@a2ui/web_core 0.8.0 → 0.9.1-alpha.0

package/src/v0_9/basic_catalog/functions/basic_functions_api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic_functions_api.d.ts","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/functions/basic_functions_api.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAOlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAOvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAOvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAOrB,CAAC;AAGF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAOrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAOxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAO1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAOvB,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;CAMlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;CAMjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;CAMlB,CAAC;AAGF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAazB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAMvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CAapB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;CAYrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;CAYtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CASpB,CAAC;AAGF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;CAM3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAQ3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CAS7B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAOzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcxB,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;CAStB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0B/B,CAAC"}

package/src/v0_9/basic_catalog/functions/basic_functions_api.js

@@ -0,0 +1,466 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from 'zod';
+// Arithmetic
+/**
+ * Adds two numbers.
+ *
+ * Arguments:
+ * - `a`: The first number.
+ * - `b`: The second number.
+ */
+export const AddApi = {
+    name: 'add',
+    returnType: 'number',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+/**
+ * Subtracts one number from another.
+ *
+ * Arguments:
+ * - `a`: The number to subtract from.
+ * - `b`: The number to subtract.
+ */
+export const SubtractApi = {
+    name: 'subtract',
+    returnType: 'number',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+/**
+ * Multiplies two numbers.
+ *
+ * Arguments:
+ * - `a`: The first number.
+ * - `b`: The second number.
+ */
+export const MultiplyApi = {
+    name: 'multiply',
+    returnType: 'number',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+/**
+ * Divides one number by another.
+ *
+ * Arguments:
+ * - `a`: The dividend.
+ * - `b`: The divisor.
+ */
+export const DivideApi = {
+    name: 'divide',
+    returnType: 'number',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+// Comparison
+/**
+ * Checks if two values are equal.
+ *
+ * Arguments:
+ * - `a`: The first value.
+ * - `b`: The second value.
+ */
+export const EqualsApi = {
+    name: 'equals',
+    returnType: 'boolean',
+    schema: z.object({
+        a: z.any().refine(v => v !== undefined, 'Required'),
+        b: z.any().refine(v => v !== undefined, 'Required'),
+    }),
+};
+/**
+ * Checks if two values are not equal.
+ *
+ * Arguments:
+ * - `a`: The first value.
+ * - `b`: The second value.
+ */
+export const NotEqualsApi = {
+    name: 'not_equals',
+    returnType: 'boolean',
+    schema: z.object({
+        a: z.any().refine(v => v !== undefined, 'Required'),
+        b: z.any().refine(v => v !== undefined, 'Required'),
+    }),
+};
+/**
+ * Checks if the first number is greater than the second.
+ *
+ * Arguments:
+ * - `a`: The number to compare.
+ * - `b`: The threshold number.
+ */
+export const GreaterThanApi = {
+    name: 'greater_than',
+    returnType: 'boolean',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+/**
+ * Checks if the first number is less than the second.
+ *
+ * Arguments:
+ * - `a`: The number to compare.
+ * - `b`: The threshold number.
+ */
+export const LessThanApi = {
+    name: 'less_than',
+    returnType: 'boolean',
+    schema: z.object({
+        a: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+        b: z.preprocess(v => (v === null ? undefined : v), z.coerce.number()),
+    }),
+};
+// Logical
+/**
+ * Performs a logical AND operation on a list of boolean values.
+ *
+ * Arguments:
+ * - `values`: List of items to evaluate (minimum 2).
+ */
+export const AndApi = {
+    name: 'and',
+    returnType: 'boolean',
+    schema: z.object({
+        values: z.array(z.any()).min(2),
+    }),
+};
+/**
+ * Performs a logical OR operation on a list of boolean values.
+ *
+ * Arguments:
+ * - `values`: List of items to evaluate (minimum 2).
+ */
+export const OrApi = {
+    name: 'or',
+    returnType: 'boolean',
+    schema: z.object({
+        values: z.array(z.any()).min(2),
+    }),
+};
+/**
+ * Performs a logical NOT operation on a boolean value.
+ *
+ * Arguments:
+ * - `value`: The value to negate.
+ */
+export const NotApi = {
+    name: 'not',
+    returnType: 'boolean',
+    schema: z.object({
+        value: z.any().refine(v => v !== undefined, 'Required'),
+    }),
+};
+// String
+/**
+ * Checks if a string contains a substring.
+ *
+ * Arguments:
+ * - `string`: The source string.
+ * - `substring`: The substring to search for.
+ */
+export const ContainsApi = {
+    name: 'contains',
+    returnType: 'boolean',
+    schema: z.object({
+        string: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+        substring: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+/**
+ * Checks if a string starts with a prefix.
+ *
+ * Arguments:
+ * - `string`: The source string.
+ * - `prefix`: The prefix to search for.
+ */
+export const StartsWithApi = {
+    name: 'starts_with',
+    returnType: 'boolean',
+    schema: z.object({
+        string: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+        prefix: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+/**
+ * Checks if a string ends with a suffix.
+ *
+ * Arguments:
+ * - `string`: The source string.
+ * - `suffix`: The suffix to search for.
+ */
+export const EndsWithApi = {
+    name: 'ends_with',
+    returnType: 'boolean',
+    schema: z.object({
+        string: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+        suffix: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+// Validation
+/**
+ * Checks that the value is not null, undefined, or empty.
+ *
+ * Arguments:
+ * - `value`: The value to check.
+ */
+export const RequiredApi = {
+    name: 'required',
+    returnType: 'boolean',
+    schema: z.object({
+        value: z.any().refine(v => v !== undefined, 'Required'),
+    }),
+};
+/**
+ * Checks that the value matches a regular expression string.
+ *
+ * Arguments:
+ * - `value`: The string to test.
+ * - `pattern`: The regex pattern string.
+ */
+export const RegexApi = {
+    name: 'regex',
+    returnType: 'boolean',
+    schema: z.object({
+        value: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+        pattern: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+/**
+ * Checks string length constraints.
+ *
+ * Arguments:
+ * - `value`: The value to inspect.
+ * - `min`: Optional minimum length.
+ * - `max`: Optional maximum length.
+ */
+export const LengthApi = {
+    name: 'length',
+    returnType: 'boolean',
+    schema: z
+        .object({
+        value: z.any().refine(v => v !== undefined, 'Required'),
+        min: z.coerce.number().optional(),
+        max: z.coerce.number().optional(),
+    })
+        .refine(data => data.min !== undefined || data.max !== undefined, {
+        message: "Must provide either 'min' or 'max'",
+    }),
+};
+/**
+ * Checks numeric range constraints.
+ *
+ * Arguments:
+ * - `value`: The value to inspect.
+ * - `min`: Optional minimum value.
+ * - `max`: Optional maximum value.
+ */
+export const NumericApi = {
+    name: 'numeric',
+    returnType: 'boolean',
+    schema: z
+        .object({
+        value: z.coerce.number(),
+        min: z.coerce.number().optional(),
+        max: z.coerce.number().optional(),
+    })
+        .refine(data => data.min !== undefined || data.max !== undefined, {
+        message: "Must provide either 'min' or 'max'",
+    }),
+};
+/**
+ * Checks that the value is a valid email address.
+ *
+ * Arguments:
+ * - `value`: The string to inspect.
+ */
+export const EmailApi = {
+    name: 'email',
+    returnType: 'boolean',
+    schema: z.object({
+        value: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+// Formatting
+/**
+ * Performs string interpolation on a value, resolving model paths and functions.
+ *
+ * Interpolation uses the `${expression}` syntax. Supported expressions include:
+ * - **JSON Pointer paths**: `${/absolute/path}` or `${relative/path}` to access data model values.
+ * - **Function calls**: `${now()}` or with named arguments like `${formatDate(value:${/currentDate}, format:'MM-dd')}`.
+ *
+ * To include a literal `${` sequence, escape it as `\\${`.
+ *
+ * @example
+ * "Hello ${/user/name}"
+ * "Total: ${formatCurrency(value:${/total}, currency:'USD')}"
+ *
+ * Arguments:
+ * - `value`: The string template to interpolate.
+ */
+export const FormatStringApi = {
+    name: 'formatString',
+    returnType: 'any',
+    schema: z.object({
+        value: z.coerce.string(),
+    }),
+};
+/**
+ * Formats a number with the specified grouping and decimal precision.
+ *
+ * Arguments:
+ * - `value`: The number to format.
+ * - `decimals`: Optional number of decimal places.
+ * - `grouping`: Whether to use thousands separators, defaults to true.
+ */
+export const FormatNumberApi = {
+    name: 'formatNumber',
+    returnType: 'string',
+    schema: z.object({
+        value: z.coerce.number(),
+        decimals: z.coerce.number().optional(),
+        grouping: z.boolean().default(true),
+    }),
+};
+/**
+ * Formats a number as a currency string.
+ *
+ * Arguments:
+ * - `value`: The number to format.
+ * - `currency`: Currency code (e.g. "USD"), defaults to "USD".
+ * - `decimals`: Optional number of decimal places.
+ * - `grouping`: Whether to use thousands separators, defaults to true.
+ */
+export const FormatCurrencyApi = {
+    name: 'formatCurrency',
+    returnType: 'string',
+    schema: z.object({
+        value: z.coerce.number(),
+        currency: z.coerce.string(),
+        decimals: z.coerce.number().optional(),
+        grouping: z.boolean().default(true),
+    }),
+};
+/**
+ * Formats a timestamp into a string using a pattern.
+ *
+ * Token Reference:
+ * - Year: 'yy' (26), 'yyyy' (2026)
+ * - Month: 'M' (1), 'MM' (01), 'MMM' (Jan), 'MMMM' (January)
+ * - Day: 'd' (1), 'dd' (01), 'E' (Tue), 'EEEE' (Tuesday)
+ * - Hour (12h): 'h' (1-12), 'hh' (01-12) - requires 'a' for AM/PM
+ * - Hour (24h): 'H' (0-23), 'HH' (00-23) - Military Time
+ * - Minute: 'mm' (00-59), Second: 'ss' (00-59)
+ * - Period: 'a' (AM/PM)
+ *
+ * Arguments:
+ * - `value`: The date to format.
+ * - `format`: A Unicode TR35 date pattern string.
+ */
+export const FormatDateApi = {
+    name: 'formatDate',
+    returnType: 'string',
+    schema: z.object({
+        value: z.any().refine(v => v !== undefined, 'Required'),
+        format: z.coerce.string(),
+    }),
+};
+/**
+ * Returns a localized string based on the Common Locale Data Repository (CLDR) plural category of the count.
+ *
+ * Requires an 'other' fallback. For English, just use 'one' and 'other'.
+ *
+ * Arguments:
+ * - `value`: Count to evaluate.
+ * - `zero`: Optional text for count 0.
+ * - `one`: Optional text for count 1.
+ * - `two`: Optional text for count 2.
+ * - `few`: Optional text for few items.
+ * - `many`: Optional text for many items.
+ * - `other`: Default text fallback.
+ */
+export const PluralizeApi = {
+    name: 'pluralize',
+    returnType: 'string',
+    schema: z
+        .object({
+        value: z.coerce.number(),
+        zero: z.coerce.string().optional(),
+        one: z.coerce.string().optional(),
+        two: z.coerce.string().optional(),
+        few: z.coerce.string().optional(),
+        many: z.coerce.string().optional(),
+        other: z.coerce.string(),
+    })
+        .passthrough(),
+};
+// Actions
+/**
+ * Opens the specified URL in a browser or handler. This function has no return value.
+ *
+ * Arguments:
+ * - `url`: The address URL string.
+ */
+export const OpenUrlApi = {
+    name: 'openUrl',
+    returnType: 'void',
+    schema: z.object({
+        url: z.preprocess(v => (v === undefined ? undefined : String(v)), z.string()),
+    }),
+};
+/**
+ * Collection containing ALL available Basic Function API descriptors.
+ */
+export const BASIC_FUNCTION_APIS = [
+    AddApi,
+    SubtractApi,
+    MultiplyApi,
+    DivideApi,
+    EqualsApi,
+    NotEqualsApi,
+    GreaterThanApi,
+    LessThanApi,
+    AndApi,
+    OrApi,
+    NotApi,
+    ContainsApi,
+    StartsWithApi,
+    EndsWithApi,
+    RequiredApi,
+    RegexApi,
+    LengthApi,
+    NumericApi,
+    EmailApi,
+    FormatStringApi,
+    FormatNumberApi,
+    FormatCurrencyApi,
+    FormatDateApi,
+    PluralizeApi,
+    OpenUrlApi,
+];
+//# sourceMappingURL=basic_functions_api.js.map

package/src/v0_9/basic_catalog/functions/basic_functions_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic_functions_api.js","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/functions/basic_functions_api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,aAAa;AACb;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,KAAc;IACpB,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAmB;IACzB,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAmB;IACzB,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF,aAAa;AACb;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;QACnD,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;KACpD,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,YAAqB;IAC3B,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;QACnD,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;KACpD,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,cAAuB;IAC7B,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,WAAoB;IAC1B,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC;CACH,CAAC;AAEF,UAAU;AACV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,KAAc;IACpB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAChC,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,IAAa;IACnB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAChC,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,KAAc;IACpB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;KACxD,CAAC;CACH,CAAC;AAEF,SAAS;AACT;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAmB;IACzB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;QACD,SAAS,EAAE,CAAC,CAAC,UAAU,CACrB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,aAAsB;IAC5B,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;QACD,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,WAAoB;IAC1B,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;QACD,MAAM,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF,aAAa;AACb;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,UAAmB;IACzB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;KACxD,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,OAAgB;IACtB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,UAAU,CACjB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;QACD,OAAO,EAAE,CAAC,CAAC,UAAU,CACnB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;QACvD,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE;QAChE,OAAO,EAAE,oCAAoC;KAC9C,CAAC;CACL,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,SAAkB;IACxB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE;QAChE,OAAO,EAAE,oCAAoC;KAC9C,CAAC;CACL,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,OAAgB;IACtB,UAAU,EAAE,SAAkB;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,UAAU,CACjB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF,aAAa;AACb;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAuB;IAC7B,UAAU,EAAE,KAAc;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;KACzB,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAuB;IAC7B,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACpC,CAAC;CACH,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAyB;IAC/B,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACpC,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAqB;IAC3B,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,UAAU,CAAC;QACvD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;KAC1B,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAoB;IAC1B,UAAU,EAAE,QAAiB;IAC7B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;KACzB,CAAC;SACD,WAAW,EAAE;CACjB,CAAC;AAEF,UAAU;AACV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,SAAkB;IACxB,UAAU,EAAE,MAAe;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,UAAU,CACf,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CACX;KACF,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,WAAW;IACX,WAAW;IACX,SAAS;IACT,SAAS;IACT,YAAY;IACZ,cAAc;IACd,WAAW;IACX,MAAM;IACN,KAAK;IACL,MAAM;IACN,WAAW;IACX,aAAa;IACb,WAAW;IACX,WAAW;IACX,QAAQ;IACR,SAAS;IACT,UAAU;IACV,QAAQ;IACR,eAAe;IACf,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,YAAY;IACZ,UAAU;CACX,CAAC"}

package/src/v0_9/basic_catalog/index.d.ts

@@ -0,0 +1,5 @@
+export * from './expressions/expression_parser.js';
+export * from './functions/basic_functions.js';
+export * from './functions/basic_functions_api.js';
+export * from './components/basic_components.js';
+//# sourceMappingURL=index.d.ts.map

package/src/v0_9/basic_catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/basic_catalog/index.ts"],"names":[],"mappings":"AAgBA,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC"}

package/src/v0_9/basic_catalog/index.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './expressions/expression_parser.js';
+export * from './functions/basic_functions.js';
+export * from './functions/basic_functions_api.js';
+export * from './components/basic_components.js';
+//# sourceMappingURL=index.js.map

package/src/v0_9/basic_catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v0_9/basic_catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC"}

package/src/v0_9/catalog/function_invoker.d.ts

@@ -0,0 +1,12 @@
+import { DataContext } from '../rendering/data-context.js';
+/**
+ * A function that invokes a catalog function by name and returns its result synchronously or as a Signal.
+ *
+ * @param name The name of the function to invoke.
+ * @param args The arguments to pass to the function.
+ * @param context The data context in which the function is being executed.
+ * @param abortSignal An optional AbortSignal for asynchronous or long-running operations.
+ * @returns The result of the function call, which can be a literal, a Signal, or a Promise (handled by the caller).
+ */
+export type FunctionInvoker = (name: string, args: Record<string, any>, context: DataContext, abortSignal?: AbortSignal) => any;
+//# sourceMappingURL=function_invoker.d.ts.map

package/src/v0_9/catalog/function_invoker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_invoker.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/catalog/function_invoker.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,WAAW,EAAC,MAAM,8BAA8B,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE,WAAW,KACtB,GAAG,CAAC"}

package/src/v0_9/catalog/function_invoker.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};
+//# sourceMappingURL=function_invoker.js.map

package/src/v0_9/catalog/function_invoker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_invoker.js","sourceRoot":"","sources":["../../../../src/v0_9/catalog/function_invoker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/src/v0_9/catalog/types.d.ts

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { DataContext } from '../rendering/data-context.js';
+import { Signal } from '@preact/signals-core';
+/**
+ * Robust check for a Preact Signal that works across package boundaries.
+ */
+export declare function isSignal(val: any): val is Signal<any>;
+export type A2uiReturnType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any' | 'void';
+export type InferA2uiReturnType<T extends A2uiReturnType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'array' ? any[] : T extends 'object' ? Record<string, any> : T extends 'void' ? void : any;
+/**
+ * A definition of a UI function's API.
+ */
+export interface FunctionApi {
+    readonly name: string;
+    readonly returnType: A2uiReturnType;
+    readonly schema: z.ZodTypeAny;
+}
+/**
+ * A function implementation that can be registered with the evaluator or basic catalog.
+ */
+export interface FunctionImplementation extends FunctionApi {
+    execute(args: Record<string, any>, context: DataContext, abortSignal?: AbortSignal): unknown | Signal<unknown>;
+}
+export declare function createFunctionImplementation<Schema extends z.ZodTypeAny, TReturn extends A2uiReturnType>(api: {
+    name: string;
+    returnType: TReturn;
+    schema: Schema;
+}, execute: (args: z.infer<Schema>, context: DataContext, abortSignal?: AbortSignal) => InferA2uiReturnType<TReturn> | Signal<InferA2uiReturnType<TReturn>>): FunctionImplementation;
+import { FunctionInvoker } from './function_invoker.js';
+/**
+ * A definition of a UI component's API.
+ * This interface defines the contract for a component's capabilities and properties,
+ * independent of any specific rendering implementation.
+ *
+ * @template Schema the Zod schema type for the component's properties.
+ */
+export interface ComponentApi<Schema extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** The name of the component as it appears in the A2UI JSON (e.g., 'Button'). */
+    name: string;
+    /**
+     * The Zod schema describing the **properties** of this component.
+     *
+     * - MUST include catalog-specific common properties (e.g. 'weight', 'accessibility').
+     * - MUST NOT include 'component' or 'id' as those are handled by the framework/envelope.
+     */
+    readonly schema: Schema;
+}
+/**
+ * Infers the schema type from a ComponentApi.
+ *
+ * This type uses `z.infer` on the `schema` property of a `ComponentApi` object.
+ * It is used to access the schema props of a component with type safety.
+ */
+export type InferredComponentApiSchemaType<Api extends ComponentApi> = z.infer<Api['schema']>;
+/**
+ * A collection of available components and functions.
+ */
+export declare class Catalog<T extends ComponentApi> {
+    readonly id: string;
+    /**
+     * A map of available components.
+     * This is readonly to encourage immutable extension patterns.
+     */
+    readonly components: ReadonlyMap<string, T>;
+    /**
+     * Map of functions provided by this catalog.
+     */
+    readonly functions: ReadonlyMap<string, FunctionImplementation>;
+    /**
+     * The schema for theme parameters used by this catalog.
+     */
+    readonly themeSchema?: z.ZodObject<any>;
+    /**
+     * A ready-to-use FunctionInvoker callback that delegates to this catalog's functions.
+     * Can be passed directly to a DataContext.
+     */
+    readonly invoker: FunctionInvoker;
+    constructor(id: string, components: T[], functions?: FunctionImplementation[], themeSchema?: z.ZodObject<any>);
+}
+//# sourceMappingURL=types.d.ts.map

package/src/v0_9/catalog/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/catalog/types.ts"],"names":[],"mappings":"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"}