@philosaether/chipper 0.1.0

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

@@ -0,0 +1,82 @@
+/**
+ * Sentence builder API.
+ *
+ * The builder is how consumers define sentences — composing clauses
+ * from palette domains with contingency relationships and behavior.
+ * See chipper-architecture.md §4, builder-dx.md.
+ */
+import type { ChipDefinition, ChipMode, ClauseDefinition, ContingencyConfig, Palette, RepeatingClauseConfig, SentenceContext, SentenceDefinition } from '../core/types';
+import type { SentenceState } from '../core/state';
+/** Display shorthand accepted by the builder `display` key on ChipOptions. */
+export type DisplayShorthand<T = unknown> = T | ((context: import('../core/types').SentenceContext, state: import('../core/state').SentenceState) => T) | {
+    url: string;
+    extract: (response: unknown) => T;
+    interval?: number;
+} | {
+    subscribe: (callback: (value: T) => void) => (() => void);
+};
+/**
+ * Define a chip within a clause.
+ */
+export declare function chip(id: string, domainName?: string | ChipOptions, options?: ChipOptions): ChipDefinition;
+export interface ChipOptions {
+    /** Make this a display chip. Accepts a value, function, or source config. */
+    display?: DisplayShorthand;
+    /** Info popup content for display chips. */
+    info?: string | ((value: unknown, state: import('../core/state').SentenceState) => string);
+    /** Legacy mode key — prefer `display` for non-interactive chips. */
+    mode?: ChipMode;
+    present?: (context: SentenceContext) => boolean;
+}
+export interface TextOptions {
+    present?: (context: SentenceContext) => boolean;
+}
+export interface PuncOptions {
+    display?: (context: SentenceContext) => string;
+    present?: (context: SentenceContext) => boolean;
+}
+export interface ClauseBuilder {
+    required(): ClauseBuilder;
+    optional(): ClauseBuilder;
+    text(text: string, options?: TextOptions): ClauseBuilder;
+    leads(first: string, rest: string): ClauseBuilder;
+    placeholder(text: string): ClauseBuilder;
+    chip(id: string, domainName?: string | ChipOptions, options?: ChipOptions): ClauseBuilder;
+    punc(options?: PuncOptions): ClauseBuilder;
+    contingentOn(superclauseId: string, config: Omit<ContingencyConfig, 'superclauseId'> | ((context: SentenceContext) => boolean)): ClauseBuilder;
+    produces(chipIdOrMapping: string | Record<string, string>): ClauseBuilder;
+    _build(id: string): ClauseDefinition;
+}
+/**
+ * Define a clause within a sentence.
+ *
+ * Segments are built in call order: .text(), .chip(), .text()
+ * all push to the segment list. Text and chips interleave freely.
+ */
+export declare function builder(): ClauseBuilder;
+/**
+ * Define a repeating clause group (e.g., "when [condition], and [condition], ...").
+ */
+export declare function repeating(clauseBuilder: ClauseBuilder, options: {
+    min?: number;
+    max?: number;
+}): RepeatingClauseConfig;
+interface LineOptions {
+    indent?: boolean;
+}
+interface SentenceBuilder {
+    clause(id: string, clauseBuilder: ClauseBuilder): SentenceBuilder;
+    clauses(clauseBuilders: ClauseBuilder[]): SentenceBuilder;
+    line(options?: LineOptions): SentenceBuilder;
+    serializer(fn: (state: SentenceState) => Record<string, unknown>): SentenceBuilder;
+    deserializer(fn: (data: Record<string, unknown>) => Record<string, unknown>): SentenceBuilder;
+    build(): SentenceDefinition;
+}
+/**
+ * Define a sentence. Entry point for the builder API.
+ *
+ * @param palette - The palette to resolve domain names from. Defaults to chipperPalette.
+ */
+export declare function sentence(palette?: Palette): SentenceBuilder;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/builder/predicates.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Predicate helpers — factories that return context predicates for use
+ * with `present`, `contingentOn`, and `.punc({ present })`.
+ */
+import type { SentenceContext } from '../core/types';
+/**
+ * True when the context value for `key` is a numeric string.
+ *
+ * Usage: `.chip('unit', 'timeUnit', { present: isNumeric('measure') })`
+ */
+export declare function isNumeric(key: string): (context: SentenceContext) => boolean;
+/**
+ * True when the context value for `key` is one of the given values.
+ *
+ * Usage: `.punc({ present: isOneOf('measure', 'daily', 'weekday', 'weekend') })`
+ */
+export declare function isOneOf(key: string, ...values: string[]): (context: SentenceContext) => boolean;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/src/builder/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../../src/builder/predicates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAK5E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAG/F"}

package/dist/src/components/Chip.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Chip — trigger button + popup mount point.
+ *
+ * Reads chip state from useChip, manages popup via usePopup.
+ * The popup renders conditionally (unmounted when closed).
+ *
+ * Interactive chips open a domain-specific input popup.
+ * Display chips optionally open a read-only info popup.
+ */
+export interface ChipProps {
+    clauseId: string;
+    chipId: string;
+}
+export declare function Chip({ clauseId, chipId }: ChipProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Chip.d.ts.map

package/dist/src/components/Chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../src/components/Chip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,2CAyHnD"}

package/dist/src/components/ChipInfoPopup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ChipInfoPopup — read-only info popup for display chips.
+ *
+ * Shows provenance/context text. Reuses popup positioning but
+ * renders a simple text block instead of domain-specific input UI.
+ */
+export interface ChipInfoPopupProps {
+    content: string;
+    onClose: () => void;
+}
+export declare function ChipInfoPopup({ content, onClose }: ChipInfoPopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ChipInfoPopup.d.ts.map

package/dist/src/components/ChipInfoPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChipInfoPopup.d.ts","sourceRoot":"","sources":["../../../src/components/ChipInfoPopup.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,kBAAkB,2CAgCrE"}

package/dist/src/components/ChipPopup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ChipPopup — popup container with positioning, Escape, outside-click,
+ * and archetype routing.
+ *
+ * Positioned via CSS (absolute, below trigger). Routes to the
+ * appropriate archetype popup based on domain.type.
+ */
+import type { Domain, SentenceContext } from '../core/types';
+export interface ChipPopupProps {
+    clauseId: string;
+    chipId: string;
+    domain: Domain;
+    value: unknown;
+    expressionActive?: boolean;
+    context?: SentenceContext;
+    onSelect: (value: unknown) => void;
+    onClose: () => void;
+}
+export declare function ChipPopup({ chipId, domain, value, expressionActive, context, onSelect, onClose }: ChipPopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ChipPopup.d.ts.map

package/dist/src/components/ChipPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChipPopup.d.ts","sourceRoot":"","sources":["../../../src/components/ChipPopup.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAA2B,eAAe,EAAE,MAAM,eAAe,CAAC;AAUtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,cAAc,2CAoIhH"}

package/dist/src/components/Chipper.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Chipper — top-level auto-rendering component.
+ *
+ * Wraps SentenceProvider + Sentence. Consumers write:
+ *   <Chipper sentence={def} onChange={fn} />
+ *
+ * For custom layouts, pass children instead of relying on auto-render:
+ *   <Chipper sentence={def} onChange={fn}>
+ *     <MyCustomLayout />
+ *   </Chipper>
+ */
+import type { SentenceDefinition } from '../core/types';
+import type { SentenceState } from '../core/state';
+export interface ChipperProps {
+    /** The sentence definition to render */
+    sentence: SentenceDefinition;
+    /** Saved values to restore on mount (from serialize()) */
+    initialValues?: Record<string, unknown>;
+    /** Called on every state change */
+    onChange?: (state: SentenceState) => void;
+    /** Custom children — if provided, replaces auto-rendered Sentence */
+    children?: React.ReactNode;
+}
+export declare function Chipper({ sentence, initialValues, onChange, children }: ChipperProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Chipper.d.ts.map

package/dist/src/components/Chipper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chipper.d.ts","sourceRoot":"","sources":["../../../src/components/Chipper.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,EAAE,kBAAkB,CAAC;IAE7B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAE1C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,YAAY,2CAMpF"}

package/dist/src/components/Clause.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Clause — renders interleaved text and chips for a single clause.
+ *
+ * Handles three presentation modes:
+ * - Contingent + latent: returns null (clause not rendered)
+ * - Optional + dormant: shows ↳ toggle + segments as plain text (muted italic)
+ * - Active: shows segments with interactive chips (with × toggle for optional)
+ */
+export interface ClauseProps {
+    clauseId: string;
+}
+export declare function Clause({ clauseId }: ClauseProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Clause.d.ts.map

package/dist/src/components/Clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clause.d.ts","sourceRoot":"","sources":["../../../src/components/Clause.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW,kDAuG/C"}

package/dist/src/components/Sentence.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sentence — renders the clause list from the sentence definition.
+ *
+ * Reads definition from context. No props — the structure comes
+ * from the SentenceProvider above.
+ *
+ * If the definition includes lines, clauses are grouped into
+ * chipper-line wrappers. Otherwise each clause gets its own line.
+ *
+ * Indent is derived: a line is indented if all its clauses are
+ * optional or contingent-not-present. Explicit indent on
+ * LineDefinition overrides this.
+ */
+export declare function Sentence(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Sentence.d.ts.map

package/dist/src/components/Sentence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sentence.d.ts","sourceRoot":"","sources":["../../../src/components/Sentence.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+CH,wBAAgB,QAAQ,4CAoBvB"}

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

@@ -0,0 +1,12 @@
+export { Chipper, type ChipperProps } from './Chipper';
+export { Sentence } from './Sentence';
+export { Clause, type ClauseProps } from './Clause';
+export { Chip, type ChipProps } from './Chip';
+export { ChipPopup, type ChipPopupProps } from './ChipPopup';
+export { ChipInfoPopup, type ChipInfoPopupProps } from './ChipInfoPopup';
+export { KeywordOrExpressionPopup, type KeywordOrExpressionPopupProps, } from './popups/KeywordOrExpressionPopup';
+export { MultiSelectPopup, type MultiSelectPopupProps, } from './popups/MultiSelectPopup';
+export { AlternativeCoordinatePopup, type AlternativeCoordinatePopupProps, } from './popups/AlternativeCoordinatePopup';
+export { NumericInput, type NumericInputProps } from './popups/NumericInput';
+export { ReferencePopup, type ReferencePopupProps, } from './popups/ReferencePopup';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,KAAK,6BAA6B,GACnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,0BAA0B,EAC1B,KAAK,+BAA+B,GACrC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC"}

package/dist/src/components/popups/AlternativeCoordinatePopup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AlternativeCoordinatePopup — tabbed popup with slot-based selection.
+ *
+ * Each tab renders one mode's slots. Single-slot modes close on keyword
+ * select (like enum). Multi-slot modes stay open until all slots are
+ * filled, then auto-close. Expression submission always closes.
+ */
+import type { ResolvedAlternativeCoordinateMode } from '../../domains/alternative-coordinate';
+export interface AlternativeCoordinatePopupProps {
+    modes: ResolvedAlternativeCoordinateMode[];
+    value: string;
+    onSelect: (value: string) => void;
+    onClose: () => void;
+}
+export declare function AlternativeCoordinatePopup({ modes, value, onSelect, onClose, }: AlternativeCoordinatePopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AlternativeCoordinatePopup.d.ts.map

package/dist/src/components/popups/AlternativeCoordinatePopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlternativeCoordinatePopup.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/AlternativeCoordinatePopup.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,sCAAsC,CAAC;AAK9F,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,iCAAiC,EAAE,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA0CD,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,GACR,EAAE,+BAA+B,2CA2LjC"}

package/dist/src/components/popups/KeywordGroupList.d.ts

@@ -0,0 +1,29 @@
+/**
+ * KeywordGroupList — shared rendering for grouped keywords.
+ *
+ * Renders NormalizedKeywordGroup[] as visual sections with optional
+ * labels, prefixes, and flow/grid layouts. Used by KOE, multi-select,
+ * and alt-coordinate popups.
+ *
+ * See keyword-grouping.md.
+ */
+import type { Keyword, SentenceContext } from '../../core/types';
+import type { NormalizedKeywordGroup } from '../../domains/normalize-keywords';
+export interface KeywordGroupListProps {
+    groups: NormalizedKeywordGroup<string>[];
+    context?: SentenceContext;
+    /** Called with the keyword's flat index (across all groups) */
+    getOptionProps: (index: number) => Record<string, unknown>;
+    /** Render selected state for a keyword */
+    isSelected?: (keyword: Keyword<string>) => boolean;
+    /** Render disabled state for a keyword */
+    isDisabled?: (keyword: Keyword<string>) => boolean;
+}
+/**
+ * Render grouped keywords with labels, prefixes, and layout variants.
+ *
+ * Flat keyword index is computed by summing keywords in prior groups,
+ * so keyboard navigation stays linear across all groups.
+ */
+export declare function KeywordGroupList({ groups, context, getOptionProps, isSelected, isDisabled, }: KeywordGroupListProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=KeywordGroupList.d.ts.map

package/dist/src/components/popups/KeywordGroupList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeywordGroupList.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/KeywordGroupList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAG/E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,+DAA+D;IAC/D,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC;IACnD,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,GACX,EAAE,qBAAqB,2CAwDvB"}

package/dist/src/components/popups/KeywordOrExpressionPopup.d.ts

@@ -0,0 +1,30 @@
+/**
+ * KeywordOrExpressionPopup — keyword pills + text/numeric input.
+ *
+ * Three layout modes:
+ * 1. Always-on expression (no trigger): keywords + expression visible simultaneously.
+ * 2. Trigger-gated, keyword mode: keywords + trigger pill, no expression input.
+ * 3. Trigger-gated, expression mode: keywords (escape hatches) + expression input.
+ *
+ * Text: keyword click or Enter submits. Valid input auto-saves on close.
+ * Numeric: stepper buttons submit immediately. Manual entry validates.
+ */
+import type { ExpressionMode, Keyword, SentenceContext } from '../../core/types';
+import type { NormalizedKeywordGroup } from '../../domains/normalize-keywords';
+export interface KeywordOrExpressionPopupProps {
+    keywords: Keyword<string>[];
+    keywordGroups?: NormalizedKeywordGroup<string>[];
+    value: string;
+    expressionMode?: ExpressionMode<string>;
+    /** Is the chip currently in trigger-gated expression mode? */
+    expressionActive?: boolean;
+    /** Label for the trigger pill (absent = always-on expression). */
+    triggerLabel?: string;
+    /** Sentence context for resolving dynamic prefix/suffix. */
+    context?: SentenceContext;
+    maxLength?: number;
+    onSelect: (value: string | symbol) => void;
+    onClose: () => void;
+}
+export declare function KeywordOrExpressionPopup({ keywords, keywordGroups, value, expressionMode, expressionActive, triggerLabel, context, maxLength, onSelect, onClose, }: KeywordOrExpressionPopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=KeywordOrExpressionPopup.d.ts.map

package/dist/src/components/popups/KeywordOrExpressionPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeywordOrExpressionPopup.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/KeywordOrExpressionPopup.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAO/E,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAMD,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,aAAa,EACb,KAAK,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,GACR,EAAE,6BAA6B,2CAuN/B"}

package/dist/src/components/popups/MultiSelectPopup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MultiSelectPopup — toggle grid with optional group keyword shortcuts.
+ *
+ * Unlike enum/KOE popups, this popup stays open during selection.
+ * The user toggles options freely and closes via outside-click,
+ * Escape, or trigger re-click.
+ */
+import type { Keyword } from '../../core/types';
+import type { NormalizedKeywordGroup } from '../../domains/normalize-keywords';
+export interface MultiSelectPopupProps {
+    options: Keyword<string>[];
+    optionGroups?: NormalizedKeywordGroup<string>[];
+    keywords: Keyword<string[]>[];
+    value: string[];
+    maxSelections?: number;
+    onSelect: (value: string[]) => void;
+    onClose?: () => void;
+}
+export declare function MultiSelectPopup({ options, optionGroups, keywords, value, maxSelections, onSelect, onClose, }: MultiSelectPopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MultiSelectPopup.d.ts.map

package/dist/src/components/popups/MultiSelectPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiSelectPopup.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/MultiSelectPopup.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAM/E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IAChD,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,aAAa,EACb,QAAQ,EACR,OAAO,GACR,EAAE,qBAAqB,2CA2GvB"}

package/dist/src/components/popups/NumericInput.d.ts

@@ -0,0 +1,16 @@
+/**
+ * NumericInput — number stepper with +/- buttons.
+ *
+ * Renders: [ − ]  value  [ + ]
+ * Submits on change (no Enter required — each click/edit is a selection).
+ */
+export interface NumericInputProps {
+    value: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    onSelect: (value: string) => void;
+    onSubmit?: () => void;
+}
+export declare function NumericInput({ value, min, max, step, onSelect, onSubmit, }: NumericInputProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NumericInput.d.ts.map

package/dist/src/components/popups/NumericInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericInput.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/NumericInput.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,iBAAiB,2CAqEnB"}

package/dist/src/components/popups/ReferencePopup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ReferencePopup — navigation/search popup for reference domains.
+ *
+ * Supports hierarchical tree navigation (breadcrumb + drill-in) and
+ * flat list search. Items can be selectable, drillable, or both.
+ * Handles sync and async data sources transparently.
+ */
+import type { Keyword } from '../../core/types';
+import type { ReferenceSource } from '../../domains/reference';
+export interface ReferencePopupProps {
+    source: ReferenceSource;
+    keywords: Keyword<string>[];
+    value: string;
+    onSelect: (value: string) => void;
+    onClose: () => void;
+    /** Write-through to the domain's display cache */
+    displayCache: Map<string, string>;
+}
+export declare function ReferencePopup({ source, keywords, value, onSelect, onClose, displayCache, }: ReferencePopupProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ReferencePopup.d.ts.map

package/dist/src/components/popups/ReferencePopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferencePopup.d.ts","sourceRoot":"","sources":["../../../../src/components/popups/ReferencePopup.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG9E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAKD,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAO,EACP,YAAY,GACb,EAAE,mBAAmB,2CAwVrB"}

package/dist/src/core/actions/set-chip-value.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SET_CHIP_VALUE action — updates a chip's value, revalidates, recomputes display.
+ *
+ * When the chip's clause produces context, triggers context propagation
+ * to evaluate contingent clauses. See contingency-engine.md §4.
+ */
+import type { SentenceStore } from '../store';
+/** Set a chip's value. */
+export interface SetChipValueAction {
+    type: 'SET_CHIP_VALUE';
+    clauseId: string;
+    chipId: string;
+    value: unknown;
+}
+/** Handle SET_CHIP_VALUE: update chip, cascade validity, propagate context. */
+export declare function handleSetChipValue(store: SentenceStore, action: SetChipValueAction): SentenceStore;
+//# sourceMappingURL=set-chip-value.d.ts.map

package/dist/src/core/actions/set-chip-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-chip-value.d.ts","sourceRoot":"","sources":["../../../../src/core/actions/set-chip-value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAM9C,0BAA0B;AAC1B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,kBAAkB,GACzB,aAAa,CAyFf"}

package/dist/src/core/actions/set-context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SET_CONTEXT action — updates scoped context and evaluates contingent clauses.
+ *
+ * Delegates to the contingency engine's evaluateContingency function
+ * for presence evaluation, domain reconfiguration, and cascade.
+ * See contingency-engine.md §3.
+ */
+import type { SentenceContext } from '../types';
+import type { SentenceStore } from '../store';
+/** Update scoped context values for a clause. */
+export interface SetContextAction {
+    type: 'SET_CONTEXT';
+    clauseId: string;
+    values: SentenceContext;
+}
+/** Handle SET_CONTEXT: evaluate contingency and cascade. */
+export declare function handleSetContext(store: SentenceStore, action: SetContextAction): SentenceStore;
+//# sourceMappingURL=set-context.d.ts.map

package/dist/src/core/actions/set-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-context.d.ts","sourceRoot":"","sources":["../../../../src/core/actions/set-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,gBAAgB,GACvB,aAAa,CAEf"}

package/dist/src/core/actions/set-display-value.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SET_DISPLAY_VALUE action — updates a display chip with a new value from its source.
+ *
+ * Handles static, derived, remote, and external display sources.
+ * Updates value, displayValue, loading, error, and lastUpdated on ChipState.
+ */
+import type { SentenceStore } from '../store';
+/** Update a display chip's value from its source. */
+export interface SetDisplayValueAction {
+    type: 'SET_DISPLAY_VALUE';
+    chipId: string;
+    value: unknown;
+    loading?: boolean;
+    error?: string;
+}
+/** Handle SET_DISPLAY_VALUE — write value + display state into the chip. */
+export declare function handleSetDisplayValue(store: SentenceStore, action: SetDisplayValueAction): SentenceStore;
+//# sourceMappingURL=set-display-value.d.ts.map

package/dist/src/core/actions/set-display-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-display-value.d.ts","sourceRoot":"","sources":["../../../../src/core/actions/set-display-value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,qBAAqB,GAC5B,aAAa,CAmDf"}

package/dist/src/core/actions/toggle-clause.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TOGGLE_CLAUSE action — activates or deactivates an optional clause.
+ *
+ * Only affects user-controlled activation, never engine-controlled presence.
+ * See contingency-engine.md §2.
+ */
+import type { SentenceStore } from '../store';
+/** Toggle an optional clause's active state. */
+export interface ToggleClauseAction {
+    type: 'TOGGLE_CLAUSE';
+    clauseId: string;
+}
+/** Handle TOGGLE_CLAUSE: flip active, cascade validity. */
+export declare function handleToggleClause(store: SentenceStore, action: ToggleClauseAction): SentenceStore;
+//# sourceMappingURL=toggle-clause.d.ts.map

package/dist/src/core/actions/toggle-clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-clause.d.ts","sourceRoot":"","sources":["../../../../src/core/actions/toggle-clause.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,kBAAkB,GACzB,aAAa,CAmBf"}

package/dist/src/core/context-resolution.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Context resolution — tree-scoped context propagation for the contingency engine.
+ *
+ * Context propagates down the contingency tree. A producing clause writes
+ * context visible to its contingent descendants. A consuming clause walks
+ * up its contingency chain to find the nearest ancestor producer.
+ *
+ * See chipper-architecture.md §1 (Sentence Context) and
+ * contingency-engine.md §3 (Context Propagation).
+ */
+import type { SentenceContext, ClauseDefinition } from './types';
+import type { ChipState, ContextScope } from './state';
+import type { SentenceStore } from './store';
+/**
+ * Build a clause's full context by merging ancestor context with its own productions.
+ * Used for evaluating segment predicates (both chip and text visibility).
+ */
+export declare function buildClauseContext(clauseId: string, clauseDef: ClauseDefinition, clauseChips: Record<string, ChipState>, clauseById: Map<string, ClauseDefinition>, contexts: ContextScope[]): SentenceContext;
+/**
+ * Resolve the full context visible to a clause by walking up the contingency chain.
+ * Nearest ancestor's values win — keys already resolved are not overwritten.
+ */
+export declare function resolveContext(clauseId: string, clauseById: Map<string, ClauseDefinition>, contexts: ContextScope[]): SentenceContext;
+/**
+ * Evaluate contingency for all clauses contingent on a given clause.
+ * Updates presence, applies domain reconfiguration, revalidates chips,
+ * and cascades through subtrees.
+ */
+export declare function evaluateContingency(store: SentenceStore, clauseId: string, values: SentenceContext): SentenceStore;
+/**
+ * Run initial context evaluation after state initialization.
+ * For each clause that produces context, compute context from default
+ * chip values and evaluate contingent clauses.
+ */
+export declare function runInitialContextPass(store: SentenceStore): SentenceStore;
+//# sourceMappingURL=context-resolution.d.ts.map

package/dist/src/core/context-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolution.d.ts","sourceRoot":"","sources":["../../../src/core/context-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAsB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACtC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACzC,QAAQ,EAAE,YAAY,EAAE,GACvB,eAAe,CASjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACzC,QAAQ,EAAE,YAAY,EAAE,GACvB,eAAe,CAuBjB;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACtB,aAAa,CA2Hf;AA8ED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAiBzE"}

package/dist/src/core/initialize.d.ts

@@ -0,0 +1,43 @@
+/**
+ * State initialization — creates a SentenceStore from a SentenceDefinition.
+ *
+ * Resolves each chip's domain from the palette, creates initial ChipState
+ * with defaultValue, and derives clause/sentence validity. Runs an initial
+ * context evaluation pass so contingent clauses start in the correct state.
+ */
+import type { Domain, SentenceContext, SentenceDefinition } from './types';
+import type { ChipState, ClauseState } from './state';
+import type { SentenceStore } from './store';
+/** Compute displayValue from a domain and value. Context enables dynamic display. */
+export declare function computeDisplayValue(domain: Domain, value: unknown, isValid: boolean, context?: SentenceContext): string;
+/** Derive clause validity: all visible chips must be valid. */
+export declare function computeClauseValidity(chips: Record<string, ChipState>, visibleChips?: string[]): boolean;
+/** Derive sentence validity: all present+active clauses must be valid. */
+export declare function computeSentenceValidity(clauses: Record<string, ClauseState>): boolean;
+/**
+ * Build context values from a clause's chips using its contextProductions mapping.
+ */
+/**
+ * Build context values from a clause's chips using its contextProductions mapping.
+ * Hidden chips (not in visibleChips) are excluded from context production.
+ */
+export declare function buildContextFromChips(contextProductions: Record<string, string>, clauseState: ClauseState): SentenceContext;
+/**
+ * Evaluate which chips in a clause are visible based on segment presence predicates.
+ * Returns undefined if all chips are unconditionally visible (no predicates).
+ */
+export declare function evaluateVisibleChips(segments: import('./types').ClauseSegment[], context: SentenceContext): string[] | undefined;
+/**
+ * Create a SentenceStore from a sentence definition.
+ *
+ * Resolves domains from the palette, initializes chip state with
+ * default values (or initial values if provided), and derives
+ * clause/sentence validity. Runs an initial context pass so contingent
+ * clauses reflect the starting values.
+ *
+ * @param initialValues — Optional saved data to overlay. Keys are chip IDs
+ *   with their values. `__active` maps optional clause IDs to activation state.
+ *   `__expressionMode` maps chip IDs to expression mode flags.
+ */
+export declare function initializeSentenceState(definition: SentenceDefinition, initialValues?: Record<string, unknown>): SentenceStore;
+//# sourceMappingURL=initialize.d.ts.map

package/dist/src/core/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/core/initialize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAW,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,SAAS,CAAC;AAkB9D,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAKR;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAMT;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAErF;AAED;;GAEG;AACH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,WAAW,EAAE,WAAW,GACvB,eAAe,CAUjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,SAAS,EAAE,aAAa,EAAE,EAC3C,OAAO,EAAE,eAAe,GACvB,MAAM,EAAE,GAAG,SAAS,CAkBtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,aAAa,CAwEf"}

package/dist/src/core/mode-switching.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mode-switching primitives.
+ *
+ * A trigger keyword enters expression mode instead of storing a value.
+ * The popup sends TRIGGER_SENTINEL via SET_CHIP_VALUE; the reducer
+ * detects it and substitutes the expression default.
+ */
+/** Sentinel value dispatched by the popup when the user clicks a trigger keyword. */
+export declare const TRIGGER_SENTINEL: unique symbol;
+//# sourceMappingURL=mode-switching.d.ts.map