@persona/design-system 0.8.0 → 0.8.1

package/dist/useChain-CEsXE2Bx.d.mts

@@ -0,0 +1,77 @@
+import { r as Sticker } from "./Sticker-DGfNuxUK.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 { t as Option } from "./schemaOptions-DGca6x7E.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-D8SGRGba.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-CEsXE2Bx.d.mts.map