@ccheever/exact-facet-core 0.1.0

package/facet-registry.json

@@ -0,0 +1,548 @@
+[
+  {
+    "name": "Button",
+    "aliases": [
+      "button"
+    ],
+    "category": "forms",
+    "description": "Intentful action control",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/button.contract"
+    },
+    "variants": [
+      {
+        "name": "variant",
+        "values": [
+          "primary",
+          "secondary",
+          "ghost"
+        ]
+      }
+    ],
+    "annotations": {
+      "targeting": "testId (developer-supplied) or accessibilityRole=\"button\"",
+      "verify": "After press, verify the callback fired or state changed.",
+      "wait": "none"
+    }
+  },
+  {
+    "name": "Input",
+    "aliases": [
+      "input"
+    ],
+    "category": "forms",
+    "description": "Text input with Facet chrome",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Textarea",
+    "aliases": [
+      "textarea"
+    ],
+    "category": "forms",
+    "description": "Multi-line text input with shared Facet chrome",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Input"
+    ]
+  },
+  {
+    "name": "FormField",
+    "aliases": [
+      "formfield",
+      "form-field"
+    ],
+    "category": "forms",
+    "description": "Label, description, and validation wrapper for form controls",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Input",
+      "Label"
+    ]
+  },
+  {
+    "name": "Card",
+    "aliases": [
+      "card"
+    ],
+    "category": "layout",
+    "description": "Surface container with theme shadow",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/card.contract"
+    }
+  },
+  {
+    "name": "Badge",
+    "aliases": [
+      "badge"
+    ],
+    "category": "feedback",
+    "description": "Compact status chip",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/badge.contract"
+    }
+  },
+  {
+    "name": "Label",
+    "aliases": [
+      "label"
+    ],
+    "category": "forms",
+    "description": "Form label with optional required indicator",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/label.contract"
+    }
+  },
+  {
+    "name": "Separator",
+    "aliases": [
+      "separator"
+    ],
+    "category": "layout",
+    "description": "Low-contrast divider line",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/separator.contract"
+    }
+  },
+  {
+    "name": "Avatar",
+    "aliases": [
+      "avatar"
+    ],
+    "category": "feedback",
+    "description": "Image-backed identity chip with fallback initials",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/avatar.contract"
+    }
+  },
+  {
+    "name": "Skeleton",
+    "aliases": [
+      "skeleton"
+    ],
+    "category": "feedback",
+    "description": "Loading placeholder block",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/skeleton.contract"
+    }
+  },
+  {
+    "name": "Progress",
+    "aliases": [
+      "progress"
+    ],
+    "category": "feedback",
+    "description": "Determinate progress indicator",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/progress.contract"
+    }
+  },
+  {
+    "name": "Spinner",
+    "aliases": [
+      "spinner"
+    ],
+    "category": "feedback",
+    "description": "Indeterminate activity indicator",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/spinner.contract"
+    }
+  },
+  {
+    "name": "Alert",
+    "aliases": [
+      "alert"
+    ],
+    "category": "feedback",
+    "description": "Inline alert surface with live-region semantics",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx",
+      "contract": "packages/exact-facet-contract/src/components/alert.contract"
+    }
+  },
+  {
+    "name": "Toggle",
+    "aliases": [
+      "toggle",
+      "switch"
+    ],
+    "category": "forms",
+    "description": "Boolean switch control",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Checkbox",
+    "aliases": [
+      "checkbox"
+    ],
+    "category": "forms",
+    "description": "Boolean checkbox control",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Slider",
+    "aliases": [
+      "slider"
+    ],
+    "category": "forms",
+    "description": "Continuous numeric input control",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "RadioGroup",
+    "aliases": [
+      "radiogroup",
+      "radio-group"
+    ],
+    "category": "forms",
+    "description": "Single-select radio group with roving focus",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Dialog",
+    "aliases": [
+      "dialog"
+    ],
+    "category": "overlay",
+    "description": "Modal surface with focus layer",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Button"
+    ],
+    "annotations": {
+      "targeting": "testId=\"facet-dialog-content\" or accessibilityRole=\"dialog\"",
+      "verify": "Focus is trapped, the dialog is modal, and outside press dismisses.",
+      "wait": "presencePhase=\"entered\""
+    }
+  },
+  {
+    "name": "AlertDialog",
+    "aliases": [
+      "alertdialog",
+      "alert-dialog"
+    ],
+    "category": "overlay",
+    "description": "High-priority dialog that resists outside dismissal",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Dialog",
+      "Button"
+    ]
+  },
+  {
+    "name": "Sheet",
+    "aliases": [
+      "sheet"
+    ],
+    "category": "overlay",
+    "description": "Edge-anchored panel surface",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Dialog"
+    ]
+  },
+  {
+    "name": "Accordion",
+    "aliases": [
+      "accordion"
+    ],
+    "category": "navigation",
+    "description": "Expandable disclosure surface with presence-backed content",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Collapsible",
+    "aliases": [
+      "collapsible"
+    ],
+    "category": "navigation",
+    "description": "Standalone disclosure primitive with presence-backed content",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Accordion"
+    ]
+  },
+  {
+    "name": "Tabs",
+    "aliases": [
+      "tabs"
+    ],
+    "category": "navigation",
+    "description": "Segmented tab switcher",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Toast",
+    "aliases": [
+      "toast"
+    ],
+    "category": "feedback",
+    "description": "Transient notification surface",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "Popover",
+    "aliases": [
+      "popover"
+    ],
+    "category": "overlay",
+    "description": "Anchored floating surface",
+    "tier": "floating",
+    "status": "preview",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "annotations": {
+      "targeting": "testId or accessibilityRole=\"dialog\"",
+      "verify": "Floating placement is positioned and dismissable.",
+      "wait": "floatingPositioned"
+    }
+  },
+  {
+    "name": "Tooltip",
+    "aliases": [
+      "tooltip"
+    ],
+    "category": "overlay",
+    "description": "Hover/focus hint surface",
+    "tier": "floating",
+    "status": "preview",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    }
+  },
+  {
+    "name": "DropdownMenu",
+    "aliases": [
+      "dropdownmenu",
+      "dropdown-menu"
+    ],
+    "category": "overlay",
+    "description": "Action menu anchored to a trigger",
+    "tier": "floating",
+    "status": "preview",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Popover"
+    ]
+  },
+  {
+    "name": "Select",
+    "aliases": [
+      "select"
+    ],
+    "category": "forms",
+    "description": "Single-select floating listbox",
+    "tier": "floating",
+    "status": "preview",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "DropdownMenu"
+    ],
+    "annotations": {
+      "targeting": "testId or accessibilityRole=\"combobox\"",
+      "verify": "Expanded state is true after opening and a new value is selected.",
+      "wait": "floatingPositioned"
+    }
+  },
+  {
+    "name": "Combobox",
+    "aliases": [
+      "combobox"
+    ],
+    "category": "forms",
+    "description": "Searchable single-select field with filtering",
+    "tier": "floating",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Select",
+      "Input",
+      "Popover"
+    ],
+    "annotations": {
+      "targeting": "testId or accessibilityRole=\"combobox\"",
+      "verify": "Typing filters the listbox and Enter or tap selects the highlighted option.",
+      "wait": "floatingPositioned"
+    }
+  },
+  {
+    "name": "Command",
+    "aliases": [
+      "command",
+      "command-palette"
+    ],
+    "category": "overlay",
+    "description": "Searchable command palette with grouped actions",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Dialog",
+      "Input"
+    ],
+    "annotations": {
+      "targeting": "testId=\"facet-command\" or accessibilityRole=\"dialog\"",
+      "verify": "Typing filters the action list and Enter triggers the active command.",
+      "wait": "presencePhase=\"entered\""
+    }
+  },
+  {
+    "name": "Table",
+    "aliases": [
+      "table"
+    ],
+    "category": "data",
+    "description": "Semantic data table with sortable headers",
+    "tier": "core",
+    "status": "stable",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "Card"
+    ]
+  },
+  {
+    "name": "ContextMenu",
+    "aliases": [
+      "contextmenu",
+      "context-menu"
+    ],
+    "category": "overlay",
+    "description": "Secondary-action menu",
+    "tier": "floating",
+    "status": "preview",
+    "sourceFilePath": "packages/exact-facet/src/index.tsx",
+    "sources": {
+      "react": "packages/exact-facet/src/index.tsx"
+    },
+    "dependencies": [
+      "DropdownMenu"
+    ]
+  }
+]

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@ccheever/exact-facet-core",
+  "version": "0.1.0",
+  "description": "Framework-neutral heart of the Facet design system: tokens, themes, recipes, motion, color math, catalog metadata, and the consolidated theme store (LLP 0157 F0)",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    },
+    "./store-machinery": {
+      "import": "./src/store-machinery.ts",
+      "types": "./src/store-machinery.ts"
+    },
+    "./facet-registry.json": "./facet-registry.json"
+  },
+  "dependencies": {
+    "@exact/core": "npm:@ccheever/exact-core@0.1.0"
+  }
+}

package/src/__tests__/facet-overrides.test.ts

@@ -0,0 +1,91 @@
+/// <reference path="../../../../js/src/types/bun-test.d.ts" />
+// Design Mode D1 (LLP 0158 §6.2): override-layer fixtures — resolver
+// precedence (variant → base → default), token rebinds through the live
+// theme, app-theme layering below scope/agent overrides, and sentinel
+// tracing staying exact under rebinding.
+
+import { afterEach, describe, expect, it } from 'bun:test';
+
+import {
+  _resetFacetOverridesForTests,
+  createTracingTheme,
+  darkTheme,
+  resolveRecipeParam,
+  resolveThemeForConfig,
+  setAppThemeOverrides,
+  setFacetParamOverrides,
+  traceStyleOrigins,
+  type FacetTheme,
+} from '../index.js';
+
+afterEach(() => {
+  _resetFacetOverridesForTests();
+});
+
+describe('facet overrides layer (LLP 0158 D1 fixtures)', () => {
+  it('resolves override(variant) → override(base) → recipe default', () => {
+    setFacetParamOverrides({
+      FacetButton: {
+        base: { paddingX: 10 },
+        variants: { primary: { paddingX: 24 } },
+      },
+    });
+    expect(resolveRecipeParam(darkTheme, 'FacetButton', 'primary', 'paddingX', darkTheme.space.md)).toBe(24);
+    expect(resolveRecipeParam(darkTheme, 'FacetButton', 'secondary', 'paddingX', darkTheme.space.md)).toBe(10);
+    expect(resolveRecipeParam(darkTheme, 'FacetButton', 'primary', 'paddingY', darkTheme.space.xs)).toBe(
+      darkTheme.space.xs,
+    );
+    expect(resolveRecipeParam(darkTheme, 'FacetCard', null, 'padding', darkTheme.space.lg)).toBe(
+      darkTheme.space.lg,
+    );
+  });
+
+  it('token rebinds resolve through the live theme', () => {
+    setFacetParamOverrides({
+      FacetButton: { base: { radius: { token: 'radius.page' } } },
+    });
+    expect(resolveRecipeParam(darkTheme, 'FacetButton', 'primary', 'radius', darkTheme.radius.element)).toBe(
+      darkTheme.radius.page,
+    );
+    // Unresolvable rebind falls back to the default, never undefined.
+    setFacetParamOverrides({
+      FacetButton: { base: { radius: { token: 'radius.doesNotExist' } } },
+    });
+    expect(resolveRecipeParam(darkTheme, 'FacetButton', 'primary', 'radius', darkTheme.radius.element)).toBe(
+      darkTheme.radius.element,
+    );
+  });
+
+  it('app theme overrides merge above base, below scope overrides', () => {
+    setAppThemeOverrides({ color: { accent: { fill: '#0000aa' } }, space: { md: 99 } });
+    const resolved = resolveThemeForConfig({ scheme: 'dark' });
+    expect(resolved.color.accent.fill).toBe('#0000aa');
+    expect(resolved.space.md).toBe(99);
+    // Scope overrides beat the app file (a provider's explicit choice wins).
+    const scoped = resolveThemeForConfig({ scheme: 'dark', overrides: { color: { accent: { fill: '#cc0000' } } } });
+    expect(scoped.color.accent.fill).toBe('#cc0000');
+    expect(scoped.space.md).toBe(99);
+  });
+
+  it('sentinel tracing stays exact under a token rebind', () => {
+    setFacetParamOverrides({
+      FacetButton: { variants: { primary: { radius: { token: 'radius.page' } } } },
+    });
+    const recipe = (theme: FacetTheme, variant: string) => ({
+      borderRadius: resolveRecipeParam(theme, 'FacetButton', variant, 'radius', theme.radius.element),
+    });
+    const origins = traceStyleOrigins(recipe, [darkTheme, 'primary']);
+    // The traced origin is the REBOUND token, not the default.
+    expect(origins!.borderRadius).toEqual({ kind: 'token', tokenPath: 'radius.page' });
+    // A literal override reports computed, never a wrong token.
+    setFacetParamOverrides({ FacetButton: { variants: { primary: { radius: 14 } } } });
+    const literalOrigins = traceStyleOrigins(recipe, [darkTheme, 'primary']);
+    expect(literalOrigins!.borderRadius).toEqual({ kind: 'computed' });
+  });
+
+  it('createTracingTheme twin round-trips through the resolver fallback path', () => {
+    const handle = createTracingTheme(darkTheme);
+    const value = resolveRecipeParam(handle.theme, 'FacetButton', 'primary', 'paddingX', handle.theme.space.md);
+    expect(handle.resolve(value)).toBe('space.md');
+  });
+});