@takazudo/zdtp 0.2.3 → 0.3.1

package/dist/utils/design-token-serde.d.ts

@@ -40,6 +40,13 @@
  * }
  * ```
  *
+ * Host-coined GENERIC tabs (any configured tab whose id is not one of the
+ * dedicated slices `color` / `color-secondary` / `spacing` / `font` / `size`)
+ * round-trip the same way as spacing/size: their overrides live in
+ * `state.tabs[id]` (the v3 envelope) and serialize under `tabs[id].raw`,
+ * cssVar-keyed (issue #363). The apply path (`applyFullState`) already consumes
+ * `state.tabs`; serialize + deserialize make Export/Load symmetric with it.
+ *
  * Key decisions (issue #74):
  * - cssVar-keyed leaves for portability across host id renames.
  * - Tier-2 ref values are stored as the literal `var(--tier1-cssvar)` CSS
@@ -65,18 +72,25 @@
  * Read-only manifest tokens are skipped in both directions.
  */
 import type { ColorTweakState, TweakState } from '../state/tweak-state';
+import { type PanelConfig } from '../config/panel-config';
 /** The canonical v2 schema identifier emitted by serialize(). */
 export declare const SCHEMA_V2 = "zudo-design-tokens/v2";
 /** The legacy v1 schema identifier accepted by deserialize() for back-compat. */
 export declare const SCHEMA_V1 = "zudo-design-tokens/v1";
 /**
- * Read the active design-token schema id at call time.
+ * Read the design-token schema id at call time.
+ *
+ * Returns the host-configured schema id from `cfg.schemaId`. Used as the
+ * `$schema` value in legacy v1 exports (for hosts that have not upgraded their
+ * config to v2) and as the expected-schema label the Import modal surfaces. The
+ * canonical v2 serialize path always emits `SCHEMA_V2`.
  *
- * Returns the host-configured schema id from `panelConfig.schemaId`. Used as
- * the `$schema` value in legacy v1 exports (for hosts that have not upgraded
- * their config to v2). The canonical v2 serialize path always emits `SCHEMA_V2`.
+ * `cfg` defaults to the active (most-recently-configured) instance so the
+ * single-default path stays byte-identical. The Import modal threads its OWN
+ * mounted instance config (multi-instance, #361) so a non-default panel
+ * validates against ITS schema id, not the default's.
  */
-export declare function getDesignTokenSchema(): string;
+export declare function getDesignTokenSchema(cfg?: PanelConfig): string;
 /** External JSON value for a base-color / semantic-color entry (v1). */
 type ColorSlotValue = number | 'bg' | 'fg';
 export interface DesignTokenJsonColorBase {
@@ -114,7 +128,14 @@ export interface DesignTokenJson {
  * For color semantic: values are palette-index integers.
  */
 export type V2TierMap = Record<string, string | number>;
-/** Per-tab overrides in v2 format. Key is tier id. */
+/**
+ * Per-tab overrides in v2 format. Keyed nominally by tier id — but only the
+ * `color` tab uses real tier ids (`palette` / `semantic`). Every other tab
+ * (spacing / font / size AND host-coined generic tabs) uses the single synthetic
+ * external key `raw` regardless of its internal tier ids; the cssVar leaves under
+ * `raw` carry the identity, so the external JSON never depends on a tab's
+ * internal tier structure.
+ */
 export type V2TabEntry = Record<string, V2TierMap>;
 /** v2 external JSON document shape. */
 export interface DesignTokenJsonV2 {
@@ -169,8 +190,14 @@ export declare class DesignTokenSchemaError extends Error {
  * defaults; set `opts.includeDefaults = true` to dump everything.
  *
  * The output `$schema` is always `SCHEMA_V2` ("zudo-design-tokens/v2").
+ *
+ * `cfg` defaults to the active (most-recently-configured) instance so the
+ * single-default path stays byte-identical. The Export / Apply modals thread
+ * their OWN mounted instance config (multi-instance, #361) so a non-default
+ * panel's export JSON / revert blob is built from ITS tab manifest + color
+ * cluster, not the default instance's.
  */
-export declare function serialize(state: TweakState, opts?: SerializeOptions): DesignTokenJsonV2;
+export declare function serialize(state: TweakState, opts?: SerializeOptions, cfg?: PanelConfig): DesignTokenJsonV2;
 /**
  * Parse a design-token JSON document and lift it back into a tweak state.
  *
@@ -187,7 +214,13 @@ export declare function serialize(state: TweakState, opts?: SerializeOptions): D
  *
  * Missing fields fall back to `opts.colorDefaults` (or, absent that, a
  * minimal neutral default) so the result is always a valid `TweakState`.
+ *
+ * `cfg` defaults to the active (most-recently-configured) instance so the
+ * single-default path stays byte-identical. The Import modal threads its OWN
+ * mounted instance config (multi-instance, #361) so a non-default panel's
+ * schema-check + cssVar→id mapping use ITS tab manifest + color cluster, not
+ * the default instance's.
  */
-export declare function deserialize(input: unknown, opts?: DeserializeOptions): DeserializeResult;
+export declare function deserialize(input: unknown, opts?: DeserializeOptions, cfg?: PanelConfig): DeserializeResult;
 export {};
 //# sourceMappingURL=design-token-serde.d.ts.map

package/dist/utils/design-token-serde.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design-token-serde.d.ts","sourceRoot":"","sources":["../../src/utils/design-token-serde.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"design-token-serde.d.ts","sourceRoot":"","sources":["../../src/utils/design-token-serde.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zdtp",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Dynamic design-token tweak panel — host-config-driven, framework-agnostic Preact UI.",
   "private": false,
   "license": "MIT",