@octaviaflow/core 3.1.0-beta.102 → 3.1.0-beta.103

package/dist/components/ExpressionField/ExpressionField.d.ts

@@ -1,11 +1,18 @@
 import { type CSSProperties, type ReactNode } from "react";
 /** What the FxPanel puts on the drag, and what a host passes to `insert`. */
 export interface ExpressionInsert {
-    /** The raw value: `ods://steps/x/output/at`, or `user.fmt()`. */
+    /** The raw value: `ods://steps/x/output/at`, or `{{user.fmt()}}`. */
     value: string;
-    /** `variable` becomes a pill; `function` becomes editable text. */
+    /** `variable` becomes a pill; `function` becomes a chip. */
     kind?: "variable" | "function";
 }
+/** What a host knows about a call, for labelling its argument rows. */
+export interface CallSignature {
+    /** Display name. Defaults to the name as written, minus `user.`. */
+    label?: string;
+    /** Argument names, in order — used as the row labels. */
+    args?: string[];
+}
 export interface ExpressionFieldProps {
     value: string;
     onChange: (next: string) => void;
@@ -20,13 +27,17 @@ export interface ExpressionFieldProps {
     style?: CSSProperties;
     /**
      * Visible text for a reference pill. Defaults to a readable tail of the
-     * reference (`steps/x/output/created` → `created`). Pass a STABLE function —
-     * its identity re-renders the content.
+     * reference (`steps/x/output/created` → `created`). Pass a STABLE function.
      */
     resolveLabel?: (token: string) => string | undefined;
     /**
-     * Treat every `{{…}}` as a pill-able reference, not just `{{ods://…}}`.
-     * For hosts whose tokens are their own short form (`{{step.field}}`).
+     * What a call's arguments are called, so the editor can label its rows.
+     * Pass a STABLE function.
+     */
+    resolveCall?: (name: string) => CallSignature | undefined;
+    /**
+     * Treat every `{{…}}` that is not a call as a reference, not just
+     * `{{ods://…}}`. For hosts whose tokens are their own short form.
      */
     pillEveryToken?: boolean;
     "aria-label"?: string;
@@ -39,6 +50,6 @@ export declare function shortReferenceLabel(token: string): string;
  * not mistaken for a call, and `"a(b"` does not open one.
  */
 export declare function insideCallArguments(textBeforeCaret: string): boolean;
-export declare function ExpressionField({ value, onChange, label, placeholder, helperText, disabled, rows, id, className, style, resolveLabel, pillEveryToken, "aria-label": ariaLabel, }: ExpressionFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function ExpressionField({ value, onChange, label, placeholder, helperText, disabled, rows, id, className, style, resolveLabel, resolveCall, pillEveryToken, "aria-label": ariaLabel, }: ExpressionFieldProps): import("react/jsx-runtime").JSX.Element;
 export default ExpressionField;
 //# sourceMappingURL=ExpressionField.d.ts.map

package/dist/components/ExpressionField/ExpressionField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpressionField.d.ts","sourceRoot":"","sources":["../../../src/components/ExpressionField/ExpressionField.tsx"],"names":[],"mappings":"AA2BA,OAAO,EAKL,KAAK,aAAa,EAElB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWzD;AAyBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAiBpE;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAgB,EAChB,IAAQ,EACR,EAAE,EACF,SAAS,EACT,KAAK,EACL,YAAY,EACZ,cAAsB,EACtB,YAAY,EAAE,SAAS,GACxB,EAAE,oBAAoB,2CAuOtB;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ExpressionField.d.ts","sourceRoot":"","sources":["../../../src/components/ExpressionField/ExpressionField.tsx"],"names":[],"mappings":"AA2BA,OAAO,EAML,KAAK,aAAa,EAIlB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAUf,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IAC1D;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWzD;AAyBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAiBpE;AAWD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAAW,EACX,UAAU,EACV,QAAgB,EAChB,IAAQ,EACR,EAAE,EACF,SAAS,EACT,KAAK,EACL,YAAY,EACZ,WAAW,EACX,cAAsB,EACtB,YAAY,EAAE,SAAS,GACxB,EAAE,oBAAoB,2CA+XtB;AA0HD,eAAe,eAAe,CAAC"}

package/dist/components/ExpressionField/parseExpression.d.ts

@@ -0,0 +1,35 @@
+/** A call's name: a built-in (`CONCAT`) or a user function (`user.fmt`). */
+export declare const CALL_NAME_SOURCE = "(?:[A-Z_][A-Z0-9_]*|user\\.[A-Za-z_][A-Za-z0-9_]*)";
+export type Segment = {
+    kind: "text";
+    raw: string;
+} | {
+    kind: "ref";
+    raw: string;
+} | {
+    kind: "call";
+    raw: string;
+    name: string;
+    args: string[];
+};
+/**
+ * Split a call's argument list at top-level commas, leaving nested calls,
+ * quoted strings and wrapped references intact.
+ */
+export declare function splitArguments(argsText: string): string[];
+/** `{{user.fmt(a, b)}}` → its name and arguments; `undefined` if not a call. */
+export declare function parseCall(raw: string): {
+    name: string;
+    args: string[];
+} | undefined;
+/** Rebuild a call from its parts, in the wrapped form a field stores. */
+export declare function formatCall(name: string, args: string[]): string;
+/**
+ * Break a field's value into what the reader sees: plain text, references
+ * (pills) and calls (chips).
+ *
+ * `pillEveryToken` widens what counts as a reference to any `{{…}}` that is
+ * not a call, for hosts whose tokens are their own short form.
+ */
+export declare function parseExpression(value: string, pillEveryToken?: boolean): Segment[];
+//# sourceMappingURL=parseExpression.d.ts.map

package/dist/components/ExpressionField/parseExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseExpression.d.ts","sourceRoot":"","sources":["../../../src/components/ExpressionField/parseExpression.ts"],"names":[],"mappings":"AASA,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,uDAAuD,CAAC;AAGrF,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA2ChE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA2CzD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAQnF;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,EAAE,CA8BhF"}