@rytass/bpm-core-react 0.17.0 → 0.17.1

package/dist/views/sent/SentView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM "sent" inbox — instances the current
+ * member has initiated or submitted on someone's behalf. Mechanical port of
+ * `apps/client/src/app/sent/page.tsx`.
+ */
+export declare function SentView(): ReactElement;

package/dist/views/sent/index.d.cts

@@ -0,0 +1 @@
+export * from './SentView.cjs';

package/dist/views/sent/index.d.ts

@@ -1 +1 @@
-export * from './SentView';
+export * from './SentView.js';

package/dist/views/settings/index.d.cts

@@ -0,0 +1 @@
+export * from './notifications/index.cjs';

package/dist/views/settings/index.d.ts

@@ -1 +1 @@
-export * from './notifications';
+export * from './notifications/index.js';

package/dist/views/settings/notifications/SettingsNotificationsView.d.cts

@@ -0,0 +1,2 @@
+import { ReactElement } from 'react';
+export declare function SettingsNotificationsView(): ReactElement;

package/dist/views/settings/notifications/index.d.cts

@@ -0,0 +1 @@
+export * from './SettingsNotificationsView.cjs';

package/dist/views/settings/notifications/index.d.ts

@@ -1 +1 @@
-export * from './SettingsNotificationsView';
+export * from './SettingsNotificationsView.js';

package/dist/views/templates/TemplatesView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+export interface TemplateCategoryOption {
+    readonly categoryId: string | null;
+    readonly id: string;
+    readonly name: string;
+}
+export declare function TemplatesView(): ReactElement;

package/dist/views/templates/categories/TemplateCategoriesView.d.cts

@@ -0,0 +1,2 @@
+import { ReactElement } from 'react';
+export declare function TemplateCategoriesView(): ReactElement;

package/dist/views/templates/categories/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/categories-DjENouRm.cjs");exports.TemplateCategoriesView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/categories-AxxhqjLZ.cjs");exports.TemplateCategoriesView=e.t;

package/dist/views/templates/categories/index.d.cts

@@ -0,0 +1 @@
+export * from './TemplateCategoriesView.cjs';

package/dist/views/templates/categories/index.d.ts

@@ -1 +1 @@
-export * from './TemplateCategoriesView';
+export * from './TemplateCategoriesView.js';

package/dist/views/templates/categories/index.js

@@ -1 +1 @@
-export { t as TemplateCategoriesView } from "../../../chunks/categories-1gKxeEqw.js";
+export { t as TemplateCategoriesView } from "../../../chunks/categories-riC33J_j.js";

package/dist/views/templates/compose/TemplateComposeWizardView.d.cts

@@ -0,0 +1,21 @@
+import { ReactElement } from 'react';
+export interface TemplateComposeWizardViewProps {
+    /**
+     * Show the workflow designer AI assistant inside Step 1 (流程設計). Opt-in,
+     * default hidden — the server page maps `BPM_AI_ASSISTANT_ENABLED` to it.
+     */
+    readonly showAiAssistant?: boolean;
+    /**
+     * Whether the LLM backend is configured (host has an API key). When `false`
+     * the AI button shows disabled as a placeholder. Default `false`.
+     */
+    readonly aiAssistantAvailable?: boolean;
+}
+/**
+ * Unified "form + flow" template creation wizard. Walks the user through
+ * Step 0 表單設計 → Step 1 流程設計 → Step 2 檢視並發佈, then commits both
+ * sides atomically through `composeApprovalTemplateWithForm`. This is the
+ * template entry point; the form builder is intentionally controlled here
+ * instead of exposed as a standalone `/forms` page.
+ */
+export declare function TemplateComposeWizardView({ aiAssistantAvailable, showAiAssistant, }?: TemplateComposeWizardViewProps): ReactElement;

package/dist/views/templates/compose/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/compose-DZ7RKvUp.cjs");exports.EMPTY_COMPOSE_FORM_SCHEMA=e.n,exports.EMPTY_COMPOSE_FORM_UI_SCHEMA=e.r,exports.TemplateComposeWizardView=e.t,exports.useTemplateComposeWizard=e.i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/compose-B7TtrpQJ.cjs");exports.EMPTY_COMPOSE_FORM_SCHEMA=e.n,exports.EMPTY_COMPOSE_FORM_UI_SCHEMA=e.r,exports.TemplateComposeWizardView=e.t,exports.useTemplateComposeWizard=e.i;

package/dist/views/templates/compose/index.d.cts

@@ -0,0 +1,2 @@
+export * from './TemplateComposeWizardView.cjs';
+export * from './use-template-compose-wizard.cjs';

package/dist/views/templates/compose/index.d.ts

@@ -1,2 +1,2 @@
-export * from './TemplateComposeWizardView';
-export * from './use-template-compose-wizard';
+export * from './TemplateComposeWizardView.js';
+export * from './use-template-compose-wizard.js';

package/dist/views/templates/compose/index.js

@@ -1 +1 @@
-export { n as EMPTY_COMPOSE_FORM_SCHEMA, r as EMPTY_COMPOSE_FORM_UI_SCHEMA, t as TemplateComposeWizardView, i as useTemplateComposeWizard } from "../../../chunks/compose-Crklayzy.js";
+export { n as EMPTY_COMPOSE_FORM_SCHEMA, r as EMPTY_COMPOSE_FORM_UI_SCHEMA, t as TemplateComposeWizardView, i as useTemplateComposeWizard } from "../../../chunks/compose-_pREPtfN.js";

package/dist/views/templates/compose/steps/ComposeFormStep.d.cts

@@ -0,0 +1,15 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema, FormUiSchema } from '@rytass/bpm-core-shared/form';
+export interface ComposeFormStepProps {
+    readonly name: string;
+    readonly categoryId: string | null;
+    readonly formSchema: FormDefinitionSchema;
+    readonly formUiSchema: FormUiSchema;
+    readonly onNameChange: (value: string) => void;
+    readonly onCategoryIdChange: (value: string | null) => void;
+    readonly onFormChange: (next: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    }) => void;
+}
+export declare function ComposeFormStep({ categoryId, formSchema, formUiSchema, name, onCategoryIdChange, onFormChange, onNameChange, }: ComposeFormStepProps): ReactElement;

package/dist/views/templates/compose/steps/ComposeReviewStep.d.cts

@@ -0,0 +1,12 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export interface ComposeReviewStepProps {
+    readonly name: string;
+    readonly formSchema: FormDefinitionSchema;
+    readonly formUiSchema: FormUiSchema;
+    readonly workflowDefinition: WorkflowDefinition | null;
+    readonly initiatorPolicyCel: string | null;
+    readonly publishError: string | null;
+}
+export declare function ComposeReviewStep({ formSchema, formUiSchema, initiatorPolicyCel, name, publishError, workflowDefinition, }: ComposeReviewStepProps): ReactElement;

package/dist/views/templates/compose/steps/ComposeWorkflowStep.d.cts

@@ -0,0 +1,22 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export interface ComposeWorkflowStepProps {
+    readonly formSchema: FormDefinitionSchema;
+    readonly workflowDefinition: WorkflowDefinition | null;
+    readonly initiatorPolicyCel: string | null;
+    readonly onWorkflowChange: (definition: WorkflowDefinition) => void;
+    readonly onInitiatorPolicyChange: (cel: string | null) => void;
+    /**
+     * Show the AI assistant button inside the embedded designer's side panel.
+     * Follows the same opt-in contract as the standalone designer page; default
+     * hidden. Wired up the stack from the server page's `BPM_AI_ASSISTANT_ENABLED`.
+     */
+    readonly showAiAssistant?: boolean;
+    /**
+     * Whether the LLM backend is configured (host has an API key). When `false`
+     * the AI button shows disabled as a placeholder. Default `false`.
+     */
+    readonly aiAssistantAvailable?: boolean;
+}
+export declare function ComposeWorkflowStep({ aiAssistantAvailable, formSchema, initiatorPolicyCel, onInitiatorPolicyChange, onWorkflowChange, showAiAssistant, workflowDefinition, }: ComposeWorkflowStepProps): ReactElement;

package/dist/views/templates/compose/use-template-compose-wizard.d.cts

@@ -0,0 +1,46 @@
+import { FormDefinitionSchema, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+import { ComposeApprovalTemplateWithFormResult } from '@rytass/bpm-core-client/template';
+export type ComposeWizardStep = 0 | 1 | 2;
+export type ComposePublishPhase = 'error' | 'idle' | 'submitting' | 'success';
+export declare const EMPTY_COMPOSE_FORM_SCHEMA: FormDefinitionSchema;
+export declare const EMPTY_COMPOSE_FORM_UI_SCHEMA: FormUiSchema;
+export interface TemplateComposeWizard {
+    readonly currentStep: ComposeWizardStep;
+    /**
+     * Single user-facing name. Persisted to both the template and the form
+     * (`templateName` / `formName`) at the `composeApprovalTemplateWithForm`
+     * boundary — the DB keeps two columns, the UI keeps one field.
+     */
+    readonly name: string;
+    readonly categoryId: string | null;
+    readonly formSchema: FormDefinitionSchema;
+    readonly formUiSchema: FormUiSchema;
+    readonly workflowDefinition: WorkflowDefinition | null;
+    readonly initiatorPolicyCel: string | null;
+    readonly publishPhase: ComposePublishPhase;
+    readonly publishError: string | null;
+    readonly canLeaveBasics: boolean;
+    readonly goToStep: (step: ComposeWizardStep) => void;
+    readonly goNext: () => void;
+    readonly goBack: () => void;
+    readonly setName: (value: string) => void;
+    readonly setCategoryId: (value: string | null) => void;
+    readonly setFormValue: (next: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    }) => void;
+    readonly setWorkflowDefinition: (definition: WorkflowDefinition) => void;
+    readonly setInitiatorPolicyCel: (cel: string | null) => void;
+    readonly publish: () => Promise<ComposeApprovalTemplateWithFormResult | null>;
+}
+/**
+ * Owns the cross-step state for the unified "form + flow" template wizard.
+ *
+ * Step 0 (表單) edits `formSchema`/`formUiSchema`; that same in-memory schema
+ * feeds Step 1 (流程) as the field source for condition branches, so the
+ * embedded designer never needs a published form version. Step 2 (檢視發佈)
+ * submits everything through the atomic `composeApprovalTemplateWithForm`
+ * mutation.
+ */
+export declare function useTemplateComposeWizard(): TemplateComposeWizard;

package/dist/views/templates/designer/NotifyWebhookTargetsEditor.d.cts

@@ -0,0 +1,20 @@
+import { ReactElement } from 'react';
+import { FormFieldDefinition } from '@rytass/bpm-core-shared/form';
+import { NotifyWebhookTarget } from '@rytass/bpm-core-shared/workflow';
+import { NotifyWebhookDesignerEndpoint } from './notify-webhook-designer.cjs';
+export type NotifyWebhookCatalogState = 'loading' | 'ready' | 'unavailable';
+export interface NotifyWebhookTargetsEditorProps {
+    /** Every endpoint the catalog lists, deprecated ones included. */
+    readonly catalog: readonly NotifyWebhookDesignerEndpoint[];
+    readonly catalogState: NotifyWebhookCatalogState;
+    /** `null` when no form is bound yet, so fields cannot be picked. */
+    readonly formFields: readonly FormFieldDefinition[] | null;
+    readonly onChange: (targets: readonly NotifyWebhookTarget[]) => void;
+    readonly targets: readonly NotifyWebhookTarget[];
+}
+/**
+ * Edits a NOTIFY node's webhook targets (ADR 18 §3.3). Parameters come from
+ * the endpoint catalog, so the author only picks an endpoint and binds each
+ * parameter; a URL, header or secret is never shown or entered here.
+ */
+export declare function NotifyWebhookTargetsEditor({ catalog, catalogState, formFields, onChange, targets, }: NotifyWebhookTargetsEditorProps): ReactElement | null;

package/dist/views/templates/designer/NotifyWebhookTargetsEditor.d.ts

@@ -1,7 +1,7 @@
 import { ReactElement } from 'react';
 import { FormFieldDefinition } from '@rytass/bpm-core-shared/form';
 import { NotifyWebhookTarget } from '@rytass/bpm-core-shared/workflow';
-import { NotifyWebhookDesignerEndpoint } from './notify-webhook-designer';
+import { NotifyWebhookDesignerEndpoint } from './notify-webhook-designer.js';
 export type NotifyWebhookCatalogState = 'loading' | 'ready' | 'unavailable';
 export interface NotifyWebhookTargetsEditorProps {
     /** Every endpoint the catalog lists, deprecated ones included. */

package/dist/views/templates/designer/TemplateDesignerView.d.cts

@@ -0,0 +1,65 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export interface TemplateDesignerViewProps {
+    /**
+     * Template id to load. Required in non-embedded mode; unused in embedded mode.
+     */
+    readonly templateId?: string;
+    /**
+     * When `true`, the component operates in embedded / wizard mode:
+     * - No `readTemplateDesigner` call (no templateId needed).
+     * - Only org data is loaded for approver pickers.
+     * - PageHeader / ContentHeader, form-version binding, and dry-run are hidden.
+     * - The AI assistant, when `showAiAssistant` is set, is offered through a
+     *   button in the side "流程工具" panel (the PageHeader button it normally
+     *   lives in is hidden here), and drives the same embedded canvas.
+     * - Mutations flow out via `onWorkflowChange` / `onInitiatorPolicyChange`
+     *   rather than save-draft / publish actions.
+     * Default `false`.
+     */
+    readonly embedded?: boolean;
+    /**
+     * In embedded mode: the formSchema used for condition-edge compilation,
+     * injected from outside (e.g. the wizard already knows the form). Replaces
+     * the "bind form version" picker. Pass `null` to clear.
+     */
+    readonly formSchemaOverride?: FormDefinitionSchema | null;
+    /**
+     * In embedded mode: the initial workflow definition to seed the canvas.
+     * Falls back to an empty start→end workflow when omitted.
+     */
+    readonly initialWorkflowDefinition?: WorkflowDefinition;
+    /**
+     * In embedded mode: the initial initiator-policy CEL expression.
+     * Falls back to `null` (no policy) when omitted.
+     */
+    readonly initialInitiatorPolicyCel?: string | null;
+    /**
+     * In embedded mode: called whenever the workflow definition changes so the
+     * host can persist the current canvas state.
+     */
+    readonly onWorkflowChange?: (definition: WorkflowDefinition) => void;
+    /**
+     * In embedded mode: called whenever the initiator-policy CEL changes.
+     */
+    readonly onInitiatorPolicyChange?: (cel: string | null) => void;
+    /**
+     * Render the "試跑流程" (dry-run) button at all. Default `true`. Hosts can
+     * pass `false` to hide it (e.g. deployments that don't expose dry-run).
+     * Has no effect in embedded mode, where the PageHeader is hidden entirely.
+     */
+    readonly showDryRun?: boolean;
+    /**
+     * Render the AI assistant toggle at all. Default `false` — the feature is
+     * hidden unless the host opts in (e.g. a deployment that has it configured).
+     */
+    readonly showAiAssistant?: boolean;
+    /**
+     * Whether the LLM backend is configured (e.g. the host has an API key set).
+     * Default `true`. When `false`, the toggle is shown but disabled and labelled
+     * as not configured — a placeholder rather than a broken feature.
+     */
+    readonly aiAssistantAvailable?: boolean;
+}
+export declare function TemplateDesignerView({ aiAssistantAvailable, embedded, formSchemaOverride, initialInitiatorPolicyCel, initialWorkflowDefinition, onInitiatorPolicyChange, onWorkflowChange, showAiAssistant, showDryRun, templateId, }: TemplateDesignerViewProps): ReactElement;

package/dist/views/templates/designer/chrome-workflow-chat.d.cts

@@ -0,0 +1,12 @@
+import { UIMessage } from 'ai';
+import { WorkflowDesignerController } from './use-workflow-designer-controller.cjs';
+export interface UseChromeWorkflowChatResult {
+    /** True only when the on-device model is usable in this browser. */
+    readonly available: boolean;
+    readonly messages: readonly UIMessage[];
+    readonly status: 'ready' | 'submitted' | 'streaming' | 'error';
+    readonly send: (text: string) => void;
+}
+export declare function useChromeWorkflowChat({ controller, }: {
+    readonly controller: WorkflowDesignerController;
+}): UseChromeWorkflowChatResult;

package/dist/views/templates/designer/chrome-workflow-chat.d.ts

@@ -1,5 +1,5 @@
 import { UIMessage } from 'ai';
-import { WorkflowDesignerController } from './use-workflow-designer-controller';
+import { WorkflowDesignerController } from './use-workflow-designer-controller.js';
 export interface UseChromeWorkflowChatResult {
     /** True only when the on-device model is usable in this browser. */
     readonly available: boolean;

package/dist/views/templates/designer/decision-policy-options.d.cts

@@ -0,0 +1,8 @@
+import { DecisionPolicy } from '@rytass/bpm-core-shared/workflow';
+export type DecisionPolicyOption = Readonly<{
+    id: DecisionPolicy['type'];
+    name: string;
+}>;
+export declare const DECISION_POLICY_OPTIONS: readonly DecisionPolicyOption[];
+export declare function readDecisionPolicyHint(policy: DecisionPolicy | undefined): string;
+export declare function readDecisionPolicyOption(type: DecisionPolicy['type']): DecisionPolicyOption;

package/dist/views/templates/designer/designer-version-labels.d.cts

@@ -0,0 +1,12 @@
+/**
+ * Header line of the designer. A published template version is named
+ * explicitly because the bound form's own version sits right below it, and a
+ * reader seeing only "v1" there takes it for the template's version.
+ */
+export declare function readTemplateVersionDescription(input: {
+    draftVersion: number | null;
+    hasPublishedVersion: boolean;
+    publishedVersion: number | null;
+}): string;
+/** The bound form's version, labelled so it is not mistaken for the template's. */
+export declare function readFormVersionLabel(formName: string, version: number): string;

package/dist/views/templates/designer/dry-run-assignee-label.d.cts

@@ -0,0 +1,28 @@
+type NamedRecord = Readonly<{
+    id: string;
+    name: string;
+}>;
+type FormFieldRecord = Readonly<{
+    fieldKey: string;
+    label: string;
+}>;
+export type DryRunAssigneeDirectory = Readonly<{
+    /** Fields of the schema the dry run samples, to name a member placeholder. */
+    formFields: readonly FormFieldRecord[];
+    /** Display name of a real member id, or `null` when it is not known. */
+    memberName: (memberId: string) => string | null;
+    orgUnits: readonly NamedRecord[];
+    positions: readonly NamedRecord[];
+}>;
+/**
+ * The dry run cannot know who a position / org-unit / manager-chain resolver
+ * would pick (that depends on the submitter and the directory at submit
+ * time), so the engine reports a `<kind>:<ids>` placeholder instead of a
+ * member id. This turns each placeholder into a sentence a template author can
+ * read; a real member id becomes the member's name, and anything else is
+ * returned untouched so an unexpected value stays visible.
+ *
+ * The placeholder shapes mirror `resolveDryRunAssigneeMemberId` in the engine.
+ */
+export declare function readDryRunAssigneeLabel(assignee: string, directory: DryRunAssigneeDirectory): string;
+export {};

package/dist/views/templates/designer/dry-run-sample-data.d.cts

@@ -0,0 +1,9 @@
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+export declare function readDryRunSampleFormData(schema: FormDefinitionSchema | null): Readonly<Record<string, unknown>>;
+/**
+ * Sample value of a member field: a placeholder the dry-run result labels as
+ * "whoever this field names", never the dry-run initiator — a real submitter
+ * picks someone else, and sampling the initiator would make a node that
+ * excludes the initiator look skipped or stopped when it would not be.
+ */
+export declare function readDryRunFormMemberPlaceholder(fieldKey: string): string;

package/dist/views/templates/designer/dynamic-form-resolver-options.d.cts

@@ -0,0 +1,35 @@
+import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
+export type MemberFieldOption = Readonly<{
+    id: string;
+    name: string;
+    /**
+     * Set when the field can be empty at submit time (optional, hidden by a
+     * visibility rule, or a store-only hidden field); the node would then find no
+     * approver, so publishing refuses it. Still selectable, so the stored choice
+     * stays visible until the form or the node is fixed.
+     */
+    warning?: string;
+}>;
+export type DynamicFormFieldChoice = Readonly<{
+    /** What the picker offers; includes the stale stored key when there is one. */
+    options: readonly MemberFieldOption[];
+    /** Hint under the picker, or `null` when nothing needs saying. */
+    problem: string | null;
+    selected: MemberFieldOption | null;
+}>;
+export declare const NO_MEMBER_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u300C\u4EBA\u54E1\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
+/** Only member fields can feed a 依表單欄位指定 approver resolver. */
+export declare function readMemberFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
+/**
+ * The member-field picker for the 依表單欄位指定 resolver. A stored `formPath`
+ * that no longer names a member field of the bound form (the form was switched
+ * or edited, or the template came from the API) stays visible as its own
+ * option together with a warning, instead of being cleared behind the user's
+ * back — the resolver stays invalid until a real field is chosen.
+ */
+export declare function readDynamicFormFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * 依表單欄位：<label>; the field key when the form does not have it (any
+ * more), and a marker when the key names something that is not a member field.
+ */
+export declare function readDynamicFormSummary(schema: FormDefinitionSchema | null, formPath: string): string;

package/dist/views/templates/designer/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/designer-sJGTGYOf.cjs");exports.TemplateDesignerView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/designer-ttAqv859.cjs");exports.TemplateDesignerView=e.t;

package/dist/views/templates/designer/index.d.cts

@@ -0,0 +1 @@
+export * from './TemplateDesignerView.cjs';

package/dist/views/templates/designer/index.d.ts

@@ -1 +1 @@
-export * from './TemplateDesignerView';
+export * from './TemplateDesignerView.js';

package/dist/views/templates/designer/index.js

@@ -1 +1 @@
-export { t as TemplateDesignerView } from "../../../chunks/designer-D9eFma1W.js";
+export { t as TemplateDesignerView } from "../../../chunks/designer-BiywgNXs.js";

package/dist/views/templates/designer/notify-webhook-designer.d.cts

@@ -0,0 +1,74 @@
+import { FormFieldDefinition } from '@rytass/bpm-core-shared/form';
+import { NotifyWebhookBindingSource, NotifyWebhookContextPath, NotifyWebhookParameterType, NotifyWebhookTarget, WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+import { NotifyWebhookEndpointContract } from '@rytass/bpm-core-shared/workflow-graph';
+export type NotifyWebhookBindingKind = NotifyWebhookBindingSource['kind'];
+/** The catalog fields the designer reads; a subset of the client record. */
+export interface NotifyWebhookDesignerEndpoint extends NotifyWebhookEndpointContract {
+    readonly deprecated: boolean;
+    readonly description: string | null;
+    /** Switched off by an administrator (database endpoints). */
+    readonly disabled?: boolean;
+    readonly key: string;
+    readonly label: string;
+    readonly parameters: readonly {
+        readonly description: string | null;
+        readonly key: string;
+        readonly label: string;
+        readonly required: boolean;
+        readonly type: NotifyWebhookParameterType;
+    }[];
+    /** `DATABASE` endpoints are maintained in the back office. */
+    readonly source?: 'DATABASE' | 'REGISTRY';
+    readonly version: number;
+}
+type DesignerParameter = NotifyWebhookDesignerEndpoint['parameters'][number];
+export declare const NOTIFY_WEBHOOK_CONTEXT_PATH_LABELS: Readonly<Record<NotifyWebhookContextPath, string>>;
+export declare const NOTIFY_WEBHOOK_PARAMETER_TYPE_LABELS: Readonly<Record<NotifyWebhookParameterType, string>>;
+export declare function readNotifyWebhookEndpointOptionId(endpoint: {
+    readonly key: string;
+    readonly version: number;
+}): string;
+export declare function findNotifyWebhookEndpoint(endpoints: readonly NotifyWebhookDesignerEndpoint[], reference: {
+    readonly key: string;
+    readonly version: number;
+}): NotifyWebhookDesignerEndpoint | null;
+/**
+ * The sources a parameter can take. A `CONTEXT` path is always a string, and
+ * a `CONSTANT` cannot hold a list, so those are only offered where they fit.
+ */
+export declare function readNotifyWebhookBindingKinds(type: NotifyWebhookParameterType): readonly NotifyWebhookBindingKind[];
+export declare function readCompatibleFormFields(formFields: readonly FormFieldDefinition[], type: NotifyWebhookParameterType): readonly FormFieldDefinition[];
+/** The value a binding starts with when its source kind is picked. */
+export declare function createNotifyWebhookBindingSource(kind: NotifyWebhookBindingKind, parameter: DesignerParameter, formFields: readonly FormFieldDefinition[]): NotifyWebhookBindingSource;
+/**
+ * Reads a typed constant from a text input. A number parameter takes plain
+ * decimals only (no `0x1f`, no exponent); anything else, including a number
+ * still being typed such as `1.`, stays text so the publish check can point
+ * at it instead of the input silently changing what was typed.
+ */
+export declare function readNotifyWebhookConstantValue(type: NotifyWebhookParameterType, raw: string): boolean | number | string | null;
+/**
+ * Whether the editor can render a node's `webhooks` at all. Parsed JSON is
+ * saved as a draft without the structural lint, so a hand-edited list may
+ * hold values the editor would throw on.
+ */
+export declare function isNotifyWebhookListEditable(webhooks: unknown): boolean;
+/** Sets, or with `null` removes, the binding for one parameter. */
+export declare function setNotifyWebhookBinding(target: NotifyWebhookTarget, parameter: string, from: NotifyWebhookBindingSource | null): NotifyWebhookTarget;
+/**
+ * Points a target at another endpoint, keeping the id (deliveries are keyed
+ * by it) and every binding whose parameter the new endpoint still declares
+ * with a type the bound value fits.
+ */
+export declare function switchNotifyWebhookEndpoint(target: NotifyWebhookTarget, endpoint: NotifyWebhookDesignerEndpoint, formFields: readonly FormFieldDefinition[]): NotifyWebhookTarget;
+/**
+ * The publish check the backend runs against the catalog, worded for the
+ * designer. Only structurally valid targets are checked; shape problems are
+ * already reported by the shared structural lint.
+ */
+export declare function readNotifyWebhookDesignerIssues({ definition, endpoints, formFields, }: {
+    readonly definition: WorkflowDefinition;
+    readonly endpoints: readonly NotifyWebhookDesignerEndpoint[];
+    readonly formFields: readonly FormFieldDefinition[];
+}): readonly string[];
+export {};

package/dist/views/templates/designer/position-level-options.d.cts

@@ -0,0 +1,17 @@
+import { PositionRecord } from '@rytass/bpm-core-client/organization';
+export type PositionLevelOption = Readonly<{
+    id: string;
+    name: string;
+    value: number;
+}>;
+type PositionLevelSource = Pick<PositionRecord, 'level' | 'name'>;
+/**
+ * One option per distinct position level in the directory, highest first, each
+ * labelled with the positions sitting on that level. A saved level that no
+ * position carries (positions deleted or not loaded yet) is still offered so
+ * the select never renders blank and the stored value is not silently changed.
+ */
+export declare function readMinPositionLevelOptions(positions: readonly PositionLevelSource[], currentLevel: number): readonly PositionLevelOption[];
+/** The highest level in the directory, or `1` when there are no positions. */
+export declare function readDefaultMinPositionLevel(positions: readonly PositionLevelSource[]): number;
+export {};

package/dist/views/templates/designer/use-workflow-chat.d.cts

@@ -0,0 +1,21 @@
+import { UseChatHelpers } from '@ai-sdk/react';
+import { UIMessage } from 'ai';
+import { WorkflowDesignerController } from './use-workflow-designer-controller.cjs';
+/**
+ * Connects the workflow designer chat UI to the LLM.
+ *
+ * The server route (`@rytass/bpm-core-react/next/workflow-chat-route`) advertises
+ * the workflow tools with no `execute`, so every tool call is forwarded here.
+ * `onToolCall` runs it against the same {@link WorkflowDesignerController} the UI
+ * uses — so the assistant draws on the canvas exactly as a user would — and feeds
+ * the resulting snapshot back to the model, forming the observe→act loop.
+ *
+ * All tools are dynamic on the client (their names are not statically wired into
+ * `useChat`), so we handle (not skip) `toolCall.dynamic`.
+ */
+export interface UseWorkflowChatOptions {
+    readonly controller: WorkflowDesignerController;
+    /** Chat API route. Defaults to same-origin `/api/chat`. */
+    readonly api?: string;
+}
+export declare function useWorkflowChat({ controller, api, }: UseWorkflowChatOptions): UseChatHelpers<UIMessage>;

package/dist/views/templates/designer/use-workflow-chat.d.ts

@@ -1,6 +1,6 @@
 import { UseChatHelpers } from '@ai-sdk/react';
 import { UIMessage } from 'ai';
-import { WorkflowDesignerController } from './use-workflow-designer-controller';
+import { WorkflowDesignerController } from './use-workflow-designer-controller.js';
 /**
  * Connects the workflow designer chat UI to the LLM.
  *

package/dist/views/templates/designer/use-workflow-designer-controller.d.cts

@@ -0,0 +1,41 @@
+import { WorkflowCommand, WorkflowCommandResult, WorkflowDesignerState, WorkflowMacroCommand, WorkflowDirectory, WorkflowSnapshot, WorkflowTool, WorkflowToolResult } from '@rytass/bpm-core-shared';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+/**
+ * Bridges the pure, framework-agnostic workflow command layer
+ * (`@rytass/bpm-core-shared`) to React. It owns the {@link WorkflowDesignerState}
+ * and is the single dispatch path through which both the designer UI and the
+ * LLM assistant mutate the workflow — guaranteeing the assistant can do exactly
+ * what a user can.
+ *
+ * The pure reducer only describes logical structure; this hook injects the
+ * pixel concern: whenever a command reports `effects.layout`, the supplied
+ * `layout` function (dagre) recomputes node positions, and `onLayout` is invoked
+ * so the host can refit the viewport.
+ */
+export interface UseWorkflowDesignerControllerOptions {
+    readonly initialState: WorkflowDesignerState;
+    /** Recompute node pixel positions (dagre) — runs after topology changes. */
+    readonly layout: (definition: WorkflowDefinition) => WorkflowDefinition;
+    /** Notified with the laid-out definition so the host can refit the viewport. */
+    readonly onLayout?: (definition: WorkflowDefinition) => void;
+    /** Org directory backing the LLM's member/org lookup query tools. */
+    readonly directory?: WorkflowDirectory;
+}
+export interface WorkflowDesignerController {
+    readonly state: WorkflowDesignerState;
+    readonly snapshot: WorkflowSnapshot;
+    /** The advertised LLM tool catalog (JSON Schema input contracts). */
+    readonly tools: readonly WorkflowTool[];
+    /** Dispatch a single primitive command. */
+    readonly dispatch: (command: WorkflowCommand) => WorkflowCommandResult;
+    /** Dispatch a high-level macro command. */
+    readonly dispatchMacro: (command: WorkflowMacroCommand) => WorkflowCommandResult;
+    /** Execute an LLM tool call by name; mutations commit + relayout. Async
+     * because directory query tools may fetch from the host. */
+    readonly executeTool: (toolName: string, input: unknown) => Promise<WorkflowToolResult>;
+    /** Replace the whole state (e.g. after loading a draft from the server). */
+    readonly replaceState: (next: WorkflowDesignerState | ((current: WorkflowDesignerState) => WorkflowDesignerState)) => void;
+    /** Imperatively read the latest committed state (avoids stale closures). */
+    readonly getState: () => WorkflowDesignerState;
+}
+export declare function useWorkflowDesignerController({ directory, initialState, layout, onLayout, }: UseWorkflowDesignerControllerOptions): WorkflowDesignerController;