@persona/design-system 0.8.0 → 0.8.1

package/dist/useChainAtCursor.d.mts

@@ -0,0 +1,87 @@
+import { t as ASTNode } from "./types-BYRTxB0a.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-Bl-qzgrr.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BVkTI8MX.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-D8SGRGba.mjs";
+import { u as ValueType } from "./types-Cs6CdZCO.mjs";
+import { n as useChain } from "./useChain-CEsXE2Bx.mjs";
+
+//#region components/SmartTextInput/useChainAtCursor.d.ts
+/**
+ * Extracts the chain context at the cursor position in a single pass.
+ *
+ * Returns:
+ *   - `chainString`: dot-joined names of all identifier links that end strictly
+ *     before the cursor. The link at or containing the cursor is excluded so
+ *     that `useChain` resolves the PARENT's options.
+ *     When `assumeOnNextLink` is true, the link at the cursor IS included so
+ *     that `useChain` resolves that link's children instead.
+ *   - `partialQuery`: partial text typed for the link at the cursor, used to
+ *     filter the dropdown. Always '' when `assumeOnNextLink` is true.
+ *
+ * Examples (cursor position denoted by |, normal mode):
+ *   `trigger.|`      → { chainString: "trigger",      partialQuery: "" }
+ *   `trigger.case.|` → { chainString: "trigger.case", partialQuery: "" }
+ *   `trigger.cas|e`  → { chainString: "trigger",      partialQuery: "cas" }
+ *   `trigger.case|`  → { chainString: "trigger",      partialQuery: "case" }
+ *   `trigger|`       → { chainString: "",             partialQuery: "trigger" }
+ *   `tri|gger`       → { chainString: "",             partialQuery: "tri" }
+ */
+declare function extractChainContextAtCursor(tree: ASTNode, cursorIdx: number | null, valueType: ValueType, assumeOnNextLink: boolean): {
+  chainString: string;
+  partialQuery: string;
+};
+/**
+ * Resolves schema-driven method chain options for the current cursor
+ * position in a SmartTextInput.
+ *
+ * Wraps `useChain` with cursor-aware chain extraction: it reads the AST to
+ * determine which chain context the cursor is in (inside `{{...}}`, inside
+ * `${...}`, or a bare top-level chain), derives the partial chain string
+ * representing all links before the cursor, and returns the next possible
+ * options from the schema.
+ *
+ * When `chainConfig` is absent, returns an empty options list.
+ */
+declare const useChainAtCursor: ({
+  value,
+  onUpdateChain,
+  tree,
+  cursorIdx,
+  valueType,
+  assumeOnNextLink,
+  useChainRootDescriptions,
+  chainRoots,
+  primitivesSchema,
+  platformObjectJsonSchema,
+  defaultPrimitiveUtilities,
+  codeChainFunctionSchema,
+  getSchemaOptionsOverride,
+  sortOptionsBy
+}: {
+  value: string;
+  onUpdateChain: (value: string, newCursorIdx: number) => void;
+  tree: ASTNode;
+  cursorIdx: number | null;
+  valueType: ValueType;
+  useChainRootDescriptions: boolean;
+  chainRoots: ChainRoot[];
+  primitivesSchema: "none" | "default" | ObjectSchemaMap;
+  platformObjectJsonSchema: ObjectSchemaMap;
+  defaultPrimitiveUtilities: ObjectSchemaMap;
+  codeChainFunctionSchema?: Record<string, Record<string, FunctionJsonSchema>>;
+  getSchemaOptionsOverride?: Parameters<typeof useChain>[0]["getSchemaOptionsOverride"];
+  sortOptionsBy?: (option: PossibleChainSchema) => number;
+  assumeOnNextLink?: boolean;
+}) => [currentChain: Chain, {
+  appendChain: (newNodes: MethodChainNode[], meta?: {
+    isFunction?: boolean;
+  }) => void;
+  insertChainAtCursor: (nodes: MethodChainNode[]) => void;
+  nextPossibleChains: PossibleChainSchema[];
+  resolveSchema: (chainStr: string) => JsonSchema | null;
+  currentSchema: JsonSchema | null;
+  query: string;
+}];
+//#endregion
+export { extractChainContextAtCursor, useChainAtCursor };
+//# sourceMappingURL=useChainAtCursor.d.mts.map

package/dist/useCodeChainFunctionPanel.d.mts

@@ -0,0 +1,26 @@
+import { o as OpenCodeChainFunctionPanel, t as CodeChainFunctionPanelRenderProps } from "./types-Cs6CdZCO.mjs";
+import { ReactNode } from "react";
+
+//#region components/SmartTextInput/useCodeChainFunctionPanel.d.ts
+/**
+ * Manages opening and rendering the CCF editing panel.
+ */
+declare const useCodeChainFunctionPanel: ({
+  enabled,
+  canCreate,
+  renderPanel: renderPanelContent,
+  onOpen,
+  onSaveNew
+}: {
+  enabled: boolean;
+  canCreate: boolean;
+  renderPanel?: (props: CodeChainFunctionPanelRenderProps) => ReactNode;
+  onOpen: () => void;
+  onSaveNew: (savedName: string) => void;
+}) => {
+  renderPanel: () => ReactNode;
+  openPanel: OpenCodeChainFunctionPanel | undefined;
+};
+//#endregion
+export { useCodeChainFunctionPanel };
+//# sourceMappingURL=useCodeChainFunctionPanel.d.mts.map

package/dist/useComboboxFooterAction.d.mts

@@ -1,4 +1,4 @@
-import { p as FooterAction } from "./ComboboxBase-BMCY6O7Y.mjs";
+import { p as FooterAction } from "./ComboboxBase-CtNrsPO9.mjs";
 import { KeyboardEvent } from "react";
 
 //#region components/Combobox/useComboboxFooterAction.d.ts

package/dist/{useFilterStateV2-CW6eght1.d.mts → useFilterStateV2-DoJ9lyJx.d.mts}

@@ -1,5 +1,5 @@
-import { l as FilterRule, n as CompoundExpression, p as FilterStateV2 } from "./types-C4WUSW3e.mjs";
-import { t as FieldRegistry } from "./FieldRegistry-0LmSQ-jc.mjs";
+import { l as FilterRule, n as CompoundExpression, p as FilterStateV2 } from "./types-Dy3lZv9z.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-DqO8HiYb.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/useFilterStateV2.d.ts
 interface UseFilterStateV2Options {
@@ -90,4 +90,4 @@ interface UseFilterStateV2Result {
 declare function useFilterStateV2(options: UseFilterStateV2Options): UseFilterStateV2Result;
 //#endregion
 export { UseFilterStateV2Result as n, useFilterStateV2 as r, UseFilterStateV2Options as t };
-//# sourceMappingURL=useFilterStateV2-CW6eght1.d.mts.map
+//# sourceMappingURL=useFilterStateV2-DoJ9lyJx.d.mts.map

package/dist/useFilterStateV2.d.mts

@@ -1,2 +1,2 @@
-import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-CW6eght1.mjs";
+import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-DoJ9lyJx.mjs";
 export { UseFilterStateV2Options, UseFilterStateV2Result, useFilterStateV2 };

package/dist/{useFormField-XezSxho_.mjs → useFormField-BAmkdxtA.mjs}

@@ -1,4 +1,4 @@
-import { n as useFormGroup } from "./useFormGroup-C7Cax8zO.mjs";
+import { n as useFormGroup } from "./useFormGroup-BZayb9fZ.mjs";
 import { createContext, useContext } from "react";
 //#region components/FormControl/useFormField.ts
 const FormControlContext = createContext({});
@@ -23,4 +23,4 @@ const useFormField = (props) => {
 //#endregion
 export { useFormField as n, FormControlContext as t };
 
-//# sourceMappingURL=useFormField-XezSxho_.mjs.map
+//# sourceMappingURL=useFormField-BAmkdxtA.mjs.map

package/dist/{useFormField-XezSxho_.mjs.map → useFormField-BAmkdxtA.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormField-XezSxho_.mjs","names":[],"sources":["../components/FormControl/useFormField.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport useFormGroup from 'design-system/components/ConfigFormGroup/useFormGroup';\nimport type ErrorProps from 'design-system/types/ErrorProps';\n\nexport interface FormControlContextProps extends ErrorProps {\n  inputId?: string;\n  helperTextId?: string;\n  errorTextId?: string;\n  warningTextId?: string;\n  labelId?: string;\n  disabled?: boolean;\n  required?: boolean;\n  maxLength?: number;\n  configField?: boolean;\n}\n\nexport const FormControlContext = createContext<FormControlContextProps>({});\n\nconst useFormField = (props: Partial<FormControlContextProps>) => {\n  const group = useFormGroup();\n  const field = useContext(FormControlContext);\n\n  const inputId = props.inputId ?? field.inputId;\n\n  return {\n    configField: props.configField ?? group.configField,\n    hasError: props.hasError ?? field.hasError,\n    hasWarning: props.hasWarning ?? field.hasWarning,\n    inputId,\n    helperTextId: props.helperTextId ?? field.helperTextId,\n    errorTextId: props.errorTextId ?? field.errorTextId,\n    warningTextId: props.warningTextId ?? field.warningTextId,\n    labelId: props.labelId ?? field.labelId,\n    disabled: props.disabled ?? field.disabled,\n    required: props.required ?? field.required,\n    maxLength: props.maxLength ?? field.maxLength,\n  };\n};\n\nexport default useFormField;\n"],"mappings":";;;AAiBA,MAAa,qBAAqB,cAAuC,EAAE,CAAC;AAE5E,MAAM,gBAAgB,UAA4C;CAChE,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,WAAW,mBAAmB;CAE5C,MAAM,UAAU,MAAM,WAAW,MAAM;AAEvC,QAAO;EACL,aAAa,MAAM,eAAe,MAAM;EACxC,UAAU,MAAM,YAAY,MAAM;EAClC,YAAY,MAAM,cAAc,MAAM;EACtC;EACA,cAAc,MAAM,gBAAgB,MAAM;EAC1C,aAAa,MAAM,eAAe,MAAM;EACxC,eAAe,MAAM,iBAAiB,MAAM;EAC5C,SAAS,MAAM,WAAW,MAAM;EAChC,UAAU,MAAM,YAAY,MAAM;EAClC,UAAU,MAAM,YAAY,MAAM;EAClC,WAAW,MAAM,aAAa,MAAM;EACrC"}
+{"version":3,"file":"useFormField-BAmkdxtA.mjs","names":[],"sources":["../components/FormControl/useFormField.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport useFormGroup from 'design-system/components/ConfigFormGroup/useFormGroup';\nimport type ErrorProps from 'design-system/types/ErrorProps';\n\nexport interface FormControlContextProps extends ErrorProps {\n  inputId?: string;\n  helperTextId?: string;\n  errorTextId?: string;\n  warningTextId?: string;\n  labelId?: string;\n  disabled?: boolean;\n  required?: boolean;\n  maxLength?: number;\n  configField?: boolean;\n}\n\nexport const FormControlContext = createContext<FormControlContextProps>({});\n\nconst useFormField = (props: Partial<FormControlContextProps>) => {\n  const group = useFormGroup();\n  const field = useContext(FormControlContext);\n\n  const inputId = props.inputId ?? field.inputId;\n\n  return {\n    configField: props.configField ?? group.configField,\n    hasError: props.hasError ?? field.hasError,\n    hasWarning: props.hasWarning ?? field.hasWarning,\n    inputId,\n    helperTextId: props.helperTextId ?? field.helperTextId,\n    errorTextId: props.errorTextId ?? field.errorTextId,\n    warningTextId: props.warningTextId ?? field.warningTextId,\n    labelId: props.labelId ?? field.labelId,\n    disabled: props.disabled ?? field.disabled,\n    required: props.required ?? field.required,\n    maxLength: props.maxLength ?? field.maxLength,\n  };\n};\n\nexport default useFormField;\n"],"mappings":";;;AAiBA,MAAa,qBAAqB,cAAuC,EAAE,CAAC;AAE5E,MAAM,gBAAgB,UAA4C;CAChE,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,WAAW,mBAAmB;CAE5C,MAAM,UAAU,MAAM,WAAW,MAAM;AAEvC,QAAO;EACL,aAAa,MAAM,eAAe,MAAM;EACxC,UAAU,MAAM,YAAY,MAAM;EAClC,YAAY,MAAM,cAAc,MAAM;EACtC;EACA,cAAc,MAAM,gBAAgB,MAAM;EAC1C,aAAa,MAAM,eAAe,MAAM;EACxC,eAAe,MAAM,iBAAiB,MAAM;EAC5C,SAAS,MAAM,WAAW,MAAM;EAChC,UAAU,MAAM,YAAY,MAAM;EAClC,UAAU,MAAM,YAAY,MAAM;EAClC,WAAW,MAAM,aAAa,MAAM;EACrC"}

package/dist/{useFormField-CLRZkUZt.d.mts → useFormField-BtnAYcHV.d.mts}

@@ -1,4 +1,4 @@
-import { t as ErrorProps } from "./ErrorProps-B8-Mqf1W.mjs";
+import { t as ErrorProps } from "./ErrorProps-6dRdJ4QQ.mjs";
 import * as _$react from "react";
 
 //#region components/FormControl/useFormField.d.ts
@@ -29,4 +29,4 @@ declare const useFormField: (props: Partial<FormControlContextProps>) => {
 };
 //#endregion
 export { FormControlContextProps as n, useFormField as r, FormControlContext as t };
-//# sourceMappingURL=useFormField-CLRZkUZt.d.mts.map
+//# sourceMappingURL=useFormField-BtnAYcHV.d.mts.map

package/dist/useFormField.d.mts

@@ -1,2 +1,2 @@
-import { n as FormControlContextProps, r as useFormField, t as FormControlContext } from "./useFormField-CLRZkUZt.mjs";
+import { n as FormControlContextProps, r as useFormField, t as FormControlContext } from "./useFormField-BtnAYcHV.mjs";
 export { FormControlContext, FormControlContextProps, useFormField as default };

package/dist/{useFormGroup-C7Cax8zO.mjs → useFormGroup-BZayb9fZ.mjs}

@@ -11,4 +11,4 @@ const useFormGroup = (props) => {
 //#endregion
 export { useFormGroup as n, FormGroupContext as t };
 
-//# sourceMappingURL=useFormGroup-C7Cax8zO.mjs.map
+//# sourceMappingURL=useFormGroup-BZayb9fZ.mjs.map

package/dist/{useFormGroup-C7Cax8zO.mjs.map → useFormGroup-BZayb9fZ.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormGroup-C7Cax8zO.mjs","names":[],"sources":["../components/ConfigFormGroup/useFormGroup.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport interface FormGroupContextProps {\n  configField?: boolean;\n  /**\n   * The z-index to use when labels are rendered as tooltips (e.g. when configField is true).\n   */\n  labelTooltipZIndex?: number;\n}\n\nexport const FormGroupContext = createContext<FormGroupContextProps>({});\n\nconst useFormGroup = (props?: Partial<FormGroupContextProps>) => {\n  const field = useContext(FormGroupContext);\n\n  return {\n    configField: props?.configField ?? field.configField,\n    labelTooltipZIndex: props?.labelTooltipZIndex ?? field.labelTooltipZIndex,\n  };\n};\n\nexport default useFormGroup;\n"],"mappings":";;AAUA,MAAa,mBAAmB,cAAqC,EAAE,CAAC;AAExE,MAAM,gBAAgB,UAA2C;CAC/D,MAAM,QAAQ,WAAW,iBAAiB;AAE1C,QAAO;EACL,aAAa,OAAO,eAAe,MAAM;EACzC,oBAAoB,OAAO,sBAAsB,MAAM;EACxD"}
+{"version":3,"file":"useFormGroup-BZayb9fZ.mjs","names":[],"sources":["../components/ConfigFormGroup/useFormGroup.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport interface FormGroupContextProps {\n  configField?: boolean;\n  /**\n   * The z-index to use when labels are rendered as tooltips (e.g. when configField is true).\n   */\n  labelTooltipZIndex?: number;\n}\n\nexport const FormGroupContext = createContext<FormGroupContextProps>({});\n\nconst useFormGroup = (props?: Partial<FormGroupContextProps>) => {\n  const field = useContext(FormGroupContext);\n\n  return {\n    configField: props?.configField ?? field.configField,\n    labelTooltipZIndex: props?.labelTooltipZIndex ?? field.labelTooltipZIndex,\n  };\n};\n\nexport default useFormGroup;\n"],"mappings":";;AAUA,MAAa,mBAAmB,cAAqC,EAAE,CAAC;AAExE,MAAM,gBAAgB,UAA2C;CAC/D,MAAM,QAAQ,WAAW,iBAAiB;AAE1C,QAAO;EACL,aAAa,OAAO,eAAe,MAAM;EACzC,oBAAoB,OAAO,sBAAsB,MAAM;EACxD"}

package/dist/{useLocationPathname-DH5Tdq5X.d.mts → useLocationPathname-pLyLOrAi.d.mts}

@@ -2,4 +2,4 @@
 declare const usePathname: () => string;
 //#endregion
 export { usePathname as t };
-//# sourceMappingURL=useLocationPathname-DH5Tdq5X.d.mts.map
+//# sourceMappingURL=useLocationPathname-pLyLOrAi.d.mts.map

package/dist/useLocationPathname.d.mts

@@ -1,2 +1,2 @@
-import { t as usePathname } from "./useLocationPathname-DH5Tdq5X.mjs";
+import { t as usePathname } from "./useLocationPathname-pLyLOrAi.mjs";
 export { usePathname };

package/dist/{useTableBoxDragAndDrop-Da4TiYBT.d.mts → useTableBoxDragAndDrop-wjc_LCpC.d.mts}

@@ -66,4 +66,4 @@ declare const useTableBoxDragAndDrop: <T extends object>({
 }: UseTableBoxDragAndDropArgs<T>) => UseTableBoxDragAndDropResult;
 //#endregion
 export { ReorderConfig as n, useTableBoxDragAndDrop as r, DragDirection as t };
-//# sourceMappingURL=useTableBoxDragAndDrop-Da4TiYBT.d.mts.map
+//# sourceMappingURL=useTableBoxDragAndDrop-wjc_LCpC.d.mts.map

package/dist/useTableBoxDragAndDrop.d.mts

@@ -1,2 +1,2 @@
-import { n as ReorderConfig, r as useTableBoxDragAndDrop, t as DragDirection } from "./useTableBoxDragAndDrop-Da4TiYBT.mjs";
+import { n as ReorderConfig, r as useTableBoxDragAndDrop, t as DragDirection } from "./useTableBoxDragAndDrop-wjc_LCpC.mjs";
 export { DragDirection, ReorderConfig, useTableBoxDragAndDrop };

package/dist/useTruncation.d.mts

@@ -1,4 +1,4 @@
-import { i as ComboboxOption } from "./ComboboxBase-BMCY6O7Y.mjs";
+import { i as ComboboxOption } from "./ComboboxBase-CtNrsPO9.mjs";
 import { MutableRefObject, RefObject } from "react";
 
 //#region components/Combobox/useTruncation.d.ts

package/dist/{utilities-DcsbI71T.d.mts → utilities-DL18UdPs.d.mts}

@@ -6,4 +6,4 @@
 type RequireOneOf<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & { [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>> }[Keys];
 //#endregion
 export { RequireOneOf as t };
-//# sourceMappingURL=utilities-DcsbI71T.d.mts.map
+//# sourceMappingURL=utilities-DL18UdPs.d.mts.map

package/dist/utilities.d.mts

@@ -1,2 +1,2 @@
-import { t as RequireOneOf } from "./utilities-DcsbI71T.mjs";
+import { t as RequireOneOf } from "./utilities-DL18UdPs.mjs";
 export { RequireOneOf };

package/dist/utils/storybook.mjs

@@ -1,4 +1,4 @@
-import { n as Stack } from "../Stack-Bkn0TUDe.mjs";
+import { n as Stack } from "../Stack-CEPzs4Pb.mjs";
 import { jsx } from "react/jsx-runtime";
 //#region utils/storybook.tsx
 const withStack = (Story) => {

package/dist/utils/testing.d.mts

@@ -1,4 +1,4 @@
-import { n as RouterAdapter } from "../types-CkpixGWr.mjs";
+import { n as RouterAdapter } from "../types-D1DijcJv.mjs";
 import { ReactElement } from "react";
 import * as _$_testing_library_react0 from "@testing-library/react";
 import { RenderOptions, screen } from "@testing-library/react";

package/dist/utils.d.mts

@@ -1,4 +1,4 @@
-import { u as FilterRuleValue } from "./types-C4WUSW3e.mjs";
+import { u as FilterRuleValue } from "./types-Dy3lZv9z.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/value-controls/utils.d.ts
 /**

package/dist/utils4.d.mts

@@ -0,0 +1,111 @@
+import { n as ASTChain } from "./types-M-rsm1Km.mjs";
+import { t as ASTNode } from "./types-BYRTxB0a.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BVkTI8MX.mjs";
+import { t as ChainRoot } from "./chainTypes-D8SGRGba.mjs";
+import { a as Mode, r as FunctionAtCursor, u as ValueType } from "./types-Cs6CdZCO.mjs";
+import { RefObject } from "react";
+
+//#region components/SmartTextInput/utils.d.ts
+declare const safeCursorIdx: (cursorIdx: number | null, ast: ASTNode) => number;
+/**
+ * Returns true if the input is allowed to transition to the given value type based on allowed type.
+ * When allowedValueType is set, transitions to a different type are prohibited.
+ */
+declare function canTransitionToValueType(valueType: ValueType, allowedValueType: ValueType | undefined): boolean;
+/**
+ * Returns true if the given interpolation mode (handlebars or code) is allowed.
+ * When allowedValueType is 'method-chain', interpolation modes are never allowed.
+ */
+declare function isInterpolationModeAllowed(mode: Mode.MethodChain | Mode.Code, allowedValueType: ValueType | undefined, allowedInterpolationModes: (Mode.MethodChain | Mode.Code)[] | undefined): boolean;
+/**
+ * Returns true if the input can exit method-chain value type back to interpolation.
+ * Requires an empty value and that the allowed value type is interpolation.
+ */
+declare function canExitToInterpolation(value: string, allowedValueType: ValueType | undefined): boolean;
+/**
+ * Apply from element scrollLeft to the to element scrollLeft
+ */
+declare const syncScroll: (from: RefObject<HTMLElement>, to: RefObject<HTMLElement>) => void;
+/**
+ * Scroll the input so the cursor at cursorIdx is visible, then sync the overlay.
+ *
+ * overflow:hidden on the StyledInput prevents the browser from auto-scrolling to
+ * the cursor when setSelectionRange is called programmatically. We replicate the
+ * same manual scrollLeft update that handleWheel uses.
+ */
+declare const scrollInputToCursor: (inputRef: RefObject<HTMLInputElement>, cursorIdx: number) => void;
+/**
+ * Returns true if the value is a valid method chain where the root is valid given the passed
+ * accepted chain roots.
+ */
+declare const isChainWithValidRoot: (value: string, chainRoots: ChainRoot[], {
+  onlyAllowSingleLink
+}?: {
+  onlyAllowSingleLink?: boolean;
+}) => boolean;
+/**
+ * Returns the ASTChain node that contains the cursor, or undefined if none.
+ */
+declare function findChainAtCursor(tree: ASTNode, cursorIdx: number | null, valueType: ValueType): ASTChain | undefined;
+/**
+ * Replace the chain string at the cursor position.
+ *
+ * - ValueType.MethodChain: replaces the entire value.
+ * - ValueType.Interpolation: replaces the chain inside the {{...}} or ${...}
+ *   expression the cursor is currently in.
+ *
+ * Returns the new value string and the new cursor position (end of inserted chain).
+ */
+declare const replaceChainAtCursor: (value: string, valueType: ValueType, cursorIdx: number | null, tree: ASTNode, newChainString: string) => {
+  newValue: string;
+  newCursorIdx: number;
+};
+/**
+ * Returns context about a method chain function whenever the cursor falls anywhere within
+ * the function node's span (name, parens, or params).
+ */
+declare function getFunctionAtCursor(tree: ASTNode, cursorIdx: number | null, valueType: ValueType): FunctionAtCursor | null;
+/**
+ * Returns true if there is a CustomFunction node that starts at the given position.
+ * Used to detect clicks on custom code function spans.
+ */
+declare function isCustomFunctionAtStart(tree: ASTNode, position: number): boolean;
+/**
+ * Returns true when the cursor sits immediately after a function call's closing paren
+ * (e.g. cursor at the `|` in `accounts.filter(x)|`). Used to derive assumeOnNextLink
+ * from cursor position rather than relying solely on state.
+ */
+declare function isCursorAfterFunctionClose(tree: ASTNode, cursorIdx: number | null, valueType: ValueType): boolean;
+/**
+ * Return the current Mode of the input. The mode determines what is valid syntax.
+ */
+declare const getMode: (tree: ASTNode, valueType: ValueType, cursorIdx: number | null) => Mode;
+/**
+ * Determine if the cursor is strictly between chars of a delimiter token (like `{{`). In this
+ * state we want to hide the popover.
+ */
+declare const isCursorInExpressionToken: (tree: ASTNode, cursorIdx: number | null, valueType: ValueType) => boolean;
+/**
+ * When the user selects a chain option that already exists at the cursor position
+ * (e.g. confirming "page_number" while the value is "accounts.page_number(#1)", or
+ * confirming "accounts" while the cursor is inside "accounts.id"), returns the cursor
+ * position to move to rather than replacing the value via appendChain (which would
+ * discard existing parameters or suffixes after the link).
+ *
+ * Returns null when the link is not already present — caller should appendChain instead.
+ *
+ * Note: options always carry Identifier chain nodes (appendedMethodChain uses strings),
+ * so `isFunction` is derived from the schema rather than chain.type.
+ */
+declare const getConfirmLinkCursorPos: (tree: ASTNode, valueType: ValueType, currentChain: Chain, chain: MethodChainNode, schema: object | null | undefined, cursorIdx: number | null) => number | null;
+/**
+ * Matching function for filtering chain options given a partially typed option name.
+ *
+ * TODO: Add more sophistication here (e.g. fuzzy matching, etc.)
+ */
+declare const isQueryMatch: (query: string, chain: {
+  property: string;
+}) => boolean;
+//#endregion
+export { canExitToInterpolation, canTransitionToValueType, findChainAtCursor, getConfirmLinkCursorPos, getFunctionAtCursor, getMode, isChainWithValidRoot, isCursorAfterFunctionClose, isCursorInExpressionToken, isCustomFunctionAtStart, isInterpolationModeAllowed, isQueryMatch, replaceChainAtCursor, safeCursorIdx, scrollInputToCursor, syncScroll };
+//# sourceMappingURL=utils4.d.mts.map

package/dist/{validation-BgwNghi2.d.mts → validation-PeVTwtd-.d.mts}

@@ -1,5 +1,5 @@
-import { l as FilterRule, p as FilterStateV2 } from "./types-C4WUSW3e.mjs";
-import { t as FieldRegistry } from "./FieldRegistry-0LmSQ-jc.mjs";
+import { l as FilterRule, p as FilterStateV2 } from "./types-Dy3lZv9z.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-DqO8HiYb.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/validation.d.ts
 /**
@@ -48,4 +48,4 @@ declare function pruneToRegistry(state: FilterStateV2, registry: FieldRegistry |
 declare function hasCompleteValue(rule: FilterRule, registry: FieldRegistry): boolean;
 //#endregion
 export { isFilterStateV2 as n, pruneToRegistry as r, hasCompleteValue as t };
-//# sourceMappingURL=validation-BgwNghi2.d.mts.map
+//# sourceMappingURL=validation-PeVTwtd-.d.mts.map

package/dist/validation.d.mts

@@ -1,2 +1,2 @@
-import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-BgwNghi2.mjs";
+import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-PeVTwtd-.mjs";
 export { hasCompleteValue, isFilterStateV2, pruneToRegistry };

package/dist/validation2.d.mts

@@ -0,0 +1,64 @@
+import { t as ASTNode } from "./types-BYRTxB0a.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-Bl-qzgrr.mjs";
+import { t as ChainRoot } from "./chainTypes-D8SGRGba.mjs";
+import { u as ValueType } from "./types-Cs6CdZCO.mjs";
+import { ReactNode } from "react";
+
+//#region components/SmartTextInput/validation.d.ts
+type SchemaValidator = (tree: ASTNode) => {
+  start: number;
+  end: number;
+  name: string;
+  message?: string;
+} | null;
+type SchemaError = {
+  start: number;
+  end: number;
+  name: string;
+  message?: string;
+};
+/**
+ * Returns the first chain identifier span that fails schema validation, walking
+ * all chains left-to-right. Once the first invalid link is found, subsequent
+ * links are meaningless and validation stops.
+ */
+declare function findSchemaErrors(tree: ASTNode, rootSchema: JsonSchema, platformObjectJsonSchema?: ObjectSchemaMap, primitiveUtilities?: ObjectSchemaMap): SchemaError | null;
+declare const useSchemaValidator: ({
+  chainRoots,
+  primitivesSchema,
+  platformObjectJsonSchema,
+  defaultPrimitiveUtilities,
+  codeChainFunctionSchema,
+  isLoading
+}: {
+  chainRoots: ChainRoot[];
+  primitivesSchema: "none" | "default" | ObjectSchemaMap;
+  platformObjectJsonSchema: ObjectSchemaMap;
+  defaultPrimitiveUtilities: ObjectSchemaMap;
+  codeChainFunctionSchema?: Record<string, Record<string, FunctionJsonSchema>>;
+  isLoading: boolean;
+}) => SchemaValidator;
+/**
+ * Calls the onValidationChange callback when the input's value is invalid in some manner based
+ * on syntax or schema.
+ */
+declare const useInternalValidation: ({
+  tree,
+  valueIsEmpty,
+  focused,
+  schemaValidator,
+  onValidationChange,
+  value,
+  valueType
+}: {
+  tree: ASTNode;
+  valueIsEmpty: boolean;
+  focused: boolean;
+  schemaValidator: SchemaValidator;
+  onValidationChange?: (errorText: ReactNode | null) => void;
+  value: string;
+  valueType: ValueType;
+}) => void;
+//#endregion
+export { SchemaValidator, findSchemaErrors, useInternalValidation, useSchemaValidator };
+//# sourceMappingURL=validation2.d.mts.map

package/dist/{value-control-resolver-B0HDRxRN.d.mts → value-control-resolver-Cx_wXQFv.d.mts}

@@ -1,4 +1,4 @@
-import { a as FilterField, c as FilterOperator, d as FilterRuleValueChange, l as FilterRule, u as FilterRuleValue } from "./types-C4WUSW3e.mjs";
+import { a as FilterField, c as FilterOperator, d as FilterRuleValueChange, l as FilterRule, u as FilterRuleValue } from "./types-Dy3lZv9z.mjs";
 import { ReactNode } from "react";
 
 //#region components/DataTable/TableControls/FiltersV2/FilterBar/value-control-resolver.d.ts
@@ -46,4 +46,4 @@ type ValueControlResolver = (opts: ResolveValueControlOptions) => ReactNode | un
 declare function resolveValueControl(opts: ResolveValueControlOptions, hostResolver?: ValueControlResolver): ReactNode;
 //#endregion
 export { ValueControlResolver as n, resolveValueControl as r, ResolveValueControlOptions as t };
-//# sourceMappingURL=value-control-resolver-B0HDRxRN.d.mts.map
+//# sourceMappingURL=value-control-resolver-Cx_wXQFv.d.mts.map

package/dist/value-control-resolver.d.mts

@@ -1,2 +1,2 @@
-import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-B0HDRxRN.mjs";
+import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-Cx_wXQFv.mjs";
 export { ResolveValueControlOptions, ValueControlResolver, resolveValueControl };

package/dist/variables/effect.d.mts

@@ -1,4 +1,4 @@
-import { t as MaybeSemanticTheme } from "../semanticColor-DuJCmDrH.mjs";
+import { t as MaybeSemanticTheme } from "../semanticColor-Bg0H3RUL.mjs";
 
 //#region variables/effect.d.ts
 /**

package/dist/variables/semantic.d.mts

@@ -1,2 +1,2 @@
-import { i as semanticLight, n as SemanticTokens, r as semanticDark, t as CssPercentage } from "../semantic-CFMBsuiJ.mjs";
+import { i as semanticLight, n as SemanticTokens, r as semanticDark, t as CssPercentage } from "../semantic-D1661f_6.mjs";
 export { CssPercentage, SemanticTokens, semanticDark, semanticLight };

package/llms.txt

@@ -34,7 +34,7 @@ their own subpaths.
 - Tables: `DataTable` (data views w/ pagination + sorting), `TableBox` (editable form tables), `TableLayout` + `Table`/`TableRow`/`TableCell`/`TableHeaderCell` primitives (components/Table) — `TableLayout` has built-in `isLoading`/`isEmpty`/`nullState`/`showHeader` handling
 - Page chrome: `PageHeader` (title or breadcrumbs variant), `Breadcrumbs`, `TabBar`, `BottomPanel` (resizable bottom drawer)
 - Feedback: `Spinner`, `Banner`, `Toast`, `LoadingShimmer`, `ProgressBar`
-- Overlays: `Modal`, `WizardModal`, `RightPanel`, `Popover`, `Tooltip` / `TextUnderlineTooltip`, `DropdownMenu`, `FloatingPanel`
+- Overlays: `Modal`, `WizardModal` (`patterns/WizardModal`), `RightPanel`, `Popover`, `Tooltip` / `TextUnderlineTooltip`, `DropdownMenu`, `FloatingPanel`
 - Forms: `ConfigFormGroup`, `FormField` (`TextField`, `TextAreaField`, `TableBoxField`), `Input`, `TextArea`, `Select`, `Combobox`, `Checkbox`, `Radio`, `Toggle`, `DatePicker`
 - Status: `Sticker` (status badges), `Badge` (counts), `StatusIndicator`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@persona/design-system",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "React components for Persona UI",
   "keywords": [
     "tanstack-intent"
@@ -65,6 +65,7 @@
     "./components/SegmentedControl": "./dist/components/SegmentedControl/index.mjs",
     "./components/Select": "./dist/components/Select/index.mjs",
     "./components/Slider": "./dist/components/Slider/index.mjs",
+    "./components/SmartTextInput": "./dist/components/SmartTextInput/index.mjs",
     "./components/SmartTextInput/parser/method-chain/parser": "./dist/components/SmartTextInput/parser/method-chain/parser.mjs",
     "./components/SmartTextInput/parser/method-chain/types": "./dist/components/SmartTextInput/parser/method-chain/types.mjs",
     "./components/SmartTextInput/parser/smart-text/parser": "./dist/components/SmartTextInput/parser/smart-text/parser.mjs",
@@ -87,7 +88,6 @@
     "./components/Toggle": "./dist/components/Toggle/index.mjs",
     "./components/Tooltip": "./dist/components/Tooltip/index.mjs",
     "./components/VersionHistory": "./dist/components/VersionHistory/index.mjs",
-    "./components/WizardModal": "./dist/components/WizardModal/index.mjs",
     "./lib/chainTypes": "./dist/lib/chainTypes.mjs",
     "./lib/color": "./dist/lib/color.mjs",
     "./lib/comboboxHelper": "./dist/lib/comboboxHelper.mjs",
@@ -123,6 +123,7 @@
     "./lib/snakifyPath": "./dist/lib/snakifyPath.mjs",
     "./lib/TruncatedText": "./dist/lib/TruncatedText.mjs",
     "./lib/TruncatedTextWithTooltip": "./dist/lib/TruncatedTextWithTooltip.mjs",
+    "./lib/useChain": "./dist/lib/useChain.mjs",
     "./lib/useControlled": "./dist/lib/useControlled.mjs",
     "./lib/useEmbeddedSurface": "./dist/lib/useEmbeddedSurface.mjs",
     "./lib/useIsOverflow": "./dist/lib/useIsOverflow.mjs",
@@ -141,6 +142,7 @@
     "./patterns/LayoutLoadingShimmer": "./dist/patterns/LayoutLoadingShimmer/index.mjs",
     "./patterns/LayoutLoadingSpinner": "./dist/patterns/LayoutLoadingSpinner/index.mjs",
     "./patterns/PageLayout": "./dist/patterns/PageLayout/index.mjs",
+    "./patterns/WizardModal": "./dist/patterns/WizardModal/index.mjs",
     "./theme": "./dist/theme.mjs",
     "./utils/storybook": "./dist/utils/storybook.mjs",
     "./utils/testing": "./dist/utils/testing.mjs",
@@ -317,6 +319,7 @@
       "./components/SegmentedControl": "./dist/components/SegmentedControl/index.mjs",
       "./components/Select": "./dist/components/Select/index.mjs",
       "./components/Slider": "./dist/components/Slider/index.mjs",
+      "./components/SmartTextInput": "./dist/components/SmartTextInput/index.mjs",
       "./components/SmartTextInput/parser/method-chain/parser": "./dist/components/SmartTextInput/parser/method-chain/parser.mjs",
       "./components/SmartTextInput/parser/method-chain/types": "./dist/components/SmartTextInput/parser/method-chain/types.mjs",
       "./components/SmartTextInput/parser/smart-text/parser": "./dist/components/SmartTextInput/parser/smart-text/parser.mjs",
@@ -339,7 +342,6 @@
       "./components/Toggle": "./dist/components/Toggle/index.mjs",
       "./components/Tooltip": "./dist/components/Tooltip/index.mjs",
       "./components/VersionHistory": "./dist/components/VersionHistory/index.mjs",
-      "./components/WizardModal": "./dist/components/WizardModal/index.mjs",
       "./lib/chainTypes": "./dist/lib/chainTypes.mjs",
       "./lib/color": "./dist/lib/color.mjs",
       "./lib/comboboxHelper": "./dist/lib/comboboxHelper.mjs",
@@ -375,6 +377,7 @@
       "./lib/snakifyPath": "./dist/lib/snakifyPath.mjs",
       "./lib/TruncatedText": "./dist/lib/TruncatedText.mjs",
       "./lib/TruncatedTextWithTooltip": "./dist/lib/TruncatedTextWithTooltip.mjs",
+      "./lib/useChain": "./dist/lib/useChain.mjs",
       "./lib/useControlled": "./dist/lib/useControlled.mjs",
       "./lib/useEmbeddedSurface": "./dist/lib/useEmbeddedSurface.mjs",
       "./lib/useIsOverflow": "./dist/lib/useIsOverflow.mjs",
@@ -393,6 +396,7 @@
       "./patterns/LayoutLoadingShimmer": "./dist/patterns/LayoutLoadingShimmer/index.mjs",
       "./patterns/LayoutLoadingSpinner": "./dist/patterns/LayoutLoadingSpinner/index.mjs",
       "./patterns/PageLayout": "./dist/patterns/PageLayout/index.mjs",
+      "./patterns/WizardModal": "./dist/patterns/WizardModal/index.mjs",
       "./theme": "./dist/theme.mjs",
       "./utils/storybook": "./dist/utils/storybook.mjs",
       "./utils/testing": "./dist/utils/testing.mjs",
@@ -406,5 +410,8 @@
       "./package.json": "./package.json"
     },
     "registry": "https://registry.npmjs.org"
+  },
+  "inlinedDependencies": {
+    "lodash": "4.18.1"
   }
 }

package/skills/ui-authoring/COMPONENTS.md

@@ -73,7 +73,6 @@ exists. If there is no `.mdx`, use the published type declarations
 | `Toggle` | Turning a setting on or off with no extra confirmation | `@persona/design-system/components/Toggle` |
 | `Tooltip` | Standalone tooltip — explaining an icon or control on hover or focus | `@persona/design-system/components/Tooltip` |
 | `VersionHistory` | Show previous versions of a file and let the user compare or restore one | `@persona/design-system/components/VersionHistory` |
-| `WizardModal` | Multi-step task behind a page overlay; Next/Confirm run `onProceed` | `@persona/design-system/components/WizardModal` |
 
 
 ## Testing

package/skills/ui-authoring/PATTERNS.md

@@ -18,6 +18,7 @@ Which pattern to use, and for what. Patterns with a dedicated doc link to
 | LayoutLoadingSpinner | Centered 120px loading ring that fills its container. Use as the loading state for a page or embedded app when no layout-specific shimmer exists. |
 | LayoutLoadingShimmer | Filling space while content loads |
 | [Panels](../../patterns/Panels/Panels.mdx) | Use `RightPanel` when the page should stay visible. Use `Modal` when the task needs full attention. Never a custom drawer. |
+| [WizardModal](../../patterns/WizardModal/WizardModal.mdx) | A linear multi-step task behind a page overlay. |
 
 
 ## Page layouts