@philosaether/chipper 0.1.0

package/dist/src/domains/facades.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Facade domain factories — sugar over keywordOrExpressionDomain.
+ *
+ * These hide KOE internals for the most common chip types. Consumers
+ * define text inputs, number inputs, date pickers, and keyword lists
+ * without thinking about expression modes or input types.
+ *
+ * See koe-facades.md.
+ */
+import type { Domain, SentenceContext } from '../core/types';
+import type { KeywordGroupItem } from './normalize-keywords';
+/** Configuration for a free-text domain. */
+export interface TextDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Text shown in chip trigger when empty */
+    placeholder?: string;
+    /** Initial value (defaults to '' → shows placeholder) */
+    default?: string;
+    /** Character limit (default 140) */
+    maxLength?: number;
+    /** Custom validation beyond non-empty */
+    validate?: (value: string) => boolean;
+    /** Format value for chip trigger display */
+    display?: (value: string) => string;
+    /** Optional preset values as keyword pills. Accepts groups for visual grouping. */
+    keywords?: KeywordGroupItem<string>[];
+}
+/**
+ * Create a free-text domain. The simplest freeform chip.
+ *
+ * @example
+ * ```typescript
+ * const taskName = textDomain({
+ *   color: 'rose',
+ *   placeholder: 'a task name',
+ * });
+ * ```
+ */
+export declare function textDomain(config: TextDomainConfig): Domain<string>;
+/** Configuration for a numeric domain. */
+export interface NumberDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Text shown in chip trigger when empty */
+    placeholder?: string;
+    /** Initial value (defaults to '' → shows placeholder) */
+    default?: string;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Step increment for +/- buttons (default 1) */
+    step?: number;
+    /** Text before the input (static or context-aware) */
+    prefix?: string | ((ctx: SentenceContext) => string);
+    /** Text after the input (static or context-aware) */
+    suffix?: string | ((ctx: SentenceContext) => string);
+    /** Custom validation beyond numeric check */
+    validate?: (value: string) => boolean;
+    /** Format value for chip trigger display */
+    display?: (value: string) => string;
+    /** Optional preset values as keyword pills. Accepts groups for visual grouping. */
+    keywords?: KeywordGroupItem<string>[];
+}
+/**
+ * Create a numeric domain with stepper UI.
+ *
+ * @example
+ * ```typescript
+ * const interval = numberDomain({
+ *   color: 'copper',
+ *   min: 1,
+ *   max: 365,
+ *   placeholder: 'an interval',
+ * });
+ * ```
+ */
+export declare function numberDomain(config: NumberDomainConfig): Domain<string>;
+/** Configuration for a calendar date domain. */
+export interface DateDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Text shown in chip trigger when empty */
+    placeholder?: string;
+    /** Initial value (defaults to '' → shows placeholder) */
+    default?: string;
+    /** Custom validation beyond YYYY-MM-DD format */
+    validate?: (value: string) => boolean;
+    /** Format date for chip trigger display */
+    display?: (value: string) => string;
+    /** Optional preset values (e.g., "tomorrow", "next Monday"). Accepts groups for visual grouping. */
+    keywords?: KeywordGroupItem<string>[];
+}
+/**
+ * Create a calendar date picker domain.
+ *
+ * @example
+ * ```typescript
+ * const dueDate = dateDomain({
+ *   color: 'sage',
+ *   placeholder: 'a date',
+ * });
+ * ```
+ */
+export declare function dateDomain(config: DateDomainConfig): Domain<string>;
+/** Configuration for a keywords-only domain. */
+export interface KeywordDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** The complete set of allowed values. Accepts groups for visual grouping. */
+    keywords: KeywordGroupItem<string>[];
+    /** Default value (defaults to first keyword value) */
+    default?: string;
+    /** Text shown in chip trigger when value is invalid */
+    placeholder?: string;
+}
+/**
+ * Create a keywords-only domain. Replaces enumDomain.
+ *
+ * @example
+ * ```typescript
+ * const priority = keywordDomain({
+ *   color: 'rose',
+ *   keywords: [
+ *     { value: 'low' },
+ *     { value: 'medium' },
+ *     { value: 'high' },
+ *   ],
+ * });
+ * ```
+ */
+export declare function keywordDomain(config: KeywordDomainConfig): Domain<string>;
+//# sourceMappingURL=facades.d.ts.map

package/dist/src/domains/facades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facades.d.ts","sourceRoot":"","sources":["../../../src/domains/facades.ts"],"names":[],"mappings":"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"}

package/dist/src/domains/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Domain archetype implementations.
+ *
+ * Each archetype provides a factory function that creates a configured
+ * Domain instance. See chipper-architecture.md §2, domain-factories.md,
+ * koe-facades.md.
+ */
+export { keywordOrExpressionDomain, expressionDomain, textExpression, numericExpression, dateExpression, type KeywordOrExpressionDomainConfig, type ExpressionDomainConfig, type ExpressionConfig, type ExpressionTrigger, } from './keyword-or-expression';
+export { type KeywordConfig, type KeywordGroup, type KeywordGroupItem, type NormalizedKeywordGroup, } from './normalize-keywords';
+export { textDomain, numberDomain, dateDomain, keywordDomain, type TextDomainConfig, type NumberDomainConfig, type DateDomainConfig, type KeywordDomainConfig, } from './facades';
+export { multiSelectDomain, selectionMatchesKeyword, type MultiSelectDomainConfig, } from './multi-select';
+export { alternativeCoordinateDomain, type AlternativeCoordinateDomainConfig, type AlternativeCoordinateMode, type ResolvedAlternativeCoordinateMode, type ResolvedModeSlot, type ModeSlot, } from './alternative-coordinate';
+export { referenceDomain, type ReferenceDomainConfig, type ReferenceSource, type ReferenceItem, } from './reference';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/domains/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domains/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,KAAK,iCAAiC,EACtC,KAAK,yBAAyB,EAC9B,KAAK,iCAAiC,EACtC,KAAK,gBAAgB,EACrB,KAAK,QAAQ,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/src/domains/keyword-or-expression.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Keyword-or-expression domain — keywords for common values, text input
+ * for everything else.
+ *
+ * The second archetype. Covers time, due, task name, description, number,
+ * start, collate name — any domain where the value space is "a few presets
+ * plus freeform."
+ *
+ * Also exports expressionDomain as a convenience alias for expression-only
+ * domains (no keywords).
+ */
+import type { Domain, Keyword, SentenceContext } from '../core/types';
+import { type KeywordGroupItem } from './normalize-keywords';
+/** Configuration for a trigger keyword that enters expression mode. */
+export interface ExpressionTrigger {
+    /** Popup pill label (e.g., "custom interval") */
+    label: string;
+    /** Default value when entering expression mode (e.g., "2") */
+    default: string;
+}
+/** Expression mode configuration for the text input. */
+export interface ExpressionConfig {
+    /** Input type — 'text', 'number' (stepper UI), or 'date' (calendar picker). Required. */
+    inputType: 'text' | 'number' | 'date';
+    /** Placeholder text for the input field */
+    placeholder?: string;
+    /** Maximum character length (omit for unlimited, text only) */
+    maxLength?: number;
+    /** Minimum value (number inputs only) */
+    min?: number;
+    /** Maximum value (number inputs only) */
+    max?: number;
+    /** Step increment for +/- buttons (number inputs only, default 1) */
+    step?: number;
+    /** Validate typed input (beyond non-empty). Return true if valid. */
+    validate?: (value: string) => boolean;
+    /** Format the value for chip trigger display (default: identity) */
+    display?: (value: string) => string;
+    /** Text shown before the input in the popup (e.g., "in"). Function receives sentence context. */
+    prefix?: string | ((context: Record<string, unknown>) => string);
+    /** Text shown after the input in the popup (e.g., "months"). Function receives sentence context. */
+    suffix?: string | ((context: Record<string, unknown>) => string);
+    /** Expression input placement relative to keywords: 'above' or 'below' (default 'below'). */
+    position?: 'above' | 'below';
+    /**
+     * Keyword that enters expression mode when selected.
+     * When absent, the expression input is always visible in the popup.
+     * When present, the expression input is hidden until this trigger is selected.
+     */
+    trigger?: ExpressionTrigger;
+}
+/**
+ * Create a text expression config.
+ * Sugar for { inputType: 'text', ...options }.
+ */
+export declare function textExpression(options?: Omit<ExpressionConfig, 'inputType'>): ExpressionConfig;
+/**
+ * Create a numeric expression config.
+ * Sugar for { inputType: 'number', ...options } with sensible defaults.
+ */
+export declare function numericExpression(options?: Omit<ExpressionConfig, 'inputType'>): ExpressionConfig;
+/**
+ * Create a calendar date expression config.
+ * Sugar for { inputType: 'date', ...options } with sensible defaults.
+ * Values are YYYY-MM-DD strings (native date input format).
+ */
+export declare function dateExpression(options?: Omit<ExpressionConfig, 'inputType'>): ExpressionConfig;
+/** Configuration for a keyword-or-expression domain. */
+export interface KeywordOrExpressionDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Preset values shown as keyword pills in the popup. Accepts groups for visual grouping. */
+    keywords?: KeywordGroupItem<string>[] | Keyword<string>[];
+    /** Expression mode configuration. Omit for keywords-only domains. */
+    expression?: ExpressionConfig;
+    /** Default value. When omitted, uses first keyword's value or '' if no keywords. */
+    default?: string;
+    /** @deprecated Use `default` instead */
+    defaultValue?: string;
+    /** Text shown in chip trigger when value is invalid */
+    placeholder?: string;
+    /** Context keys this domain reads from ancestor producers */
+    consumes?: string[];
+    /** Context keys this domain writes for descendant consumers */
+    produces?: string[];
+    /** Reconfigure domain when ancestor context changes */
+    onContextChange?: (context: SentenceContext) => Partial<Domain<string>>;
+}
+/**
+ * Create a keyword-or-expression domain.
+ *
+ * @example
+ * ```typescript
+ * const timeOfDay = keywordOrExpressionDomain({
+ *   color: 'copper',
+ *   keywords: [
+ *     { value: '09:00', label: 'morning' },
+ *     { value: '12:00', label: 'afternoon' },
+ *     { value: '17:00', label: 'evening' },
+ *   ],
+ *   expression: textExpression({
+ *     placeholder: 'a specific time (HH:MM)',
+ *     validate: (v) => /^\d{2}:\d{2}$/.test(v),
+ *   }),
+ *   placeholder: 'a time',
+ * });
+ * ```
+ */
+export declare function keywordOrExpressionDomain(config: KeywordOrExpressionDomainConfig): Domain<string>;
+/** Configuration for an expression-only domain (no keywords). */
+export interface ExpressionDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Expression mode configuration */
+    expression: ExpressionConfig;
+    /** Default value. Empty string if omitted (invalid → placeholder). */
+    default?: string;
+    /** @deprecated Use `default` instead */
+    defaultValue?: string;
+    /** Text shown in chip trigger when value is invalid */
+    placeholder?: string;
+    /** Context keys this domain reads from ancestor producers */
+    consumes?: string[];
+    /** Context keys this domain writes for descendant consumers */
+    produces?: string[];
+    /** Reconfigure domain when ancestor context changes */
+    onContextChange?: (context: SentenceContext) => Partial<Domain<string>>;
+}
+/**
+ * Create an expression-only domain (no keywords).
+ *
+ * Convenience alias for keywordOrExpressionDomain with empty keywords.
+ * Use this for free-text inputs: task names, descriptions, custom values.
+ *
+ * @example
+ * ```typescript
+ * const taskName = expressionDomain({
+ *   color: 'rose',
+ *   expression: textExpression({
+ *     placeholder: 'task name',
+ *     maxLength: 200,
+ *   }),
+ *   placeholder: 'a new task',
+ * });
+ * ```
+ */
+export declare function expressionDomain(config: ExpressionDomainConfig): Domain<string>;
+//# sourceMappingURL=keyword-or-expression.d.ts.map

package/dist/src/domains/keyword-or-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-or-expression.d.ts","sourceRoot":"","sources":["../../../src/domains/keyword-or-expression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtF,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEtC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAEtC,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAEpC,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;IAEjE,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;IAEjE,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAE7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC5C,gBAAgB,CAElB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC5C,gBAAgB,CAMlB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC5C,gBAAgB,CAWlB;AAED,wDAAwD;AACxD,MAAM,WAAW,+BAA+B;IAC9C,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAE1D,qEAAqE;IACrE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,+BAA+B,GACtC,MAAM,CAAC,MAAM,CAAC,CAmFhB;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,UAAU,EAAE,gBAAgB,CAAC;IAE7B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,CAE/E"}

package/dist/src/domains/multi-select.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Multi-select domain — toggle grid of options, group keyword shortcuts.
+ *
+ * The third archetype. Value is string[] — an ordered array of selected
+ * option values. Covers tags, day-sets, and any multi-choice value space.
+ *
+ * Display uses a "3 then count" rule: up to 3 labels comma-joined,
+ * then "{n} selected" at 4+.
+ */
+import type { Domain, Keyword, SentenceContext } from '../core/types';
+import { type KeywordConfig, type KeywordGroupItem } from './normalize-keywords';
+/** Configuration for a multi-select domain. */
+export interface MultiSelectDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Available options (rendered as toggle pills in the popup). Accepts groups for visual grouping. */
+    options: KeywordGroupItem<string>[] | Keyword<string>[];
+    /**
+     * Group keywords — shortcuts that set multiple options at once.
+     * Selecting a keyword replaces the current selection entirely.
+     * E.g., { label: 'weekdays', value: ['mon', 'tue', 'wed', 'thu', 'fri'] }
+     */
+    keywords?: KeywordConfig<string[]>[] | Keyword<string[]>[];
+    /** Max selections (omit for unlimited) */
+    maxSelections?: number;
+    /**
+     * Label used when count display kicks in (4+ selections).
+     * E.g., "days" → "4 days", "instruments" → "5 instruments".
+     * Defaults to "selected".
+     */
+    countLabel?: string;
+    /** Default value — empty array if omitted (invalid → placeholder) */
+    default?: string[];
+    /** @deprecated Use `default` instead */
+    defaultValue?: string[];
+    /** Text shown in chip trigger when no options are selected */
+    placeholder?: string;
+    /** Context keys this domain reads from ancestor producers */
+    consumes?: string[];
+    /** Context keys this domain writes for descendant consumers */
+    produces?: string[];
+    /** Reconfigure domain when ancestor context changes */
+    onContextChange?: (context: SentenceContext) => Partial<Domain<string[]>>;
+}
+/** Check if a selection matches a group keyword's value set (order-independent). */
+export declare function selectionMatchesKeyword(selection: ReadonlySet<string>, selectionLength: number, keywordValues: readonly string[]): boolean;
+/**
+ * Create a multi-select domain.
+ *
+ * @example
+ * ```typescript
+ * const daySet = multiSelectDomain({
+ *   color: 'sage',
+ *   options: [
+ *     { label: 'Mon', value: 'mon' },
+ *     { label: 'Tue', value: 'tue' },
+ *     { label: 'Wed', value: 'wed' },
+ *     // ...
+ *   ],
+ *   keywords: [
+ *     { label: 'weekdays', value: ['mon', 'tue', 'wed', 'thu', 'fri'] },
+ *   ],
+ *   placeholder: 'which days',
+ * });
+ * ```
+ */
+export declare function multiSelectDomain(config: MultiSelectDomainConfig): Domain<string[]>;
+//# sourceMappingURL=multi-select.d.ts.map

package/dist/src/domains/multi-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-select.d.ts","sourceRoot":"","sources":["../../../src/domains/multi-select.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,qGAAqG;IACrG,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAExD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAE3D,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3E;AAKD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CA0DnF"}

package/dist/src/domains/normalize-keywords.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared keyword normalization and domain utilities.
+ *
+ * Consumers can provide keyword shorthand:
+ *   { value: 'daily' }                          → label='daily', display=undefined
+ *   { value: 'daily', label: 'day' }            → label='day', display=undefined
+ *   { value: 'daily', label: 'day', display: 'day of the week' }
+ *                                                → label='day', display='day of the week'
+ *
+ * Grouping (keyword-grouping.md):
+ *   Keywords arrays accept KeywordGroup objects alongside plain configs.
+ *   Groups carry label, layout, columns, prefix. Ungrouped keywords
+ *   collect into one implicit group at the top.
+ *
+ * See builder-dx.md §4, keyword-grouping.md.
+ */
+import type { Keyword } from '../core/types';
+/** Shorthand keyword config accepted by domain factories. */
+export interface KeywordConfig<T = string> {
+    value: T;
+    label?: string | ((context: Record<string, unknown>) => string);
+    display?: string;
+    partial?: boolean;
+}
+/** A named group of keywords rendered as a visual section in the popup. */
+export interface KeywordGroup<T = string> {
+    /** Display label rendered above the keywords (omit for unlabeled group) */
+    label?: string;
+    /** Keywords in this group */
+    keywords: KeywordConfig<T>[];
+    /** Layout mode: 'flow' (default flex-wrap) or 'grid' (CSS grid) */
+    layout?: 'flow' | 'grid';
+    /** Grid column count (required when layout is 'grid') */
+    columns?: number;
+    /** Text rendered before the keyword pills (e.g., "the") */
+    prefix?: string;
+}
+/** A keyword config or a group of keyword configs. */
+export type KeywordGroupItem<T = string> = KeywordConfig<T> | KeywordGroup<T>;
+/** Normalized group ready for popup rendering. */
+export interface NormalizedKeywordGroup<T = string> {
+    label?: string;
+    layout: 'flow' | 'grid';
+    columns?: number;
+    prefix?: string;
+    keywords: Keyword<T>[];
+}
+/** Type guard: is this item a KeywordGroup (has a `keywords` array, no `value`)? */
+export declare function isKeywordGroup<T>(item: KeywordGroupItem<T>): item is KeywordGroup<T>;
+/** Normalize shorthand keyword configs into full Keyword<T> objects. */
+export declare function normalizeKeywords<T>(configs: KeywordConfig<T>[]): Keyword<T>[];
+/**
+ * Normalize a mixed keywords array into grouped form.
+ *
+ * Returns both a flat keyword list (for validation, display, keyboard nav)
+ * and a grouped list (for popup rendering).
+ *
+ * Ungrouped KeywordConfig items are collected into a single implicit group
+ * placed before any explicit groups. If all items are ungrouped, the result
+ * is a single group with default config.
+ */
+export declare function normalizeKeywordGroups<T>(items: KeywordGroupItem<T>[]): {
+    flat: Keyword<T>[];
+    groups: NormalizedKeywordGroup<T>[];
+};
+/**
+ * Build a value → display text map from normalized keywords.
+ * Uses display if present, falls back to label.
+ */
+export declare function buildDisplayMap<T>(keywords: Keyword<T>[]): Map<T, string>;
+/**
+ * Resolve the default value for a domain.
+ *
+ * Cascade: explicit default → deprecated defaultValue → placeholder-aware fallback.
+ * When placeholder is set, defaults to fallbackEmpty (user must choose).
+ * When no placeholder, defaults to first keyword if available.
+ */
+export declare function resolveDefault<T>(config: {
+    default?: T;
+    defaultValue?: T;
+    placeholder?: string;
+}, keywords: Keyword<unknown>[], firstKeywordValue: T | undefined, fallbackEmpty: T): T;
+//# sourceMappingURL=normalize-keywords.d.ts.map

package/dist/src/domains/normalize-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-keywords.d.ts","sourceRoot":"","sources":["../../../src/domains/normalize-keywords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,6DAA6D;AAC7D,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM;IACtC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAE9E,kDAAkD;AAClD,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,MAAM;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;CACxB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,CAAC,CAEpF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAO9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAmC7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAC5B,iBAAiB,EAAE,CAAC,GAAG,SAAS,EAChC,aAAa,EAAE,CAAC,GACf,CAAC,CAKH"}

package/dist/src/domains/reference.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Reference domain — external data with navigation/search popup.
+ *
+ * The fifth archetype. Value is an opaque reference ID (string).
+ * The consumer provides a ReferenceSource that fetches items on demand;
+ * Chipper provides tree navigation, search, and selection mechanics.
+ *
+ * Covers priority pickers (hierarchical tree), user pickers (flat search),
+ * and any domain where the value space lives outside the palette.
+ */
+import type { Domain, Keyword, SentenceContext } from '../core/types';
+/** A single item in the reference data set. */
+export interface ReferenceItem {
+    /** Unique ID — becomes the chip value when selected */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Whether this item has children (enables drill-in affordance) */
+    hasChildren?: boolean;
+    /**
+     * Whether this item can be selected. Default true.
+     * If false, the item is a navigation-only node (category, folder).
+     * Items with hasChildren can be both drillable and selectable.
+     */
+    selectable?: boolean;
+}
+/** Data source for a reference domain. */
+export interface ReferenceSource {
+    /**
+     * Fetch items at a given path in the hierarchy.
+     * - Root level: path is []
+     * - One level deep: path is [rootItem]
+     * - Flat data: ignore path, return full list
+     *
+     * Called on popup open and on each drill-in navigation.
+     */
+    getItems: (path: ReferenceItem[]) => ReferenceItem[] | Promise<ReferenceItem[]>;
+    /**
+     * Search across the full data set.
+     * If omitted, the popup hides the search input.
+     */
+    search?: (query: string) => ReferenceItem[] | Promise<ReferenceItem[]>;
+    /**
+     * Resolve an ID to its display string.
+     * Called eagerly on chip mount to populate displayValue for saved references.
+     * If omitted, the raw ID is shown as the display value.
+     */
+    resolveDisplay?: (id: string) => string | Promise<string>;
+}
+/** Configuration for a reference domain. */
+export interface ReferenceDomainConfig {
+    /** Semantic color key */
+    color: string;
+    /** Data source — provides items, search, display resolution */
+    source: ReferenceSource;
+    /**
+     * Shortcut keywords. Selected like enum keywords — bypass the popup.
+     * Useful for "none" or "any" sentinel values.
+     */
+    keywords?: Keyword<string>[];
+    /** Default value — empty string if omitted (invalid → placeholder) */
+    default?: string;
+    /** Text shown when value is invalid */
+    placeholder?: string;
+    /** Context keys this domain reads */
+    consumes?: string[];
+    /** Context keys this domain writes */
+    produces?: string[];
+    /** Reconfigure domain when ancestor context changes */
+    onContextChange?: (context: SentenceContext) => Partial<Domain<string>>;
+}
+/**
+ * Create a reference domain.
+ *
+ * @example
+ * ```typescript
+ * const priorityRef = referenceDomain({
+ *   color: 'indigo',
+ *   source: {
+ *     getItems: (path) => fetchPrioritiesAt(path),
+ *     search: (query) => searchPriorities(query),
+ *     resolveDisplay: (id) => getPriorityPath(id),
+ *   },
+ *   placeholder: 'a priority',
+ * });
+ * ```
+ */
+export declare function referenceDomain(config: ReferenceDomainConfig): Domain<string>;
+//# sourceMappingURL=reference.d.ts.map

package/dist/src/domains/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/domains/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGtE,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IAEX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEhF;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IAEd,+DAA+D;IAC/D,MAAM,EAAE,eAAe,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAE7B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,CAkC7E"}

package/dist/src/hooks/SentenceProvider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SentenceProvider — wraps useReducer and popup state for a sentence instance.
+ *
+ * Components and hooks beneath this provider access sentence state via
+ * useSentence, useChip, and usePopup.
+ */
+import type { SentenceDefinition } from '../core/types';
+import type { SentenceState } from '../core/state';
+export interface SentenceProviderProps {
+    definition: SentenceDefinition;
+    /** Saved values to restore on mount (from serialize()) */
+    initialValues?: Record<string, unknown>;
+    onChange?: (state: SentenceState) => void;
+    children: React.ReactNode;
+}
+export declare function SentenceProvider({ definition, initialValues, onChange, children }: SentenceProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SentenceProvider.d.ts.map

package/dist/src/hooks/SentenceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentenceProvider.d.ts","sourceRoot":"","sources":["../../../src/hooks/SentenceProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CA2BxG"}

package/dist/src/hooks/context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * React context for a Chipper sentence instance.
+ *
+ * Carries the store, dispatch, definition, and popup state.
+ * One context per SentenceProvider — multiple Chipper instances
+ * on the same page get independent contexts.
+ */
+import type { SentenceStore } from '../core/store';
+import type { SentenceAction } from '../core/reducer';
+import type { SentenceDefinition } from '../core/types';
+/** Which chip popup is currently open, or null if none. */
+export interface PopupState {
+    /** Currently open chip ID, or null */
+    chipId: string | null;
+    /** Clause containing the open chip, or null */
+    clauseId: string | null;
+    /** DOM element the popup positions relative to */
+    anchorElement: HTMLElement | null;
+}
+/** Value carried by SentenceContext. */
+export interface SentenceContextValue {
+    store: SentenceStore;
+    dispatch: React.Dispatch<SentenceAction>;
+    definition: SentenceDefinition;
+    popupState: PopupState;
+    setPopupState: React.Dispatch<React.SetStateAction<PopupState>>;
+}
+/** Initial popup state — no popup open. */
+export declare const closedPopup: PopupState;
+export declare const SentenceContext: import("react").Context<SentenceContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/hooks/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/hooks/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kDAAkD;IAClD,aAAa,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACzC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AAED,2CAA2C;AAC3C,eAAO,MAAM,WAAW,EAAE,UAIzB,CAAC;AAEF,eAAO,MAAM,eAAe,sDAAmD,CAAC"}

package/dist/src/hooks/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * React hooks — also the headless API.
+ *
+ * These hooks are the same ones used internally by the built-in components.
+ * Consumers import from 'chipper/headless' to use them without the default UI.
+ */
+export { SentenceProvider, type SentenceProviderProps } from './SentenceProvider';
+export { useSentence } from './useSentence';
+export { useChip } from './useChip';
+export { usePopup } from './usePopup';
+export { useKeyboardNavigation, type KeyboardNavigationOptions, type KeyboardNavigationResult } from './useKeyboardNavigation';
+export type { SentenceContextValue, PopupState } from './context';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC/H,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}