@rytass/bpm-core-react 0.16.2 → 0.17.1

package/dist/views/instances/detail/sections/shared.d.cts

@@ -0,0 +1,141 @@
+import { ActivityLogRecord, ApprovalInstanceRecord, AttachmentRecord, MemberProfileRecord, SignatureRecord, SignatureVerificationRecord, TaskDecisionRecord, TaskRecord, WorkflowTokenRecord } from '@rytass/bpm-core-client/workflow';
+import { WorkflowDefinition, WorkflowNode } from '@rytass/bpm-core-shared/workflow';
+export type TaskRow = Readonly<Record<string, unknown> & TaskRecord & {
+    assigneeLabel: string;
+    key: string;
+    nodeLabel: string;
+    statusLabel: string;
+}>;
+export type AttachmentRow = Readonly<Record<string, unknown> & {
+    attachment: AttachmentRecord;
+    createdAt: string;
+    filename: string;
+    id: string;
+    key: string;
+    mimeType: string;
+    sizeLabel: string;
+}>;
+export type SignatureRow = Readonly<Record<string, unknown> & {
+    algorithm: string;
+    hashLabel: string;
+    key: string;
+    keyVersion: number;
+    signedAtLabel: string;
+    signerMemberId: string;
+}>;
+export type MemberOption = Readonly<{
+    email: string | null;
+    id: string;
+    name: string;
+}>;
+export type ActivityStepDescriptionPart = Readonly<{
+    text: string;
+    type: 'text';
+}> | Readonly<{
+    email: string | null;
+    label: string;
+    memberId: string | null;
+    prefix: string;
+    type: 'member';
+}>
+/**
+ * What an approver actually wrote. Kept apart from the `text` parts so the
+ * timeline can give it its own line instead of burying it mid-sentence
+ * between the node, the actor, the timestamp and the signature hash.
+ */
+ | Readonly<{
+    label: string;
+    text: string;
+    tone: 'danger' | 'neutral';
+    type: 'comment';
+}>;
+export interface ActivityStepRecord {
+    readonly descriptionParts: readonly ActivityStepDescriptionPart[];
+    readonly error: boolean;
+    readonly forcePending?: boolean;
+    readonly id: string;
+    readonly title: string;
+}
+interface DelegationChainStep {
+    readonly from: string;
+    readonly reason: string;
+    readonly ruleId: string | null;
+    readonly to: string;
+}
+export declare function readDelegationChain(value: string): readonly DelegationChainStep[];
+export declare function readStringField(record: Readonly<Record<string, unknown>>, key: string): string | null;
+export declare function readStringArrayField(record: Readonly<Record<string, unknown>>, key: string): readonly string[];
+export declare function readNumberField(record: Readonly<Record<string, unknown>>, key: string): number | null;
+export declare function isPresentText(value: string | null): value is string;
+export declare function isRecord(value: unknown): value is Readonly<Record<string, unknown>>;
+export declare function isPendingTask(task: TaskRecord): boolean;
+export declare function readErrorMessage(error: unknown): string;
+export declare function formatFileSize(sizeBytes: number): string;
+export declare function readShortHash(hash: string): string;
+export declare function readInstanceStateLabel(state: string): string;
+export declare function readTaskStatusLabel(status: TaskRecord['status']): string;
+export declare function readTaskDecisionActionLabel(action: string): string;
+export declare function readNodeKindLabel(type: WorkflowNode['type']): string;
+export declare function readNodeDisplayLabel(nodeId: string, workflow: WorkflowDefinition | null): string;
+export declare function readMemberDisplayText(memberId: string | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>): string;
+export declare function readTaskAssigneeLabel(task: TaskRecord, memberProfilesById?: ReadonlyMap<string, MemberProfileRecord>): string;
+export declare function canMemberActOnTask(task: TaskRecord, memberId: string | null): boolean;
+export declare function readReturnTargetOptions(workflow: WorkflowDefinition, node: WorkflowNode): readonly {
+    readonly id: string;
+    readonly name: string;
+}[];
+export declare function readMemberOption(profile: MemberProfileRecord): MemberOption;
+/**
+ * The target an ad-hoc directive is sent to, or the reason it cannot be built
+ * yet. Kept out of the component so the "which shape do we send" decision is
+ * testable on its own — it is the part that changed when the member picker
+ * went from one selection to many.
+ */
+export type AdhocTargetDraft = Readonly<{
+    target: Readonly<{
+        kind: 'MEMBER';
+        memberIds: readonly string[];
+    }> | Readonly<{
+        kind: 'WEBHOOK';
+        webhookUrl: string;
+    }>;
+    valid: true;
+}> | Readonly<{
+    error: string;
+    valid: false;
+}>;
+export declare function readAdhocTargetDraft({ memberIds, useWebhookTarget, webhookUrl, }: {
+    readonly memberIds: readonly string[];
+    readonly useWebhookTarget: boolean;
+    readonly webhookUrl: string;
+}): AdhocTargetDraft;
+export declare function isPresentMemberOption(option: MemberOption | null): option is MemberOption;
+export declare function readMemberOptionFromValue(value: unknown): MemberOption | null;
+export declare function readUniqueMemberOption(searchText: string, options: readonly MemberOption[]): MemberOption | null;
+export declare function readTextDescriptionPart(text: string | null): ActivityStepDescriptionPart | null;
+export declare function readCommentDescriptionPart(label: string, text: string | null, tone?: 'danger' | 'neutral'): ActivityStepDescriptionPart | null;
+export declare function readMemberDescriptionPart(prefix: string, memberId: string | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>, fallbackLabel: string): ActivityStepDescriptionPart;
+export declare function isActivityDescriptionPart(part: ActivityStepDescriptionPart | null): part is ActivityStepDescriptionPart;
+export declare function readCurrentActivityStep(activitySteps: readonly ActivityStepRecord[]): number;
+export declare function isUserMeaningfulActivity(activityLog: ActivityLogRecord): boolean;
+/**
+ * Member ids that only appear inside the payload of the sequential-signing
+ * events, so the timeline can load their profiles and show names, not ids.
+ */
+export declare function readSequentialActivityPayloadMemberIds(activityLog: ActivityLogRecord): readonly string[];
+export declare function readActivityEventLabel(eventType: string, payload: Readonly<Record<string, unknown>>): string;
+export declare function readActivityPayload(activityLog: ActivityLogRecord): Readonly<Record<string, unknown>>;
+export declare function isActivityError(activityLog: ActivityLogRecord, payload: Readonly<Record<string, unknown>>): boolean;
+export declare function formatActivityDateTime(value: string): string;
+export declare function readActivityDetailParts(activityLog: ActivityLogRecord, payload: Readonly<Record<string, unknown>>, workflow: WorkflowDefinition | null, taskDecisionsByTaskId: ReadonlyMap<string, TaskDecisionRecord>, signaturesById: ReadonlyMap<string, SignatureRecord>, signatureVerification: SignatureVerificationRecord | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>): readonly ActivityStepDescriptionPart[];
+export declare function isFutureTimelineNode(node: WorkflowNode, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: ApprovalInstanceRecord['state'], representedNodeIds: ReadonlySet<string>): boolean;
+export declare function readFutureTimelineNodes(workflow: WorkflowDefinition, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: ApprovalInstanceRecord['state'], representedNodeIds: ReadonlySet<string>): readonly WorkflowNode[];
+export declare function readFutureNodeStepTitle(node: WorkflowNode): string;
+export declare function readActivityStepRecords(activityLogs: readonly ActivityLogRecord[], tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], workflow: WorkflowDefinition | null, instanceState: ApprovalInstanceRecord['state'], memberProfilesById: ReadonlyMap<string, MemberProfileRecord>, taskDecisionsByTaskId: ReadonlyMap<string, TaskDecisionRecord>, signaturesById: ReadonlyMap<string, SignatureRecord>, signatureVerification: SignatureVerificationRecord | null): ActivityStepRecord[];
+type RuntimeTone = 'cancelled' | 'completed' | 'current' | 'neutral' | 'waiting';
+export declare function readNodeRuntimeState(node: WorkflowNode, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: string): Readonly<{
+    secondaryLabel: string;
+    statusLabel: string;
+    tone: RuntimeTone;
+}>;
+export {};

package/dist/views/instances/detail/submitted-by.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Who filed an approval instance on someone's behalf.
+ *
+ * `submittedByMemberId` is `null` on rows written before the column existed
+ * and equals `initiatorMemberId` when the applicant submitted it themselves;
+ * only a different, non-empty value means somebody else filed it. This is the
+ * one place the detail page reads that rule.
+ */
+interface SubmittedByFields {
+    readonly initiatorMemberId: string | null | undefined;
+    readonly submittedByMemberId?: string | null;
+}
+interface NamedMember {
+    readonly name: string;
+}
+export declare function readDistinctSubmitterMemberId({ initiatorMemberId, submittedByMemberId, }: SubmittedByFields): string | null;
+/**
+ * 「由 {submitter} 代 {initiator} 送出」, or `null` when the applicant
+ * submitted it themselves. A member whose profile did not load shows by id,
+ * like every other member on the page.
+ */
+export declare function readSubmittedOnBehalfLabel(fields: SubmittedByFields, memberProfilesById: ReadonlyMap<string, NamedMember>): string | null;
+export {};

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

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

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

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

package/dist/views/instances/new/InstanceNewView.d.cts

@@ -0,0 +1,15 @@
+import { ReactElement } from 'react';
+export interface InstanceNewViewProps {
+    /**
+     * Optional template id pre-selected by the host. The Server Component
+     * page should read `?templateId=` from its `searchParams` and pass the
+     * value through this prop.
+     */
+    readonly templateId?: string | null;
+}
+/**
+ * Framework-agnostic view for the BPM "發起簽核" launch page. Mechanical port
+ * of `apps/client/src/app/instances/new/page.tsx` — picks a launchable
+ * template and submits the launch form.
+ */
+export declare function InstanceNewView(props?: InstanceNewViewProps): ReactElement;

package/dist/views/instances/new/index.d.cts

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

package/dist/views/instances/new/index.d.ts

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

package/dist/views/login/LoginView.d.cts

@@ -0,0 +1,47 @@
+import { ReactElement } from 'react';
+export interface LoginViewProps {
+    /**
+     * Logo image URL. Renders an inline `<img>` so the view stays framework
+     * agnostic (no `next/image` dependency). Defaults to
+     * `/rytass-logo.png` — host should serve a static asset at that path or
+     * override via this prop.
+     */
+    readonly logoSrc?: string;
+    /**
+     * Pre-fill the identifier input. Defaults to the seeded demo account
+     * email so the form is usable out of the box.
+     */
+    readonly defaultIdentifier?: string;
+    /**
+     * Pre-fill the password input. Defaults to the seeded demo password
+     * (`'demo'`). Production hosts should pass an empty string.
+     */
+    readonly defaultPassword?: string;
+    /**
+     * Custom redirect target after a successful login. Defaults to reading
+     * `?next=` from the host router's search params, falling back to `'/'`.
+     */
+    readonly defaultNextPath?: string;
+    /**
+     * Override the BPM admin brand title shown above the form. Defaults to
+     * `'BPM Admin'`.
+     */
+    readonly brandTitle?: string;
+    /**
+     * Override the brand subtitle shown above the form. Defaults to
+     * `'BPM API 登入'`.
+     */
+    readonly brandSubtitle?: string;
+}
+/**
+ * Login UI for the BPM admin host. Renders the brand mark, identifier /
+ * password fields, and a "test members" picker fed by
+ * `listApiTestMembers()`. Self-contained: composes Mezzanine UI primitives,
+ * reads the auth context, and uses the host router adapter to redirect on
+ * success.
+ *
+ * Wrap with `<AuthProvider>` (and indirectly `<RouterAdapterProvider>`)
+ * higher in the tree. The `pages/login` subpath ships a thin Next.js
+ * wrapper that exports `default` (Server Component) and `metadata`.
+ */
+export declare function LoginView({ logoSrc, defaultIdentifier, defaultPassword, defaultNextPath, brandTitle, brandSubtitle, }?: LoginViewProps): ReactElement;

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

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

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

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

package/dist/views/root/RootView.d.cts

@@ -0,0 +1,10 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic placeholder for the BPM root path. Server-side redirect
+ * to `/dashboard` is the consumer's responsibility (Next.js `middleware.ts`
+ * or `app/page.tsx`). This view renders nothing so it can be safely mounted
+ * during the redirect flash.
+ *
+ * Mechanical port of `apps/client/src/app/page.tsx`.
+ */
+export declare function RootView(): ReactElement | null;

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

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

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

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

package/dist/views/search/SearchView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM case search page — list of all
+ * instances the current member has visibility on. Mechanical port of
+ * `apps/client/src/app/search/page.tsx`.
+ */
+export declare function SearchView(): ReactElement;

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

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

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

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

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-DUH9cQ-L.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-DO6n0NJi.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;