@takazudo/zdtp 0.5.2 → 0.6.1

package/CHANGELOG.md

@@ -4,6 +4,56 @@ All notable changes to `@takazudo/zdtp` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [0.6.1] - 2026-09-08
+
+### Features
+
+- feat: model declared token defaults for static dashboards (422643b)
+- feat: expose a static Preact token dashboard (5b6c0f8)
+- feat(playground): add static token dashboard demo and docs (2edd98b)
+- feat(dashboard): render rulers, palette strips and wide type specimens (7cdf01f)
+
+### Fixed
+
+- fix: preserve semantic literals alongside legacy palette references (b813c8a)
+
+### Other Changes
+
+- test: account for standalone dashboard stylesheet delivery (a00541a)
+- test: verify packed dashboard SSR and public stylesheet consumption (6cd8157)
+- test: cover static dashboard list-view geometry in browser (e07d69e)
+- chore: normalize dashboard browser test file mode (0ec8217)
+- docs: demonstrate dashboard rulers ramps and reading specimens (859d3a4)
+- test: verify packed dashboard list views and preview text (7ebf4cf)
+- test: prove isolated dashboard package consumption (fdb3906)
+- fix(test): compare Preact package identity across module conditions (bb280ee)
+- Fix static browser harness loading and polling (3fe6203)
+
+## [0.6.0] - 2026-09-08
+
+### Breaking Changes
+
+- fix: validate reserved palette tab configuration (73e70f9). The reserved `palette` tab now rejects `colorExtras`, empty or non-color tiers, and inconsistent CSS-variable families. This also affects Astro host configuration validation. **Migration**: remove `colorExtras` from the `palette` tab; give each tier non-empty color items using either consecutive numbered CSS variables with one prefix or unique named variables with one prefix. Move mixed-kind generic tiers to a differently named tab and update any `referencesRamps` tab references.
+
+### Features
+
+- feat(minimal): teach grouped palette and semantic colors (5dcbe12)
+- feat(playground): use grouped OKLCH palette and semantic colors (42c7c86)
+
+### Fixed
+
+- fix: preserve host color-scheme on per-mode apply (90c30c6)
+- fix: render specimen fonts from instance values (7d18952)
+- fix: normalize emitted declaration module specifiers (8f858c0)
+- fix: expose panel config validator through public entrypoints (5335713)
+
+### Other Changes
+
+- docs: explain grouped palettes and per-mode semantic colors (3d1d114)
+- Restructure playground colors into grouped semantic ramps (2076abe)
+- test: verify specimen instance isolation in Chromium (6ff7ed6)
+- test: guard packed declarations across TypeScript resolution modes (f1e5e21)
+
 ## [0.5.2] - 2026-09-08
 
 ### Features

package/PORTABLE-CONTRACT.md

@@ -191,6 +191,24 @@ export function setPanelColorPresets(presets: Record<string, ColorScheme>): void
 export function assertValidPanelConfig(value: unknown): asserts value is PanelConfig;
 ```
 
+`assertValidPanelConfig` and its `PanelConfig` type are public exports from both
+`@takazudo/zdtp` and `@takazudo/zdtp/testing`; no deep import is needed.
+Run the assertion against your host config in a CI test, for example:
+
+```ts
+import { assertValidPanelConfig } from '@takazudo/zdtp/testing';
+import { panelConfig } from './panel-config';
+
+// An invalid manifest throws and fails the test/CI run.
+assertValidPanelConfig(panelConfig);
+```
+
+The assertion accepts `unknown` and narrows it to `PanelConfig` on success.
+Validation is explicit: `configurePanel` does not call this assertion. A host
+that wants configure-time validation can import both functions from
+`@takazudo/zdtp` and call `assertValidPanelConfig(config)` before
+`configurePanel(config)`.
+
 Required behaviours:
 
 - **Multi-instance.** Calling `configurePanel` with a **distinct**
@@ -1723,6 +1741,107 @@ on across a release bump.
 
 ---
 
+## 12. Static token dashboard
+
+This entry is available from v0.6.1. It does
+not change the `configurePanel` or persistence contracts above.
+
+`@takazudo/zdtp/dashboard` exports the Preact `TokenDashboard` component and
+`TokenDashboardProps`, `DashboardMode`, `DashboardPreviewKind`, `TabConfig`,
+`TierConfig`, and `TierItem` types. The internal value model is not a public API.
+
+```ts
+export type DashboardMode = 'light' | 'dark';
+export type DashboardPreviewKind =
+  | 'bar' | 'size' | 'line-height' | 'family' | 'weight' | 'radius' | 'duration'
+  | 'color' | 'shadow' | 'text';
+
+export interface TokenDashboardProps {
+  tabs: readonly TabConfig[];
+  mode?: DashboardMode; // default: light
+  title?: string; // default: Token dashboard
+  previewText?: string; // static typography passage; default English/Japanese prose
+  id?: string; // optional root ID; caller owns uniqueness
+  previewOverrides?: Readonly<Record<string, DashboardPreviewKind>>;
+}
+```
+
+### Rendering and package boundary
+
+- Ordinary Preact rendering and server rendering are supported. The component
+  has no browser-global, panel-runtime, persistence, host-adapter, bin-server,
+  or browser Tailwind compiler dependency. No hydration is required.
+- `@takazudo/zdtp/dashboard/styles.css` is a separate public asset. Dashboard
+  JavaScript has no CSS side-effect import; the host must include this asset
+  through its CSS build or a static stylesheet link. It is not appended to the
+  existing panel stylesheet, which is unnecessary for a dashboard-only page.
+- Each instance declares known token variables inside its inventory and sets
+  `color-scheme` to its explicit `mode`. It never writes to `:root` or host
+  state. Dashboard chrome styles are independent of inventory variables.
+- Tabs, tiers, and rows render in input order. All token rows remain visible;
+  no collapsed sections or automatic IDs are introduced. Empty input is valid.
+  Notes-only tabs are omitted, and arbitrary notes HTML is never injected.
+
+### Layouts for spacing, color, and typography
+
+Spacing (`bar`) uses wide rows with aligned ruler origins. Nonnegative `px` or
+`rem` lengths, unitless zero, and resolved direct local aliases get an actual-size
+sample. Ticks mark 8 CSS px, with major ticks every 64 CSS px. The browser sizes
+`rem` against the host root font size; the dashboard does not assume a conversion.
+Large lengths scroll inside the focusable ruler instead of shrinking or clamping.
+Zero has zero width. Negative lengths, `em`, percentages, `calc()` and other
+unsupported expressions retain their declaration with a ruler-unavailable
+explanation. Missing references also retain their diagnostics.
+
+A nonsemantic, non-reference tier whose source items are all colors becomes a
+discrete palette strip. Stops stay in declared order, with every label and value
+visible; narrow containers scroll horizontally. Grouping uses tier structure,
+not name matching or generated intermediate colors. Semantic and reference tiers
+keep independent color samples. Per-variable preview overrides remain authoritative
+and retain each token's slot and order, including mixed overrides within a strip.
+
+`size`, `family`, `weight`, and `line-height` use wide, multiline specimens with
+auto height outside palette strips. Overrides inside a palette retain their stop slot. The baseline is 18px text with 1.6 line height; each sample changes
+only its intended property. A resolved `previewBase` can supply the font size of
+a line-height sample. Font families use locally available fonts and their CSS
+fallbacks; the dashboard does not download fonts.
+
+`previewText` supplies one static passage for all typography samples in an
+instance. Its default is longer English/Japanese prose. Newlines and white space
+are preserved, text is escaped, and an explicit empty string stays empty.
+Long text wraps; unusually large glyphs can scroll locally without scaling.
+There is no built-in editable text workbench or connection to panel state.
+
+### Values and previews
+
+- Inputs describe **declared defaults**: item defaults, selected-mode
+  `colorExtras.semanticDefaults`, and explicit `colorExtras.baseDefaults` for
+  base-role rows. Named presets, panel initialization, and saved/current panel
+  state are not applied. Pill rows preserve `item.default`, not `customDefault`.
+- Reference tiers, cross-tab ramps, aliases, and legacy palette indices resolve
+  against actual declared IDs and `cssVar` names. Rows retain declared values
+  and display CSS/reference text. Missing/ambiguous mappings, duplicate
+  variables, cycles, and unsafe declarations remain visible with diagnostics
+  and no misleading sample.
+- CSS expressions remain expressions. Resolution is not universal CSS grammar
+  validation or browser computed-style inspection. External dependencies may
+  be context-dependent; unresolved dependencies suppress samples and expose
+  diagnostics. Browser layout, units, and available fonts affect previews.
+- Preview choice is `previewOverrides[cssVar]`, then `TierConfig.preview`, then
+  color for color-editor rows or text for other rows. `duration` and `text`
+  display values without animated/visual samples. A resolved `previewBase`
+  token can supply font size for a line-height sample. Subsets must include
+  referenced tiers to retain resolved samples.
+- Preact escapes text. URL/mask assets and unsafe resource-bearing expressions
+  are not automatically loaded through samples.
+
+Keep shared token definitions in a build-safe data module using type-only
+imports. Pass the same tabs to `PanelConfig` and `TokenDashboard`; no automatic
+state synchronization follows from sharing them. A React adapter and an
+HTML-export function or CLI are outside this checkpoint.
+
+---
+
 ## Appendix A — section index
 
 Cross-reference table — what each section pins down.
@@ -1754,6 +1873,7 @@ Cross-reference table — what each section pins down.
 | `data-zdtp-action` stable header-action hook (ids stable, labels not; two matches while the compact popover is open) | §7.6 |
 | v4 envelope precedence, v1/v2/v3 storage migration, and typography-id rename map             | §2, §8.3, §8.4 |
 | JSON export/import schemas v1/v2/v3 (serde)                                                  | §9            |
+| Static Preact dashboard props, defaults, previews, isolation, and CSS export | §12 |
 | Out-of-scope / deferred concerns                                                            | §10           |
 | Versioning promise, breaking-change signalling, and consumer guidance for mirroring the eager-load gate registries | §11 |
 | Feature walkthrough and shortcut table                                                     | [Panel UX tour](/docs/recipes/panel-ux-tour) |

package/README.md

@@ -32,12 +32,94 @@ The authoritative API spec is [`PORTABLE-CONTRACT.md`](./PORTABLE-CONTRACT.md).
   partial reconciliation, and JSON export/import when disk apply is not
   configured.
 - Owner autoload for developer-only loading across page visits.
+- A separate Preact `TokenDashboard` for a static, read-only token inventory
+  (available from v0.6.1).
 
 See the [Panel UX tour](/docs/recipes/panel-ux-tour) for a feature-by-feature
 walkthrough and the shortcut table.
 
 ---
 
+## Static token dashboard
+
+Import `TokenDashboard` from `@takazudo/zdtp/dashboard` to render the same tab
+manifest on a plain page. This entry is available from v0.6.1. The [live workspace demo](https://zdtp-playground.zudolab.dev/dashboard/)
+shows both modes and a compact embedded instance.
+
+```tsx
+import { TokenDashboard } from '@takazudo/zdtp/dashboard';
+import { tokenTabs } from './token-tabs'; // Shared data module; type-only imports.
+
+export default function TokenPage() {
+  return <TokenDashboard tabs={tokenTabs} mode="light" title="Site tokens" />;
+}
+```
+
+For example, keep the definitions in a module that is safe to import at build time:
+
+```ts
+// token-tabs.ts — data only; safe to import during a site build.
+import type { TabConfig } from '@takazudo/zdtp/dashboard';
+
+export const tokenTabs: readonly TabConfig[] = [{
+  id: 'space',
+  label: 'Spacing',
+  tiers: [{
+    id: 'scale',
+    label: 'Scale',
+    preview: 'bar',
+    items: [{
+      id: 'space-md',
+      cssVar: '--site-space-md',
+      label: 'Medium',
+      default: '1rem',
+      type: { kind: 'length', step: 0.25, unit: 'rem' },
+    }],
+  }],
+}];
+```
+
+Also pass `tokenTabs` as `tabs` in your panel's config. Keep panel initialization
+and browser/storage code out of this data module.
+The component requires Preact and can render during the host's static build
+without hydration; no panel initialization is needed.
+
+Include **`@takazudo/zdtp/dashboard/styles.css`** separately. The dashboard JS
+does not import CSS and does not need the panel stylesheet. A CSS-emitting
+bundler can import this asset from its layout; strict static hosts should use
+a supported global CSS `@import` or copy the resolved public export to their
+public assets directory and add a stylesheet link. The
+[static dashboard recipe](https://zdtp.zudolab.dev/docs/recipes/static-token-dashboard/)
+provides complete data and CSS-copy examples.
+
+Optional props are `mode` (`light` by default), `title`, caller-owned unique
+`id`, `previewText`, and `previewOverrides` keyed by CSS variable (for example,
+a text-editor shadow can use `'shadow'`). Existing `TierConfig.preview` metadata is reused.
+
+Spacing uses actual-size rulers with local scrolling. Nonnegative px/rem, zero,
+and resolved direct aliases are supported; other lengths keep a readable fallback.
+Color-only nonsemantic, non-reference tiers form discrete strips in source order.
+Typography uses wide multiline specimens; `previewText` supplies your static
+passage (default: English/Japanese prose; an explicit empty string stays empty).
+The baseline is 18px/1.6, with only the intended property changed and resolved
+`previewBase` honored for line-height. Fonts use local availability and CSS
+fallbacks. There is no editable text workbench.
+
+The inventory uses **declared defaults**: item defaults, per-mode
+`semanticDefaults`, and explicit base-role `baseDefaults`. It does not apply
+named color presets, panel initialization, or persisted edits. CSS expressions
+remain expressions; samples depend on browser layout and available fonts.
+Missing/context-dependent references and invalid declarations remain readable
+with diagnostics rather than misleading samples. Preview variables and
+`color-scheme` are local to each instance; the component never writes to
+`:root`. Arbitrary notes HTML and URL/mask assets are not rendered or loaded.
+
+This checkpoint provides a Preact component. An HTML-export API/CLI, React
+adapter, and automatic panel-state synchronization are outside its scope.
+See [`PORTABLE-CONTRACT.md` §12](./PORTABLE-CONTRACT.md#12-static-token-dashboard).
+
+---
+
 ## 0. Architecture at a glance
 
 The design-token panel is a browser-based UI that writes token overrides to

package/dist/apply/build-apply-overrides.d.ts

@@ -60,8 +60,8 @@
  *
  * Pure / no IO — safe to import anywhere (browser, Node, tests).
  */
-import type { ColorTweakState, TweakState, ColorClusterConfig } from '../state/tweak-state';
-import type { TabConfig } from '../tokens/tier-model';
+import type { ColorTweakState, TweakState, ColorClusterConfig } from "../state/tweak-state.js";
+import type { TabConfig } from "../tokens/tier-model.js";
 /**
  * Produce the flat cssVar → value map for the dev-API handler.
  *

package/dist/apply/last-applied.d.ts

@@ -1,4 +1,4 @@
-import type { PanelConfig } from '../config/panel-config';
+import type { PanelConfig } from "../config/panel-config.js";
 export type FlatOverrides = Record<string, string>;
 export declare function loadLastApplied(cfg: PanelConfig): FlatOverrides;
 export declare function saveLastApplied(overrides: FlatOverrides, cfg: PanelConfig): void;

package/dist/apply/reconcile-applied.d.ts

@@ -1,5 +1,5 @@
-import type { PanelConfig } from '../config/panel-config';
-import type { ColorTweakState, TweakState } from '../state/tweak-state';
+import type { PanelConfig } from "../config/panel-config.js";
+import type { ColorTweakState, TweakState } from "../state/tweak-state.js";
 /**
  * Remove only overrides the server confirms it wrote. CSS variables are
  * resolved through the manifest token index so color, secondary-color,

package/dist/apply/route-tokens-to-files.d.ts

@@ -14,7 +14,7 @@
  *
  * No IO, no DOM, no Node-specific imports — safe to bundle for the browser.
  */
-import type { ApplyRoutingMap } from '../config/panel-config';
+import type { ApplyRoutingMap } from "../config/panel-config.js";
 /**
  * Prefix-family identifier. Plain string — the routing map is host-supplied.
  */

package/dist/apply/tier-resolver.d.ts

@@ -19,7 +19,7 @@
  * For a reference tier (referencesTier is set) the value is the id of a target
  * item in the named tier.
  */
-import type { TabConfig } from '../tokens/tier-model';
+import type { TabConfig } from "../tokens/tier-model.js";
 export type TabOverrides = Readonly<Record<string, Readonly<Record<string, string>>>>;
 export declare class TierResolverError extends Error {
     constructor(message: string);

package/dist/apply-modal.d.ts

@@ -1,5 +1,5 @@
-import { type PanelConfig } from './config/panel-config';
-import { type ColorTweakState, type TweakState } from './state/tweak-state';
+import { type PanelConfig } from "./config/panel-config.js";
+import { type ColorTweakState, type TweakState } from "./state/tweak-state.js";
 export interface ApplyModalProps {
     state: TweakState;
     open: boolean;

package/dist/astro/host-adapter.js

@@ -1,6 +1,6 @@
-import { c as y, g as m, a as w, b, i as P } from "../panel-config-CqbuB0nh.js";
-import { g, Z as A } from "../tweak-state-c53KtLHq.js";
-import { s as D, l as E, a as _, i as c, r as f, c as k, b as S, d } from "../autoload-state-BI4-9A58.js";
+import { c as y, g as m, a as w, b, i as P } from "../panel-config-Crn5QJGy.js";
+import { g, Z as A } from "../tweak-state-Dzr5kDhX.js";
+import { s as D, l as E, a as _, i as c, r as f, c as k, b as S, d } from "../autoload-state-CGnis85c.js";
 import { READABLE_STATE_KEY_SUFFIXES as T } from "../constants.js";
 const u = "tokenpanel-config";
 function I() {

package/dist/astro/index.d.ts

@@ -22,11 +22,11 @@
  * callers don't need a deep `@takazudo/zdtp/dist/config/panel-config`
  * import to type their config object.
  */
-export type { PanelConfig } from '../config/panel-config';
-export type { ColorScheme, ColorRef } from '../config/color-schemes';
-export type { ColorClusterConfig } from '../state/tweak-state';
-export { setPanelColorPresets } from '../config/panel-config';
-export { colorSchemes } from '../config/color-schemes';
-export { panelSettings, SEMANTIC_CSS_NAMES, SEMANTIC_DEFAULTS_ZD } from '../config/color-scheme-utils';
-export { GROUP_ORDER, FONT_GROUP_ORDER, SIZE_GROUP_ORDER, GROUP_TITLES } from '../tokens/manifest';
-export type { TokenDef, TokenManifest } from '../tokens/manifest';
+export type { PanelConfig } from "../config/panel-config.js";
+export type { ColorScheme, ColorRef } from "../config/color-schemes.js";
+export type { ColorClusterConfig } from "../state/tweak-state.js";
+export { setPanelColorPresets } from "../config/panel-config.js";
+export { colorSchemes } from "../config/color-schemes.js";
+export { panelSettings, SEMANTIC_CSS_NAMES, SEMANTIC_DEFAULTS_ZD } from "../config/color-scheme-utils.js";
+export { GROUP_ORDER, FONT_GROUP_ORDER, SIZE_GROUP_ORDER, GROUP_TITLES } from "../tokens/manifest.js";
+export type { TokenDef, TokenManifest } from "../tokens/manifest.js";

package/dist/astro/index.js

@@ -1,4 +1,4 @@
-import { s as t } from "../panel-config-CqbuB0nh.js";
+import { s as t } from "../panel-config-Crn5QJGy.js";
 import { c as d } from "../color-schemes-CgzOBqGO.js";
 import { F as r, G as m, a as g, S as z } from "../manifest-DvuKi7I4.js";
 const e = {

package/dist/{autoload-state-BI4-9A58.js → autoload-state-CGnis85c.js}

@@ -1,4 +1,4 @@
-import { g as n, j as o } from "./panel-config-CqbuB0nh.js";
+import { g as n, j as o } from "./panel-config-Crn5QJGy.js";
 function c() {
   return typeof document < "u" && document !== null && typeof document.getElementById == "function";
 }

package/dist/bulk/bulk-actions.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentChildren } from 'preact';
-import type { TierConfig } from '../tokens/tier-model';
-import { type NumericValue } from '../utils/numeric-transform';
-import type { FlatTabEntry, RowContribution, TokenAddress } from '../tabs/flat/types';
+import type { TierConfig } from "../tokens/tier-model.js";
+import { type NumericValue } from "../utils/numeric-transform.js";
+import type { FlatTabEntry, RowContribution, TokenAddress } from "../tabs/flat/types.js";
 export interface BulkOperations {
     multiply: string;
     add: string;

package/dist/bulk/index.d.ts

@@ -1,2 +1,2 @@
-export { BulkActionBar, DEFAULT_BULK_OPERATIONS, createBulkContribution, isBulkSelectable, isSelectable, numericEntryUnit, numericValueForEntry, transformBulkEntry, } from './bulk-actions';
-export type { BulkActionBarProps, BulkContributionOptions, BulkOperations, BulkPatchEntry, } from './bulk-actions';
+export { BulkActionBar, DEFAULT_BULK_OPERATIONS, createBulkContribution, isBulkSelectable, isSelectable, numericEntryUnit, numericValueForEntry, transformBulkEntry, } from "./bulk-actions.js";
+export type { BulkActionBarProps, BulkContributionOptions, BulkOperations, BulkPatchEntry, } from "./bulk-actions.js";

package/dist/chain/index.d.ts

@@ -1,2 +1,2 @@
-export { ChainButton, ChainPopover, TOKEN_CHAIN_CONTRIBUTION, TokenChainButton, TokenChainPopover, type TokenChainButtonProps, type TokenChainPopoverProps, } from './token-chain-popover';
-export { TokenChainProvider, useTokenChainContext, type TokenChainContextValue, type TokenChainProviderProps, } from './token-chain-context';
+export { ChainButton, ChainPopover, TOKEN_CHAIN_CONTRIBUTION, TokenChainButton, TokenChainPopover, type TokenChainButtonProps, type TokenChainPopoverProps, } from "./token-chain-popover.js";
+export { TokenChainProvider, useTokenChainContext, type TokenChainContextValue, type TokenChainProviderProps, } from "./token-chain-context.js";

package/dist/chain/token-chain-context.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentChildren } from 'preact';
-import type { PanelConfig } from '../config/panel-config';
-import type { TweakState } from '../state/tweak-state';
-import { type TokenGraph } from '../utils/token-graph';
+import type { PanelConfig } from "../config/panel-config.js";
+import type { TweakState } from "../state/tweak-state.js";
+import { type TokenGraph } from "../utils/token-graph.js";
 export interface TokenChainContextValue {
     graph: TokenGraph;
 }

package/dist/chain/token-chain-popover.d.ts

@@ -1,6 +1,6 @@
 import type { JSX } from 'preact';
-import { type TokenAddress } from '../utils/token-index';
-import type { RowContribution } from '../tabs/flat/types';
+import { type TokenAddress } from "../utils/token-index.js";
+import type { RowContribution } from "../tabs/flat/types.js";
 export interface TokenChainPopoverProps {
     address: TokenAddress;
     anchorRef: React.RefObject<HTMLElement | null>;

package/dist/changed/contribution.d.ts

@@ -5,11 +5,11 @@
  * row's visual state, Changed-only filtering, ghost value, and revert affordance
  * all consult the same `isChanged` result for the row's stable token address.
  */
-import type { PanelConfig } from '../config/panel-config';
-import type { TweakState } from '../state/tweak-state';
-import { revertEntry, type ColorBaseline } from '../utils/token-diff';
-import type { TokenIndex, TokenAddress } from '../utils/token-index';
-import type { RowContribution } from '../tabs/flat/types';
+import type { PanelConfig } from "../config/panel-config.js";
+import type { TweakState } from "../state/tweak-state.js";
+import { revertEntry, type ColorBaseline } from "../utils/token-diff.js";
+import type { TokenIndex, TokenAddress } from "../utils/token-index.js";
+import type { RowContribution } from "../tabs/flat/types.js";
 export interface ChangedContributionOptions {
     index: TokenIndex;
     state: TweakState;

package/dist/changed/footer-content.d.ts

@@ -1,8 +1,8 @@
 import type { JSX } from 'preact';
-import type { PanelConfig } from '../config/panel-config';
-import type { ColorBaseline } from '../utils/token-diff';
-import type { TweakState } from '../state/tweak-state';
-import type { TokenIndex } from '../utils/token-index';
+import type { PanelConfig } from "../config/panel-config.js";
+import type { ColorBaseline } from "../utils/token-diff.js";
+import type { TweakState } from "../state/tweak-state.js";
+import type { TokenIndex } from "../utils/token-index.js";
 export declare const COPY_REVERT_MS = 2000;
 export interface ChangedFooterContentProps {
     index: TokenIndex;

package/dist/changed/index.d.ts

@@ -1,4 +1,4 @@
-export { changedContribution, changedStateContribution, createChangedContribution, revertEntry, } from './contribution';
-export { ChangedFooter, ChangedFooterContent, COPY_REVERT_MS } from './footer-content';
-export { ChangedOnlyToggle } from './tab-filter';
-export { ChangedTabBadge, TabChangedBadge } from './tab-badge';
+export { changedContribution, changedStateContribution, createChangedContribution, revertEntry, } from "./contribution.js";
+export { ChangedFooter, ChangedFooterContent, COPY_REVERT_MS } from "./footer-content.js";
+export { ChangedOnlyToggle } from "./tab-filter.js";
+export { ChangedTabBadge, TabChangedBadge } from "./tab-badge.js";

package/dist/components/color-picker/color-field.d.ts

@@ -7,7 +7,7 @@
  * DOM-hygiene compliant: div-button with onClick + onKeyDown (Enter/Space);
  * no banned semantic tags — hostile-host policy (CLAUDE.md).
  */
-import type { ColorPickerValueFormat } from './color-picker';
+import type { ColorPickerValueFormat } from "./color-picker.js";
 export interface ColorFieldProps {
     /** Current color value. Hex string in hex mode; `oklch(...)` string in oklch mode. */
     value: string;

package/dist/components/color-picker/index.d.ts

@@ -1,2 +1,2 @@
-export { ColorPicker, type ColorPickerMode, type ColorPickerProps, LOCAL_STORAGE_KEY, getFixedPopoverStyle, usePopoverClose, } from './color-picker';
-export { default } from './color-picker';
+export { ColorPicker, type ColorPickerMode, type ColorPickerProps, LOCAL_STORAGE_KEY, getFixedPopoverStyle, usePopoverClose, } from "./color-picker.js";
+export { default } from "./color-picker.js";

package/dist/components/palette-chart/index.d.ts

@@ -1,2 +1,2 @@
-export { PaletteChart, type PaletteChartProps, type Oklcha, type Channel, } from './palette-chart';
-export { default } from './palette-chart';
+export { PaletteChart, type PaletteChartProps, type Oklcha, type Channel, } from "./palette-chart.js";
+export { default } from "./palette-chart.js";

package/dist/components/palette-chart/palette-chart.d.ts

@@ -1,6 +1,6 @@
 import type { JSX } from 'preact';
-import { type Channel } from '../../utils/palette-curve';
-import { type Oklcha } from '../../utils/color-oklch';
+import { type Channel } from "../../utils/palette-curve.js";
+import { type Oklcha } from "../../utils/color-oklch.js";
 /**
  * PaletteChart — controlled, presentational OKLCH L/C/H curve editor.
  *
@@ -32,8 +32,8 @@ import { type Oklcha } from '../../utils/color-oklch';
  *   within the same SVG, so a pointer-down on a node hits the circle (DOM order
  *   within an SVG determines paint/hit precedence).
  */
-export type { Oklcha } from '../../utils/color-oklch';
-export type { Channel } from '../../utils/palette-curve';
+export type { Oklcha } from "../../utils/color-oklch.js";
+export type { Channel } from "../../utils/palette-curve.js";
 export interface PaletteChartProps {
     /**
      * Dense palette slots in OKLCH space. A null slot preserves its index/band,

package/dist/config/cluster-config.d.ts

@@ -20,9 +20,9 @@
  * everything the color tab needs to render is reachable from
  * `panelConfig.colorCluster`.
  */
-import type { ColorScheme } from './color-schemes';
-import type { SemanticValue } from '../tokens/tier-model';
-export type { SemanticValue } from '../tokens/tier-model';
+import type { ColorScheme } from "./color-schemes.js";
+import type { SemanticValue } from "../tokens/tier-model.js";
+export type { SemanticValue } from "../tokens/tier-model.js";
 /**
  * Base-role keys that a cluster may declare. Subset is allowed (a cluster may
  * ship zero base roles when its design system doesn't expose them as tokens).
@@ -110,7 +110,7 @@ export interface ColorClusterDataConfig {
 export declare function resolvePaletteCssVar(cluster: {
     paletteCssVarTemplate: string;
 }, index: number): string;
-import type { TabConfig } from '../tokens/tier-model';
+import type { TabConfig } from "../tokens/tier-model.js";
 /**
  * Derive a `ColorClusterDataConfig` from a color `TabConfig`.
  *

package/dist/config/color-scheme-utils.d.ts

@@ -14,7 +14,7 @@
  *   mappings in the bundled tokens, so the panel's defaults on first open
  *   match the example CSS exactly.
  */
-import { type ColorScheme, type ColorRef } from './color-schemes';
+import { type ColorScheme, type ColorRef } from "./color-schemes.js";
 /**
  * Minimal local replacement for the upstream `settings` object. The panel only
  * ever reads `colorScheme` and `colorMode`; the rest of the upstream settings

package/dist/config/panel-config.d.ts

@@ -45,9 +45,9 @@
  * arbitrary host-irrelevant data. Hosts MUST call `configurePanel(...)` to
  * see useful behaviour.
  */
-import type { ColorScheme } from './color-schemes';
-import type { TabConfig } from '../tokens/tier-model';
-export { DEFAULT_STORAGE_PREFIX, DEFAULT_TOGGLE_EVENT } from '../constants';
+import type { ColorScheme } from "./color-schemes.js";
+import type { TabConfig } from "../tokens/tier-model.js";
+export { DEFAULT_STORAGE_PREFIX, DEFAULT_TOGGLE_EVENT } from "../constants.js";
 /**
  * Apply-routing map.
  *
@@ -430,8 +430,8 @@ export declare function clearColorSchemeOwnership(prefix: string): void;
  * never removes a `color-scheme` it did not write.
  */
 export declare function ownsColorScheme(prefix: string): boolean;
-export { resolvePrimaryColorCluster, resolveSecondaryColorClusterFromTabs, } from './cluster-config';
-import type { ColorClusterDataConfig } from './cluster-config';
+export { resolvePrimaryColorCluster, resolveSecondaryColorClusterFromTabs, } from "./cluster-config.js";
+import type { ColorClusterDataConfig } from "./cluster-config.js";
 /**
  * Resolve the active primary color cluster from the panel config's tabs array.
  *

package/dist/controls/tier-ref-selector.d.ts

@@ -1,4 +1,4 @@
-import type { TabConfig } from '../tokens/tier-model';
+import type { TabConfig } from "../tokens/tier-model.js";
 /**
  * Names one item in a (possibly cross-tab) tier. `tab` omitted means "the tab
  * `TierRefSelector` itself renders in" — the intra-tab case used by the

package/dist/dashboard/index.d.ts

@@ -0,0 +1,4 @@
+export { TokenDashboard } from "./token-dashboard.js";
+export type { TokenDashboardProps, DashboardPreviewKind } from "./token-dashboard.js";
+export type { DashboardMode } from "./types.js";
+export type { TabConfig, TierConfig, TierItem } from "../tokens/tier-model.js";