@unpunnyfuns/swatchbook-blocks 0.64.0 → 0.66.0

package/dist/index.d.mts

@@ -80,6 +80,13 @@ interface ProjectSnapshot {
   activeTheme: string;
   activeAxes: Readonly<Record<string, string>>;
   cssVarPrefix: string;
+  /**
+   * Project-wide baseline for the row-indicator strip from
+   * `config.indicators`. Sits between the hard-coded indicator defaults
+   * and a block's `indicators` prop. Optional — hand-built snapshots
+   * (tests, MDX) omit it and blocks fall back to the bare defaults.
+   */
+  indicators?: Readonly<Record<string, boolean>>;
   diagnostics: readonly VirtualDiagnosticShape[];
   css: string;
   /**
@@ -99,11 +106,14 @@ interface ProjectSnapshot {
   /** The default tuple — `{ axis: axis.default }` for every axis. */
   defaultTuple: Record<string, string>;
   /**
-   * Pre-built `resolveAt(tuple)` accessor. The addon's preview
-   * decorator instantiates this once per iframe lifetime, backed by
-   * `resolveAllAt` over the stable `tokenGraph` export. Hand-built
-   * snapshots (tests, MDX) can omit this; blocks fall back to
-   * building a graph-backed resolver from `tokenGraph`.
+   * Pre-built `resolveAt(tuple)` accessor. The addon's preview decorator
+   * instantiates this once per iframe lifetime. When present, use-project
+   * prefers it over building its own from `tokenGraph`, so it MUST preserve
+   * alias provenance — back it with `resolveAllWithProvenanceAt`, not the raw
+   * leaf `resolveAllAt`, or axis-varying aliases silently lose their chain /
+   * reverse refs / description at non-default tuples. Hand-built snapshots
+   * (tests, MDX) can omit this; blocks then fall back to a provenance-aware
+   * graph-backed resolver built from `tokenGraph`.
    */
   resolveAt?: (tuple: Record<string, string>) => Record<string, VirtualTokenShape>;
 }
@@ -226,6 +236,18 @@ declare function ColorPalette({
   sortDir
 }: ColorPaletteProps): ReactElement;
 //#endregion
+//#region src/indicators/resolve.d.ts
+/** The individually-toggleable indicators in the row strip. `alias` covers the whole alias unit (forward chain + reverse count). */
+type IndicatorName = 'alias' | 'variance' | 'gamut' | 'deprecation' | 'description' | 'composes';
+/**
+ * Consumer-facing indicator config for the strip-hosting blocks:
+ * - `true` — every indicator on (including the opt-in `description`)
+ * - `false` — every indicator off
+ * - object — per-key override layered over the defaults
+ * - omitted — the defaults
+ */
+type IndicatorsProp = boolean | Partial<Record<IndicatorName, boolean>>;
+//#endregion
 //#region src/ColorTable.d.ts
 interface ColorTableProps {
   /**
@@ -279,6 +301,8 @@ interface ColorTableProps {
   variants?: Record<string, string>;
   /** Disambiguates persisted UI state for two identical-prop tables on a page. */
   id?: string;
+  /** Configure the per-row indicator strip. See `IndicatorsProp`. Gamut stays in the Value cell, so it is not part of this strip. */
+  indicators?: IndicatorsProp;
 }
 declare function ColorTable({
   filter,
@@ -288,7 +312,8 @@ declare function ColorTable({
   searchable,
   onSelect,
   variants,
-  id
+  id,
+  indicators
 }: ColorTableProps): ReactElement;
 //#endregion
 //#region src/Diagnostics.d.ts
@@ -603,6 +628,8 @@ interface TokenSnapshot {
   readonly diagnostics: readonly VirtualDiagnosticShape[];
   readonly css: string;
   readonly cssVarPrefix: string;
+  /** Project-wide baseline for the row-indicator strip from `config.indicators`. */
+  readonly indicators: Readonly<Record<string, boolean>>;
   readonly listing: Readonly<Record<string, VirtualTokenListingShape>>;
   readonly tokenGraph: VirtualTokenGraph;
   readonly defaultTuple: Record<string, string>;
@@ -805,6 +832,8 @@ interface TokenNavigatorProps {
    * props otherwise.
    */
   id?: string;
+  /** Configure the per-row indicator strip. See `IndicatorsProp`. */
+  indicators?: IndicatorsProp;
 }
 declare function TokenNavigator({
   root,
@@ -812,7 +841,8 @@ declare function TokenNavigator({
   initiallyExpanded,
   searchable,
   onSelect,
-  id
+  id,
+  indicators
 }: TokenNavigatorProps): ReactElement;
 //#endregion
 //#region src/TokenTable.d.ts
@@ -855,6 +885,8 @@ interface TokenTableProps {
   onSelect?(path: string): void;
   /** Disambiguates persisted UI state for two identical-prop tables on a page. */
   id?: string;
+  /** Configure the per-row indicator strip. See `IndicatorsProp`. */
+  indicators?: IndicatorsProp;
 }
 declare function TokenTable({
   filter,
@@ -864,7 +896,8 @@ declare function TokenTable({
   sortDir,
   searchable,
   onSelect,
-  id
+  id,
+  indicators
 }: TokenTableProps): ReactElement;
 //#endregion
 //#region src/TypographyScale.d.ts