@persona/design-system 0.8.0 → 0.8.2

package/dist/useChain-DQq1UsGZ.d.mts

@@ -0,0 +1,77 @@
+import { r as Sticker } from "./Sticker-rxBNVYlX.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-BMPLdT4p.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BtSMV5OZ.mjs";
+import { t as Option } from "./schemaOptions-DTeNBwir.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-dY6jc22J.mjs";
+import { ComponentProps } from "react";
+
+//#region lib/useChain.d.ts
+type ChainStickerProp = {
+  label: string;
+  variant: ComponentProps<typeof Sticker>['variant'];
+};
+type UseChainHook = (opts: {
+  chainString: string;
+  chainRoots: ChainRoot[];
+  useChainRootDescriptions?: boolean;
+  primitivesSchema?: 'none' | 'default' | ObjectSchemaMap;
+  platformObjectJsonSchema: ObjectSchemaMap;
+  defaultPrimitiveUtilities: ObjectSchemaMap;
+  codeChainFunctionSchema?: Record<string, Record<string, FunctionJsonSchema>>;
+  getSchemaOptionsOverride?: (schema: JsonSchema, options: Option[]) => Option[];
+  onUpdateChain: (value: string, meta: {
+    schema: JsonSchema | null;
+    [key: string]: unknown;
+  }) => void;
+}) => [currentChain: Chain, {
+  amendChain: (replacement: MethodChainNode[], startingIndex: number) => void;
+  appendChain: (newNodes: MethodChainNode[], meta?: Record<string, unknown>) => void;
+  chainStickers: ChainStickerProp[];
+  commitChain: (chainStr: string, meta?: Record<string, unknown>) => void;
+  currentSchema: JsonSchema | null;
+  deleteChainAfter: (position: number) => void;
+  deleteLastChain: () => void;
+  isValid: boolean;
+  nextPossibleChains: PossibleChainSchema[];
+  resolveSchema: (chainStr: string) => JsonSchema | null;
+}];
+interface ChainRootsFromSchemaOptions {
+  includeFunctions?: boolean;
+  getLabel?: (key: string) => string;
+}
+/**
+ * Converts a schema's `properties` map into selectable method-chain roots
+ * (the `chainRoots` input this hook consumes).
+ *
+ * Centralizes the `properties → ChainRoot[]` conversion that several editors
+ * previously hand-rolled with an unconditional `parseMethodChain(key)` — which
+ * throws when a key is an `@`-prefixed custom function (see the
+ * `global:custom-code-functions-in-schema` rollout, which injects functions as
+ * schema `properties`). Function entries are excluded by default, and any key
+ * that isn't a parseable chain is skipped defensively.
+ */
+declare const chainRootsFromSchemaProperties: (properties?: Record<string, JsonSchema> | null, {
+  includeFunctions,
+  getLabel
+}?: ChainRootsFromSchemaOptions) => ChainRoot[];
+/**
+ * Single hook to load all schemas correctly for the input
+ */
+declare const useChainSchema: ({
+  primitivesSchema,
+  platformObjectJsonSchema,
+  defaultPrimitiveUtilities,
+  codeChainFunctionSchema
+}: {
+  primitivesSchema: "none" | "default" | ObjectSchemaMap;
+  platformObjectJsonSchema: ObjectSchemaMap;
+  defaultPrimitiveUtilities: ObjectSchemaMap;
+  codeChainFunctionSchema?: Record<string, Record<string, FunctionJsonSchema>>;
+}) => {
+  platformObjectJsonSchema: ObjectSchemaMap;
+  primitiveUtilities: ObjectSchemaMap;
+};
+declare const useChain: UseChainHook;
+//#endregion
+export { useChain as n, useChainSchema as r, chainRootsFromSchemaProperties as t };
+//# sourceMappingURL=useChain-DQq1UsGZ.d.mts.map

package/dist/useChainAtCursor.d.mts

@@ -0,0 +1,87 @@
+import { t as ASTNode } from "./types-BB5WwerD.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-BMPLdT4p.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BtSMV5OZ.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-dY6jc22J.mjs";
+import { u as ValueType } from "./types-CptsgFbu.mjs";
+import { n as useChain } from "./useChain-DQq1UsGZ.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-CptsgFbu.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-DXhu2YSh.mjs";
 import { KeyboardEvent } from "react";
 
 //#region components/Combobox/useComboboxFooterAction.d.ts

package/dist/{useFilterStateV2-CW6eght1.d.mts → useFilterStateV2-CGGABOcq.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-Rj-C3LGL.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-C2eIbP1X.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-CGGABOcq.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-CGGABOcq.mjs";
 export { UseFilterStateV2Options, UseFilterStateV2Result, useFilterStateV2 };

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

@@ -1,4 +1,4 @@
-import { t as ErrorProps } from "./ErrorProps-B8-Mqf1W.mjs";
+import { t as ErrorProps } from "./ErrorProps-C-sfKFxK.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-4w9TNFgD.d.mts.map

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

@@ -1,4 +1,4 @@
-import { n as useFormGroup } from "./useFormGroup-C7Cax8zO.mjs";
+import { n as useFormGroup } from "./useFormGroup-CsKC93Pt.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-CbNYbDdp.mjs.map

package/dist/{useFormField-XezSxho_.mjs.map → useFormField-CbNYbDdp.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-CbNYbDdp.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.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-4w9TNFgD.mjs";
 export { FormControlContext, FormControlContextProps, useFormField as default };

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

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

package/dist/{useFormGroup-C7Cax8zO.mjs.map → useFormGroup-CsKC93Pt.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-CsKC93Pt.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-CZwH8h5n.d.mts}

@@ -2,4 +2,4 @@
 declare const usePathname: () => string;
 //#endregion
 export { usePathname as t };
-//# sourceMappingURL=useLocationPathname-DH5Tdq5X.d.mts.map
+//# sourceMappingURL=useLocationPathname-CZwH8h5n.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-CZwH8h5n.mjs";
 export { usePathname };

package/dist/{useTableBoxDragAndDrop-Da4TiYBT.d.mts → useTableBoxDragAndDrop-Bw93rNFH.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-Bw93rNFH.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-Bw93rNFH.mjs";
 export { DragDirection, ReorderConfig, useTableBoxDragAndDrop };

package/dist/{useToggle-DUHQjohK.mjs → useToggle-DRzCDqrc.mjs}

@@ -18,4 +18,4 @@ function useToggle(initialValue = false) {
 //#endregion
 export { useToggle as t };
 
-//# sourceMappingURL=useToggle-DUHQjohK.mjs.map
+//# sourceMappingURL=useToggle-DRzCDqrc.mjs.map

package/dist/{useToggle-DUHQjohK.mjs.map → useToggle-DRzCDqrc.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useToggle-DUHQjohK.mjs","names":[],"sources":["../lib/useToggle.ts"],"sourcesContent":["import { useCallback, useState } from 'react';\n\ninterface UseToggleCallbacks {\n  set: (value: boolean) => void;\n  toggle: () => void;\n  enable: () => void;\n  disable: () => void;\n}\n\n/**\n * useToggle\n *\n * Boolean state hook that provides callbacks for enabling, disabling, flipping\n * and setting state.\n */\nexport default function useToggle(initialValue = false): [boolean, UseToggleCallbacks] {\n  const [value, setValue] = useState<boolean>(!!initialValue);\n  const set = useCallback((newValue: boolean) => setValue(newValue), []);\n  const toggle = useCallback(() => setValue(!value), [value]);\n  const enable = useCallback(() => setValue(true), []);\n  const disable = useCallback(() => setValue(false), []);\n  return [value, { set, toggle, enable, disable }];\n}\n"],"mappings":";;;;;;;;AAeA,SAAwB,UAAU,eAAe,OAAsC;CACrF,MAAM,CAAC,OAAO,YAAY,SAAkB,CAAC,CAAC,aAAa;AAK3D,QAAO,CAAC,OAAO;EAAE,KAJL,aAAa,aAAsB,SAAS,SAAS,EAAE,EAAE,CAIjD;EAAE,QAHP,kBAAkB,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,CAG9B;EAAE,QAFf,kBAAkB,SAAS,KAAK,EAAE,EAAE,CAEf;EAAE,SADtB,kBAAkB,SAAS,MAAM,EAAE,EAAE,CACR;EAAE,CAAC"}
+{"version":3,"file":"useToggle-DRzCDqrc.mjs","names":[],"sources":["../lib/useToggle.ts"],"sourcesContent":["import { useCallback, useState } from 'react';\n\ninterface UseToggleCallbacks {\n  set: (value: boolean) => void;\n  toggle: () => void;\n  enable: () => void;\n  disable: () => void;\n}\n\n/**\n * useToggle\n *\n * Boolean state hook that provides callbacks for enabling, disabling, flipping\n * and setting state.\n */\nexport default function useToggle(initialValue = false): [boolean, UseToggleCallbacks] {\n  const [value, setValue] = useState<boolean>(!!initialValue);\n  const set = useCallback((newValue: boolean) => setValue(newValue), []);\n  const toggle = useCallback(() => setValue(!value), [value]);\n  const enable = useCallback(() => setValue(true), []);\n  const disable = useCallback(() => setValue(false), []);\n  return [value, { set, toggle, enable, disable }];\n}\n"],"mappings":";;;;;;;;AAeA,SAAwB,UAAU,eAAe,OAAsC;CACrF,MAAM,CAAC,OAAO,YAAY,SAAkB,CAAC,CAAC,aAAa;AAK3D,QAAO,CAAC,OAAO;EAAE,KAJL,aAAa,aAAsB,SAAS,SAAS,EAAE,EAAE,CAIjD;EAAE,QAHP,kBAAkB,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,CAG9B;EAAE,QAFf,kBAAkB,SAAS,KAAK,EAAE,EAAE,CAEf;EAAE,SADtB,kBAAkB,SAAS,MAAM,EAAE,EAAE,CACR;EAAE,CAAC"}

package/dist/useTruncation.d.mts

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

package/dist/{utilities-DcsbI71T.d.mts → utilities-B8PzMOza.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-B8PzMOza.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-B8PzMOza.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-BkC7FCdF.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-ClbV4wNp.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-Rj-C3LGL.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-l-arEBLb.mjs";
+import { t as ASTNode } from "./types-BB5WwerD.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BtSMV5OZ.mjs";
+import { t as ChainRoot } from "./chainTypes-dY6jc22J.mjs";
+import { a as Mode, r as FunctionAtCursor, u as ValueType } from "./types-CptsgFbu.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-DP8f6tgh.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-Rj-C3LGL.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-C2eIbP1X.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-DP8f6tgh.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-DP8f6tgh.mjs";
 export { hasCompleteValue, isFilterStateV2, pruneToRegistry };

package/dist/validation2.d.mts

@@ -0,0 +1,64 @@
+import { t as ASTNode } from "./types-BB5WwerD.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-BMPLdT4p.mjs";
+import { t as ChainRoot } from "./chainTypes-dY6jc22J.mjs";
+import { u as ValueType } from "./types-CptsgFbu.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-CwjOaVAn.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-Rj-C3LGL.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-CwjOaVAn.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-CwjOaVAn.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-BCPOKF9L.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-CfiNA4Yy.mjs";
 export { CssPercentage, SemanticTokens, semanticDark, semanticLight };

package/llms.txt

@@ -13,7 +13,7 @@ For exact prop types, prefer the published type declarations (`dist/**/*.d.mts`,
 
 ## Skills
 
-- [ui-authoring](skills/ui-authoring/SKILL.md): design tokens, PDS implementation guidelines, table guidelines (DataTable vs TableBox vs TableLayout), routing/link adapters (react-router, TanStack, custom), loading states, testing, Storybook
+- [ui-authoring](skills/ui-authoring/SKILL.md): design tokens, PDS implementation guidelines, table guidelines (DataTable vs TableBox vs TableLayout), routing/link adapters (react-router, TanStack, custom), localization (PDSProvider strings/locale), loading states, testing, Storybook
 - [Tokens](skills/ui-authoring/TOKENS.md): Color / Spacing / Typography selection and catalog, radius, charts
 - [Patterns](skills/ui-authoring/PATTERNS.md): forms, layout, indicators, feedback, empty states, charts, panels
 - [Components](skills/ui-authoring/COMPONENTS.md): which PDS component to use (and its import path); APIs live in that component's `.mdx` when one exists, otherwise in `dist/components/<Name>/index.d.mts`
@@ -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`