@elastic/distillate 0.0.0 → 0.1.0

package/docs/reference/api/index.md

@@ -0,0 +1,9 @@
+# @elastic/distillate
+
+## Modules
+
+| Module | Description |
+| ------ | ------ |
+| [emotion](emotion.md) | - |
+| [index](index-1.md) | - |
+| [testing](testing.md) | - |

package/docs/reference/api/testing.md

@@ -0,0 +1,92 @@
+# testing
+
+## Interfaces
+
+### VarInvariantViolation [#varinvariantviolation]
+
+Defined in: [var\_invariant.ts:14](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/var_invariant.ts#L14)
+
+A `var(...)` whose custom property is never declared in the same CSS text.
+
+#### Properties
+
+| Property | Modifier | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| $$$context$$$ `context` | `readonly` | `string` | Surrounding CSS text for error reporting. | [var\_invariant.ts:18](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/var_invariant.ts#L18) |
+| $$$reference$$$ `reference` | `readonly` | `string` | The undeclared custom property name (e.g. `--aui-color-bg`). | [var\_invariant.ts:16](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/var_invariant.ts#L16) |
+
+## Functions
+
+### assertVarRefsHaveDeclarations() [#assertvarrefshavedeclarations]
+
+```ts
+function assertVarRefsHaveDeclarations(css): void;
+```
+
+Defined in: [var\_invariant.ts:135](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/var_invariant.ts#L135)
+
+Throws if any `var(...)` in `css` has no matching custom-property declaration.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `css` | `string` | Full CSS text to scan. |
+
+#### Returns
+
+`void`
+
+#### Throws
+
+If any reference has no declaration in the same text.
+
+***
+
+### findVarRefViolations() [#findvarrefviolations]
+
+```ts
+function findVarRefViolations(css): readonly VarInvariantViolation[];
+```
+
+Defined in: [var\_invariant.ts:109](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/var_invariant.ts#L109)
+
+Returns all `var(...)` references whose custom property is never declared in `css`.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `css` | `string` | Full CSS text to scan. |
+
+#### Returns
+
+readonly [`VarInvariantViolation`](#varinvariantviolation)[]
+
+***
+
+### tokenTreeDts() [#tokentreedts]
+
+```ts
+function tokenTreeDts(
+   typeName, 
+   tree, 
+   leafType?
+): string;
+```
+
+Defined in: [testing.ts:23](https://github.com/elastic/distillate/blob/f131912edadeb90a659ad22ee215412bedb1394d/src/testing.ts#L23)
+
+Emits a TypeScript `interface` for a derived token tree, for Monaco extraLib text.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `typeName` | `string` | `undefined` | Interface identifier. |
+| `tree` | `object` | `undefined` | Derived CssToken / ScaleToken tree. |
+| `leafType` | `string` | `'CssInterpolable'` | Identifier used for every leaf. Defaults to `CssInterpolable`. |
+
+#### Returns
+
+`string`

package/docs/reference/api.md

@@ -0,0 +1,12 @@
+---
+navigation_title: Generated API
+description: TypeDoc output for the three public entry points.
+---
+
+# Generated API
+
+Per-symbol pages are generated by TypeDoc from the source JSDoc and written to `docs/reference/api/` at build time (`pnpm docs:api`). They are not committed.
+
+On the published site those pages appear in this section's sidebar. Locally, `pnpm docs:dev` generates the folder and serves it with live reload.
+
+When browsing this repo on GitHub, use [entry points](entry-points.md): runtime vs type tables, import examples, and signatures for `createDistillery`, collectors, `createEmotion`, and the testing helpers. The JSDoc on `src/index.ts`, `src/emotion.ts`, and `src/testing.ts` is the source of truth for those pages.

package/docs/reference/entry-points.md

@@ -0,0 +1,125 @@
+---
+navigation_title: Entry points
+description: Root, emotion, and testing exports.
+---
+
+# Entry points
+
+Runtime values are importable at runtime. Type-only names exist in `.d.ts` only.
+
+## `@elastic/distillate`
+
+```ts
+import {
+  createDistillery,
+  combineClassNames,
+  type Distillery,
+  type DistilleryEnvironment,
+  type StyleHandle,
+} from '@elastic/distillate';
+```
+
+| Export | Kind | Role |
+| ------ | ---- | ---- |
+| `createDistillery` | runtime | Bind prefix and a theme tree. |
+| `cssVarName` | runtime | `--${prefix}-${path}` with `/` joined on `-`; strips a leading `vars/`. |
+| `lightDark` / `cq` | runtime | Theme-tree leaves. `cq` aliases `scaleToken`. |
+| `zipSchemes` | runtime | Fold two per-scheme trees. Differing strings become `lightDark`. |
+| `resolveThemeValues` | runtime | Nested literal values for one scheme. Prefer `distillery.resolveValues`. |
+| `themeToken` / `scaleToken` / `contextualVar` | runtime | Token factories. Derivation calls `themeToken` / `scaleToken`. |
+| `isCssToken` / `isScaleToken` / `isContextualCssVar` / `isContextualCssVarName` | runtime | Type guards. |
+| `css` / `decls` | runtime | Handle and declaration templates. Also on the `createStyleModule` factory argument. |
+| `rule` / `media` / `container` / `variants` / `mapDomain` | runtime | Root-entry authoring helpers. `mapDomain` has no collector side effect. |
+| `combineClassNames` | runtime | `context.resolveClassName(...handles)`. |
+| `StylesCollector` | runtime | Class; `artifactCollector` / `stylesheetCollector` return instances. |
+| `renderStyles` | runtime | Unbound renderer; prefer `distillery.renderStyles`. |
+| `createStyleNameResolver` | runtime | Standalone compact/readable name map. |
+| `StyleRegistry` | runtime | Module registry class. |
+| `Distillery` / `DistilleryOptions` / `DistilleryEnvironment` / `ThemeVarDefinition` | type | Bindings. |
+| `TokensOf` / `ValuesOf` / `PathsOf` / `ThemeTree` / `SchemePair` / `ThemeVariation` / `ResolvedThemeVariation` / `ThemeAlternate` / `RenderStylesOptions` | type | Theme derivation and render selection. |
+| `StyleHandle` / `StylesModule` / `StyleNameResolver` / `StyleNameMode` / `StyleTarget` | type | Handles, modules, naming. |
+
+### Key signatures
+
+```ts
+createDistillery<const TTheme extends ThemeTree>(
+  options: DistilleryOptions<TTheme>
+): Distillery<TokensOf<TTheme>, TTheme>;
+
+distillery.resolveValues(scheme: 'light' | 'dark', variation?: string): ValuesOf<TTheme>;
+
+distillery.createStyleModule(name, ({ css, tokens }) => ({ ... }));
+distillery.artifactCollector(
+  names: 'compact' | 'readable',
+  options?: { warn?: (message: string) => void }
+): StylesCollector;
+distillery.stylesheetCollector(
+  names?: 'compact' | 'readable',
+  options?: { warn?: (message: string) => void }
+): StylesCollector;
+distillery.renderStyles(
+  collector: StylesCollector,
+  resolver?: StyleNameResolver,
+  options?: RenderStylesOptions
+): string;
+
+collector.use(module | entry | entries): void;
+collector.useHandles(handles: readonly StyleHandle[]): readonly StyleHandle[];
+collector.createResolver(): StyleNameResolver;
+```
+
+Field-level environment types: [Environment](environment.md).
+
+## `@elastic/distillate/emotion`
+
+```ts
+import {
+  createEmotion,
+  createDomSink,
+  type Emotion,
+} from '@elastic/distillate/emotion';
+
+const { css, cx, injectGlobal, stylesheet, globalModules } = createEmotion(
+  distillery,
+  { sink: createDomSink({ document }) }
+);
+```
+
+| Export | Kind | Role |
+| ------ | ---- | ---- |
+| `createEmotion` | runtime | `css` / `cx` / `injectGlobal` over the distillery registry. |
+| `createDomSink` | runtime | One `<style>` element, flushed per turn. |
+| `Emotion` / `EmotionCss` / `CreateEmotionOptions` / `StyleSink` | type | Return and option types. |
+| `CreateDomSinkOptions` / `DocumentLike` / `StyleElementLike` | type | DOM sink surface. |
+
+```ts
+createEmotion(distillery, options?: { sink?: StyleSink }): Emotion;
+createDomSink(options: { document: DocumentLike; schedule?: (flush: () => void) => void }): StyleSink;
+```
+
+The string form of a `css` template is readable and does not collect. The wrapper is still a `StyleHandle` for `useHandles` / `resolveClassName`.
+
+## `@elastic/distillate/testing`
+
+```ts callouts=false
+import {
+  assertVarRefsHaveDeclarations,
+  findVarRefViolations,
+  tokenTreeDts,
+  type VarInvariantViolation,
+} from '@elastic/distillate/testing';
+
+findVarRefViolations(css: string): VarInvariantViolation[];
+assertVarRefsHaveDeclarations(css: string): void; // throws on violations
+```
+
+| Export | Kind | Role |
+| ------ | ---- | ---- |
+| `findVarRefViolations` | runtime | Returns `{ reference, context }[]`. |
+| `assertVarRefsHaveDeclarations` | runtime | Throws if any `var(...)` is undeclared in the same text. |
+| `tokenTreeDts` | runtime | Emits a TypeScript `interface` for a derived token tree (Monaco extraLib). |
+| `VarInvariantViolation` | type | `reference` plus nearby `context`. |
+
+No `stylis` import. Safe to use from tests that must not pull the compiler.
+
+Generated per-symbol docs are under [Generated API](api.md) after `pnpm docs:api`.

package/docs/reference/environment.md

@@ -0,0 +1,60 @@
+---
+navigation_title: Environment
+description: DistilleryOptions, DistilleryEnvironment, and ThemeVarDefinition fields.
+---
+
+# Environment
+
+`createDistillery` takes `DistilleryOptions`. `Distillery.environment` is the resolved form: derived `themeVars` and `tokens`.
+
+## `DistilleryOptions`
+
+| Field        | Type                             | Required | Notes                                                                                                           |
+| ------------ | -------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
+| `prefix`     | `string`                         | yes      | CSS identifier segment. Used in readable class and CSS-variable names.                                          |
+| `themeScope` | `string`                         | yes      | Selector wrapping the theme-variable block.                                                                     |
+| `theme`      | `ThemeTree`                      | yes      | Nested value tree. Strings and `lightDark` become theme vars; `cq` / `scaleToken` inline.                       |
+| `variations` | `Record<string, ThemeVariation>` | no       | Named value-only diffs of `theme`. Declaring a variation does not emit it. See [theming](../guides/theming.md). |
+| `sharedVars` | `readonly \`vars/${string}\`[]`  | no       | Cross-module contextual-var paths. Names follow `cssVarName`.                                                   |
+| `dev`        | `boolean`                        | no       | When `true`, collectors warn about no-op handles. Default `false`. Does not affect the single-copy guard.       |
+
+Theme-tree keys must match `/^[A-Za-z_][A-Za-z0-9_]*$/`. Hyphens are rejected so hyphen-joined custom properties reverse uniquely.
+
+## `DistilleryEnvironment`
+
+| Field        | Type                                     | Notes                                                          |
+| ------------ | ---------------------------------------- | -------------------------------------------------------------- |
+| `prefix`     | `string`                                 | Copied from options.                                           |
+| `themeScope` | `string`                                 | Copied from options.                                           |
+| `themeVars`  | `Record<string, ThemeVarDefinition>`     | Derived. Emission sorts paths.                                 |
+| `sharedVars` | `ReadonlySet<\`vars/${string}\`>`        | Optional. Path set from options.                               |
+| `tokens`     | `TTokens`                                | Derived. Surfaced as `tokens` on the authoring API.            |
+| `variations` | `Record<string, ResolvedThemeVariation>` | Optional. Resolved variations; absent when none were declared. |
+
+`Distillery.tokens` aliases `environment.tokens`. `Distillery.themeVars` aliases `environment.themeVars`. `Distillery.resolveValues(scheme, variation?)` reshapes the theme into a nested literal tree for one scheme. See [read values outside CSS](../guides/non-css-surfaces.md).
+
+## `ThemeVarDefinition`
+
+| Field    | Type                | Notes                                                                         |
+| -------- | ------------------- | ----------------------------------------------------------------------------- |
+| `path`   | `string`            | Theme-tree path this definition was derived from.                             |
+| `cssVar` | `` `--${string}` `` | Equal to `cssVarName(prefix, path)`.                                          |
+| `light`  | `string`            | Light color-scheme value.                                                     |
+| `dark`   | `string`            | Dark color-scheme value. Equal to `light` when the token is scheme-invariant. |
+
+Differing `light` / `dark` fold into `light-dark(light, dark)`.
+
+## `RenderStylesOptions`
+
+Passed as the third argument to `distillery.renderStyles` / `renderStyles`.
+
+| Field                 | Type                              | Notes                                                                                                                                         |
+| --------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `flatten`             | `string`                          | Flatten this declared variation into `themeScope`. Default is the base. A media variation does not replace the primary block.                 |
+| `scheme`              | `'light' \| 'dark'`               | Emit one scheme's literal instead of `light-dark(...)`. Applies to every emitted block. `themeValueOverrides` wins.                           |
+| `alternates`          | `readonly ThemeAlternate[]`       | Extra blocks for runtime switching. Each entry emits only the variation's diff. `ThemeAlternate.variation` is the declared name.              |
+| `themeValueOverrides` | `Partial<Record<string, string>>` | Replace a collected token's emitted value. Wins over the flattened variation and over `scheme`.                                               |
+
+A non-media alternate requires `selector`. A media-conditioned alternate may omit it and uses `themeScope`. See [declare and select variations](../guides/theming.md).
+
+Paths are `themeVars` keys (`colors/ink`), not dotted paths.

package/docs/reference/index.md

@@ -0,0 +1,11 @@
+---
+navigation_title: Reference
+description: Entry points, environment fields, generated API, and the OKF map.
+---
+
+# Reference
+
+- [Entry points](entry-points.md) — root, emotion, and testing exports
+- [Environment](environment.md) — `DistilleryOptions` and the resolved environment
+- [Generated API](api.md) — TypeDoc pages for the three public entry points
+- [OKF map](okf-map.md) — generated map of the Distillate OKF concept graph

package/docs/reference/okf-map.md

@@ -0,0 +1,92 @@
+---
+navigation_title: OKF map
+description: Generated map of the Distillate OKF concept graph.
+---
+
+# OKF map
+
+Generated from `.okf/distillate` by `pnpm okf:map`. Do not edit by hand.
+
+- Concepts: 19
+- Links: 29
+- Isolated concepts: 0
+
+## Graph
+
+```mermaid
+flowchart LR
+    concepts_authoring["Authoring"]:::concept
+    concepts_collection["Reachability collection"]:::concept
+    concepts_distillery["The distillery"]:::concept
+    concepts_naming["Naming and output"]:::concept
+    concepts_ordering["Ordering"]:::concept
+    concepts_single_copy["Single-copy invariant"]:::concept
+    concepts_tokens["Tokens and vars"]:::concept
+    entry_points_emotion["Emotion"]:::entrypoint
+    entry_points_root["Root"]:::entrypoint
+    entry_points_testing["Testing"]:::entrypoint
+    playbooks_bind_a_library["Bind a library"]:::playbook
+    playbooks_maintain_okf["Maintain OKF"]:::playbook
+    playbooks_migrate_from_emotion["Migrate from Emotion"]:::playbook
+    playbooks_read_theme_values["Read theme values"]:::playbook
+    playbooks_ship_an_artifact["Ship an artifact"]:::playbook
+    playbooks_use_the_playground["Use the playground"]:::playbook
+    playbooks_vs_emotion["Distillate vs CSS-in-JS"]:::playbook
+    reference_glossary["Glossary"]:::reference
+    reference_public_contract["Public contract"]:::reference
+    concepts_authoring --> concepts_collection
+    concepts_authoring --> concepts_tokens
+    concepts_authoring --> playbooks_use_the_playground
+    concepts_distillery --> playbooks_bind_a_library
+    concepts_naming --> concepts_distillery
+    concepts_naming --> playbooks_ship_an_artifact
+    concepts_ordering --> concepts_authoring
+    concepts_ordering --> concepts_naming
+    concepts_tokens --> concepts_distillery
+    concepts_tokens --> reference_public_contract
+    entry_points_emotion --> playbooks_migrate_from_emotion
+    entry_points_root --> entry_points_emotion
+    entry_points_root --> entry_points_testing
+    playbooks_bind_a_library --> concepts_distillery
+    playbooks_maintain_okf --> entry_points_root
+    playbooks_maintain_okf --> reference_public_contract
+    playbooks_migrate_from_emotion --> entry_points_emotion
+    playbooks_migrate_from_emotion --> playbooks_bind_a_library
+    playbooks_read_theme_values --> concepts_distillery
+    playbooks_read_theme_values --> concepts_tokens
+    playbooks_ship_an_artifact --> concepts_naming
+    playbooks_use_the_playground --> concepts_authoring
+    playbooks_use_the_playground --> concepts_tokens
+    playbooks_use_the_playground --> playbooks_ship_an_artifact
+    playbooks_vs_emotion --> concepts_single_copy
+    playbooks_vs_emotion --> playbooks_migrate_from_emotion
+    reference_glossary --> concepts_distillery
+    reference_glossary --> reference_public_contract
+    reference_public_contract --> concepts_single_copy
+    classDef concept fill:#e7f5ff,stroke:#1971c2,color:#102a43
+    classDef entrypoint fill:#fff4e6,stroke:#e67700,color:#2d1600
+    classDef playbook fill:#ebfbee,stroke:#2b8a3e,color:#102a12
+    classDef reference fill:#f8f0fc,stroke:#9c36b5,color:#2b1033
+```
+
+## Concepts
+
+- Authoring (Concept): `concepts/authoring`
+- Reachability collection (Concept): `concepts/collection`
+- The distillery (Concept): `concepts/distillery`
+- Naming and output (Concept): `concepts/naming`
+- Ordering (Concept): `concepts/ordering`
+- Single-copy invariant (Concept): `concepts/single-copy`
+- Tokens and vars (Concept): `concepts/tokens`
+- Emotion (Entry Point): `entry-points/emotion`
+- Root (Entry Point): `entry-points/root`
+- Testing (Entry Point): `entry-points/testing`
+- Bind a library (Playbook): `playbooks/bind-a-library`
+- Maintain OKF (Playbook): `playbooks/maintain-okf`
+- Migrate from Emotion (Playbook): `playbooks/migrate-from-emotion`
+- Read theme values (Playbook): `playbooks/read-theme-values`
+- Ship an artifact (Playbook): `playbooks/ship-an-artifact`
+- Use the playground (Playbook): `playbooks/use-the-playground`
+- Distillate vs CSS-in-JS (Playbook): `playbooks/vs-emotion`
+- Glossary (Reference): `reference/glossary`
+- Public contract (Reference): `reference/public-contract`

package/package.json

@@ -1,6 +1,129 @@
 {
-   "name": "@elastic/distillate",
-   "version": "0.0.0",
-   "description": "Placeholder to enable Trusted Publisher configuration.",
-   "repository": { "type": "git", "url": "https://github.com/elastic/distillate" }
+  "name": "@elastic/distillate",
+  "version": "0.1.0",
+  "description": "Theme-agnostic CSS style engine: typed authoring with dependency capture, render-driven reachability collection, and dual readable/compact output targets. One runtime dependency: stylis.",
+  "license": "Elastic-2.0",
+  "author": "Elastic",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elastic/distillate.git"
+  },
+  "homepage": "https://elastic.github.io/distillate/",
+  "bugs": {
+    "url": "https://github.com/elastic/distillate/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/instance.ts",
+    "**/instance.js"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./emotion": {
+      "types": "./dist/emotion.d.ts",
+      "import": "./dist/emotion.js",
+      "require": "./dist/cjs/emotion.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/cjs/testing.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "src",
+    "!src/**/*.test.ts",
+    "!docs/examples/**/*.test.ts",
+    "!src/types",
+    "!docs/playground/node_modules",
+    "!docs/playground/dist",
+    "LICENSE.txt",
+    "NOTICE.txt",
+    "THIRD_PARTY_LICENSES.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.17.0",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "pnpm build:clean && pnpm build:compile && pnpm build:specifiers && pnpm build:compile:cjs && pnpm build:cjs-manifest",
+    "build:clean": "rm -rf ./dist",
+    "build:compile": "tsc -p tsconfig.build.json",
+    "build:specifiers": "tsc-alias -p tsconfig.build.json",
+    "build:compile:cjs": "tsc -p tsconfig.build.cjs.json",
+    "build:cjs-manifest": "node scripts/write_cjs_manifest.js",
+    "prepack": "pnpm docs:api && pnpm build",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p docs/playground/tsconfig.json --noEmit",
+    "lint": "pnpm lint:es && pnpm lint:md",
+    "lint:es": "eslint .",
+    "lint:fix": "pnpm lint:es --fix",
+    "lint:md": "markdownlint-cli2",
+    "okf:check": "okf validate .okf/distillate && node scripts/check_okf_anchors.js && node scripts/write_okf_map.js --check",
+    "okf:index": "okf index .okf/distillate && pnpm okf:map",
+    "okf:map": "node scripts/write_okf_map.js",
+    "test": "vitest run && pnpm --filter @elastic/distillate-playground test",
+    "test:coverage": "vitest run --coverage",
+    "docs:api": "typedoc && node scripts/docs_api_anchors.js",
+    "docs:build": "pnpm docs:api && docs-builder",
+    "docs:dev": "pnpm docs:api && node scripts/docs_dev.js",
+    "docs:serve": "pnpm docs:dev",
+    "playground:dev": "pnpm --filter @elastic/distillate-playground dev",
+    "playground:build": "pnpm --filter @elastic/distillate-playground build",
+    "smoke:exports": "node scripts/smoke_exports.js",
+    "smoke:declarations": "node scripts/check_declarations.js",
+    "licenses:report": "node scripts/licenses_report.js",
+    "verify": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm smoke:exports && pnpm smoke:declarations && pnpm licenses:report --check",
+    "semantic-release": "node scripts/run_semantic_release.js",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "stylis": "4.4.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/js": "^9.25.1",
+    "@rmenke/css-tokenizer-tests": "^1.2.0",
+    "@types/node": "^24.13.5",
+    "@types/stylis": "^4.2.7",
+    "@vitest/coverage-v8": "^4.1.11",
+    "eslint": "^9.25.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-license-header": "^0.9.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-simple-import-sort": "^14.0.0",
+    "globals": "^17.12.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.2",
+    "markdownlint-cli2": "^0.23.2",
+    "prettier": "^3.5.3",
+    "semantic-release": "^25.0.9",
+    "tsc-alias": "^1.8.16",
+    "typedoc": "^0.28.13",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.31.0",
+    "vitest": "^4.1.11"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ],
+    "overrides": {
+      "smol-toml": ">=1.7.1",
+      "dompurify": ">=3.4.13"
+    }
+  }
 }