@takazudo/zdtp 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,31 @@ 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.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**

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/dom-tweaker/dom-tweaker-diff-action-link.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'preact';
-import type { PanelConfig } from '../config/panel-config';
+import type { PanelConfig } from "../config/panel-config.js";
 export interface DomTweakerDiffActionLinkProps {
     instanceConfig: PanelConfig;
     onSelected?: () => void;

package/dist/dom-tweaker/dom-tweaker-orchestrator.d.ts

@@ -10,7 +10,7 @@
  *      explicit scalar config values into that boundary.
  */
 import type { ComponentChildren, JSX } from 'preact';
-import type { PanelConfig } from '../config/panel-config';
+import type { PanelConfig } from "../config/panel-config.js";
 export declare function DomTweakerOrchestrator({ children, instanceConfig, }: {
     children: ComponentChildren;
     instanceConfig: PanelConfig;

package/dist/dom-tweaker/dom-tweaker-state.d.ts

@@ -6,7 +6,7 @@
  * time (never at module init), so a late `configurePanel({ storagePrefix })`
  * is respected by no-arg callers.
  */
-import { type PanelConfig } from '../config/panel-config';
+import { type PanelConfig } from "../config/panel-config.js";
 export declare function storageKey_domTweakerEnabled(cfg?: PanelConfig): string;
 /**
  * Load the persisted enabled flag from localStorage. Defaults to `false` on

package/dist/dom-tweaker/lazy/class-editor-popup.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'preact';
-import { type TrackedElementRect } from './pinned-selection-overlay';
+import { type TrackedElementRect } from "./pinned-selection-overlay.js";
 export interface ClassEditorPopupProps {
     target: Element | null;
     selectorSummary: string;

package/dist/dom-tweaker/lazy/diff-export-modal.d.ts

@@ -1,5 +1,5 @@
 import type { JSX } from 'preact';
-import { type PanelConfig } from '../../config/panel-config';
+import { type PanelConfig } from "../../config/panel-config.js";
 export interface DiffExportModalProps {
     diffText: string;
     onClose: () => void;

package/dist/dom-tweaker/lazy/index.d.ts

@@ -8,8 +8,8 @@
  * lazy boundary does not read global panel config.
  */
 import type { JSX } from 'preact';
-import type { DomTweakerRuntimeStatus } from '../dom-tweaker-context';
-export { buildStaticSuggestions, buildSuggestions, buildThemeSuggestions, filterSuggestions, STATIC_SUGGESTIONS, } from './suggestions';
+import type { DomTweakerRuntimeStatus } from "../dom-tweaker-context.js";
+export { buildStaticSuggestions, buildSuggestions, buildThemeSuggestions, filterSuggestions, STATIC_SUGGESTIONS, } from "./suggestions.js";
 export interface DomTweakerLazyBoundaryProps {
     enabled: boolean;
     storagePrefix: string;

package/dist/element-inspect/element-inspect-context.d.ts

@@ -1,4 +1,4 @@
-import type { FindTokensForElementResult } from './find-tokens-for-element';
+import type { FindTokensForElementResult } from "./find-tokens-for-element.js";
 /** The synthetic tab id used by the transient element-inspect view. */
 export declare const ELEMENT_INSPECT_TAB_ID = "inspect";
 export interface ElementInspectContextValue {

package/dist/element-inspect/element-inspect-orchestrator.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 { CommitTweakStateOptions, TweakStateUpdater } from '../state/transaction';
+import type { PanelConfig } from "../config/panel-config.js";
+import type { TweakState } from "../state/tweak-state.js";
+import type { CommitTweakStateOptions, TweakStateUpdater } from "../state/transaction.js";
 type CommitTweakState = (reason: string, next: TweakStateUpdater, options?: CommitTweakStateOptions) => void;
 export interface ElementInspectOrchestratorProps {
     children: ComponentChildren;

package/dist/element-inspect/element-inspect-overlay.d.ts

@@ -1,6 +1,6 @@
 import type { JSX } from 'preact';
 /** Body-level mount used by the picker and the pinned inspect marker. */
-export { ELEMENT_INSPECT_PORTAL_MOUNT_ID } from '../highlight/find-elements';
+export { ELEMENT_INSPECT_PORTAL_MOUNT_ID } from "../highlight/find-elements.js";
 /** Class hooks shared by the hover picker and the pinned overlay. */
 export declare const ELEMENT_INSPECT_PICKER_CLASS_NAMES: {
     readonly box: "tokenpanel-element-inspect-box";

package/dist/element-inspect/find-tokens-for-element.d.ts

@@ -1,4 +1,4 @@
-import type { TokenAddress, TokenIndex, TokenIndexEntry } from '../utils/token-index';
+import type { TokenAddress, TokenIndex, TokenIndexEntry } from "../utils/token-index.js";
 export interface ElementTokenMatch {
     property: string;
     cssVar: string;

package/dist/element-inspect/index.d.ts

@@ -1,8 +1,8 @@
-export { findTokensForElement } from './find-tokens-for-element';
-export type { ElementTokenMatch, ElementTokenPropertyGroup, FindTokensForElementResult, } from './find-tokens-for-element';
-export { ElementInspectOrchestrator, type ElementInspectOrchestratorProps, } from './element-inspect-orchestrator';
-export { ElementInspectOverlay, ELEMENT_INSPECT_PORTAL_MOUNT_ID } from './element-inspect-overlay';
-export { ElementInspectToggleButton } from './element-inspect-toggle-button';
-export { ElementInspectView, type ElementInspectViewProps } from './element-inspect-view';
-export { ElementInspectContext, ELEMENT_INSPECT_TAB_ID, } from './element-inspect-context';
-export type { ElementInspectContextValue } from './element-inspect-context';
+export { findTokensForElement } from "./find-tokens-for-element.js";
+export type { ElementTokenMatch, ElementTokenPropertyGroup, FindTokensForElementResult, } from "./find-tokens-for-element.js";
+export { ElementInspectOrchestrator, type ElementInspectOrchestratorProps, } from "./element-inspect-orchestrator.js";
+export { ElementInspectOverlay, ELEMENT_INSPECT_PORTAL_MOUNT_ID } from "./element-inspect-overlay.js";
+export { ElementInspectToggleButton } from "./element-inspect-toggle-button.js";
+export { ElementInspectView, type ElementInspectViewProps } from "./element-inspect-view.js";
+export { ElementInspectContext, ELEMENT_INSPECT_TAB_ID, } from "./element-inspect-context.js";
+export type { ElementInspectContextValue } from "./element-inspect-context.js";

package/dist/element-path/element-path-state.d.ts

@@ -10,7 +10,7 @@
  * `panelConfig.storagePrefix` at call-time (never at module init) so a host's
  * `configurePanel({ storagePrefix })` is respected.
  */
-import type { PanelConfig } from '../config/panel-config';
+import type { PanelConfig } from "../config/panel-config.js";
 /**
  * Load the persisted enabled flag from localStorage. Defaults to `false`
  * (inspect mode off) on any parse/access failure or when absent.

package/dist/element-path/index.d.ts

@@ -5,10 +5,10 @@
  * DevTools-style highlight, click to copy an annotated path block to the
  * clipboard) for precise human↔AI communication about the page.
  */
-export { ElementPathOrchestrator } from './element-path-orchestrator';
-export { ElementPathToggleButton } from './element-path-toggle-button';
-export { ElementPathContext } from './element-path-context';
-export type { ElementPathContextValue } from './element-path-context';
-export { buildElementPath, buildElementPathString, formatElementPath, buildUniqueSelector, buildBreadcrumb, } from './build-element-path';
-export type { ElementPathResult } from './build-element-path';
-export { loadElementPathEnabled, saveElementPathEnabled } from './element-path-state';
+export { ElementPathOrchestrator } from "./element-path-orchestrator.js";
+export { ElementPathToggleButton } from "./element-path-toggle-button.js";
+export { ElementPathContext } from "./element-path-context.js";
+export type { ElementPathContextValue } from "./element-path-context.js";
+export { buildElementPath, buildElementPathString, formatElementPath, buildUniqueSelector, buildBreadcrumb, } from "./build-element-path.js";
+export type { ElementPathResult } from "./build-element-path.js";
+export { loadElementPathEnabled, saveElementPathEnabled } from "./element-path-state.js";

package/dist/export-modal.d.ts

@@ -22,8 +22,8 @@
  * programmatic "Close" button) routes through `dialog.close()` so the native
  * `close` event — and thus `onClose` — fires exactly once per dismissal.
  */
-import { type ColorTweakState, type TweakState } from './state/tweak-state';
-import { type PanelConfig } from './config/panel-config';
+import { type ColorTweakState, type TweakState } from "./state/tweak-state.js";
+import { type PanelConfig } from "./config/panel-config.js";
 export interface ExportModalProps {
     onClose: () => void;
     /** Full unified tweak state — the modal serializes all four categories. */

package/dist/highlight/highlight-orchestrator.d.ts

@@ -14,8 +14,8 @@
  * overlay persists even when the panel is closed.
  */
 import type { ComponentChildren } from 'preact';
-import { type PanelConfig } from '../config/panel-config';
-import type { TierValueKind } from '../tokens/tier-model';
+import { type PanelConfig } from "../config/panel-config.js";
+import type { TierValueKind } from "../tokens/tier-model.js";
 type ProbeKind = 'color' | 'length' | 'number' | 'text' | 'easing' | 'cursor' | 'content' | 'mask-image';
 export declare function tierKindToProbeKind(t: TierValueKind | undefined): ProbeKind | undefined;
 export interface HighlightOrchestratorProps {

package/dist/highlight/highlight-state.d.ts

@@ -14,7 +14,7 @@
  *   outlineWidth → localStorage  (survives full page reload — user width setting kept)
  *   active       → sessionStorage (cleared on reload — inspection set is ephemeral)
  */
-import { type PanelConfig } from '../config/panel-config';
+import { type PanelConfig } from "../config/panel-config.js";
 export interface HighlightSlotSpec {
     color: string;
 }

package/dist/highlight/highlight-toggle-button.d.ts

@@ -11,8 +11,8 @@
  * module.
  */
 import type { JSX } from 'preact';
-import type { HighlightState, HighlightSlotSpec } from './highlight-state';
-import type { TokenAddress } from '../utils/token-index';
+import type { HighlightState, HighlightSlotSpec } from "./highlight-state.js";
+import type { TokenAddress } from "../utils/token-index.js";
 export interface HighlightContextValue {
     state: HighlightState;
     toggle: (cssVar: string) => void;

package/dist/history/buttons.d.ts

@@ -1,4 +1,4 @@
-import type { TweakHistorySnapshot } from '../state/history';
+import type { TweakHistorySnapshot } from "../state/history.js";
 export interface HistoryButtonProps {
     canUndo: boolean;
     onUndo: () => void;

package/dist/history/index.d.ts

@@ -1,3 +1,3 @@
-export { HistoryButtons, HistoryRedoButton, HistoryShortcuts, HistoryUndoButton, type HistoryButtonProps, type HistoryButtonsProps, type HistoryShortcutsProps, } from './buttons';
-export { HistoryRail, type HistoryRailProps } from './rail';
-export { clearSnapshots, getSnapshotKey, isSnapshotState, loadSnapshot, loadSnapshots, removeSnapshot, restoreSnapshotState, saveSnapshot, storageKey_snapshotA, storageKey_snapshotB, useSnapshots, type SnapshotRestoreResult, type SnapshotSlot, type SnapshotSlots, type TweakSnapshot, } from './snapshots';
+export { HistoryButtons, HistoryRedoButton, HistoryShortcuts, HistoryUndoButton, type HistoryButtonProps, type HistoryButtonsProps, type HistoryShortcutsProps, } from "./buttons.js";
+export { HistoryRail, type HistoryRailProps } from "./rail.js";
+export { clearSnapshots, getSnapshotKey, isSnapshotState, loadSnapshot, loadSnapshots, removeSnapshot, restoreSnapshotState, saveSnapshot, storageKey_snapshotA, storageKey_snapshotB, useSnapshots, type SnapshotRestoreResult, type SnapshotSlot, type SnapshotSlots, type TweakSnapshot, } from "./snapshots.js";

package/dist/history/rail.d.ts

@@ -1,5 +1,5 @@
-import type { TweakHistorySnapshot } from '../state/history';
-import type { SnapshotSlot, SnapshotSlots } from './snapshots';
+import type { TweakHistorySnapshot } from "../state/history.js";
+import type { SnapshotSlot, SnapshotSlots } from "./snapshots.js";
 export interface HistoryRailProps {
     history: TweakHistorySnapshot;
     snapshots: SnapshotSlots;

package/dist/history/snapshots.d.ts

@@ -1,5 +1,5 @@
-import { storageKey_snapshotA, storageKey_snapshotB, type PanelConfig } from '../config/panel-config';
-import type { TweakState } from '../state/tweak-state';
+import { storageKey_snapshotA, storageKey_snapshotB, type PanelConfig } from "../config/panel-config.js";
+import type { TweakState } from "../state/tweak-state.js";
 export type SnapshotSlot = 'A' | 'B';
 export interface TweakSnapshot {
     state: TweakState;

package/dist/import-modal.d.ts

@@ -20,8 +20,8 @@
  * programmatic "Close" button) routes through `dialog.close()` so the native
  * `close` event — and thus `onClose` — fires exactly once per dismissal.
  */
-import type { ColorTweakState, TweakState } from './state/tweak-state';
-import { type PanelConfig } from './config/panel-config';
+import type { ColorTweakState, TweakState } from "./state/tweak-state.js";
+import { type PanelConfig } from "./config/panel-config.js";
 export interface ImportModalProps {
     onClose: () => void;
     /** Called with the parsed state when the user hits "Load". The caller is