@rytass/bpm-core-react 0.17.0 → 0.17.1

package/dist/pages/admin/webhook-endpoints/index.d.cts

@@ -0,0 +1,4 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function AdminWebhookEndpointsPage(): ReactElement;

package/dist/pages/cc/index.d.cts

@@ -0,0 +1,16 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM "cc" page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM cc inbox. Usage in
+ * `app/cc/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/cc';
+ * ```
+ */
+export default function CcPage(): ReactElement;

package/dist/pages/dashboard/index.d.cts

@@ -0,0 +1,16 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM dashboard page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM dashboard. Usage in
+ * `app/dashboard/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/dashboard';
+ * ```
+ */
+export default function DashboardPage(): ReactElement;

package/dist/pages/delegations/index.d.cts

@@ -0,0 +1,4 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function DelegationsPage(): ReactElement;

package/dist/pages/inbox/index.d.cts

@@ -0,0 +1,16 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM inbox page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM inbox. Usage in
+ * `app/inbox/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/inbox';
+ * ```
+ */
+export default function InboxPage(): ReactElement;

package/dist/pages/instances/detail/index.d.cts

@@ -0,0 +1,23 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM instance detail page. Consumers re-export
+ * this alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM instance detail screen.
+ * Accepts the standard App Router `params: Promise<{ id: string }>` shape
+ * and forwards the resolved `id` into the view as `instanceId`.
+ *
+ * Usage in `app/instances/[id]/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/instances/detail';
+ * ```
+ */
+export default function InstanceDetailPage({ params, }: {
+    readonly params: Promise<{
+        readonly id: string;
+    }>;
+}): Promise<ReactElement>;

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

@@ -0,0 +1,20 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM "launch approval" page. Consumers re-export
+ * this alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM launch screen. Usage in
+ * `app/instances/new/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/instances/new';
+ * ```
+ */
+export default function InstanceNewPage({ searchParams, }: {
+    readonly searchParams: Promise<{
+        readonly templateId?: string;
+    }>;
+}): Promise<ReactElement>;

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

@@ -0,0 +1,21 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM login page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM login screen.
+ *
+ * Consumer usage in `app/login/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/login';
+ * ```
+ */
+export default function LoginPage({ searchParams, }: {
+    readonly searchParams: Promise<{
+        readonly next?: string;
+    }>;
+}): Promise<ReactElement>;

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

@@ -0,0 +1,18 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM root path.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM root path. Server-side
+ * redirects to `/dashboard` — never renders any client tree, so it cannot
+ * pollute the chunk boundary with `'use client'`.
+ *
+ * Consumer usage in `app/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/root';
+ * ```
+ */
+export default function RootPage(): ReactElement;

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

@@ -0,0 +1,16 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM case search page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM case search. Usage in
+ * `app/search/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/search';
+ * ```
+ */
+export default function SearchPage(): ReactElement;

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

@@ -0,0 +1,16 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+/**
+ * Next.js metadata for the BPM "sent" page. Consumers re-export this
+ * alongside the default page component.
+ */
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the BPM sent inbox. Usage in
+ * `app/sent/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/sent';
+ * ```
+ */
+export default function SentPage(): ReactElement;

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

@@ -0,0 +1,4 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function SettingsNotificationsPage(): ReactElement;

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

@@ -1,2 +1,2 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/categories-DjENouRm.cjs");let t=require("react/jsx-runtime");var n={title:`範本分類管理 | BPM Admin`,description:`維護 BPM 流程範本的分類設定。`};function r(){return(0,t.jsx)(e.t,{})}exports.default=r,exports.metadata=n;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/categories-AxxhqjLZ.cjs");let t=require("react/jsx-runtime");var n={title:`範本分類管理 | BPM Admin`,description:`維護 BPM 流程範本的分類設定。`};function r(){return(0,t.jsx)(e.t,{})}exports.default=r,exports.metadata=n;
 //# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1,4 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function TemplateCategoriesPage(): ReactElement;

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

@@ -1,4 +1,4 @@
-import { t as e } from "../../../chunks/categories-1gKxeEqw.js";
+import { t as e } from "../../../chunks/categories-riC33J_j.js";
 import { jsx as t } from "react/jsx-runtime";
 //#region src/pages/templates/categories/index.tsx
 var n = {

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

@@ -1,2 +1,2 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/compose-DZ7RKvUp.cjs");let t=require("react/jsx-runtime"),n=require("next/server");var r={title:`建立模板（表單 + 流程） | BPM Admin`,description:`以精靈式流程一次完成 BPM 表單與簽核流程設計並發佈。`};async function i(){return await(0,n.connection)(),(0,t.jsx)(e.t,{aiAssistantAvailable:!!process.env.OPENAI_API_KEY,showAiAssistant:process.env.BPM_AI_ASSISTANT_ENABLED===`true`})}exports.default=i,exports.metadata=r;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/compose-B7TtrpQJ.cjs");let t=require("react/jsx-runtime"),n=require("next/server");var r={title:`建立模板（表單 + 流程） | BPM Admin`,description:`以精靈式流程一次完成 BPM 表單與簽核流程設計並發佈。`};async function i(){return await(0,n.connection)(),(0,t.jsx)(e.t,{aiAssistantAvailable:!!process.env.OPENAI_API_KEY,showAiAssistant:process.env.BPM_AI_ASSISTANT_ENABLED===`true`})}exports.default=i,exports.metadata=r;
 //# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1,25 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+/**
+ * Drop-in Next.js App Router page for the unified template wizard.
+ *
+ * Consumer usage in `app/templates/compose/page.tsx`:
+ *
+ * ```ts
+ * export { default, metadata } from '@rytass/bpm-core-react/pages/templates/compose';
+ * ```
+ *
+ * The Step 1 (流程設計) embedded designer offers the same opt-in AI assistant
+ * as the standalone designer page. `BPM_AI_ASSISTANT_ENABLED` shows the button;
+ * `OPENAI_API_KEY` decides whether it's usable (else a disabled placeholder).
+ * Both are server-only env on the Next.js host.
+ *
+ * `await connection()` opts this route out of static prerendering so those env
+ * vars are read at request time. They are NOT set during `next build` (only
+ * injected into the runtime container), so without this the flags would bake to
+ * `false` on a production build — unlike the `[id]` designer page, which is
+ * already dynamic by virtue of its route params. Survives the host's one-line
+ * re-export, so npm consumers don't need their own route-segment config.
+ */
+export default function TemplateComposePage(): Promise<ReactElement>;

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

@@ -1,4 +1,4 @@
-import { t as e } from "../../../chunks/compose-Crklayzy.js";
+import { t as e } from "../../../chunks/compose-_pREPtfN.js";
 import { jsx as t } from "react/jsx-runtime";
 import { connection as n } from "next/server";
 //#region src/pages/templates/compose/index.tsx

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

@@ -1,2 +1,2 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/designer-sJGTGYOf.cjs");let t=require("react/jsx-runtime");var n={title:`流程設計器 | BPM Admin`,description:`以視覺化設計器編輯 BPM 簽核流程節點、條件與發佈版本。`};async function r({params:n}){let{id:r}=await n;return(0,t.jsx)(e.t,{aiAssistantAvailable:!!process.env.OPENAI_API_KEY,showAiAssistant:process.env.BPM_AI_ASSISTANT_ENABLED===`true`,showDryRun:process.env.BPM_TEMPLATE_DRY_RUN_ENABLED!==`false`,templateId:r})}exports.default=r,exports.metadata=n;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../../../chunks/designer-ttAqv859.cjs");let t=require("react/jsx-runtime");var n={title:`流程設計器 | BPM Admin`,description:`以視覺化設計器編輯 BPM 簽核流程節點、條件與發佈版本。`};async function r({params:n}){let{id:r}=await n;return(0,t.jsx)(e.t,{aiAssistantAvailable:!!process.env.OPENAI_API_KEY,showAiAssistant:process.env.BPM_AI_ASSISTANT_ENABLED===`true`,showDryRun:process.env.BPM_TEMPLATE_DRY_RUN_ENABLED!==`false`,templateId:r})}exports.default=r,exports.metadata=n;
 //# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1,8 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function TemplateDesignerPage({ params, }: {
+    readonly params: Promise<{
+        readonly id: string;
+    }>;
+}): Promise<ReactElement>;

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

@@ -1,4 +1,4 @@
-import { t as e } from "../../../chunks/designer-D9eFma1W.js";
+import { t as e } from "../../../chunks/designer-BiywgNXs.js";
 import { jsx as t } from "react/jsx-runtime";
 //#region src/pages/templates/designer/index.tsx
 var n = {

package/dist/pages/templates/index.d.cts

@@ -0,0 +1,4 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function TemplatesPage(): ReactElement;

package/dist/pages/templates/versions/index.d.cts

@@ -0,0 +1,8 @@
+import { Metadata } from 'next';
+import { ReactElement } from 'react';
+export declare const metadata: Metadata;
+export default function TemplateVersionsPage({ params, }: {
+    readonly params: Promise<{
+        readonly id: string;
+    }>;
+}): Promise<ReactElement>;

package/dist/views/admin/delegations/AdminDelegationsView.d.cts

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

package/dist/views/admin/delegations/index.d.cts

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

package/dist/views/admin/delegations/index.d.ts

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

package/dist/views/admin/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/users-DVBJluFR.cjs"),t=require("../../chunks/orgs-Dr0FFoZo.cjs"),n=require("../../chunks/delegations-V9HIe3_P.cjs"),r=require("./webhook-endpoints/index.cjs");exports.AdminDelegationsView=n.t,exports.AdminOrgsView=t.t,exports.AdminUsersView=e.t,exports.AdminWebhookEndpointsView=r.AdminWebhookEndpointsView;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../chunks/users-DVQicZIo.cjs"),t=require("../../chunks/orgs-C8usknWb.cjs"),n=require("../../chunks/delegations-V9HIe3_P.cjs"),r=require("./webhook-endpoints/index.cjs");exports.AdminDelegationsView=n.t,exports.AdminOrgsView=t.t,exports.AdminUsersView=e.t,exports.AdminWebhookEndpointsView=r.AdminWebhookEndpointsView;

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

@@ -0,0 +1,4 @@
+export * from './users/index.cjs';
+export * from './orgs/index.cjs';
+export * from './delegations/index.cjs';
+export * from './webhook-endpoints/index.cjs';

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

@@ -1,4 +1,4 @@
-export * from './users';
-export * from './orgs';
-export * from './delegations';
-export * from './webhook-endpoints';
+export * from './users/index.js';
+export * from './orgs/index.js';
+export * from './delegations/index.js';
+export * from './webhook-endpoints/index.js';

package/dist/views/admin/index.js

@@ -1,5 +1,5 @@
-import { t as e } from "../../chunks/users-BCyePbwB.js";
-import { t } from "../../chunks/orgs-CY0i1fie.js";
+import { t as e } from "../../chunks/users-DRbuDYF1.js";
+import { t } from "../../chunks/orgs-Lg7tXv2u.js";
 import { t as n } from "../../chunks/delegations-xUt1tj8d.js";
 import { AdminWebhookEndpointsView as r } from "./webhook-endpoints/index.js";
 export { n as AdminDelegationsView, t as AdminOrgsView, e as AdminUsersView, r as AdminWebhookEndpointsView };

package/dist/views/admin/orgs/AdminOrgsView.d.cts

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

package/dist/views/admin/orgs/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/orgs-Dr0FFoZo.cjs");exports.AdminOrgsView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/orgs-C8usknWb.cjs");exports.AdminOrgsView=e.t;

package/dist/views/admin/orgs/index.d.cts

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

package/dist/views/admin/orgs/index.d.ts

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

package/dist/views/admin/orgs/index.js

@@ -1 +1 @@
-export { t as AdminOrgsView } from "../../../chunks/orgs-CY0i1fie.js";
+export { t as AdminOrgsView } from "../../../chunks/orgs-Lg7tXv2u.js";

package/dist/views/admin/users/AdminUsersView.d.cts

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

package/dist/views/admin/users/MemberTaskReassignModal.d.cts

@@ -0,0 +1,13 @@
+import { ReactElement } from 'react';
+import { MemberProfileRecord } from '@rytass/bpm-core-client';
+/**
+ * Administrator reassignment of a member's open tasks. Lists what the member
+ * holds, takes a target and a reason, previews every task's outcome (dry run),
+ * and only then commits. Confirm stays disabled until the preview matches the
+ * current target and reason. Replacing a seat is not a decision: no signature
+ * is written, and the task keeps its id.
+ */
+export declare function MemberTaskReassignModal({ member, onClose, }: {
+    readonly member: MemberProfileRecord | null;
+    readonly onClose: () => void;
+}): ReactElement;

package/dist/views/admin/users/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/users-DVBJluFR.cjs");exports.AdminUsersView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/users-DVQicZIo.cjs");exports.AdminUsersView=e.t;

package/dist/views/admin/users/index.d.cts

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

package/dist/views/admin/users/index.d.ts

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

package/dist/views/admin/users/index.js

@@ -1 +1 @@
-export { t as AdminUsersView } from "../../../chunks/users-BCyePbwB.js";
+export { t as AdminUsersView } from "../../../chunks/users-DRbuDYF1.js";

package/dist/views/admin/webhook-endpoints/AdminWebhookEndpointsView.d.cts

@@ -0,0 +1,8 @@
+import { ReactElement } from 'react';
+/**
+ * Back-office management of database webhook endpoints (ADR 18 §3.13):
+ * create, edit, disable, rotate the signing secret, test-send and read the
+ * change history. Header values and secrets are entered here and never shown
+ * again. Administrator-only on the server.
+ */
+export declare function AdminWebhookEndpointsView(): ReactElement;

package/dist/views/admin/webhook-endpoints/index.d.cts

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

package/dist/views/admin/webhook-endpoints/index.d.ts

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

package/dist/views/cc/CcView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM "cc" inbox — instances the current
+ * member is copied on. Mechanical port of
+ * `apps/client/src/app/cc/page.tsx`.
+ */
+export declare function CcView(): ReactElement;

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

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

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

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

package/dist/views/dashboard/DashboardView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM dashboard. Delegates to the shared
+ * `<DashboardPage>` component. Mechanical port of
+ * `apps/client/src/app/dashboard/page.tsx`.
+ */
+export declare function DashboardView(): ReactElement;

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

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

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

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

package/dist/views/delegations/DelegationsView.d.cts

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

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

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

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

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

package/dist/views/forms/builder/FormBuilderView.d.cts

@@ -0,0 +1,18 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema, FormUiSchema } from '@rytass/bpm-core-shared/form';
+export interface FormBuilderViewProps {
+    /**
+     * Initial (or controlled) schema value.
+     * If omitted, the builder starts with empty schema / uiSchema.
+     */
+    readonly value?: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    };
+    /** Called whenever the schema or uiSchema changes. */
+    readonly onChange?: (next: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    }) => void;
+}
+export declare function FormBuilderView({ onChange, value, }: FormBuilderViewProps): ReactElement;

package/dist/views/forms/builder/index.d.cts

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

package/dist/views/forms/builder/index.d.ts

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

package/dist/views/forms/builder/json-code-editor.d.cts

@@ -0,0 +1,11 @@
+import { ReactElement } from 'react';
+interface JsonCodeEditorProps {
+    readonly disabled?: boolean;
+    readonly height: string;
+    readonly name: string;
+    readonly onChange: (value: string) => void;
+    readonly placeholder: string;
+    readonly value: string;
+}
+export declare function JsonCodeEditor({ disabled, height, name, onChange, placeholder, value, }: JsonCodeEditorProps): ReactElement;
+export {};

package/dist/views/forms/renderer/FormRendererView.d.cts

@@ -0,0 +1,24 @@
+import { CSSProperties, ReactElement } from 'react';
+import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { FormRendererValues } from '@rytass/bpm-core-client/form';
+import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field.cjs';
+export interface FormRendererProps {
+    readonly dataSourceContext?: FormRendererDataSourceContext;
+    readonly dataSourceInitialValues?: FormRendererValues;
+    readonly emptyText?: string;
+    readonly errors?: Readonly<Record<string, string>>;
+    readonly maxWidth?: CSSProperties['maxWidth'];
+    readonly onChange?: (values: FormRendererValues) => void;
+    readonly onDataSourceStateChange?: (fieldKey: string, state: Pick<FormDataSourceFieldState, 'hasValue' | 'invalidValues' | 'status'>) => void;
+    readonly onUploadAttachment?: (field: FormFieldDefinition, file: File) => Promise<{
+        readonly id: string;
+    }>;
+    readonly optionSnapshots?: FormDataSourceValueSnapshots;
+    readonly readonly?: boolean;
+    readonly schema: FormDefinitionSchema;
+    readonly singleColumn?: boolean;
+    readonly uiSchema: FormUiSchema;
+    readonly value?: FormRendererValues;
+}
+export declare function FormRenderer({ dataSourceContext, dataSourceInitialValues, emptyText, errors, maxWidth, onChange, onDataSourceStateChange, onUploadAttachment, optionSnapshots, readonly, schema, singleColumn, uiSchema, value, }: FormRendererProps): ReactElement;
+export { FormRenderer as FormRendererView };

package/dist/views/forms/renderer/FormRendererView.d.ts

@@ -1,7 +1,7 @@
 import { CSSProperties, ReactElement } from 'react';
 import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '@rytass/bpm-core-shared/form';
 import { FormRendererValues } from '@rytass/bpm-core-client/form';
-import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field';
+import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field.js';
 export interface FormRendererProps {
     readonly dataSourceContext?: FormRendererDataSourceContext;
     readonly dataSourceInitialValues?: FormRendererValues;

package/dist/views/forms/renderer/form-data-source-field.d.cts

@@ -0,0 +1,65 @@
+import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormFieldOption, FormFieldValue, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { FormDataSourceFieldStatus, FormRendererValues } from '@rytass/bpm-core-client/form';
+export type FormRendererDataSourceContext = {
+    readonly kind: 'preview';
+} | {
+    readonly instanceId?: string | null;
+    readonly kind: 'runtime';
+    readonly templateId?: string | null;
+};
+export interface FormDataSourceFieldState {
+    /**
+     * False when nothing can be re-requested — a read-only or context-less field
+     * has no query to retry, so the view must not offer a dead retry action.
+     */
+    readonly canRetry: boolean;
+    readonly error: string | null;
+    readonly hasValue: boolean;
+    readonly hasNextPage: boolean;
+    readonly invalidValues: readonly string[];
+    readonly onReachBottom: () => void;
+    readonly onSearch: (searchText: string) => void;
+    readonly options: readonly FormFieldOption[];
+    readonly retry: () => void;
+    readonly status: FormDataSourceFieldStatus;
+}
+/**
+ * What makes a table cell different from a top-level field: it is addressed by
+ * a schema path, snapshotted under an instance path, and its `ROW_FIELD`
+ * bindings read from its own row rather than the form (ADR 16 §3.3, §3.5).
+ */
+export interface UseFormDataSourceFieldRow {
+    /** The row as it was loaded, so a returned case can tell what changed. */
+    readonly initialValues?: FormRendererValues;
+    readonly values: FormRendererValues;
+}
+export interface UseFormDataSourceFieldInput {
+    readonly context?: FormRendererDataSourceContext;
+    readonly field: FormFieldDefinition;
+    /** Schema path used to address the field; defaults to its own key. */
+    readonly fieldPath?: string;
+    readonly formData: FormRendererValues;
+    readonly initialFormData?: FormRendererValues;
+    readonly initialValue?: FormFieldValue | undefined;
+    readonly optionSnapshots?: FormDataSourceValueSnapshots;
+    readonly readonly: boolean;
+    /** Set only for a table cell. */
+    readonly row?: UseFormDataSourceFieldRow;
+    readonly schema: FormDefinitionSchema;
+    /** Snapshot map key; defaults to the field key. */
+    readonly snapshotKey?: string;
+    readonly uiSchema: FormUiSchema;
+}
+export declare function useFormDataSourceField(input: UseFormDataSourceFieldInput): FormDataSourceFieldState;
+export declare function readFormDataSourceFieldStatusMessage(state: FormDataSourceFieldState): string | null;
+export declare function isFormDataSourceFieldSubmissionBlocked(state: Pick<FormDataSourceFieldState, 'hasValue' | 'status'>): boolean;
+/**
+ * The copy to show when a submission is refused because of dynamic options.
+ * `LOADING` and `STALE` clear on their own once the pending query answers, so
+ * saying "finish validating" reads as a dead end for what is really a "wait a
+ * moment"; the caller would otherwise show the same permanent-sounding line for
+ * both cases.
+ *
+ * Returns `null` when nothing blocks the submission.
+ */
+export declare function readFormDataSourceSubmissionBlockMessage(states: readonly Pick<FormDataSourceFieldState, 'hasValue' | 'status'>[]): string | null;

package/dist/views/forms/renderer/form-field-link.d.cts

@@ -0,0 +1,16 @@
+export interface FormFieldLink {
+    /** Absolute links open in a new tab; site-relative ones stay in this tab. */
+    readonly external: boolean;
+    readonly href: string;
+}
+/**
+ * Decides whether a `displayAs: 'link'` text value may become an anchor.
+ * Returns `null` for everything that must stay plain text.
+ *
+ * Allowed: a site-relative path (`/` first, never `//`) or an absolute
+ * `http(s)://` URL with a host and no embedded credentials. Everything else —
+ * `javascript:`, `data:`, protocol-relative `//host`, backslash tricks
+ * (`/\host` is `//host` to a browser), padded or multi-line values, non-strings
+ * — is refused rather than repaired.
+ */
+export declare function resolveFormFieldLink(value: unknown): FormFieldLink | null;

package/dist/views/forms/renderer/index.d.cts

@@ -0,0 +1,2 @@
+export * from './FormRendererView.cjs';
+export * from './form-data-source-field.cjs';