@nordcraft/core 1.0.78 → 1.0.80

package/dist/api/ToddleApiV2.d.ts

@@ -30,7 +30,7 @@ export declare class ToddleApiV2<Handler> implements ApiRequest {
     get method(): Nullable<import("./apiTypes").ApiMethod>;
     get body(): Nullable<Formula>;
     get inputs(): Record<string, {
-        formula: Nullable<Formula>;
+        formula?: Nullable<Formula>;
     }>;
     get queryParams(): Nullable<Record<string, {
         formula: Formula;
@@ -73,7 +73,7 @@ export declare class ToddleApiV2<Handler> implements ApiRequest {
         formula: Formula;
     }>;
     get '@nordcraft/metadata'(): Nullable<{
-        comments: Nullable<Partial<Record<string, import("../types").Comment & {
+        comments?: Nullable<Partial<Record<string, import("../types").Comment & {
             index: number;
         }>>>;
     }>;

package/dist/api/apiTypes.d.ts

@@ -70,7 +70,7 @@ export interface ApiRequest extends ApiBase {
     method?: Nullable<ApiMethod>;
     body?: Nullable<Formula>;
     inputs: Record<string, {
-        formula: Nullable<Formula>;
+        formula?: Nullable<Formula>;
     }>;
     service?: Nullable<string>;
     servicePath?: Nullable<string>;

package/dist/component/component.types.d.ts

@@ -276,7 +276,7 @@ export interface FetchActionModel {
     type: 'Fetch';
     api: string;
     inputs?: Nullable<Record<string, {
-        formula: Nullable<Formula>;
+        formula?: Nullable<Formula>;
     }>>;
     onSuccess: ActionModelActions;
     onError: ActionModelActions;

package/dist/component/schemas/action-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+import type { ActionModel } from '../component.types';
+export declare const ActionModelSchema: z.ZodType<ActionModel>;

package/dist/component/schemas/action-schema.js

@@ -0,0 +1,169 @@
+import { z } from 'zod';
+import { FormulaSchema } from './formula-schema';
+// Action Models
+const VariableActionModelSchema = z
+    .object({
+    type: z.literal('SetVariable'),
+    variable: z.string().describe('Name of the variable to be set.'),
+    data: FormulaSchema.describe('Formula evaluating to the new variable value.'),
+})
+    .describe('Model describing the action of setting a variable.');
+const EventActionModelSchema = z
+    .object({
+    type: z.literal('TriggerEvent'),
+    event: z.string().describe('Name of the event to be triggered.'),
+    data: FormulaSchema.describe('Data to pass to the event being triggered.'),
+})
+    .describe('Model describing the action of triggering an event. This is only relevant on components as they are the only entities that can have events defined.');
+const SwitchActionModelSchema = z
+    .object({
+    type: z.literal('Switch'),
+    cases: z
+        .array(z.object({
+        condition: FormulaSchema.describe('Condition to evaluate for this case. If truthy the actions are executed.'),
+        actions: z
+            .array(z.lazy(() => ActionModelSchema))
+            .describe('List of actions to execute if the condition is met.'),
+    }))
+        .describe('Cases for the switch action. Each case has a condition and actions.'),
+    default: z
+        .object({
+        actions: z.array(z.lazy(() => ActionModelSchema)),
+    })
+        .describe('Actions to execute if no case conditions are met.'),
+})
+    .describe('Model describing a switch action. A switch action allows branching logic based on conditions.');
+const FetchActionModelSchema = z
+    .object({
+    type: z.literal('Fetch'),
+    api: z
+        .string()
+        .describe('Key of the API to fetch data from. This is the key defined in the APIs object in the file.'),
+    inputs: z
+        .record(z.string().describe('Name of the API input.'), z.object({
+        formula: FormulaSchema.nullish().describe('Formula for the input.'),
+    }))
+        .describe('Inputs overriding the default input values for the API. Available inputs are defined as part of the API definition.'),
+    onSuccess: z
+        .object({
+        actions: z.array(z.lazy(() => ActionModelSchema)),
+    })
+        .describe('Actions to execute when the fetch is successful.'),
+    onError: z
+        .object({
+        actions: z.array(z.lazy(() => ActionModelSchema)),
+    })
+        .describe('Actions to execute when the fetch fails.'),
+    onMessage: z
+        .object({
+        actions: z.array(z.lazy(() => ActionModelSchema)),
+    })
+        .nullish()
+        .describe('Actions to execute when a message is received during streaming.'),
+})
+    .describe('Model describing the action of fetching data from an API.');
+const CustomActionModelSchema = z
+    .object({
+    type: z.literal('Custom'),
+    name: z.string().describe('Name of the custom action to be executed.'),
+    package: z
+        .string()
+        .nullish()
+        .describe('Package where the custom action is defined. Should not be set for local custom actions.'),
+    arguments: z
+        .array(z.object({
+        name: z.string().describe('Name of the argument.'),
+        formula: FormulaSchema.describe('Formula evaluating to the argument value.'),
+    }))
+        .nullish()
+        .describe('Arguments to pass to the custom action.'),
+    events: z
+        .record(z.string().describe('Name of the event.'), z
+        .object({
+        actions: z
+            .array(z.lazy(() => ActionModelSchema))
+            .describe('List of actions to execute when the event is triggered.'),
+    })
+        .describe('Record with one entry called "actions" which is a list of actions to execute when the event is triggered..'))
+        .nullish()
+        .describe('Record of events defined in the custom action. Each event has a list of actions to execute when the event is emitted.'),
+    version: z
+        .literal(2)
+        .nullish()
+        .describe('Version of the custom action model. This should always be 2.'),
+})
+    .describe('Model describing the action of a custom action. A custom action is a user-defined action that can be reused across the project. A list of available custom actions has been provided as part of the system prompt.');
+const BuiltInActionModelSchema = z
+    .object({
+    name: z
+        .string()
+        .describe('Name of the built-in action. This will always be prefixed with "@toddle/" and should match the action key in the system.'),
+    arguments: z
+        .array(z.object({
+        name: z.string().describe('Name of the argument.'),
+        formula: FormulaSchema.describe('Formula evaluating to the argument value.'),
+    }))
+        .nullish()
+        .describe('Arguments to pass to the built-in action.'),
+    events: z
+        .record(z.string().describe('Name of the event.'), z
+        .object({
+        actions: z.array(z.lazy(() => ActionModelSchema)),
+    })
+        .describe('List of actions to execute when the event is triggered.'))
+        .nullish()
+        .describe('Events that can be triggered by the built-in action. Common events include onSuccess and onError.'),
+    label: z
+        .string()
+        .describe('Label for the built-in action. This label will be used in the UI.'),
+})
+    .describe('Model describing a built-in action provided by the Nordcraft system. Built-in actions are pre-defined actions that can be used to perform common tasks within a Nordcraft project.');
+const SetURLParameterActionSchema = z
+    .object({
+    type: z.literal('SetURLParameter'),
+    parameter: z.string(),
+    data: FormulaSchema,
+    historyMode: z.enum(['replace', 'push']).nullish(),
+})
+    .describe('This model is deprecated. Instead refer to SetMultiUrlParameterActionSchema.');
+const SetMultiUrlParameterActionSchema = z
+    .object({
+    type: z.literal('SetURLParameters'),
+    parameters: z
+        .record(z.string(), FormulaSchema)
+        .describe('Record of URL parameters to set, where the key is the parameter name and the value is a formula evaluating to the parameter value.'),
+    historyMode: z
+        .enum(['replace', 'push'])
+        .nullish()
+        .describe('This determines how the URL is updated in the browser history. Use "replace" to update the current history entry without adding a new one, or "push" to create a new history entry for the URL change. If not specified, the default behavior is to use "push".'),
+})
+    .describe('Model describing the action of setting multiple URL parameters. Use this action to update any number (1-*) of URL parameter(s) in one go.');
+const WorkflowActionModelSchema = z
+    .object({
+    type: z.literal('TriggerWorkflow'),
+    workflow: z.string().describe('ID of the workflow to be triggered.'),
+    parameters: z
+        .record(z.string().describe('Name of the workflow parameter.'), z
+        .object({
+        formula: FormulaSchema,
+    })
+        .describe('Formula evaluating to the parameter value.'))
+        .describe('Parameters to pass to the workflow being triggered. '),
+    contextProvider: z
+        .string()
+        .nullish()
+        .describe('If the workflow being triggered is from a parent component and exposed via a context provider, this is the ID of that context provider.'),
+})
+    .describe('Model describing the action of triggering a workflow.');
+export const ActionModelSchema = z.lazy(() => z.union([
+    VariableActionModelSchema,
+    EventActionModelSchema,
+    SwitchActionModelSchema,
+    FetchActionModelSchema,
+    CustomActionModelSchema,
+    SetURLParameterActionSchema,
+    SetMultiUrlParameterActionSchema,
+    WorkflowActionModelSchema,
+    BuiltInActionModelSchema,
+]));
+//# sourceMappingURL=action-schema.js.map

package/dist/component/schemas/action-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-schema.js","sourceRoot":"","sources":["../../../src/component/schemas/action-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,gBAAgB;AAChB,MAAM,yBAAyB,GAAmC,CAAC;KAChE,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAChE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAC1B,+CAA+C,CAChD;CACF,CAAC;KACD,QAAQ,CAAC,oDAAoD,CAAC,CAAA;AAEjE,MAAM,sBAAsB,GAAgC,CAAC;KAC1D,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAChE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC3E,CAAC;KACD,QAAQ,CACP,qJAAqJ,CACtJ,CAAA;AAEH,MAAM,uBAAuB,GAAiC,CAAC;KAC5D,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,KAAK,EAAE,CAAC;SACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,SAAS,EAAE,aAAa,CAAC,QAAQ,CAC/B,0EAA0E,CAC3E;QACD,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;aACtC,QAAQ,CAAC,qDAAqD,CAAC;KACnE,CAAC,CACH;SACA,QAAQ,CACP,qEAAqE,CACtE;IACH,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;KAClD,CAAC;SACD,QAAQ,CAAC,mDAAmD,CAAC;CACjE,CAAC;KACD,QAAQ,CACP,+FAA+F,CAChG,CAAA;AAEH,MAAM,sBAAsB,GAAgC,CAAC;KAC1D,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,4FAA4F,CAC7F;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAC7C,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACpE,CAAC,CACH;SACA,QAAQ,CACP,qHAAqH,CACtH;IACH,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;KAClD,CAAC;SACD,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;KAClD,CAAC;SACD,QAAQ,CAAC,0CAA0C,CAAC;IACvD,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;KAClD,CAAC;SACD,OAAO,EAAE;SACT,QAAQ,CACP,iEAAiE,CAClE;CACJ,CAAC;KACD,QAAQ,CAAC,2DAA2D,CAAC,CAAA;AAExE,MAAM,uBAAuB,GAAiC,CAAC;KAC5D,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACtE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,OAAO,EAAE;SACT,QAAQ,CACP,yFAAyF,CAC1F;IACH,SAAS,EAAE,CAAC;SACT,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAClD,OAAO,EAAE,aAAa,CAAC,QAAQ,CAC7B,2CAA2C,CAC5C;KACF,CAAC,CACH;SACA,OAAO,EAAE;SACT,QAAQ,CAAC,yCAAyC,CAAC;IACtD,MAAM,EAAE,CAAC;SACN,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EACzC,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;aACtC,QAAQ,CACP,yDAAyD,CAC1D;KACJ,CAAC;SACD,QAAQ,CACP,4GAA4G,CAC7G,CACJ;SACA,OAAO,EAAE;SACT,QAAQ,CACP,uHAAuH,CACxH;IACH,OAAO,EAAE,CAAC;SACP,OAAO,CAAC,CAAC,CAAC;SACV,OAAO,EAAE;SACT,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;KACD,QAAQ,CACP,oNAAoN,CACrN,CAAA;AAEH,MAAM,wBAAwB,GAAiC,CAAC;KAC7D,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,0HAA0H,CAC3H;IACH,SAAS,EAAE,CAAC;SACT,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAClD,OAAO,EAAE,aAAa,CAAC,QAAQ,CAC7B,2CAA2C,CAC5C;KACF,CAAC,CACH;SACA,OAAO,EAAE;SACT,QAAQ,CAAC,2CAA2C,CAAC;IACxD,MAAM,EAAE,CAAC;SACN,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EACzC,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC;KAClD,CAAC;SACD,QAAQ,CAAC,yDAAyD,CAAC,CACvE;SACA,OAAO,EAAE;SACT,QAAQ,CACP,mGAAmG,CACpG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,mEAAmE,CACpE;CACJ,CAAC;KACD,QAAQ,CACP,oLAAoL,CACrL,CAAA;AAEH,MAAM,2BAA2B,GAAqC,CAAC;KACpE,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;CACnD,CAAC;KACD,QAAQ,CACP,8EAA8E,CAC/E,CAAA;AAEH,MAAM,gCAAgC,GACpC,CAAC;KACE,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,UAAU,EAAE,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC;SACjC,QAAQ,CACP,oIAAoI,CACrI;IACH,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;SACzB,OAAO,EAAE;SACT,QAAQ,CACP,iQAAiQ,CAClQ;CACJ,CAAC;KACD,QAAQ,CACP,2IAA2I,CAC5I,CAAA;AAEL,MAAM,yBAAyB,GAAmC,CAAC;KAChE,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACpE,UAAU,EAAE,CAAC;SACV,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EACtD,CAAC;SACE,MAAM,CAAC;QACN,OAAO,EAAE,aAAa;KACvB,CAAC;SACD,QAAQ,CAAC,4CAA4C,CAAC,CAC1D;SACA,QAAQ,CAAC,sDAAsD,CAAC;IACnE,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,OAAO,EAAE;SACT,QAAQ,CACP,yIAAyI,CAC1I;CACJ,CAAC;KACD,QAAQ,CAAC,uDAAuD,CAAC,CAAA;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAA2B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACnE,CAAC,CAAC,KAAK,CAAC;IACN,yBAAyB;IACzB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,2BAA2B;IAC3B,gCAAgC;IAChC,yBAAyB;IACzB,wBAAwB;CACzB,CAAC,CACH,CAAA"}

package/dist/component/schemas/api-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+import type { ComponentAPI } from '../../api/apiTypes';
+export declare const ComponentAPISchema: z.ZodType<ComponentAPI>;

package/dist/component/schemas/api-schema.js

@@ -0,0 +1,174 @@
+import { z } from 'zod';
+import { EventModelSchema } from './event-schema';
+import { FormulaSchema } from './formula-schema';
+import { MetadataSchema } from './zod-schemas';
+// API Models
+const ApiMethodSchema = z
+    .enum(['GET', 'POST', 'DELETE', 'PUT', 'PATCH', 'HEAD', 'OPTIONS'])
+    .describe('HTTP method for the API request.');
+const ApiParserModeSchema = z
+    .enum(['auto', 'text', 'json', 'event-stream', 'json-stream', 'blob'])
+    .describe('Available modes for parsing API responses.');
+const RedirectStatusCodes = {
+    '300': 300,
+    '301': 301,
+    '302': 302,
+    '303': 303,
+    '304': 304,
+    '307': 307,
+    '308': 308,
+};
+const RedirectStatusCodeSchema = z
+    .enum(RedirectStatusCodes)
+    .describe('HTTP status code to use for the redirect.');
+const ApiRequestSchema = z
+    .object({
+    '@nordcraft/metadata': MetadataSchema.nullish().describe('Metadata for the API request'),
+    version: z
+        .literal(2)
+        .describe('Version of the API request schema. This should always be 2.'),
+    name: z.string().describe('Name of the API request.'),
+    type: z.enum(['http', 'ws']).describe('Type of the API request.'),
+    method: ApiMethodSchema.nullish().describe('HTTP method for the API request.'),
+    url: FormulaSchema.nullish().describe('Base URL for the API request. Params and query strings are added when this API is called.'),
+    service: z
+        .string()
+        .nullish()
+        .describe('Name of the service to use for the API request. Only Services defined in the project can be used here.'),
+    servicePath: z
+        .string()
+        .nullish()
+        .describe('File path to the service definition. If service is defined, servicePath must also be defined.'),
+    inputs: z
+        .record(z.string().describe('Name of the input'), z
+        .object({
+        formula: FormulaSchema.nullish(),
+    })
+        .describe('Formula evaluating to the input value.'))
+        .describe('Inputs to the API request. Inputs have a default value that can be overridden when the API is started from a workflow. Inputs can be used inside any Formula in the API request definition.'),
+    path: z
+        .record(z.string().describe('Name of the path segment'), z.object({
+        formula: FormulaSchema.describe('Formula evaluating to the value of the path segment'),
+        index: z
+            .number()
+            .describe('Index defining the order of the path segments.'),
+    }))
+        .nullish()
+        .describe('Path segments to include in the API request.'),
+    queryParams: z
+        .record(z.string().describe('Name of the query parameter'), z.object({
+        formula: FormulaSchema.describe('Formula evaluating to the value of the query parameter'),
+        enabled: FormulaSchema.nullish().describe('Formula evaluating to whether the query parameter is included or not. If included it should evaluate to true.'),
+    }))
+        .nullish()
+        .describe('Query parameters to include in the API request.'),
+    headers: z
+        .record(z.string().describe('Name of the header'), z.object({
+        formula: FormulaSchema.describe('Formula evaluating to the header value'),
+        enabled: FormulaSchema.nullish().describe('Formula evaluating to whether the header is included or not. If included it should evaluate to true.'),
+    }))
+        .nullish()
+        .describe('Headers to include in the API request.'),
+    body: FormulaSchema.nullish().describe('Body of the API request.'),
+    autoFetch: FormulaSchema.nullish().describe('Indicates if the API request should be automatically fetched when the component or page loads.'),
+    client: z
+        .object({
+        parserMode: ApiParserModeSchema.describe('Defines how the API response should be parsed.'),
+        credentials: z
+            .enum(['include', 'same-origin', 'omit'])
+            .nullish()
+            .describe('Indicates whether credentials such as cookies or authorization headers should be sent with the request.'),
+        debounce: z
+            .object({ formula: FormulaSchema })
+            .nullish()
+            .describe('Debounce time in milliseconds for the API request. Useful for limiting the number of requests made when inputs change rapidly.'),
+        onCompleted: EventModelSchema.nullish().describe('Event triggered when the API request completes successfully.'),
+        onFailed: EventModelSchema.nullish().describe('Event triggered when the API request fails. This is also triggered when the isError formula evaluates to true.'),
+        onMessage: EventModelSchema.nullish().describe('Event triggered when a message is received from the API. Only applicable for WebSocket and streaming APIs.'),
+    })
+        .nullish()
+        .describe('Client-side settings for the API request.'),
+    server: z
+        .object({
+        proxy: z
+            .object({
+            enabled: z
+                .object({ formula: FormulaSchema })
+                .describe('Indicates if the API request should be proxied through the Nordcraft backend server. This is useful for avoiding CORS issues or hiding sensitive information in the request. It is also useful if the request needs access to http-only cookies.'),
+            useTemplatesInBody: z
+                .object({ formula: FormulaSchema })
+                .nullish()
+                .describe('Indicates if templates in the body should be processed when proxying the request. A template could be a http-only cookie that needs to be included in the proxied request. Enabling this flag will ensure that templates in the body are processed before sending the proxied request.'),
+        })
+            .nullish()
+            .describe('Proxy settings for the API request.'),
+        ssr: z
+            .object({
+            enabled: z
+                .object({ formula: FormulaSchema })
+                .nullish()
+                .describe('Indicates if server-side rendering is enabled for this API request. This means the API will be executed on the server during the initial page load. Note: This can have performance implications for the loading of a page on slow APIs.'),
+        })
+            .nullish()
+            .describe('Server-side rendering settings.'),
+    })
+        .nullish()
+        .describe('Server-side settings for the API request.'),
+    timeout: z
+        .object({ formula: FormulaSchema })
+        .nullish()
+        .describe('Timeout for the API request in milliseconds.'),
+    hash: z.object({ formula: FormulaSchema }).nullish(),
+    isError: z
+        .object({ formula: FormulaSchema })
+        .nullish()
+        .describe('Indicates if the last API response was an error. Useful for forcing a response to be treated as an error even if status code is 200.'),
+    redirectRules: z
+        .record(z.string().describe('The key of the redirect rule.'), z
+        .object({
+        formula: FormulaSchema.describe('Formula evaluating to the URL. If a URL is returned, the redirect will be triggered. If null is returned, no redirect will happen.'),
+        index: z
+            .number()
+            .describe('Index defining the order of the redirect rules.'),
+        statusCode: RedirectStatusCodeSchema.nullish().describe('HTTP status code to use for the redirect.'),
+    })
+        .describe('Defines a single redirect rule.'))
+        .nullish()
+        .describe('Rules for redirecting based on response data. The key is a unique identifier for the rule.'),
+})
+    .describe('Schema defining an API request from a component or a page.');
+const LegacyComponentAPISchema = z
+    .object({
+    type: z.literal('REST'),
+    name: z.string(),
+    method: z.enum(['GET', 'POST', 'DELETE', 'PUT']),
+    url: FormulaSchema.nullish(),
+    path: z.array(z.object({ formula: FormulaSchema })).nullish(),
+    queryParams: z
+        .record(z.string(), z.object({
+        name: z.string(),
+        formula: FormulaSchema,
+    }))
+        .nullish(),
+    headers: z
+        .union([z.record(z.string(), FormulaSchema), FormulaSchema])
+        .nullish(),
+    body: FormulaSchema.nullish(),
+    autoFetch: FormulaSchema.nullish(),
+    proxy: z.boolean().nullish(),
+    debounce: z.number().nullish(),
+    throttle: z.number().nullish(),
+    onCompleted: EventModelSchema.nullish(),
+    onFailed: EventModelSchema.nullish(),
+    auth: z
+        .object({
+        type: z.enum(['Bearer id_token', 'Bearer access_token']),
+    })
+        .nullish(),
+})
+    .describe('Legacy API schema for backward compatibility. Never use this for new APIs.');
+export const ComponentAPISchema = z.union([
+    LegacyComponentAPISchema,
+    ApiRequestSchema,
+]);
+//# sourceMappingURL=api-schema.js.map

package/dist/component/schemas/api-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-schema.js","sourceRoot":"","sources":["../../../src/component/schemas/api-schema.ts"],"names":[],"mappings":"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"}

package/dist/component/schemas/attribute-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+import type { ComponentAttribute } from '../component.types';
+export declare const ComponentAttributeSchema: z.ZodType<ComponentAttribute>;

package/dist/component/schemas/attribute-schema.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { MetadataSchema, SCHEMA_DESCRIPTIONS } from './zod-schemas';
+export const ComponentAttributeSchema = z
+    .object({
+    '@nordcraft/metadata': MetadataSchema.nullish().describe(SCHEMA_DESCRIPTIONS.metadata('component attribute')),
+    name: z.string().describe('Name of the component attribute'),
+    testValue: z
+        .any()
+        .describe(SCHEMA_DESCRIPTIONS.testData('component attribute')),
+})
+    .describe('Schema for a component attribute.');
+//# sourceMappingURL=attribute-schema.js.map

package/dist/component/schemas/attribute-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-schema.js","sourceRoot":"","sources":["../../../src/component/schemas/attribute-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnE,MAAM,CAAC,MAAM,wBAAwB,GAAkC,CAAC;KACrE,MAAM,CAAC;IACN,qBAAqB,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,QAAQ,CACtD,mBAAmB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CACpD;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC5D,SAAS,EAAE,CAAC;SACT,GAAG,EAAE;SACL,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;CACjE,CAAC;KACD,QAAQ,CAAC,mCAAmC,CAAC,CAAA"}

package/dist/component/schemas/component-schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import type { Component, PageComponent } from '../component.types';
+export declare const ComponentSchema: z.ZodType<Component>;
+export declare const PageSchema: z.ZodType<PageComponent>;
+export declare const ShallowComponentSchema: z.ZodType<Component>;
+export declare const ShallowPageSchema: z.ZodType<PageComponent>;

package/dist/component/schemas/component-schema.js

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import { ActionModelSchema } from './action-schema';
+import { ComponentAPISchema } from './api-schema';
+import { ComponentAttributeSchema } from './attribute-schema';
+import { ComponentContextSchema } from './context-schema';
+import { ComponentEventSchema } from './event-schema';
+import { ComponentFormulaSchema } from './formula-schema';
+import { NodeModelSchema } from './node-schema';
+import { RouteSchema } from './route-schema';
+import { ComponentVariableSchema } from './variable-schema';
+import { ComponentWorkflowSchema } from './workflow-schema';
+import { SCHEMA_DESCRIPTIONS } from './zod-schemas';
+const commonComponentSchema = (type) => z
+    .object({
+    name: z.string().describe(`Name of the ${type}`),
+    exported: z
+        .boolean()
+        .nullish()
+        .describe(`Whether the ${type} is exported in a package project for use in other projects. Do not change this value. It should be managed by the user.`),
+    nodes: z
+        .record(z.string(), NodeModelSchema)
+        .nullish()
+        .describe(`All nodes in the ${type}, indexed by their unique IDs. Nodes represent HTML elements, text, slots, or ${type === 'component' ? 'other components' : 'components'}. They defined the UI structure of the ${type}.`),
+    variables: z
+        .record(z.string(), ComponentVariableSchema)
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.variables(type)),
+    formulas: z
+        .record(z.string(), ComponentFormulaSchema)
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.formulas(type)),
+    workflows: z
+        .record(z.string(), ComponentWorkflowSchema)
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.workflows(type)),
+    apis: z
+        .record(z.string(), ComponentAPISchema)
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.apis(type)),
+    events: z
+        .array(ComponentEventSchema)
+        .nullish()
+        .describe('All events this the component can emit. Events allow the component to communicate with its parent or other components. They can be triggered via actions.'),
+    contexts: z
+        .record(z.string(), ComponentContextSchema)
+        .nullish()
+        .describe('Defines which contexts this component is subscribed to. Contexts allow the component to access formulas and workflows from other components, enabling reusability and modular design.'),
+    onLoad: z
+        .object({
+        trigger: z.literal('Load'),
+        actions: z.array(ActionModelSchema),
+    })
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.onLoad(type)),
+    onAttributeChange: z
+        .object({
+        trigger: z.literal('Attribute change'),
+        actions: z.array(ActionModelSchema),
+    })
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.onAttributeChange(type)),
+})
+    .describe('Schema defining a reusable Nordcraft component.');
+export const ComponentSchema = commonComponentSchema('component').extend({
+    attributes: z
+        .record(z.string(), ComponentAttributeSchema)
+        .nullish()
+        .describe('All attributes that can be passed into the component when it is used. Attributes allow for customization and configuration of the component instance. When the value of an attribute changes, any formulas depending on it will automatically recalculate and the onAttributeChange lifecycle event is triggered.'),
+});
+export const PageSchema = commonComponentSchema('page').extend({
+    attributes: z
+        .object({})
+        .nullish()
+        .describe('Attributes for the page (currently none). Should always be an empty object.'),
+    route: RouteSchema.describe('Route information for the page, including path segments, query parameters, and metadata such as title and description.'),
+});
+const shallowCommonComponentSchema = (type) => z
+    .object({
+    name: z.string().describe(`Name of the ${type}`),
+    exported: z
+        .boolean()
+        .nullish()
+        .describe(`Whether the ${type} is exported in a package project for use in other projects. Do not change this value. It should be managed by the user.`),
+    nodes: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe(`All nodes in the ${type}, indexed by their unique IDs. Nodes represent HTML elements, text, slots, or ${type === 'component' ? 'other components' : 'components'}. They defined the UI structure of the ${type}.`),
+    variables: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.variables(type)),
+    formulas: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.formulas(type)),
+    workflows: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.workflows(type)),
+    apis: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.apis(type)),
+    events: z
+        .array(z.any())
+        .nullish()
+        .describe('All events this the component can emit. Events allow the component to communicate with its parent or other components. They can be triggered via actions.'),
+    contexts: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe('Defines which contexts this component is subscribed to. Contexts allow the component to access formulas and workflows from other components, enabling reusability and modular design.'),
+    onLoad: z.any().nullish().describe(SCHEMA_DESCRIPTIONS.onLoad(type)),
+    onAttributeChange: z
+        .any()
+        .nullish()
+        .describe(SCHEMA_DESCRIPTIONS.onAttributeChange(type)),
+})
+    .describe('Schema defining a reusable Nordcraft component.');
+export const ShallowComponentSchema = shallowCommonComponentSchema('component').extend({
+    attributes: z
+        .record(z.string(), z.any())
+        .nullish()
+        .describe('All attributes that can be passed into the component when it is used. Attributes allow for customization and configuration of the component instance. When the value of an attribute changes, any formulas depending on it will automatically recalculate and the onAttributeChange lifecycle event is triggered.'),
+});
+export const ShallowPageSchema = shallowCommonComponentSchema('page').extend({
+    attributes: z
+        .any()
+        .nullish()
+        .describe('Attributes for the page (currently none). Should always be an empty object.'),
+    route: RouteSchema.describe('Route information for the page, including path segments, query parameters, and metadata such as title and description.'),
+});
+//# sourceMappingURL=component-schema.js.map

package/dist/component/schemas/component-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-schema.js","sourceRoot":"","sources":["../../../src/component/schemas/component-schema.ts"],"names":[],"mappings":"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"}

package/dist/component/schemas/context-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+import type { ComponentContext } from '../component.types';
+export declare const ComponentContextSchema: z.ZodType<ComponentContext>;

package/dist/component/schemas/context-schema.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export const ComponentContextSchema = z
+    .object({
+    package: z
+        .string()
+        .nullish()
+        .describe('Package name of the component providing the context'),
+    componentName: z
+        .string()
+        .nullish()
+        .describe('Name of the component providing the context'),
+    formulas: z
+        .array(z.string())
+        .describe('Names of the formulas from the context to subscribe to'),
+    workflows: z
+        .array(z.string())
+        .describe('Names of the workflows from the context to subscribe to'),
+})
+    .describe('Schema defining a component context subscription.');
+//# sourceMappingURL=context-schema.js.map

package/dist/component/schemas/context-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-schema.js","sourceRoot":"","sources":["../../../src/component/schemas/context-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,sBAAsB,GAAgC,CAAC;KACjE,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,OAAO,EAAE;SACT,QAAQ,CAAC,qDAAqD,CAAC;IAClE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,OAAO,EAAE;SACT,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,wDAAwD,CAAC;IACrE,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;KACD,QAAQ,CAAC,mDAAmD,CAAC,CAAA"}

package/dist/component/schemas/event-schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { ComponentEvent, EventModel } from '../component.types';
+export declare const EventModelSchema: z.ZodType<EventModel>;
+export declare const ComponentEventSchema: z.ZodType<ComponentEvent>;