@rytass/bpm-core-react 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -8,6 +8,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Releases are managed by [`nx release`](https://nx.dev/recipes/nx-release) with
 Conventional Commits — see `nx.json` for the release config.
 
+## 0.3.3 — 2026-05-28
+
+### Fixed
+
+- **Dist `.d.ts` files leaked workspace-source paths.** The 0.3.0–0.3.2
+  release shipped declaration files that contained relative imports back
+  into the vendor's monorepo (e.g. `import { ApiMember } from
+  '../../libs/bpm-core-client/src/index.ts'`), which broke `tsc` for any
+  consumer that didn't have BPMCore's source on disk at that exact
+  relative path. The build now passes `compilerOptions.paths: {}` to
+  `vite-plugin-dts` so the published types reference packages by their
+  npm names (`@rytass/bpm-core-client`) rather than by resolved aliases.
+
+### Added
+
+- **`BPMNextProviders` props are now typed and forwarded.** The
+  `loginPath`, `publicPaths`, and `locale` props were always accepted by
+  the inner `<Providers>` but the `next` subpath wrapper hid them. They
+  are now part of the exported `BPMNextProvidersProps` interface and
+  forwarded through. Default `loginPath` remains `'/login'`, so hosts
+  with a different auth route must pass their override explicitly.
+
+### Documentation
+
+- `BPMRoutes.caseDetail` and `BPMRoutes.caseNew(templateId?)` JSDoc
+  carries `@example` annotations showing the default factory's literal
+  paths so consumers can see what they're overriding without reading
+  the source.
+
+### Why a patch
+
+The d.ts fix only affected consumers' type-check experience — runtime
+behavior didn't change. The `BPMNextProviders` props forwarding is
+additive (props were silently dropped before, now they work).
+
 ## 0.3.2 — 2026-05-28
 
 ### Added

package/dist/chunks/routes-config-2aKbWq2H.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"routes-config-2aKbWq2H.cjs","names":[],"sources":["../../src/lib/routes-config.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\n\n/**\n * Framework-agnostic path mapping every BPM view uses for internal\n * cross-navigation. When a host embeds BPM under a non-root prefix\n * (e.g. `/workspace/bpm/*`) it provides its own implementation through\n * `<BPMRoutesProvider value={...}>`; otherwise the default factory\n * preserves the historical `/instances/:id`, `/templates`, etc. paths.\n *\n * Function-shape (instead of string templates) means:\n * - Optional and multi-param routes can branch on argument presence\n *   (`caseNew(templateId?)`).\n * - Query-string composition stays inside the host's resolver, not the\n *   view.\n * - TypeScript flags missing arguments at compile time.\n *\n * Mirror sibling: {@link RouterAdapter} owns *navigation primitives*\n * (`push`, `replace`, `pathname`); `BPMRoutes` owns *path strings*. The\n * two compose: views call `router.push(routes.caseDetail(id))`.\n */\nexport interface BPMRoutes {\n  /** Workflow dashboard landing. Used by sidebar + dashboard tiles. */\n  dashboard(): string;\n  /** Inbox (待簽) — pending tasks assigned to the current member. */\n  inbox(): string;\n  /** Sent (我發起的) — instances the current member initiated. */\n  sent(): string;\n  /** CC (抄送給我) — instances the current member is copied on. */\n  cc(): string;\n  /** Cross-view search. */\n  search(): string;\n  /** Personal delegation rules. */\n  delegations(): string;\n  /** Notification list. */\n  notifications(): string;\n\n  /** Detail page for one approval instance. */\n  caseDetail(instanceId: string): string;\n  /**\n   * Launch a new approval instance. When `templateId` is passed, the\n   * launch form is pre-populated for that template.\n   */\n  caseNew(templateId?: string): string;\n\n  /** Template index. */\n  templates(): string;\n  /** Template designer (xyflow canvas). */\n  templateDesigner(templateId: string): string;\n  /** Template version history. */\n  templateVersions(templateId: string): string;\n  /** Template categories admin. */\n  templateCategories(): string;\n\n  /** Form definitions index. */\n  forms(): string;\n  /** Form-builder (CodeMirror schema editor + preview). */\n  formBuilder(formId: string): string;\n\n  /** Per-member notification preferences. */\n  notificationSettings(): string;\n\n  /** Admin: organization tree management. */\n  adminOrgs(): string;\n  /** Admin: member directory mapping. */\n  adminUsers(): string;\n  /** Admin: delegation rule management. */\n  adminDelegations(): string;\n}\n\n/**\n * Factory for the default `BPMRoutes` value. Reproduces the exact path\n * literals BPM views used before `BPMRoutesContext` existed, so existing\n * hosts (no provider mounted) keep working unchanged.\n */\nexport function createDefaultBPMRoutes(): BPMRoutes {\n  return {\n    dashboard: () => '/dashboard',\n    inbox: () => '/inbox',\n    sent: () => '/sent',\n    cc: () => '/cc',\n    search: () => '/search',\n    delegations: () => '/delegations',\n    notifications: () => '/notifications',\n\n    caseDetail: (instanceId) => `/instances/${instanceId}`,\n    caseNew: (templateId) =>\n      templateId\n        ? `/instances/new?templateId=${encodeURIComponent(templateId)}`\n        : '/instances/new',\n\n    templates: () => '/templates',\n    templateDesigner: (templateId) => `/templates/${templateId}/designer`,\n    templateVersions: (templateId) => `/templates/${templateId}/versions`,\n    templateCategories: () => '/templates/categories',\n\n    forms: () => '/forms',\n    formBuilder: (formId) => `/forms/${formId}/builder`,\n\n    notificationSettings: () => '/settings/notifications',\n\n    adminOrgs: () => '/admin/orgs',\n    adminUsers: () => '/admin/users',\n    adminDelegations: () => '/admin/delegations',\n  };\n}\n\nconst BPMRoutesContext = createContext<BPMRoutes | null>(null);\n\nexport interface BPMRoutesProviderProps {\n  /**\n   * Override the path mapping. Provide a full implementation, or spread\n   * the default and override individual entries:\n   *\n   * ```tsx\n   * <BPMRoutesProvider value={{\n   *   ...createDefaultBPMRoutes(),\n   *   caseDetail: (id) => `/workspace/cases/${id}`,\n   * }}>\n   * ```\n   */\n  readonly value?: BPMRoutes;\n  readonly children: ReactNode;\n}\n\n/**\n * Wraps the BPM React tree with a {@link BPMRoutes} value. Mounting the\n * provider is **optional** — `useBPMRoutes()` falls back to\n * {@link createDefaultBPMRoutes} when no provider is present. Use it\n * only when the host needs to remap BPM's internal paths.\n */\nexport function BPMRoutesProvider({\n  value,\n  children,\n}: BPMRoutesProviderProps): React.ReactElement {\n  const resolved = useMemo(() => value ?? createDefaultBPMRoutes(), [value]);\n  return (\n    <BPMRoutesContext.Provider value={resolved}>\n      {children}\n    </BPMRoutesContext.Provider>\n  );\n}\n\n/**\n * Reads the host-configured {@link BPMRoutes}. Falls back to\n * {@link createDefaultBPMRoutes} when no `<BPMRoutesProvider>` ancestor\n * is mounted, so views remain self-contained.\n */\nexport function useBPMRoutes(): BPMRoutes {\n  const value = useContext(BPMRoutesContext);\n  return value ?? DEFAULT_ROUTES;\n}\n\nconst DEFAULT_ROUTES: BPMRoutes = createDefaultBPMRoutes();\n"],"mappings":"mEA4EA,SAAgB,GAAoC,CAClD,MAAO,CACL,cAAiB,aACjB,UAAa,SACb,SAAY,QACZ,OAAU,MACV,WAAc,UACd,gBAAmB,eACnB,kBAAqB,iBAErB,WAAa,GAAe,cAAc,IAC1C,QAAU,GACR,EACI,6BAA6B,mBAAmB,CAAU,IAC1D,iBAEN,cAAiB,aACjB,iBAAmB,GAAe,cAAc,EAAW,WAC3D,iBAAmB,GAAe,cAAc,EAAW,WAC3D,uBAA0B,wBAE1B,UAAa,SACb,YAAc,GAAW,UAAU,EAAO,UAE1C,yBAA4B,0BAE5B,cAAiB,cACjB,eAAkB,eAClB,qBAAwB,oBAC1B,CACF,CAEA,IAAM,GAAA,EAAA,EAAA,eAAmD,IAAI,EAwB7D,SAAgB,EAAkB,CAChC,QACA,YAC6C,CAC7C,IAAM,GAAA,EAAA,EAAA,aAAyB,GAAS,EAAuB,EAAG,CAAC,CAAK,CAAC,EACzE,OACE,EAAA,EAAA,KAAC,EAAiB,SAAlB,CAA2B,MAAO,EAC/B,UACwB,CAAA,CAE/B,CAOA,SAAgB,GAA0B,CAExC,OAAA,EAAA,EAAA,YADyB,CAClB,GAAS,CAClB,CAEA,IAAM,EAA4B,EAAuB"}
+{"version":3,"file":"routes-config-2aKbWq2H.cjs","names":[],"sources":["../../src/lib/routes-config.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\n\n/**\n * Framework-agnostic path mapping every BPM view uses for internal\n * cross-navigation. When a host embeds BPM under a non-root prefix\n * (e.g. `/workspace/bpm/*`) it provides its own implementation through\n * `<BPMRoutesProvider value={...}>`; otherwise the default factory\n * preserves the historical `/instances/:id`, `/templates`, etc. paths.\n *\n * Function-shape (instead of string templates) means:\n * - Optional and multi-param routes can branch on argument presence\n *   (`caseNew(templateId?)`).\n * - Query-string composition stays inside the host's resolver, not the\n *   view.\n * - TypeScript flags missing arguments at compile time.\n *\n * Mirror sibling: {@link RouterAdapter} owns *navigation primitives*\n * (`push`, `replace`, `pathname`); `BPMRoutes` owns *path strings*. The\n * two compose: views call `router.push(routes.caseDetail(id))`.\n */\nexport interface BPMRoutes {\n  /** Workflow dashboard landing. Used by sidebar + dashboard tiles. */\n  dashboard(): string;\n  /** Inbox (待簽) — pending tasks assigned to the current member. */\n  inbox(): string;\n  /** Sent (我發起的) — instances the current member initiated. */\n  sent(): string;\n  /** CC (抄送給我) — instances the current member is copied on. */\n  cc(): string;\n  /** Cross-view search. */\n  search(): string;\n  /** Personal delegation rules. */\n  delegations(): string;\n  /** Notification list. */\n  notifications(): string;\n\n  /**\n   * Detail page for one approval instance.\n   *\n   * @example default → `/instances/abc123`\n   */\n  caseDetail(instanceId: string): string;\n  /**\n   * Launch a new approval instance. When `templateId` is passed, the\n   * launch form is pre-populated for that template — by default this is\n   * appended as a `?templateId=` query string so the path itself stays\n   * stable for routing.\n   *\n   * @example default `caseNew()` → `/instances/new`\n   * @example default `caseNew('tpl-1')` → `/instances/new?templateId=tpl-1`\n   */\n  caseNew(templateId?: string): string;\n\n  /** Template index. */\n  templates(): string;\n  /** Template designer (xyflow canvas). */\n  templateDesigner(templateId: string): string;\n  /** Template version history. */\n  templateVersions(templateId: string): string;\n  /** Template categories admin. */\n  templateCategories(): string;\n\n  /** Form definitions index. */\n  forms(): string;\n  /** Form-builder (CodeMirror schema editor + preview). */\n  formBuilder(formId: string): string;\n\n  /** Per-member notification preferences. */\n  notificationSettings(): string;\n\n  /** Admin: organization tree management. */\n  adminOrgs(): string;\n  /** Admin: member directory mapping. */\n  adminUsers(): string;\n  /** Admin: delegation rule management. */\n  adminDelegations(): string;\n}\n\n/**\n * Factory for the default `BPMRoutes` value. Reproduces the exact path\n * literals BPM views used before `BPMRoutesContext` existed, so existing\n * hosts (no provider mounted) keep working unchanged.\n */\nexport function createDefaultBPMRoutes(): BPMRoutes {\n  return {\n    dashboard: () => '/dashboard',\n    inbox: () => '/inbox',\n    sent: () => '/sent',\n    cc: () => '/cc',\n    search: () => '/search',\n    delegations: () => '/delegations',\n    notifications: () => '/notifications',\n\n    caseDetail: (instanceId) => `/instances/${instanceId}`,\n    caseNew: (templateId) =>\n      templateId\n        ? `/instances/new?templateId=${encodeURIComponent(templateId)}`\n        : '/instances/new',\n\n    templates: () => '/templates',\n    templateDesigner: (templateId) => `/templates/${templateId}/designer`,\n    templateVersions: (templateId) => `/templates/${templateId}/versions`,\n    templateCategories: () => '/templates/categories',\n\n    forms: () => '/forms',\n    formBuilder: (formId) => `/forms/${formId}/builder`,\n\n    notificationSettings: () => '/settings/notifications',\n\n    adminOrgs: () => '/admin/orgs',\n    adminUsers: () => '/admin/users',\n    adminDelegations: () => '/admin/delegations',\n  };\n}\n\nconst BPMRoutesContext = createContext<BPMRoutes | null>(null);\n\nexport interface BPMRoutesProviderProps {\n  /**\n   * Override the path mapping. Provide a full implementation, or spread\n   * the default and override individual entries:\n   *\n   * ```tsx\n   * <BPMRoutesProvider value={{\n   *   ...createDefaultBPMRoutes(),\n   *   caseDetail: (id) => `/workspace/cases/${id}`,\n   * }}>\n   * ```\n   */\n  readonly value?: BPMRoutes;\n  readonly children: ReactNode;\n}\n\n/**\n * Wraps the BPM React tree with a {@link BPMRoutes} value. Mounting the\n * provider is **optional** — `useBPMRoutes()` falls back to\n * {@link createDefaultBPMRoutes} when no provider is present. Use it\n * only when the host needs to remap BPM's internal paths.\n */\nexport function BPMRoutesProvider({\n  value,\n  children,\n}: BPMRoutesProviderProps): React.ReactElement {\n  const resolved = useMemo(() => value ?? createDefaultBPMRoutes(), [value]);\n  return (\n    <BPMRoutesContext.Provider value={resolved}>\n      {children}\n    </BPMRoutesContext.Provider>\n  );\n}\n\n/**\n * Reads the host-configured {@link BPMRoutes}. Falls back to\n * {@link createDefaultBPMRoutes} when no `<BPMRoutesProvider>` ancestor\n * is mounted, so views remain self-contained.\n */\nexport function useBPMRoutes(): BPMRoutes {\n  const value = useContext(BPMRoutesContext);\n  return value ?? DEFAULT_ROUTES;\n}\n\nconst DEFAULT_ROUTES: BPMRoutes = createDefaultBPMRoutes();\n"],"mappings":"mEAqFA,SAAgB,GAAoC,CAClD,MAAO,CACL,cAAiB,aACjB,UAAa,SACb,SAAY,QACZ,OAAU,MACV,WAAc,UACd,gBAAmB,eACnB,kBAAqB,iBAErB,WAAa,GAAe,cAAc,IAC1C,QAAU,GACR,EACI,6BAA6B,mBAAmB,CAAU,IAC1D,iBAEN,cAAiB,aACjB,iBAAmB,GAAe,cAAc,EAAW,WAC3D,iBAAmB,GAAe,cAAc,EAAW,WAC3D,uBAA0B,wBAE1B,UAAa,SACb,YAAc,GAAW,UAAU,EAAO,UAE1C,yBAA4B,0BAE5B,cAAiB,cACjB,eAAkB,eAClB,qBAAwB,oBAC1B,CACF,CAEA,IAAM,GAAA,EAAA,EAAA,eAAmD,IAAI,EAwB7D,SAAgB,EAAkB,CAChC,QACA,YAC6C,CAC7C,IAAM,GAAA,EAAA,EAAA,aAAyB,GAAS,EAAuB,EAAG,CAAC,CAAK,CAAC,EACzE,OACE,EAAA,EAAA,KAAC,EAAiB,SAAlB,CAA2B,MAAO,EAC/B,UACwB,CAAA,CAE/B,CAOA,SAAgB,GAA0B,CAExC,OAAA,EAAA,EAAA,YADyB,CAClB,GAAS,CAClB,CAEA,IAAM,EAA4B,EAAuB"}

package/dist/chunks/routes-config-dxahImVe.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes-config-dxahImVe.js","names":[],"sources":["../../src/lib/routes-config.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\n\n/**\n * Framework-agnostic path mapping every BPM view uses for internal\n * cross-navigation. When a host embeds BPM under a non-root prefix\n * (e.g. `/workspace/bpm/*`) it provides its own implementation through\n * `<BPMRoutesProvider value={...}>`; otherwise the default factory\n * preserves the historical `/instances/:id`, `/templates`, etc. paths.\n *\n * Function-shape (instead of string templates) means:\n * - Optional and multi-param routes can branch on argument presence\n *   (`caseNew(templateId?)`).\n * - Query-string composition stays inside the host's resolver, not the\n *   view.\n * - TypeScript flags missing arguments at compile time.\n *\n * Mirror sibling: {@link RouterAdapter} owns *navigation primitives*\n * (`push`, `replace`, `pathname`); `BPMRoutes` owns *path strings*. The\n * two compose: views call `router.push(routes.caseDetail(id))`.\n */\nexport interface BPMRoutes {\n  /** Workflow dashboard landing. Used by sidebar + dashboard tiles. */\n  dashboard(): string;\n  /** Inbox (待簽) — pending tasks assigned to the current member. */\n  inbox(): string;\n  /** Sent (我發起的) — instances the current member initiated. */\n  sent(): string;\n  /** CC (抄送給我) — instances the current member is copied on. */\n  cc(): string;\n  /** Cross-view search. */\n  search(): string;\n  /** Personal delegation rules. */\n  delegations(): string;\n  /** Notification list. */\n  notifications(): string;\n\n  /** Detail page for one approval instance. */\n  caseDetail(instanceId: string): string;\n  /**\n   * Launch a new approval instance. When `templateId` is passed, the\n   * launch form is pre-populated for that template.\n   */\n  caseNew(templateId?: string): string;\n\n  /** Template index. */\n  templates(): string;\n  /** Template designer (xyflow canvas). */\n  templateDesigner(templateId: string): string;\n  /** Template version history. */\n  templateVersions(templateId: string): string;\n  /** Template categories admin. */\n  templateCategories(): string;\n\n  /** Form definitions index. */\n  forms(): string;\n  /** Form-builder (CodeMirror schema editor + preview). */\n  formBuilder(formId: string): string;\n\n  /** Per-member notification preferences. */\n  notificationSettings(): string;\n\n  /** Admin: organization tree management. */\n  adminOrgs(): string;\n  /** Admin: member directory mapping. */\n  adminUsers(): string;\n  /** Admin: delegation rule management. */\n  adminDelegations(): string;\n}\n\n/**\n * Factory for the default `BPMRoutes` value. Reproduces the exact path\n * literals BPM views used before `BPMRoutesContext` existed, so existing\n * hosts (no provider mounted) keep working unchanged.\n */\nexport function createDefaultBPMRoutes(): BPMRoutes {\n  return {\n    dashboard: () => '/dashboard',\n    inbox: () => '/inbox',\n    sent: () => '/sent',\n    cc: () => '/cc',\n    search: () => '/search',\n    delegations: () => '/delegations',\n    notifications: () => '/notifications',\n\n    caseDetail: (instanceId) => `/instances/${instanceId}`,\n    caseNew: (templateId) =>\n      templateId\n        ? `/instances/new?templateId=${encodeURIComponent(templateId)}`\n        : '/instances/new',\n\n    templates: () => '/templates',\n    templateDesigner: (templateId) => `/templates/${templateId}/designer`,\n    templateVersions: (templateId) => `/templates/${templateId}/versions`,\n    templateCategories: () => '/templates/categories',\n\n    forms: () => '/forms',\n    formBuilder: (formId) => `/forms/${formId}/builder`,\n\n    notificationSettings: () => '/settings/notifications',\n\n    adminOrgs: () => '/admin/orgs',\n    adminUsers: () => '/admin/users',\n    adminDelegations: () => '/admin/delegations',\n  };\n}\n\nconst BPMRoutesContext = createContext<BPMRoutes | null>(null);\n\nexport interface BPMRoutesProviderProps {\n  /**\n   * Override the path mapping. Provide a full implementation, or spread\n   * the default and override individual entries:\n   *\n   * ```tsx\n   * <BPMRoutesProvider value={{\n   *   ...createDefaultBPMRoutes(),\n   *   caseDetail: (id) => `/workspace/cases/${id}`,\n   * }}>\n   * ```\n   */\n  readonly value?: BPMRoutes;\n  readonly children: ReactNode;\n}\n\n/**\n * Wraps the BPM React tree with a {@link BPMRoutes} value. Mounting the\n * provider is **optional** — `useBPMRoutes()` falls back to\n * {@link createDefaultBPMRoutes} when no provider is present. Use it\n * only when the host needs to remap BPM's internal paths.\n */\nexport function BPMRoutesProvider({\n  value,\n  children,\n}: BPMRoutesProviderProps): React.ReactElement {\n  const resolved = useMemo(() => value ?? createDefaultBPMRoutes(), [value]);\n  return (\n    <BPMRoutesContext.Provider value={resolved}>\n      {children}\n    </BPMRoutesContext.Provider>\n  );\n}\n\n/**\n * Reads the host-configured {@link BPMRoutes}. Falls back to\n * {@link createDefaultBPMRoutes} when no `<BPMRoutesProvider>` ancestor\n * is mounted, so views remain self-contained.\n */\nexport function useBPMRoutes(): BPMRoutes {\n  const value = useContext(BPMRoutesContext);\n  return value ?? DEFAULT_ROUTES;\n}\n\nconst DEFAULT_ROUTES: BPMRoutes = createDefaultBPMRoutes();\n"],"mappings":";;;;AA4EA,SAAgB,IAAoC;CAClD,OAAO;EACL,iBAAiB;EACjB,aAAa;EACb,YAAY;EACZ,UAAU;EACV,cAAc;EACd,mBAAmB;EACnB,qBAAqB;EAErB,aAAa,MAAe,cAAc;EAC1C,UAAU,MACR,IACI,6BAA6B,mBAAmB,CAAU,MAC1D;EAEN,iBAAiB;EACjB,mBAAmB,MAAe,cAAc,EAAW;EAC3D,mBAAmB,MAAe,cAAc,EAAW;EAC3D,0BAA0B;EAE1B,aAAa;EACb,cAAc,MAAW,UAAU,EAAO;EAE1C,4BAA4B;EAE5B,iBAAiB;EACjB,kBAAkB;EAClB,wBAAwB;CAC1B;AACF;AAEA,IAAM,IAAmB,EAAgC,IAAI;AAwB7D,SAAgB,EAAkB,EAChC,UACA,eAC6C;CAC7C,IAAM,IAAW,QAAc,KAAS,EAAuB,GAAG,CAAC,CAAK,CAAC;CACzE,OACE,kBAAC,EAAiB,UAAlB;EAA2B,OAAO;EAC/B;CACwB,CAAA;AAE/B;AAOA,SAAgB,IAA0B;CAExC,OADc,EAAW,CAClB,KAAS;AAClB;AAEA,IAAM,IAA4B,EAAuB"}
+{"version":3,"file":"routes-config-dxahImVe.js","names":[],"sources":["../../src/lib/routes-config.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\n\n/**\n * Framework-agnostic path mapping every BPM view uses for internal\n * cross-navigation. When a host embeds BPM under a non-root prefix\n * (e.g. `/workspace/bpm/*`) it provides its own implementation through\n * `<BPMRoutesProvider value={...}>`; otherwise the default factory\n * preserves the historical `/instances/:id`, `/templates`, etc. paths.\n *\n * Function-shape (instead of string templates) means:\n * - Optional and multi-param routes can branch on argument presence\n *   (`caseNew(templateId?)`).\n * - Query-string composition stays inside the host's resolver, not the\n *   view.\n * - TypeScript flags missing arguments at compile time.\n *\n * Mirror sibling: {@link RouterAdapter} owns *navigation primitives*\n * (`push`, `replace`, `pathname`); `BPMRoutes` owns *path strings*. The\n * two compose: views call `router.push(routes.caseDetail(id))`.\n */\nexport interface BPMRoutes {\n  /** Workflow dashboard landing. Used by sidebar + dashboard tiles. */\n  dashboard(): string;\n  /** Inbox (待簽) — pending tasks assigned to the current member. */\n  inbox(): string;\n  /** Sent (我發起的) — instances the current member initiated. */\n  sent(): string;\n  /** CC (抄送給我) — instances the current member is copied on. */\n  cc(): string;\n  /** Cross-view search. */\n  search(): string;\n  /** Personal delegation rules. */\n  delegations(): string;\n  /** Notification list. */\n  notifications(): string;\n\n  /**\n   * Detail page for one approval instance.\n   *\n   * @example default → `/instances/abc123`\n   */\n  caseDetail(instanceId: string): string;\n  /**\n   * Launch a new approval instance. When `templateId` is passed, the\n   * launch form is pre-populated for that template — by default this is\n   * appended as a `?templateId=` query string so the path itself stays\n   * stable for routing.\n   *\n   * @example default `caseNew()` → `/instances/new`\n   * @example default `caseNew('tpl-1')` → `/instances/new?templateId=tpl-1`\n   */\n  caseNew(templateId?: string): string;\n\n  /** Template index. */\n  templates(): string;\n  /** Template designer (xyflow canvas). */\n  templateDesigner(templateId: string): string;\n  /** Template version history. */\n  templateVersions(templateId: string): string;\n  /** Template categories admin. */\n  templateCategories(): string;\n\n  /** Form definitions index. */\n  forms(): string;\n  /** Form-builder (CodeMirror schema editor + preview). */\n  formBuilder(formId: string): string;\n\n  /** Per-member notification preferences. */\n  notificationSettings(): string;\n\n  /** Admin: organization tree management. */\n  adminOrgs(): string;\n  /** Admin: member directory mapping. */\n  adminUsers(): string;\n  /** Admin: delegation rule management. */\n  adminDelegations(): string;\n}\n\n/**\n * Factory for the default `BPMRoutes` value. Reproduces the exact path\n * literals BPM views used before `BPMRoutesContext` existed, so existing\n * hosts (no provider mounted) keep working unchanged.\n */\nexport function createDefaultBPMRoutes(): BPMRoutes {\n  return {\n    dashboard: () => '/dashboard',\n    inbox: () => '/inbox',\n    sent: () => '/sent',\n    cc: () => '/cc',\n    search: () => '/search',\n    delegations: () => '/delegations',\n    notifications: () => '/notifications',\n\n    caseDetail: (instanceId) => `/instances/${instanceId}`,\n    caseNew: (templateId) =>\n      templateId\n        ? `/instances/new?templateId=${encodeURIComponent(templateId)}`\n        : '/instances/new',\n\n    templates: () => '/templates',\n    templateDesigner: (templateId) => `/templates/${templateId}/designer`,\n    templateVersions: (templateId) => `/templates/${templateId}/versions`,\n    templateCategories: () => '/templates/categories',\n\n    forms: () => '/forms',\n    formBuilder: (formId) => `/forms/${formId}/builder`,\n\n    notificationSettings: () => '/settings/notifications',\n\n    adminOrgs: () => '/admin/orgs',\n    adminUsers: () => '/admin/users',\n    adminDelegations: () => '/admin/delegations',\n  };\n}\n\nconst BPMRoutesContext = createContext<BPMRoutes | null>(null);\n\nexport interface BPMRoutesProviderProps {\n  /**\n   * Override the path mapping. Provide a full implementation, or spread\n   * the default and override individual entries:\n   *\n   * ```tsx\n   * <BPMRoutesProvider value={{\n   *   ...createDefaultBPMRoutes(),\n   *   caseDetail: (id) => `/workspace/cases/${id}`,\n   * }}>\n   * ```\n   */\n  readonly value?: BPMRoutes;\n  readonly children: ReactNode;\n}\n\n/**\n * Wraps the BPM React tree with a {@link BPMRoutes} value. Mounting the\n * provider is **optional** — `useBPMRoutes()` falls back to\n * {@link createDefaultBPMRoutes} when no provider is present. Use it\n * only when the host needs to remap BPM's internal paths.\n */\nexport function BPMRoutesProvider({\n  value,\n  children,\n}: BPMRoutesProviderProps): React.ReactElement {\n  const resolved = useMemo(() => value ?? createDefaultBPMRoutes(), [value]);\n  return (\n    <BPMRoutesContext.Provider value={resolved}>\n      {children}\n    </BPMRoutesContext.Provider>\n  );\n}\n\n/**\n * Reads the host-configured {@link BPMRoutes}. Falls back to\n * {@link createDefaultBPMRoutes} when no `<BPMRoutesProvider>` ancestor\n * is mounted, so views remain self-contained.\n */\nexport function useBPMRoutes(): BPMRoutes {\n  const value = useContext(BPMRoutesContext);\n  return value ?? DEFAULT_ROUTES;\n}\n\nconst DEFAULT_ROUTES: BPMRoutes = createDefaultBPMRoutes();\n"],"mappings":";;;;AAqFA,SAAgB,IAAoC;CAClD,OAAO;EACL,iBAAiB;EACjB,aAAa;EACb,YAAY;EACZ,UAAU;EACV,cAAc;EACd,mBAAmB;EACnB,qBAAqB;EAErB,aAAa,MAAe,cAAc;EAC1C,UAAU,MACR,IACI,6BAA6B,mBAAmB,CAAU,MAC1D;EAEN,iBAAiB;EACjB,mBAAmB,MAAe,cAAc,EAAW;EAC3D,mBAAmB,MAAe,cAAc,EAAW;EAC3D,0BAA0B;EAE1B,aAAa;EACb,cAAc,MAAW,UAAU,EAAO;EAE1C,4BAA4B;EAE5B,iBAAiB;EACjB,kBAAkB;EAClB,wBAAwB;CAC1B;AACF;AAEA,IAAM,IAAmB,EAAgC,IAAI;AAwB7D,SAAgB,EAAkB,EAChC,UACA,eAC6C;CAC7C,IAAM,IAAW,QAAc,KAAS,EAAuB,GAAG,CAAC,CAAK,CAAC;CACzE,OACE,kBAAC,EAAiB,UAAlB;EAA2B,OAAO;EAC/B;CACwB,CAAA;AAE/B;AAOA,SAAgB,IAA0B;CAExC,OADc,EAAW,CAClB,KAAS;AAClB;AAEA,IAAM,IAA4B,EAAuB"}

package/dist/components/admin-pickers.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement } from 'react';
-import { OrgUnitRecord, PositionRecord } from '../../libs/bpm-core-client/src/lib/organization/index.ts';
+import { OrgUnitRecord, PositionRecord } from '@rytass/bpm-core-client/organization';
 export type MemberOption = Readonly<{
     email: string;
     id: string;

package/dist/components/approval-instance-list-page.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement } from 'react';
-import { ApprovalInstanceState, ApprovalInstanceView } from '../../libs/bpm-core-client/src/lib/workflow/index.ts';
+import { ApprovalInstanceState, ApprovalInstanceView } from '@rytass/bpm-core-client/workflow';
 export interface ApprovalInstanceListPageProps {
     readonly activeHref: string;
     readonly defaultState: ApprovalInstanceState | null;

package/dist/components/org-unit-tree-draft-editor.d.ts

@@ -1,4 +1,4 @@
-import { OrgUnitRecord } from '../../libs/bpm-core-client/src/lib/organization/index.ts';
+import { OrgUnitRecord } from '@rytass/bpm-core-client/organization';
 import { OrgUnitHierarchyDraftChange } from '../lib/org-tree-draft';
 export type OrgUnitTreeDraftEditorHandle = Readonly<{
     cancelEditing: () => void;

package/dist/lib/auth-provider.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement, ReactNode } from 'react';
-import { ApiMember } from '../../libs/bpm-core-client/src/index.ts';
+import { ApiMember } from '@rytass/bpm-core-client';
 interface AuthContextValue {
     readonly loading: boolean;
     readonly member: ApiMember | null;

package/dist/lib/org-tree-draft.d.ts

@@ -1,4 +1,4 @@
-import { OrgUnitRecord } from '../../libs/bpm-core-client/src/lib/organization/index.ts';
+import { OrgUnitRecord } from '@rytass/bpm-core-client/organization';
 export type OrgUnitParentDraftMap = ReadonlyMap<string, string | null>;
 export type OrgUnitHierarchyDraftChange = Readonly<{
     orgUnitId: string;

package/dist/lib/routes-config.d.ts

@@ -32,11 +32,20 @@ export interface BPMRoutes {
     delegations(): string;
     /** Notification list. */
     notifications(): string;
-    /** Detail page for one approval instance. */
+    /**
+     * Detail page for one approval instance.
+     *
+     * @example default → `/instances/abc123`
+     */
     caseDetail(instanceId: string): string;
     /**
      * Launch a new approval instance. When `templateId` is passed, the
-     * launch form is pre-populated for that template.
+     * launch form is pre-populated for that template — by default this is
+     * appended as a `?templateId=` query string so the path itself stays
+     * stable for routing.
+     *
+     * @example default `caseNew()` → `/instances/new`
+     * @example default `caseNew('tpl-1')` → `/instances/new?templateId=tpl-1`
      */
     caseNew(templateId?: string): string;
     /** Template index. */

package/dist/next/BPMNextProviders.d.ts

@@ -1,6 +1,51 @@
 import { ReactElement, ReactNode } from 'react';
-interface BPMNextProvidersProps {
+import { CalendarLocale } from '@mezzanine-ui/react/moment';
+export interface BPMNextProvidersProps {
     readonly children: ReactNode;
+    /**
+     * Override the Mezzanine calendar locale. Forwarded to the inner
+     * `<Providers>`. Defaults to `CalendarLocale.ZH_TW`.
+     */
+    readonly locale?: CalendarLocale;
+    /**
+     * Routes that must remain accessible without a BPM session — visiting
+     * these does not redirect to `loginPath` even when `member` is null.
+     * Forwarded to `<AuthProvider>`. Defaults to `['/login']`.
+     *
+     * Hosts that mount BPM under a non-root prefix (see
+     * `<BPMRoutesProvider>`) should typically expand this to include their
+     * own auth-bypass paths.
+     */
+    readonly publicPaths?: readonly string[];
+    /**
+     * Where to redirect unauthenticated users. Forwarded to
+     * `<AuthProvider>`. Defaults to `'/login'`. Hosts owning their own
+     * login route (the recommended case) override this to their host
+     * route, e.g. `'/auth/sign-in'`.
+     */
+    readonly loginPath?: string;
 }
-export declare function BPMNextProviders({ children, }: BPMNextProvidersProps): ReactElement;
-export {};
+/**
+ * One-line Next.js App Router shim for the full BPM provider stack.
+ * Mounts in the host's root layout (or layout for the BPM sub-tree):
+ *
+ * ```tsx
+ * import { BPMNextProviders } from '@rytass/bpm-core-react/next';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html><body>
+ *       <BPMNextProviders loginPath="/auth/sign-in">
+ *         {children}
+ *       </BPMNextProviders>
+ *     </body></html>
+ *   );
+ * }
+ * ```
+ *
+ * Forwards every prop on {@link BPMNextProvidersProps} to the inner
+ * `<Providers>` and `<AuthProvider>`. For per-feature path remapping
+ * (BPM internal navigation), additionally wrap with
+ * `<BPMRoutesProvider>` exported from the same subpath.
+ */
+export declare function BPMNextProviders(props: BPMNextProvidersProps): ReactElement;

package/dist/next/index.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/routes-config-2aKbWq2H.cjs");let t=require("react"),n=require("react/jsx-runtime"),r=require("next/navigation"),i=require("@rytass/bpm-core-react");function a({children:e}){let a=(0,r.useRouter)(),o=(0,r.usePathname)(),s=(0,r.useSearchParams)();return(0,n.jsx)(i.RouterAdapterProvider,{value:(0,t.useMemo)(()=>({pathname:o,push:e=>a.push(e),replace:e=>a.replace(e),back:()=>a.back(),searchParams:()=>new URLSearchParams(s?.toString()??``)}),[a,o,s]),children:(0,n.jsx)(i.Providers,{children:e})})}function o({children:e}){return(0,n.jsx)(t.Suspense,{fallback:null,children:(0,n.jsx)(a,{children:e})})}exports.BPMNextProviders=o,exports.BPMRoutesProvider=e.t,exports.createDefaultBPMRoutes=e.n,exports.useBPMRoutes=e.r;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/routes-config-2aKbWq2H.cjs");let t=require("react"),n=require("react/jsx-runtime"),r=require("next/navigation"),i=require("@rytass/bpm-core-react");function a({children:e,locale:a,publicPaths:o,loginPath:s}){let c=(0,r.useRouter)(),l=(0,r.usePathname)(),u=(0,r.useSearchParams)();return(0,n.jsx)(i.RouterAdapterProvider,{value:(0,t.useMemo)(()=>({pathname:l,push:e=>c.push(e),replace:e=>c.replace(e),back:()=>c.back(),searchParams:()=>new URLSearchParams(u?.toString()??``)}),[c,l,u]),children:(0,n.jsx)(i.Providers,{locale:a,publicPaths:o,loginPath:s,children:e})})}function o(e){return(0,n.jsx)(t.Suspense,{fallback:null,children:(0,n.jsx)(a,{...e})})}exports.BPMNextProviders=o,exports.BPMRoutesProvider=e.t,exports.createDefaultBPMRoutes=e.n,exports.useBPMRoutes=e.r;
 //# sourceMappingURL=index.cjs.map

package/dist/next/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/next/BPMNextProviders.tsx"],"sourcesContent":["'use client';\n\n// One-line Next.js App Router shim for BPM. Reads `next/navigation` hooks,\n// builds a `RouterAdapter`, then composes `<RouterAdapterProvider>` and the\n// shared `<BPMProviders>`. Wrapped in `<Suspense>` so static prerender of\n// routes like `/404` does not fail on `useSearchParams()` during `next build`.\n\nimport { Suspense, useMemo, type ReactElement, type ReactNode } from 'react';\nimport { usePathname, useRouter, useSearchParams } from 'next/navigation';\nimport {\n  Providers as BPMProviders,\n  RouterAdapterProvider,\n  type RouterAdapter,\n} from '@rytass/bpm-core-react';\n\ninterface BPMNextProvidersProps {\n  readonly children: ReactNode;\n}\n\nfunction BPMNextProvidersBody({\n  children,\n}: BPMNextProvidersProps): ReactElement {\n  const nextRouter = useRouter();\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  const adapter = useMemo<RouterAdapter>(\n    () => ({\n      pathname,\n      push: (href: string): void => nextRouter.push(href),\n      replace: (href: string): void => nextRouter.replace(href),\n      back: (): void => nextRouter.back(),\n      searchParams: (): URLSearchParams =>\n        new URLSearchParams(searchParams?.toString() ?? ''),\n    }),\n    [nextRouter, pathname, searchParams],\n  );\n\n  return (\n    <RouterAdapterProvider value={adapter}>\n      <BPMProviders>{children}</BPMProviders>\n    </RouterAdapterProvider>\n  );\n}\n\nexport function BPMNextProviders({\n  children,\n}: BPMNextProvidersProps): ReactElement {\n  return (\n    <Suspense fallback={null}>\n      <BPMNextProvidersBody>{children}</BPMNextProvidersBody>\n    </Suspense>\n  );\n}\n"],"mappings":"+PAmBA,SAAS,EAAqB,CAC5B,YACsC,CACtC,IAAM,GAAA,EAAA,EAAA,WAAuB,EACvB,GAAA,EAAA,EAAA,aAAuB,EACvB,GAAA,EAAA,EAAA,iBAA+B,EAcrC,OACE,EAAA,EAAA,KAAC,EAAA,sBAAD,CAAuB,OAAA,EAAA,EAAA,cAZhB,CACL,WACA,KAAO,GAAuB,EAAW,KAAK,CAAI,EAClD,QAAU,GAAuB,EAAW,QAAQ,CAAI,EACxD,SAAkB,EAAW,KAAK,EAClC,iBACE,IAAI,gBAAgB,GAAc,SAAS,GAAK,EAAE,CACtD,GACA,CAAC,EAAY,EAAU,CAAY,CAIL,YAC5B,EAAA,EAAA,KAAC,EAAA,UAAD,CAAe,UAAuB,CAAA,CACjB,CAAA,CAE3B,CAEA,SAAgB,EAAiB,CAC/B,YACsC,CACtC,OACE,EAAA,EAAA,KAAC,EAAA,SAAD,CAAU,SAAU,eAClB,EAAA,EAAA,KAAC,EAAD,CAAuB,UAA+B,CAAA,CAC9C,CAAA,CAEd"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/next/BPMNextProviders.tsx"],"sourcesContent":["'use client';\n\n// One-line Next.js App Router shim for BPM. Reads `next/navigation` hooks,\n// builds a `RouterAdapter`, then composes `<RouterAdapterProvider>` and the\n// shared `<BPMProviders>`. Wrapped in `<Suspense>` so static prerender of\n// routes like `/404` does not fail on `useSearchParams()` during `next build`.\n\nimport { Suspense, useMemo, type ReactElement, type ReactNode } from 'react';\nimport { usePathname, useRouter, useSearchParams } from 'next/navigation';\nimport {\n  Providers as BPMProviders,\n  RouterAdapterProvider,\n  type RouterAdapter,\n} from '@rytass/bpm-core-react';\nimport type { CalendarLocale } from '@mezzanine-ui/react/moment';\n\nexport interface BPMNextProvidersProps {\n  readonly children: ReactNode;\n  /**\n   * Override the Mezzanine calendar locale. Forwarded to the inner\n   * `<Providers>`. Defaults to `CalendarLocale.ZH_TW`.\n   */\n  readonly locale?: CalendarLocale;\n  /**\n   * Routes that must remain accessible without a BPM session — visiting\n   * these does not redirect to `loginPath` even when `member` is null.\n   * Forwarded to `<AuthProvider>`. Defaults to `['/login']`.\n   *\n   * Hosts that mount BPM under a non-root prefix (see\n   * `<BPMRoutesProvider>`) should typically expand this to include their\n   * own auth-bypass paths.\n   */\n  readonly publicPaths?: readonly string[];\n  /**\n   * Where to redirect unauthenticated users. Forwarded to\n   * `<AuthProvider>`. Defaults to `'/login'`. Hosts owning their own\n   * login route (the recommended case) override this to their host\n   * route, e.g. `'/auth/sign-in'`.\n   */\n  readonly loginPath?: string;\n}\n\nfunction BPMNextProvidersBody({\n  children,\n  locale,\n  publicPaths,\n  loginPath,\n}: BPMNextProvidersProps): ReactElement {\n  const nextRouter = useRouter();\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  const adapter = useMemo<RouterAdapter>(\n    () => ({\n      pathname,\n      push: (href: string): void => nextRouter.push(href),\n      replace: (href: string): void => nextRouter.replace(href),\n      back: (): void => nextRouter.back(),\n      searchParams: (): URLSearchParams =>\n        new URLSearchParams(searchParams?.toString() ?? ''),\n    }),\n    [nextRouter, pathname, searchParams],\n  );\n\n  return (\n    <RouterAdapterProvider value={adapter}>\n      <BPMProviders\n        locale={locale}\n        publicPaths={publicPaths}\n        loginPath={loginPath}\n      >\n        {children}\n      </BPMProviders>\n    </RouterAdapterProvider>\n  );\n}\n\n/**\n * One-line Next.js App Router shim for the full BPM provider stack.\n * Mounts in the host's root layout (or layout for the BPM sub-tree):\n *\n * ```tsx\n * import { BPMNextProviders } from '@rytass/bpm-core-react/next';\n *\n * export default function RootLayout({ children }) {\n *   return (\n *     <html><body>\n *       <BPMNextProviders loginPath=\"/auth/sign-in\">\n *         {children}\n *       </BPMNextProviders>\n *     </body></html>\n *   );\n * }\n * ```\n *\n * Forwards every prop on {@link BPMNextProvidersProps} to the inner\n * `<Providers>` and `<AuthProvider>`. For per-feature path remapping\n * (BPM internal navigation), additionally wrap with\n * `<BPMRoutesProvider>` exported from the same subpath.\n */\nexport function BPMNextProviders(props: BPMNextProvidersProps): ReactElement {\n  return (\n    <Suspense fallback={null}>\n      <BPMNextProvidersBody {...props} />\n    </Suspense>\n  );\n}\n"],"mappings":"+PA0CA,SAAS,EAAqB,CAC5B,WACA,SACA,cACA,aACsC,CACtC,IAAM,GAAA,EAAA,EAAA,WAAuB,EACvB,GAAA,EAAA,EAAA,aAAuB,EACvB,GAAA,EAAA,EAAA,iBAA+B,EAcrC,OACE,EAAA,EAAA,KAAC,EAAA,sBAAD,CAAuB,OAAA,EAAA,EAAA,cAZhB,CACL,WACA,KAAO,GAAuB,EAAW,KAAK,CAAI,EAClD,QAAU,GAAuB,EAAW,QAAQ,CAAI,EACxD,SAAkB,EAAW,KAAK,EAClC,iBACE,IAAI,gBAAgB,GAAc,SAAS,GAAK,EAAE,CACtD,GACA,CAAC,EAAY,EAAU,CAAY,CAIL,YAC5B,EAAA,EAAA,KAAC,EAAA,UAAD,CACU,SACK,cACF,YAEV,UACW,CAAA,CACO,CAAA,CAE3B,CAyBA,SAAgB,EAAiB,EAA4C,CAC3E,OACE,EAAA,EAAA,KAAC,EAAA,SAAD,CAAU,SAAU,eAClB,EAAA,EAAA,KAAC,EAAD,CAAsB,GAAI,CAAQ,CAAA,CAC1B,CAAA,CAEd"}

package/dist/next/index.js

@@ -5,27 +5,32 @@ import { jsx as a } from "react/jsx-runtime";
 import { usePathname as o, useRouter as s, useSearchParams as c } from "next/navigation";
 import { Providers as l, RouterAdapterProvider as u } from "@rytass/bpm-core-react";
 //#region src/next/BPMNextProviders.tsx
-function d({ children: e }) {
-	let t = s(), n = o(), r = c();
+function d({ children: e, locale: t, publicPaths: n, loginPath: r }) {
+	let d = s(), f = o(), p = c();
 	return /* @__PURE__ */ a(u, {
 		value: i(() => ({
-			pathname: n,
-			push: (e) => t.push(e),
-			replace: (e) => t.replace(e),
-			back: () => t.back(),
-			searchParams: () => new URLSearchParams(r?.toString() ?? "")
+			pathname: f,
+			push: (e) => d.push(e),
+			replace: (e) => d.replace(e),
+			back: () => d.back(),
+			searchParams: () => new URLSearchParams(p?.toString() ?? "")
 		}), [
-			t,
-			n,
-			r
+			d,
+			f,
+			p
 		]),
-		children: /* @__PURE__ */ a(l, { children: e })
+		children: /* @__PURE__ */ a(l, {
+			locale: t,
+			publicPaths: n,
+			loginPath: r,
+			children: e
+		})
 	});
 }
-function f({ children: e }) {
+function f(e) {
 	return /* @__PURE__ */ a(r, {
 		fallback: null,
-		children: /* @__PURE__ */ a(d, { children: e })
+		children: /* @__PURE__ */ a(d, { ...e })
 	});
 }
 //#endregion

package/dist/next/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/next/BPMNextProviders.tsx"],"sourcesContent":["'use client';\n\n// One-line Next.js App Router shim for BPM. Reads `next/navigation` hooks,\n// builds a `RouterAdapter`, then composes `<RouterAdapterProvider>` and the\n// shared `<BPMProviders>`. Wrapped in `<Suspense>` so static prerender of\n// routes like `/404` does not fail on `useSearchParams()` during `next build`.\n\nimport { Suspense, useMemo, type ReactElement, type ReactNode } from 'react';\nimport { usePathname, useRouter, useSearchParams } from 'next/navigation';\nimport {\n  Providers as BPMProviders,\n  RouterAdapterProvider,\n  type RouterAdapter,\n} from '@rytass/bpm-core-react';\n\ninterface BPMNextProvidersProps {\n  readonly children: ReactNode;\n}\n\nfunction BPMNextProvidersBody({\n  children,\n}: BPMNextProvidersProps): ReactElement {\n  const nextRouter = useRouter();\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  const adapter = useMemo<RouterAdapter>(\n    () => ({\n      pathname,\n      push: (href: string): void => nextRouter.push(href),\n      replace: (href: string): void => nextRouter.replace(href),\n      back: (): void => nextRouter.back(),\n      searchParams: (): URLSearchParams =>\n        new URLSearchParams(searchParams?.toString() ?? ''),\n    }),\n    [nextRouter, pathname, searchParams],\n  );\n\n  return (\n    <RouterAdapterProvider value={adapter}>\n      <BPMProviders>{children}</BPMProviders>\n    </RouterAdapterProvider>\n  );\n}\n\nexport function BPMNextProviders({\n  children,\n}: BPMNextProvidersProps): ReactElement {\n  return (\n    <Suspense fallback={null}>\n      <BPMNextProvidersBody>{children}</BPMNextProvidersBody>\n    </Suspense>\n  );\n}\n"],"mappings":";;;;;;;AAmBA,SAAS,EAAqB,EAC5B,eACsC;CACtC,IAAM,IAAa,EAAU,GACvB,IAAW,EAAY,GACvB,IAAe,EAAgB;CAcrC,OACE,kBAAC,GAAD;EAAuB,OAbT,SACP;GACL;GACA,OAAO,MAAuB,EAAW,KAAK,CAAI;GAClD,UAAU,MAAuB,EAAW,QAAQ,CAAI;GACxD,YAAkB,EAAW,KAAK;GAClC,oBACE,IAAI,gBAAgB,GAAc,SAAS,KAAK,EAAE;EACtD,IACA;GAAC;GAAY;GAAU;EAAY,CAIL;YAC5B,kBAAC,GAAD,EAAe,YAAuB,CAAA;CACjB,CAAA;AAE3B;AAEA,SAAgB,EAAiB,EAC/B,eACsC;CACtC,OACE,kBAAC,GAAD;EAAU,UAAU;YAClB,kBAAC,GAAD,EAAuB,YAA+B,CAAA;CAC9C,CAAA;AAEd"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/next/BPMNextProviders.tsx"],"sourcesContent":["'use client';\n\n// One-line Next.js App Router shim for BPM. Reads `next/navigation` hooks,\n// builds a `RouterAdapter`, then composes `<RouterAdapterProvider>` and the\n// shared `<BPMProviders>`. Wrapped in `<Suspense>` so static prerender of\n// routes like `/404` does not fail on `useSearchParams()` during `next build`.\n\nimport { Suspense, useMemo, type ReactElement, type ReactNode } from 'react';\nimport { usePathname, useRouter, useSearchParams } from 'next/navigation';\nimport {\n  Providers as BPMProviders,\n  RouterAdapterProvider,\n  type RouterAdapter,\n} from '@rytass/bpm-core-react';\nimport type { CalendarLocale } from '@mezzanine-ui/react/moment';\n\nexport interface BPMNextProvidersProps {\n  readonly children: ReactNode;\n  /**\n   * Override the Mezzanine calendar locale. Forwarded to the inner\n   * `<Providers>`. Defaults to `CalendarLocale.ZH_TW`.\n   */\n  readonly locale?: CalendarLocale;\n  /**\n   * Routes that must remain accessible without a BPM session — visiting\n   * these does not redirect to `loginPath` even when `member` is null.\n   * Forwarded to `<AuthProvider>`. Defaults to `['/login']`.\n   *\n   * Hosts that mount BPM under a non-root prefix (see\n   * `<BPMRoutesProvider>`) should typically expand this to include their\n   * own auth-bypass paths.\n   */\n  readonly publicPaths?: readonly string[];\n  /**\n   * Where to redirect unauthenticated users. Forwarded to\n   * `<AuthProvider>`. Defaults to `'/login'`. Hosts owning their own\n   * login route (the recommended case) override this to their host\n   * route, e.g. `'/auth/sign-in'`.\n   */\n  readonly loginPath?: string;\n}\n\nfunction BPMNextProvidersBody({\n  children,\n  locale,\n  publicPaths,\n  loginPath,\n}: BPMNextProvidersProps): ReactElement {\n  const nextRouter = useRouter();\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  const adapter = useMemo<RouterAdapter>(\n    () => ({\n      pathname,\n      push: (href: string): void => nextRouter.push(href),\n      replace: (href: string): void => nextRouter.replace(href),\n      back: (): void => nextRouter.back(),\n      searchParams: (): URLSearchParams =>\n        new URLSearchParams(searchParams?.toString() ?? ''),\n    }),\n    [nextRouter, pathname, searchParams],\n  );\n\n  return (\n    <RouterAdapterProvider value={adapter}>\n      <BPMProviders\n        locale={locale}\n        publicPaths={publicPaths}\n        loginPath={loginPath}\n      >\n        {children}\n      </BPMProviders>\n    </RouterAdapterProvider>\n  );\n}\n\n/**\n * One-line Next.js App Router shim for the full BPM provider stack.\n * Mounts in the host's root layout (or layout for the BPM sub-tree):\n *\n * ```tsx\n * import { BPMNextProviders } from '@rytass/bpm-core-react/next';\n *\n * export default function RootLayout({ children }) {\n *   return (\n *     <html><body>\n *       <BPMNextProviders loginPath=\"/auth/sign-in\">\n *         {children}\n *       </BPMNextProviders>\n *     </body></html>\n *   );\n * }\n * ```\n *\n * Forwards every prop on {@link BPMNextProvidersProps} to the inner\n * `<Providers>` and `<AuthProvider>`. For per-feature path remapping\n * (BPM internal navigation), additionally wrap with\n * `<BPMRoutesProvider>` exported from the same subpath.\n */\nexport function BPMNextProviders(props: BPMNextProvidersProps): ReactElement {\n  return (\n    <Suspense fallback={null}>\n      <BPMNextProvidersBody {...props} />\n    </Suspense>\n  );\n}\n"],"mappings":";;;;;;;AA0CA,SAAS,EAAqB,EAC5B,aACA,WACA,gBACA,gBACsC;CACtC,IAAM,IAAa,EAAU,GACvB,IAAW,EAAY,GACvB,IAAe,EAAgB;CAcrC,OACE,kBAAC,GAAD;EAAuB,OAbT,SACP;GACL;GACA,OAAO,MAAuB,EAAW,KAAK,CAAI;GAClD,UAAU,MAAuB,EAAW,QAAQ,CAAI;GACxD,YAAkB,EAAW,KAAK;GAClC,oBACE,IAAI,gBAAgB,GAAc,SAAS,KAAK,EAAE;EACtD,IACA;GAAC;GAAY;GAAU;EAAY,CAIL;YAC5B,kBAAC,GAAD;GACU;GACK;GACF;GAEV;EACW,CAAA;CACO,CAAA;AAE3B;AAyBA,SAAgB,EAAiB,GAA4C;CAC3E,OACE,kBAAC,GAAD;EAAU,UAAU;YAClB,kBAAC,GAAD,EAAsB,GAAI,EAAQ,CAAA;CAC1B,CAAA;AAEd"}

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

@@ -1,6 +1,6 @@
 import { CSSProperties, ReactElement } from 'react';
-import { FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '../../../../libs/shared/src/lib/form.ts';
-import { FormRendererValues } from '../../../../libs/bpm-core-client/src/lib/form/index.ts';
+import { FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { FormRendererValues } from '@rytass/bpm-core-client/form';
 export interface FormRendererProps {
     readonly emptyText?: string;
     readonly errors?: Readonly<Record<string, string>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/bpm-core-react",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "BPM approval workflow React components and views for the Rytass BPM stack. Self-contained AuthProvider, NotificationDrawer, AppNavigation, plus full views for inbox / instances / templates / forms / admin / settings that compose on top of Mezzanine UI and the BPM client functions.",
   "keywords": [
     "bpm",
@@ -278,8 +278,8 @@
     }
   },
   "peerDependencies": {
-    "@rytass/bpm-core-client": "^0.1.5",
-    "@rytass/bpm-core-shared": "^0.1.5",
+    "@rytass/bpm-core-client": "^0.1.6",
+    "@rytass/bpm-core-shared": "^0.1.6",
     "@mezzanine-ui/react": "^1.1.0",
     "@mezzanine-ui/icons": "^1.0.2",
     "react": "^18.0.0 || ^19.0.0",