Changelog
New releases, improvements, and fixes across Kirari and its integrations.
Breaking changes
Renamed from
@vortexlabs/kiraritokirariThe package is now published as
kirari.@vortexlabs/kirariis deprecated and unsupported: it re-exportskirari1.x, so existing imports keep working, but it gets no releases of its own and does not follow 2.0 or later. Switch tokirarito keep receiving updates.How to migrate
- Uninstall
@vortexlabs/kirariand installkirari. - Replace every
@vortexlabs/kirariimport specifier withkirari, including subpaths such as@vortexlabs/kirari/languages/python. - Update any other mention of
@vortexlabs/kirari, such as bundler configuration oroptimizeDepsentries.
Runnpm uninstall @vortexlabs/kirari && npm install kirariBeforeimport { highlight } from '@vortexlabs/kirari' import { python } from '@vortexlabs/kirari/languages/python' import '@vortexlabs/kirari/theme.css'Afterimport { highlight } from 'kirari' import { python } from 'kirari/languages/python' import 'kirari/theme.css'Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
- Uninstall
Breaking changes
Renamed from
@vortexlabs/kirari-reacttokirari-reactThe package is now published as
kirari-react.@vortexlabs/kirari-reactis deprecated and unsupported: it re-exportskirari-react1.x, so existing imports keep working, but it gets no releases of its own and does not follow 2.0 or later. Switch tokirari-reactto keep receiving updates.How to migrate
- Uninstall
@vortexlabs/kirari-reactand installkirari-react. - Replace every
@vortexlabs/kirari-reactimport specifier withkirari-react, including subpaths such as@vortexlabs/kirari-react/stream. kirari-reactrequireskirarias a peer dependency. If the project still uses@vortexlabs/kirari, migrate it tokirarithe same way.- Update any other mention of
@vortexlabs/kirari-react, such as bundler configuration oroptimizeDepsentries.
Runnpm uninstall @vortexlabs/kirari @vortexlabs/kirari-react && npm install kirari kirari-reactBeforeimport { Code } from '@vortexlabs/kirari-react' import { useTokenStream } from '@vortexlabs/kirari-react/stream'Afterimport { Code } from 'kirari-react' import { useTokenStream } from 'kirari-react/stream'Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
- Uninstall
Breaking changes
Renamed from
@vortexlabs/kirari-rehypetokirari-rehypeThe package is now published as
kirari-rehype.@vortexlabs/kirari-rehypeis deprecated and unsupported: it re-exportskirari-rehype1.x, so existing imports keep working, but it gets no releases of its own and does not follow 2.0 or later. Switch tokirari-rehypeto keep receiving updates.How to migrate
- Uninstall
@vortexlabs/kirari-rehypeand installkirari-rehype. - Replace every
@vortexlabs/kirari-rehypeimport specifier withkirari-rehype. kirari-rehyperequireskirarias a peer dependency. If the project still uses@vortexlabs/kirari, migrate it tokirarithe same way.- Update any other mention of
@vortexlabs/kirari-rehype, such as bundler configuration oroptimizeDepsentries.
Runnpm uninstall @vortexlabs/kirari @vortexlabs/kirari-rehype && npm install kirari kirari-rehypeBeforeimport rehypeKirari from '@vortexlabs/kirari-rehype'Afterimport rehypeKirari from 'kirari-rehype'Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
- Uninstall
Bug fixes
- Python annotated parameters after commas, such as
bindef f(a: str, b: str): pass, are highlighted as variables instead of dictionary keys. Multiline signatures keep the same highlighting when streamed. - Unparenthesized lambda parameters inside dictionaries, such as
bin{'f': lambda a, b: 1}, keep their variable highlighting, including across streamed line breaks.
- Python annotated parameters after commas, such as
Breaking changes
Public object types are type aliases
Token,Rule,Language,RenderOptions,Decoration,TokenPatch, andTokenStreamare now type aliases instead of interfaces. Their members are unchanged, but code that extends them through declaration merging (module augmentation) no longer compiles.How to migrate
- Replace
declare moduleaugmentations of these types with your own type that intersects them, such astype AppToken = Token & { line: number }. - No change is needed if you only import and use the types.
Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
Bug fixes
- Markdown heading tokens no longer include the trailing line break, so heading styles and line-based renderers stop at the end of the line.
- JavaScript and TypeScript private class names such as
#countare now one token, highlighted as properties at both the declaration andthis.#count, and as functions for private methods.
- Replace
Bug fixes
- TypeScript and TSX member names after semicolons are now highlighted as properties, matching the first member in class, interface, and object type bodies.
Breaking changes
Public object types are type aliases
LineandStreamedTokensfrom@vortexlabs/kirari-react/streamare now type aliases instead of interfaces. Their members are unchanged, but code that extends them through declaration merging (module augmentation) no longer compiles.CodePropsremains an interface.How to migrate
- Replace
declare moduleaugmentations of these types with your own type that intersects them, such astype AppLine = Line & { id: string }. - No change is needed if you only import and use the types.
Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
- Replace
Improvements
- Reduce bundle overhead by consolidating function lookahead, simplifying equivalent JavaScript regexes, and sharing HTML escape replacements.
Bug fixes
- TypeScript enum declaration names are now highlighted as types, like class, interface, and type alias names.
- JavaScript, TypeScript, and Python decorator markers are highlighted as operators and bare decorator names as functions, while qualified names and Python matrix multiplication retain their classifications.
Improvements
- The default bundle shrinks from about 6.1 KB to about 4.3 KB gzipped. Function definition highlighting for languages other than JavaScript now ships with those language definitions instead of the core scanner, so
highlight,tokenize, and@vortexlabs/kirari/coreno longer include it. Highlighting output is unchanged. - Definitions can set a new optional
definitions(tokens)callback that runs after tokenizing and can retype names as functions. Built-in definitions that highlight function definitions set it, and a copy made by spreading one keeps it even when renamed. A custom definition that only reuses a built-in name such as'python'no longer gets that highlighting; setdefinitions: python.definitionsto keep it.
- The default bundle shrinks from about 6.1 KB to about 4.3 KB gzipped. Function definition highlighting for languages other than JavaScript now ships with those language definitions instead of the core scanner, so
Improvements
- Streaming Python, JSX, TSX, and JSONC with
createTokenStreamnow rescans only near the end of the source instead of retokenizing everything on every write. Streaming 8 KB one character at a time drops from about 5 seconds to 0.1 seconds for Python, and from about 13 seconds to 0.2 seconds for TSX.
Bug fixes
- Python names before a colon, such as
readyinif ready:orcountincount: int, are no longer highlighted as functions when a later line assigns a lambda. - Streamed JavaScript and TypeScript function names stay revisable while a slash on the last line could still start a regex literal.
renderDecoratedwithlines: trueno longer adds an empty last line wrapper after a trailing newline.
- Streaming Python, JSX, TSX, and JSONC with
Improvements
<Code>accepts text children the way React renders text, so<Code>let x = {count}</Code>highlights the joined source. Numbers and bigints are kept,null,undefined, and booleans render nothing, and element children throw aTypeError. The newCodeTexttype describes the accepted children.
Bug fixes
linesandhighlightLinesno longer add an empty last line wrapper after a trailing newline.
Bug fixes
- Line wrappers no longer add an empty last line after a code block's trailing newline, which showed an extra line, and an extra CSS line number, on every block rendered with
linesor fence line metadata such as{2,4-6}.
- Line wrappers no longer add an empty last line after a code block's trailing newline, which showed an extra line, and an extra CSS line number, on every block rendered with
Bug fixes
- Long runs of short tokens in CSS, Makefile, TOML, YAML, and Markdown with embedded languages now tokenize in linear time instead of slowing down quadratically.
- An unclosed Markdown fence on a single line no longer backtracks over the whole line.
- YAML numbers, booleans, and nulls end before
#only when whitespace precedes it, so3#xreads as one plain scalar. - TOML numbers no longer split names such as
42n.
Improvements
- JavaScript, JSX, TypeScript, and TSX handle multiline and parenthesized arrows, nested default parameters, typed bindings, and contextual method names.
- Batch and streaming output stay consistent while signatures, comments, and arrow operators are incomplete.
Bug fixes
- Function names are no longer highlighted as ordinary variables. Declarations, generic signatures, quoted names, lambdas, and closures are recognized across the programming-language grammars.
Bug fixes
- Adjacent JSX and TSX element snippets highlight without a fragment wrapper, and comparisons after JSX stay JavaScript.
Improvements
- Package homepage and documentation links point to kirari.sh.
Improvements
- First stable release of the core highlighting APIs.
- Import languages by name from
@vortexlabs/kirari/languages. Individual language entry points still work.
Improvements
- Package homepage and documentation links point to kirari.sh.
Breaking changes
Requires
@vortexlabs/kirari1.xThe
^0.1.0peer range no longer applies, so upgrading only@vortexlabs/kirari-reactfails with a peer dependency conflict.How to migrate
- Upgrade
@vortexlabs/kirariand@vortexlabs/kirari-reactin the same install. - No code changes are needed:
CodeanduseTokenStreamkeep the same props and behavior.
Runnpm install @vortexlabs/kirari@^1 @vortexlabs/kirari-react@^1Migrate with an AI assistant Copy a prompt with these steps and paste it into Claude, Cursor, or Codex in your project. It finds the affected code and updates it.
Improvements
- First stable release, built on the Kirari 1.0 core APIs.
- Upgrade
Improvements
- Package homepage and documentation links point to kirari.sh.
Improvements
- First stable release of the Rehype and MDX plugin. Install it with
@vortexlabs/kirari1.x.
- First stable release of the Rehype and MDX plugin. Install it with
Improvements
- First preview release of the core library.
Improvements
- First preview release of the React components and streaming hook.