@unpunnyfuns/swatchbook-blocks 0.15.0 → 0.17.0

package/dist/index.d.mts

@@ -226,6 +226,68 @@ declare function ColorPalette({
   sortDir
 }: ColorPaletteProps): ReactElement;
 //#endregion
+//#region src/ColorTable.d.ts
+interface ColorTableProps {
+  /**
+   * Token-path filter. Defaults to every `$type: color` token. `"color.*"`
+   * scopes to the semantic layer; `"color.palette.blue.*"` to a single ramp.
+   */
+  filter?: string;
+  /** Override the table caption. */
+  caption?: string;
+  /**
+   * Sort order.
+   * - `'path'` (default) — lexicographic on the dot-path.
+   * - `'value'` — perceptual (oklch L → C → H). Ramps read light→dark, then
+   *   warm→cool within each lightness band.
+   * - `'none'` — preserve project iteration order.
+   */
+  sortBy?: SortBy;
+  /** `'asc'` (default) or `'desc'`. */
+  sortDir?: SortDir;
+  /**
+   * Render a fuzzy-search input above the table. Defaults to `true`.
+   */
+  searchable?: boolean;
+  /**
+   * Called with the *currently-selected* variant's dot-path on row click.
+   * When set, the built-in expand-in-place behavior is suppressed — the
+   * consumer owns follow-up UI.
+   */
+  onSelect?(path: string): void;
+  /**
+   * Map from a display label to a suffix matched against each token's
+   * trailing path segment. Tokens whose leaves match a suffix are grouped
+   * under a shared "base" path (the path with the suffix stripped), and
+   * the group renders as a single row with a pill selector — clicking a
+   * pill swaps the displayed values to that variant. Sibling tokens
+   * without a suffix that share the group's base path are labeled `base`.
+   *
+   * Matches both DTCG-idiomatic and Backmarket-style conventions:
+   * - **Dot segment** (`color.bg.hi.disabled`): last dot-segment equals
+   *   the suffix (`disabled`). Base path = drop the last segment.
+   * - **Hyphen tail** (`color.bg.hi-d`): last dot-segment ends in
+   *   `-<suffix>` (`d`). Base path = trim the `-<suffix>` from the leaf.
+   *
+   * Longest-suffix-wins. Hyphen-tail form requires an actual hyphen
+   * boundary — suffix `0` does not match `neutral-900`.
+   *
+   * Single-member groups render as plain rows (no pill selector). Empty
+   * map (default) disables grouping entirely; each token renders as its
+   * own row, identical to the pre-grouping behavior.
+   */
+  variants?: Record<string, string>;
+}
+declare function ColorTable({
+  filter,
+  caption,
+  sortBy,
+  sortDir,
+  searchable,
+  onSelect,
+  variants
+}: ColorTableProps): ReactElement;
+//#endregion
 //#region src/Diagnostics.d.ts
 interface DiagnosticsProps {
   /** Override the section caption. Defaults to a severity summary. */
@@ -705,5 +767,5 @@ declare function TypographyScale({
   sortDir
 }: TypographyScaleProps): ReactElement;
 //#endregion
-export { AliasChain, type AliasChainProps, AliasedBy, type AliasedByProps, AxesContext, AxisVariance, type AxisVarianceProps, BorderPreview, type BorderPreviewProps, BorderSample, type BorderSampleProps, COLOR_FORMATS, type ColorFormat, ColorFormatContext, ColorPalette, type ColorPaletteProps, CompositeBreakdown, type CompositeBreakdownProps, CompositePreview, type CompositePreviewProps, ConsumerOutput, type ConsumerOutputProps, Diagnostics, type DiagnosticsProps, DimensionBar, type DimensionBarProps, type DimensionKind, DimensionScale, type DimensionScaleProps, FontFamilySample, type FontFamilySampleProps, FontWeightScale, type FontWeightScaleProps, type FormatColorResult, GradientPalette, type GradientPaletteProps, MotionPreview, type MotionPreviewProps, MotionSample, type MotionSampleProps, type MotionSpeed, type NormalizedColor, type ProjectSnapshot, ShadowPreview, type ShadowPreviewProps, ShadowSample, type ShadowSampleProps, StrokeStyleSample, type StrokeStyleSampleProps, SwatchbookContext, SwatchbookProvider, type SwatchbookProviderProps, ThemeContext, TokenDetail, type TokenDetailProps, TokenHeader, type TokenHeaderProps, TokenNavigator, type TokenNavigatorProps, TokenTable, type TokenTableProps, TokenUsageSnippet, type TokenUsageSnippetProps, TypographyScale, type TypographyScaleProps, type VirtualAxisShape as VirtualAxis, type VirtualAxisShape, type VirtualDiagnosticShape as VirtualDiagnostic, type VirtualDiagnosticShape, type VirtualPresetShape as VirtualPreset, type VirtualPresetShape, type VirtualThemeShape as VirtualTheme, type VirtualThemeShape, type VirtualTokenShape as VirtualToken, type VirtualTokenShape, formatColor, useActiveAxes, useActiveTheme, useColorFormat, useOptionalSwatchbookData, useSwatchbookData };
+export { AliasChain, type AliasChainProps, AliasedBy, type AliasedByProps, AxesContext, AxisVariance, type AxisVarianceProps, BorderPreview, type BorderPreviewProps, BorderSample, type BorderSampleProps, COLOR_FORMATS, type ColorFormat, ColorFormatContext, ColorPalette, type ColorPaletteProps, ColorTable, type ColorTableProps, CompositeBreakdown, type CompositeBreakdownProps, CompositePreview, type CompositePreviewProps, ConsumerOutput, type ConsumerOutputProps, Diagnostics, type DiagnosticsProps, DimensionBar, type DimensionBarProps, type DimensionKind, DimensionScale, type DimensionScaleProps, FontFamilySample, type FontFamilySampleProps, FontWeightScale, type FontWeightScaleProps, type FormatColorResult, GradientPalette, type GradientPaletteProps, MotionPreview, type MotionPreviewProps, MotionSample, type MotionSampleProps, type MotionSpeed, type NormalizedColor, type ProjectSnapshot, ShadowPreview, type ShadowPreviewProps, ShadowSample, type ShadowSampleProps, StrokeStyleSample, type StrokeStyleSampleProps, SwatchbookContext, SwatchbookProvider, type SwatchbookProviderProps, ThemeContext, TokenDetail, type TokenDetailProps, TokenHeader, type TokenHeaderProps, TokenNavigator, type TokenNavigatorProps, TokenTable, type TokenTableProps, TokenUsageSnippet, type TokenUsageSnippetProps, TypographyScale, type TypographyScaleProps, type VirtualAxisShape as VirtualAxis, type VirtualAxisShape, type VirtualDiagnosticShape as VirtualDiagnostic, type VirtualDiagnosticShape, type VirtualPresetShape as VirtualPreset, type VirtualPresetShape, type VirtualThemeShape as VirtualTheme, type VirtualThemeShape, type VirtualTokenShape as VirtualToken, type VirtualTokenShape, formatColor, useActiveAxes, useActiveTheme, useColorFormat, useOptionalSwatchbookData, useSwatchbookData };
 //# sourceMappingURL=index.d.mts.map