@appinternalleads/ui 0.2.0

package/dist/esm/components/catalog.d.ts

@@ -0,0 +1,108 @@
+/**
+ * **The component-family catalogue — `Directory` · `Checklist` · `Grid` · `Table`.**
+ *
+ * The third family root, alongside the input widgets (`src/widgets/*`, `question/1`) and the
+ * output renderers (`src/widgets/output/`, `output/1`). See
+ * `docs/architecture/COMPONENT-FAMILIES.md` for the map and `tasks/COMPONENTS.md` for status.
+ *
+ * Every family listed is implemented. `grid` and `table` were `blocked` until the batch 4 PRD
+ * (`design_handoff_data_components_batch4`, 2026-09-24) gave them a source of truth; they joined on
+ * 2026-09-25 with C14 Combobox, Tabbed and Fallback. An entry appears when a family has something
+ * real to show, never because a folder exists. This is the single source of
+ * "what exists and can be shown", the same role `OUTPUT_CATALOGUE` plays for output renderers.
+ *
+ * **Why not extend `OUTPUT_CATALOGUE`.** `OutputCatalogueEntry` is shaped around `output/1`:
+ * its `family` axis is `display | decision`, its `fixtureDir` assumes
+ * `spec/examples/output/<type>/`, its `storyId` follows output's own Storybook title format, and
+ * its `type` is an `OutputWidgetKind`. A component family has none of those. Widening that type
+ * to fit would put optional fields on every output renderer that no output renderer will ever
+ * set — the overload this split exists to avoid.
+ *
+ * **Naming.** "Component" is already overloaded in this repo: `component/1`
+ * (`spec/component.schema.json`, `spec/components/*.json`) is the build-time **code generator**
+ * layer, and `/components/*` are the site's catalogue routes. Neither is this. New family
+ * contracts therefore live at `spec/families/<family>.schema.json`, not in the occupied
+ * `spec/components/` directory — see `docs/architecture/COMPONENT-FAMILIES.md` §1.
+ */
+/**
+ * The first-class families. Adding one is a real architecture decision, not a config edit —
+ * `threshold-flow` was added 2026-09-23 and the decision is logged in `docs/DECISIONS.md` §2
+ * ("ThresholdFlow is a component family").
+ */
+export type ComponentFamily = 'directory' | 'checklist' | 'threshold-flow' | 'grid' | 'table' | 'brand-kit' | 'budget-allocation' | 'calendar-sync' | 'carousel' | 'contact-import' | 'dashboard-config' | 'export-format' | 'setup-tasks' | 'cicd-setup' | 'completion' | 'department-setup' | 'help-center' | 'permissions-setup' | 'plan-selection' | 'quick-actions' | 'rate-limit' | 'seat-allocation' | 'status-page' | 'tag-creation' | 'terms-consent' | 'trial-countdown' | 'two-factor' | 'achievement' | 'event-reminder' | 'file-shared' | 'filter-panel' | 'floating' | 'mark-read' | 'password-expiry' | 'payment-alert' | 'onboarding-step' | 'queue-status' | 'shipping-update' | 'id-verification' | 'combobox' | 'tabbed' | 'fallback' | 'budget-tracker' | 'ab-tests' | 'conversion-funnel' | 'expandable-feed' | 'score-summary' | 'criteria-spider' | 'activity-heatmap' | 'tag-cloud' | 'receipt-printer';
+/**
+ * **A set of families shipped and shown together.** The seven onboarding components (2026-09-24)
+ * are separate families — each its own config, engine and page — but one design handoff, one
+ * schema (`spec/families/onboarding.schema.json`) and one place on the site
+ * (`/components/new`). An entry with a `group` is listed under it rather than as its own
+ * top-level tab; the site reads this, never a list of names. `dashboard` (26 Sep 2026) holds the
+ * read-only dashboard and insight components — batches 5 and 6 — at `/components/dashboard`.
+ */
+export type ComponentGroup = 'new' | 'dashboard';
+export declare const COMPONENT_GROUPS: Record<ComponentGroup, {
+    label: string;
+    blurb: string;
+}>;
+/**
+ * Same three-value ladder `OutputImplementationStatus` uses, and for the same reason: `status` is
+ * a design/engineering completeness claim, not a guess from "the folder exists".
+ *
+ * - `implemented` — source-of-truth spec AND contract, schema, fixtures, implementation, tests,
+ *   Storybook, catalogue entry, resource page and Playground all done.
+ * - `design-complete` — an implementation-depth spec exists, engineering has not shipped.
+ * - `blocked` — no implementation-depth spec, or an unresolved question specific to that family.
+ *   Nothing is here today; `grid` and `table` left it on 2026-09-25 (batch 4 PRD).
+ */
+export type ComponentImplementationStatus = 'implemented' | 'design-complete' | 'blocked';
+/**
+ * How a family is driven — see `docs/architecture/CONFIGURATION-MODEL.md`. This is a real axis,
+ * not a label: a `rule-driven` family's behaviour is bounded by the data contract's available
+ * columns (and the rules over them), while a `configuration-driven` family's behaviour space is
+ * enumerable from its own config alone.
+ */
+export type ComponentDriver = 'configuration-driven' | 'rule-driven';
+export type ComponentCatalogueEntry = {
+    /** Stable identity, and the site route segment: `/components/<type>`. */
+    type: ComponentFamily;
+    label: string;
+    status: ComponentImplementationStatus;
+    driver: ComponentDriver;
+    /** One line, for the catalogue card. */
+    blurb: string;
+    /** Subfolder under `spec/examples/components/` once fixtures exist. Absent until then. */
+    fixtureDir?: string;
+    /** Storybook title this family's stories should carry, once they exist. */
+    storyId?: string;
+    /** Dedicated resource page + Playground, the way `OUTPUT_CATALOGUE.resource` drives `list`'s. */
+    resource?: {
+        slug: string;
+        defaultFixture: string;
+    };
+    /** The `/playground/<slug>` route, when the family has one. Site navigation reads this rather
+        than hardcoding a path — the same data-driven discovery `resource` already gives the page. */
+    playground?: {
+        slug: string;
+    };
+    /** Why this status — for docs/tooling, never end-user copy. */
+    note: string;
+    /**
+     * The date (YYYY-MM-DD) the family shipped. The site's Components landing features the entries
+     * with the most recent date as "New" — derived from this field, never from a list kept there.
+     */
+    introduced?: string;
+    /** Listed under this group on the site (`/components/<group>/<type>`) instead of as its own tab. */
+    group?: ComponentGroup;
+    /** How many case studies the family ships — the site's totals add these up. */
+    caseStudies?: number;
+};
+/** One entry per family that is genuinely built — see `tasks/COMPONENTS.md`. */
+export declare const COMPONENT_CATALOGUE: ComponentCatalogueEntry[];
+/** The most recent `introduced` date among these — what "New" means on the site. */
+export declare function latestIntroduced(dates: (string | undefined)[]): string | undefined;
+/** The query the site's future `/components` catalogue would run — mirrors `getOutputComponents`. */
+export declare function getComponents(opts?: {
+    status?: ComponentImplementationStatus;
+    driver?: ComponentDriver;
+    group?: ComponentGroup | null;
+}): ComponentCatalogueEntry[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/esm/components/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/components/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAC/D,WAAW,GAAG,mBAAmB,GAAG,eAAe,GAAG,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,GAC1H,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,kBAAkB,GAAG,aAAa,GAAG,mBAAmB,GAAG,gBAAgB,GACzH,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,GACxI,aAAa,GAAG,gBAAgB,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,iBAAiB,GAChH,eAAe,GAAG,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,GAC5F,UAAU,GAAG,QAAQ,GAAG,UAAU,GAClC,gBAAgB,GAAG,UAAU,GAAG,mBAAmB,GACnD,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,WAAW,GAC1F,iBAAiB,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,WAAW,CAAC;AAEjD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASrF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,6BAA6B,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,aAAa,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAAG;IACpC,yEAAyE;IACzE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD;qGACiG;IACjG,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oGAAoG;IACpG,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,uBAAuB,EA2cxD,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAElF;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAC3B,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,6BAA6B,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CAAO,GAC7G,uBAAuB,EAAE,CAM3B"}