@takazudo/zdtp 0.7.0 → 0.8.1

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

@@ -235,6 +235,29 @@ export interface DeserializeOptions {
      *  exports are missing most fields by design). Typically the current
      *  scheme's initial state. */
     colorDefaults?: ColorTweakState;
+    /** Tab ids to load. Omitted selects every configured token tab; [] loads nothing.
+     * Supports color, spacing, font, size, and generic tabs. Notes and
+     * color-secondary have no external serde slice. */
+    tabs?: string[];
+    /** Map only explicit per-mode values; ordinary token values are unchanged. */
+    modeSides?: 'as-is' | 'swap' | 'light-only' | 'dark-only' | 'light-to-both';
+    /** Replace selected tabs by default, or retain their unmentioned current values. */
+    strategy?: 'merge' | 'replace';
+    /** Live instance state. Without it, merge and one-side imports fall back to defaults. */
+    current?: TweakState;
+}
+/** A state-free description of the token entries in an import document. */
+export interface ImportAnalysis {
+    schema: string;
+    tabs: {
+        id: string;
+        known: boolean;
+        entries: number;
+        perModeEntries: number;
+    }[];
+    sides: ('light' | 'dark')[];
+    /** Unknown token keys within known tabs; foreign tabs are identified by `known`. */
+    unknownTokens: string[];
 }
 /**
  * Thrown when the payload is not a v1 or v2 schema object. The error `.reason`
@@ -289,8 +312,9 @@ export declare function serialize(state: TweakState, opts?: SerializeOptions, cf
  * CSS var name that doesn't match a known manifest entry is collected into
  * `unknownTokens` (the caller can surface these as a warning).
  *
- * Missing fields fall back to `opts.colorDefaults` (or, absent that, a
- * minimal neutral default) so the result is always a valid `TweakState`.
+ * Missing fields in selected tabs fall back to defaults, or to `opts.current`
+ * under `strategy: 'merge'`. Unselected tabs always retain their current state.
+ * `modeSides` transforms only explicit per-mode leaves in the document.
  *
  * `cfg` defaults to the active (most-recently-configured) instance so the
  * single-default path stays byte-identical. The Import modal threads its OWN
@@ -299,4 +323,10 @@ export declare function serialize(state: TweakState, opts?: SerializeOptions, cf
  * the default instance's.
  */
 export declare function deserialize(input: unknown, opts?: DeserializeOptions, cfg?: PanelConfig): DeserializeResult;
+/**
+ * Inspect a document without constructing state, resolving CSS colors, or
+ * touching storage. Counts token leaves (including unknown/malformed values),
+ * not tier containers or the properties inside a semantic literal/ref leaf.
+ */
+export declare function analyzeDesignTokenJson(input: unknown, cfg?: PanelConfig): ImportAnalysis;
 export {};