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

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

@@ -0,0 +1,55 @@
+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()}}`. */
+    value: string;
+    /** `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;
+    label?: ReactNode;
+    placeholder?: string;
+    helperText?: ReactNode;
+    disabled?: boolean;
+    /** Visible rows at rest. The field grows with its content. */
+    rows?: number;
+    id?: string;
+    className?: string;
+    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.
+     */
+    resolveLabel?: (token: string) => string | undefined;
+    /**
+     * 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;
+}
+/** A short, human tail for a reference: the last path segments. */
+export declare function shortReferenceLabel(token: string): string;
+/**
+ * Is the caret inside the parentheses of a call? Counts unclosed `(` in the
+ * text before it, ignoring anything inside quotes — so a `(` in a message is
+ * 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, 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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -0,0 +1,3 @@
+export { ExpressionField, shortReferenceLabel, insideCallArguments } from "./ExpressionField";
+export type { ExpressionFieldProps, ExpressionInsert } from "./ExpressionField";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ExpressionField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,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"}