Migrating from older versions

Notices for releases you may be upgrading past. If you are starting fresh, none of this applies — go to the Quick Start instead.

Current releases are described in CHANGELOG.md.

`Cannot find module` under Node — fixed in 1.9.1

If an import of tosijs-ui (any entry point) fails under Node with something like:

Cannot find module '.../dist/doc-system/site/site-config'
imported from '.../dist/doc-system/site/index.js'

you are on 1.9.0 or earlier. Upgrade to 1.9.1; there is no workaround on the older versions and no code change needed on yours.

Shipped dist/ used extensionless relative imports (from './site-config'). Bun resolves those; Node ESM does not — it requires the extension. So the package worked perfectly under bun and failed on the very first import under Node, on every entry point, going back well before 1.8.0.

Not deprecated, deliberately. The failure is loud and immediate — it stops your build on the first import, so nobody is quietly running broken code. A deprecation warning would only nag the bun users for whom every version worked. If you are pinned to an older line and need this backported, open an issue; it is a mechanical change.

Worth knowing while you are here, because the error messages name symptoms rather than causes:

entry point	runtime it needs
`tosijs-ui/site`	bun — it shells out, builds and spawns. Under Node: `Cannot find package 'bun'`
`tosijs-ui`, `tosijs-ui/<component>`	a browser or a bundler targeting one. Under bare Node: `HTMLElement is not defined`
`tosijs-ui/icon-svg`	anything — deliberately DOM-free, which is why it exists

Those three are unchanged in 1.9.1 and are not bugs; only the module resolution was.

⚠️ Breaking change in 1.7.0 — `<tosi-code>` (ACE → CodeMirror 6)

1.7.0 is a breaking release shipping under a minor version, deliberately. <tosi-code> moved from ACE to CodeMirror 6. value, mode, the change event, disabled, and undo/redo are unchanged; the ACE-era theme and options props are removed with no shim. Dark mode is now automatic (body.darkmode) and styling comes from --code-bg / --text-color. The 2.0 name is reserved for the tjs-native tosijs port, so this ships as 1.7.0 — pin tosijs-ui@1.6 to defer. Full detail and rationale in CHANGELOG.md.

Migrating to v1.3.0

v1.3.0 completes the rename from xinjs-ui to tosijs-ui. All custom element tags now use the tosi- prefix and all exports use Tosi*/tosi* names.

Breaking changes

Custom element tags have changed from <xin-*> to <tosi-*>. For example: <xin-select> is now <tosi-select>, <xin-icon> is now <tosi-icon>, <xin-example> is now <tosi-example>, etc.
CSS selectors targeting old tag names (e.g. xin-select { ... }) must be updated.
CSS custom properties in component styleSpec objects retain --xin-* fallbacks for backward compatibility, but new code should use --tosi-*.

Deprecated exports still work

The old xin* JavaScript exports (xinSelect, xinTabs, xinTable, etc.) remain available and will continue to work. Most log a runtime deprecation warning; a few are silent aliases marked with JSDoc @deprecated. They will be removed in a future major version.

Migration checklist

Search your HTML for <xin- and replace with <tosi-
Search your CSS for xin- selectors and update to tosi-
Search your JS/TS for xinSelect, xinTabs, etc. and switch to tosiSelect, tosiTabs, etc.
Search for --xin- CSS variable overrides and switch to --tosi-