@elytracms/studio 0.0.93 → 0.0.94

package/dist/components/rail-store-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"rail-store-status.js","sourceRoot":"","sources":["../../src/components/rail-store-status.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,UAAU,EACV,YAAY,EACZ,WAAW,GAaZ;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,CACL,6BAAkB,WAAW,YAC3B,KAAC,gBAAgB,IACf,KAAK,EAAC,OAAO,EACb,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,2BAA2B,CAAC,EACzE,MAAM,EACJ,MAAC,MAAM,IAAC,OAAO,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,aACrE,KAAC,SAAS,KAAG,OAAE,SAAS,CAAC,cAAc,CAAC,IACjC,GAEX,GACE,CACP,CAAA;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAC,gBAAgB,IAAC,KAAK,EAAC,SAAS,EAAC,KAAK,EAAE,YAAY,GAAI,CAAA;IAClE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import type { ReactElement } from 'react'\nimport { RotateCcw } from 'lucide-react'\nimport { Button } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { SectionStateView } from './section-state'\n\n/**\n * The shared error/loading status gate for a rail module (EC-319/EC-323,\n * repointed onto `SectionStateView` in EC-327). The assets, users, and\n * redirects rails each read a list store with the same\n * `{ status, errorMessage, refresh }` shape; this renders the shared\n * error/loading section state — each rail's own translated `errorLabel`/\n * `loadingLabel` copy, not a generic one — instead of a rail re-inlining its\n * own AlertTriangle+retry panel. Returns `null` for a `ready` store.\n */\nexport function RailStoreStatus({\n  store,\n  errorLabel,\n  loadingLabel,\n  errorTestId,\n}: {\n  store: {\n    status: 'loading' | 'ready' | 'error'\n    errorMessage?: string\n    refresh: () => Promise<void>\n  }\n  /** Localized \"…failed to load\" heading for this rail. */\n  errorLabel: string\n  /** Localized \"Loading …\" text for this rail. */\n  loadingLabel: string\n  /** data-testid on the error container (per-rail, for tests). */\n  errorTestId: string\n}): ReactElement | null {\n  if (store.status === 'error') {\n    return (\n      <div data-testid={errorTestId}>\n        <SectionStateView\n          state=\"error\"\n          title={errorLabel}\n          description={store.errorMessage ?? translate('common.backendUnreachable')}\n          action={\n            <Button variant=\"outline\" size=\"sm\" onClick={() => void store.refresh()}>\n              <RotateCcw /> {translate('common.retry')}\n            </Button>\n          }\n        />\n      </div>\n    )\n  }\n  if (store.status === 'loading') {\n    return <SectionStateView state=\"loading\" title={loadingLabel} />\n  }\n  return null\n}\n"]}
+{"version":3,"file":"rail-store-status.js","sourceRoot":"","sources":["../../src/components/rail-store-status.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,UAAU,EACV,YAAY,EACZ,WAAW,GAaZ;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,CACL,6BAAkB,WAAW,YAC3B,KAAC,gBAAgB,IACf,KAAK,EAAC,OAAO,EACb,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,2BAA2B,CAAC,EACzE,MAAM,EACJ,MAAC,MAAM,IAAC,OAAO,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,aACrE,KAAC,SAAS,KAAG,OAAE,SAAS,CAAC,cAAc,CAAC,IACjC,GAEX,GACE,CACP,CAAA;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAC,gBAAgB,IAAC,KAAK,EAAC,SAAS,EAAC,KAAK,EAAE,YAAY,GAAI,CAAA;IAClE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import type { ReactElement } from 'react'\nimport { RotateCcw } from 'lucide-react'\nimport { Button } from '@elytracms/studio/ui'\nimport { translate } from '../lib/i18n'\nimport { SectionStateView } from './section-state'\n\n/**\n * The shared error/loading status gate for a rail module (EC-319/EC-323,\n * repointed onto `SectionStateView` in EC-327). The assets, users, and\n * redirects rails each read a list store with the same\n * `{ status, errorMessage, refresh }` shape; this renders the shared\n * error/loading section state — each rail's own translated `errorLabel`/\n * `loadingLabel` copy, not a generic one — instead of a rail re-inlining its\n * own AlertTriangle+retry panel. Returns `null` for a `ready` store.\n */\nexport function RailStoreStatus({\n  store,\n  errorLabel,\n  loadingLabel,\n  errorTestId,\n}: {\n  store: {\n    status: 'loading' | 'ready' | 'error'\n    errorMessage?: string\n    refresh: () => Promise<void>\n  }\n  /** Localized \"…failed to load\" heading for this rail. */\n  errorLabel: string\n  /** Localized \"Loading …\" text for this rail. */\n  loadingLabel: string\n  /** data-testid on the error container (per-rail, for tests). */\n  errorTestId: string\n}): ReactElement | null {\n  if (store.status === 'error') {\n    return (\n      <div data-testid={errorTestId}>\n        <SectionStateView\n          state=\"error\"\n          title={errorLabel}\n          description={store.errorMessage ?? translate('common.backendUnreachable')}\n          action={\n            <Button variant=\"outline\" size=\"sm\" onClick={() => void store.refresh()}>\n              <RotateCcw /> {translate('common.retry')}\n            </Button>\n          }\n        />\n      </div>\n    )\n  }\n  if (store.status === 'loading') {\n    return <SectionStateView state=\"loading\" title={loadingLabel} />\n  }\n  return null\n}\n"]}

package/dist/components/rail-view-source.d.ts

@@ -1,8 +1,8 @@
 import type { CmsDocument, CmsValidationIssue, CollectionDef, DocumentRef, FieldDef, LocaleConfig } from '@elytracms/core/cms-core';
 import type { OperationError, OperationResult } from '@elytracms/core/operations';
 import type { ReferenceTarget } from '@elytracms/core/persistence';
-import type { TableViewState } from '@elytracms/studio/lib/cms-views';
-import type { CollectionViewCapabilities, CollectionViewSource, FieldAccess } from '@elytracms/studio/lib/collection-view/collection-view-source';
+import type { TableViewState } from '../lib/cms-views/index.js';
+import type { CollectionViewCapabilities, CollectionViewSource, FieldAccess } from '../lib/collection-view/collection-view-source.js';
 import type { BulkAction, BulkReport, BulkSetField } from './cms/bulk-actions.js';
 /**
  * The shared scaffold behind the primitive-rail `CollectionViewSource` hooks
@@ -48,7 +48,7 @@ export declare function metaBagProjection(values: Record<string, unknown>, canon
 /** Wrap a raw store write (save/remove) so a normalized failure surfaces via
  *  `setError` — the factory's error-mapping plumbing, pulled out as a plain
  *  function (no hook) so it is unit-testable without a `renderHook` harness. */
-export declare function createErrorMappedWriter<TArg, TResult>(write: (arg: TArg) => Promise<TResult>, normalize: (result: TResult) => OperationError | null, setError: (error: OperationError) => void): (arg: TArg) => void;
+export declare function createErrorMappedWriter<TArg, TResult, TExtra = never>(write: (arg: TArg, extra?: TExtra) => Promise<TResult>, normalize: (result: TResult) => OperationError | null, setError: (error: OperationError) => void): (arg: TArg, extra?: TExtra) => void;
 /** The store-facing input of {@link runRailBulkAction} — plain data/functions,
  *  so the rail bulk path is unit-testable without a hook harness. */
 export interface RailBulkInput {
@@ -110,7 +110,8 @@ interface RailViewSourceCore {
  *  each rail's own store-result shape — reconciled to `lastError` by the
  *  rail's own `normalizeSaveResult`/`normalizeRemoveResult`. */
 export interface RailAdapter<TSaveResult, TRemoveResult> extends RailViewSourceCore {
-    save(doc: CmsDocument): Promise<TSaveResult>;
+    /** `base`: the record as the editor opened it (EC-616 — see `RecordWrites.save`). */
+    save(doc: CmsDocument, base?: CmsDocument): Promise<TSaveResult>;
     remove(ref: DocumentRef): Promise<TRemoveResult>;
     /**
      * The delete the BULK path dispatches (EC-433) — always post-confirmation
@@ -130,7 +131,7 @@ interface RailViewSourceAssemblyInput extends RailViewSourceCore {
     clearLastError(): void;
     viewState: TableViewState;
     setViewState: CollectionViewSource['setViewState'];
-    save(doc: CmsDocument): void;
+    save(doc: CmsDocument, base?: CmsDocument): void;
     remove(ref: DocumentRef): void;
     /**
      * The rail bulk runner (EC-433). Assembled onto the source ONLY when

package/dist/components/rail-view-source.js

@@ -1,5 +1,5 @@
 import { useCallback, useMemo, useState } from 'react';
-import { defaultViewState } from '@elytracms/studio/lib/cms-views';
+import { defaultViewState } from '../lib/cms-views/index.js';
 import { runBulkAction } from './cms/bulk-actions.js';
 /** The default normalizer for an {@link OkResult}: a failure maps to a
  *  surfaced {@link OperationError}; a success maps to no error at all. */
@@ -27,8 +27,9 @@ export function metaBagProjection(values, canonicalNames) {
  *  `setError` — the factory's error-mapping plumbing, pulled out as a plain
  *  function (no hook) so it is unit-testable without a `renderHook` harness. */
 export function createErrorMappedWriter(write, normalize, setError) {
-    return (arg) => {
-        void write(arg).then((result) => {
+    // `extra` (EC-616): a record save's base, forwarded untouched.
+    return (arg, extra) => {
+        void write(arg, extra).then((result) => {
             const error = normalize(result);
             if (error)
                 setError(error);

package/dist/components/rail-view-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"rail-view-source.js","sourceRoot":"","sources":["../../src/components/rail-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  DocumentRef,\n  FieldDef,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport type { OperationError, OperationResult } from '@elytracms/core/operations'\nimport type { ReferenceTarget } from '@elytracms/core/persistence'\nimport { defaultViewState } from '@elytracms/studio/lib/cms-views'\nimport type { TableViewState } from '@elytracms/studio/lib/cms-views'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n  FieldAccess,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { runBulkAction } from './cms/bulk-actions'\nimport type { BulkAction, BulkReport, BulkSetField } from './cms/bulk-actions'\n\n/**\n * The shared scaffold behind the primitive-rail `CollectionViewSource` hooks\n * (EC-327) — assets, users, redirects. All three hand-rolled identical\n * `viewState`/`lastError` state, an identical `setViewState` updater-fn\n * wrapper, an identical `if (!result.ok) setLastError(...)` error-mapping\n * shape (assets' `remove` diverges — see {@link OkResult} below), and a large\n * final `useMemo` assembling the same ~20-field {@link CollectionViewSource}.\n * The 4th rail (`useCmsCollectionViewSource`) does NOT reduplicate this — it\n * delegates to the ambient `CmsStore` — so this scaffold is scoped to the\n * three self-contained rails, not a fully generic replacement for the CMS\n * adapter.\n *\n * Genuinely divergent per-rail behaviour is a PARAMETER, never hidden here:\n * users' principal-based `fieldAccess`, users' no-op vs. redirects/assets'\n * registry-driven `validate`, redirects-only `create`, and — the one save/\n * remove result-shape mismatch — assets' `remove()` returns an\n * `outcome`-discriminated result where users/redirects use `{ ok }`; each rail\n * supplies its own `normalizeSaveResult`/`normalizeRemoveResult` to reconcile\n * whichever shape its store returns into `lastError`.\n */\n\n/** The common `{ ok: true; … } | { ok: false; message }` store-result shape —\n *  users' and redirects' save/remove, and assets' `updateMetadata` (save). */\nexport type OkResult = { ok: true } | { ok: false; message: string }\n\n/** The default normalizer for an {@link OkResult}: a failure maps to a\n *  surfaced {@link OperationError}; a success maps to no error at all. */\nexport function normalizeOkResult(result: OkResult): OperationError | null {\n  return result.ok ? null : { code: 'unknown', message: result.message }\n}\n\n/**\n * Project a lens document's values into a meta bag (EC-311/EC-240/EC-303):\n * every entry whose key is NOT one of the rail's canonical/identity field\n * names round-trips through the record's open `meta` bag. Shared by the users\n * (`IDENTITY_FIELDS`) and redirects (`CANONICAL_REDIRECT_FIELDS`) rails — the\n * assets rail's projection is schema-FIELDS-driven inclusion (iterating the\n * schema's declared fields, not the document's value keys), a genuinely\n * different shape that stays bespoke in `assets-collection-view-source.ts`.\n */\nexport function metaBagProjection(\n  values: Record<string, unknown>,\n  canonicalNames: ReadonlySet<string>,\n): Record<string, unknown> {\n  const meta: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(values)) {\n    if (!canonicalNames.has(key)) meta[key] = value\n  }\n  return meta\n}\n\n/** Wrap a raw store write (save/remove) so a normalized failure surfaces via\n *  `setError` — the factory's error-mapping plumbing, pulled out as a plain\n *  function (no hook) so it is unit-testable without a `renderHook` harness. */\nexport function createErrorMappedWriter<TArg, TResult>(\n  write: (arg: TArg) => Promise<TResult>,\n  normalize: (result: TResult) => OperationError | null,\n  setError: (error: OperationError) => void,\n): (arg: TArg) => void {\n  return (arg: TArg) => {\n    void write(arg).then((result) => {\n      const error = normalize(result)\n      if (error) setError(error)\n    })\n  }\n}\n\n/** The store-facing input of {@link runRailBulkAction} — plain data/functions,\n *  so the rail bulk path is unit-testable without a hook harness. */\nexport interface RailBulkInput {\n  collectionId: string\n  /** Current rail rows (lens documents) — the runner's lookup + validation input. */\n  documents: readonly CmsDocument[]\n  titleOf(ref: DocumentRef): string\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  /**\n   * Dispatch ONE already-confirmed delete (the EC-173 reference dialog ran\n   * before anything reaches this) and reconcile the rail store's result shape\n   * into an operation-shaped outcome — a failure here is a visible per-item\n   * failure in the report, never a swallowed one.\n   */\n  removeConfirmed(ref: DocumentRef): Promise<OperationResult<unknown>>\n}\n\n/**\n * The primitive rails' bulk runner (EC-433): the SAME `runBulkAction` machinery\n * the CMS rail uses ([[client-data-flow-one-cache]] — no parallel data flow),\n * wired to the rail's own store delete. Only `delete` is dispatchable — the\n * rails have no publish lifecycle and no bulk set-field — and an unsupported\n * action fails each item HONESTLY in the report rather than silently no-oping\n * (the exact bug this replaces: the assets rail's bulk delete confirmed into a\n * missing `source.bulk` and dropped the whole action on the floor).\n */\nexport function runRailBulkAction(\n  input: RailBulkInput,\n  ids: readonly string[],\n  action: BulkAction,\n  setField?: BulkSetField,\n): Promise<BulkReport> {\n  return runBulkAction(\n    {\n      documents: input.documents,\n      titleOf: input.titleOf,\n      validate: input.validate,\n      // A rail store patches its own cache/state inside a succeeded remove\n      // (assets/users/redirects all do), and publish/unpublish/set-field never\n      // succeed here (dispatch rejects them), so the session-apply hooks have\n      // nothing left to apply.\n      applyState: () => undefined,\n      applyDelete: () => undefined,\n      dispatch: (bulkAction, ref) =>\n        bulkAction === 'delete'\n          ? input.removeConfirmed(ref)\n          : Promise.resolve<OperationResult<unknown>>({\n              ok: false,\n              error: {\n                code: 'unknown',\n                message: `Bulk ${bulkAction} is not supported in this view.`,\n              },\n            }),\n    },\n    input.collectionId,\n    ids,\n    action,\n    setField,\n  )\n}\n\n/** The fields shared by {@link RailAdapter} and the pure assembly input —\n *  everything the factory copies straight onto the assembled source, or\n *  defaults when a rail omits it. */\ninterface RailViewSourceCore {\n  readonly projectId: string\n  readonly schema: CollectionDef\n  readonly capabilities: CollectionViewCapabilities\n  readonly localeConfig: LocaleConfig\n  documents(): CmsDocument[]\n  get(ref: DocumentRef): CmsDocument | undefined\n  titleOf(ref: DocumentRef): string\n  /** Default `() => []` — none of the three rails carry cross-collection relation fields (v1). */\n  referenceCandidates?(collectionId: string): CmsDocument[]\n  /** Default `[schema]` — the rail's own schema is the only collection in scope. */\n  collections?: readonly CollectionDef[]\n  detailPath?(id: string): string\n  listPath?: string\n  /** Default `field => field.form?.readOnly ?? false`. */\n  isFieldReadOnly?(field: FieldDef): boolean\n  /** Principal-based tri-state — only the users rail supplies one. */\n  fieldAccess?(field: FieldDef, record?: CmsDocument): FieldAccess\n  /**\n   * How this rail's records are addressed in the reference index (EC-433) —\n   * only the assets rail supplies one (`{ type: 'asset' }`); absent ⇒ the\n   * confirm dialog's default document-shaped lookup.\n   */\n  referenceTarget?(ref: DocumentRef): ReferenceTarget\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  create(): DocumentRef\n}\n\n/** A rail's input to {@link useRailViewSource}: its store-facing reads/writes,\n *  capability profile, and lens projections. `TSaveResult`/`TRemoveResult` are\n *  each rail's own store-result shape — reconciled to `lastError` by the\n *  rail's own `normalizeSaveResult`/`normalizeRemoveResult`. */\nexport interface RailAdapter<TSaveResult, TRemoveResult> extends RailViewSourceCore {\n  save(doc: CmsDocument): Promise<TSaveResult>\n  remove(ref: DocumentRef): Promise<TRemoveResult>\n  /**\n   * The delete the BULK path dispatches (EC-433) — always post-confirmation\n   * (the EC-173 reference dialog ran first). Defaults to {@link remove}; the\n   * assets rail overrides it to pass `confirmInUse: true` so a confirmed bulk\n   * delete of a referenced asset actually deletes (mirroring the detail\n   * surface's confirmed delete) instead of re-blocking on the usage gate.\n   */\n  bulkRemove?(ref: DocumentRef): Promise<TRemoveResult>\n  normalizeSaveResult(result: TSaveResult): OperationError | null\n  normalizeRemoveResult(result: TRemoveResult): OperationError | null\n}\n\n/** The already-resolved state + error-wrapped writes {@link useRailViewSource}\n *  hands to the pure assembly function below. */\ninterface RailViewSourceAssemblyInput extends RailViewSourceCore {\n  lastError: OperationError | null\n  clearLastError(): void\n  viewState: TableViewState\n  setViewState: CollectionViewSource['setViewState']\n  save(doc: CmsDocument): void\n  remove(ref: DocumentRef): void\n  /**\n   * The rail bulk runner (EC-433). Assembled onto the source ONLY when\n   * `capabilities.bulk` is set — the `CollectionViewSource` contract is\n   * \"method present iff the flag is\" — so a bulk-less rail's list never\n   * half-offers the affordance.\n   */\n  bulk?: CollectionViewSource['bulk']\n}\n\n/**\n * Pure assembly of a {@link CollectionViewSource} from a rail's resolved\n * fields + state. Exported (and taking plain data/functions, no hook) so it is\n * directly unit-testable — this workspace runs vitest in `environment: 'node'`\n * (no `renderHook`); {@link useRailViewSource} is a thin `useState`/`useMemo`\n * wrapper around it.\n */\nexport function assembleRailViewSource(input: RailViewSourceAssemblyInput): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    referenceTarget,\n    validate,\n    create,\n    lastError,\n    clearLastError,\n    viewState,\n    setViewState,\n    save,\n    remove,\n    bulk,\n  } = input\n  return {\n    collectionId: schema.id,\n    schema,\n    capabilities,\n    projectId,\n    localeConfig,\n    activeLocale: localeConfig.default,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates: referenceCandidates ?? (() => []),\n    collections: collections ?? [schema],\n    ...(detailPath ? { detailPath } : {}),\n    ...(listPath !== undefined ? { listPath } : {}),\n    isFieldReadOnly: isFieldReadOnly ?? ((field: FieldDef) => field.form?.readOnly ?? false),\n    ...(fieldAccess ? { fieldAccess } : {}),\n    ...(referenceTarget ? { referenceTarget } : {}),\n    validate,\n    lastError,\n    clearLastError,\n    viewState: () => viewState,\n    setViewState,\n    create,\n    // EC-595 A2: a rail record is written whole, on the editor's explicit Save.\n    writes: { kind: 'record', save },\n    remove,\n    // Present iff the capability flag is set (the CollectionViewSource contract).\n    ...(capabilities.bulk && bulk ? { bulk } : {}),\n  }\n}\n\n/**\n * The shared scaffold factory (EC-327) behind the assets/users/redirects rail\n * `CollectionViewSource` hooks: `viewState`/`lastError` state, the\n * `setViewState` updater-fn wrapper, the error-mapped save/remove wiring (via\n * the rail's own result normalizer), and the final assembled source. See the\n * module doc for what stays a per-rail parameter rather than being absorbed\n * here.\n */\nexport function useRailViewSource<TSaveResult, TRemoveResult>(\n  adapter: RailAdapter<TSaveResult, TRemoveResult>,\n): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    referenceTarget,\n    validate,\n    create,\n    save: rawSave,\n    remove: rawRemove,\n    bulkRemove,\n    normalizeSaveResult,\n    normalizeRemoveResult,\n  } = adapter\n\n  const [viewState, setViewStateRaw] = useState<TableViewState>(() => defaultViewState(schema))\n  const [lastError, setLastError] = useState<OperationError | null>(null)\n\n  const setViewState = useCallback<CollectionViewSource['setViewState']>((update) => {\n    setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update))\n  }, [])\n  const clearLastError = useCallback(() => setLastError(null), [])\n\n  const save = useCallback(createErrorMappedWriter(rawSave, normalizeSaveResult, setLastError), [\n    rawSave,\n    normalizeSaveResult,\n  ])\n  const remove = useCallback(\n    createErrorMappedWriter(rawRemove, normalizeRemoveResult, setLastError),\n    [rawRemove, normalizeRemoveResult],\n  )\n\n  // The rail bulk runner (EC-433): the shared `runBulkAction` machinery over\n  // the rail's own confirmed delete, its store result reconciled into an\n  // operation-shaped outcome (a failing remove is a visible per-item failure).\n  // Assembled onto the source only when `capabilities.bulk` is set (below).\n  const bulk = useCallback(\n    (ids: readonly string[], action: BulkAction, setField?: BulkSetField): Promise<BulkReport> =>\n      runRailBulkAction(\n        {\n          collectionId: schema.id,\n          documents: documents(),\n          titleOf,\n          validate,\n          removeConfirmed: async (ref) => {\n            const result = await (bulkRemove ?? rawRemove)(ref)\n            const error = normalizeRemoveResult(result)\n            return error ? { ok: false, error } : { ok: true, value: undefined }\n          },\n        },\n        ids,\n        action,\n        setField,\n      ),\n    [schema.id, documents, titleOf, validate, bulkRemove, rawRemove, normalizeRemoveResult],\n  )\n\n  return useMemo(\n    () =>\n      assembleRailViewSource({\n        projectId,\n        schema,\n        capabilities,\n        localeConfig,\n        documents,\n        get,\n        titleOf,\n        referenceCandidates,\n        collections,\n        detailPath,\n        listPath,\n        isFieldReadOnly,\n        fieldAccess,\n        referenceTarget,\n        validate,\n        create,\n        lastError,\n        clearLastError,\n        viewState,\n        setViewState,\n        save,\n        remove,\n        bulk,\n      }),\n    [\n      projectId,\n      schema,\n      capabilities,\n      localeConfig,\n      documents,\n      get,\n      titleOf,\n      referenceCandidates,\n      collections,\n      detailPath,\n      listPath,\n      isFieldReadOnly,\n      fieldAccess,\n      referenceTarget,\n      validate,\n      create,\n      lastError,\n      clearLastError,\n      viewState,\n      setViewState,\n      save,\n      remove,\n      bulk,\n    ],\n  )\n}\n"]}
+{"version":3,"file":"rail-view-source.js","sourceRoot":"","sources":["../../src/components/rail-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  DocumentRef,\n  FieldDef,\n  LocaleConfig,\n} from '@elytracms/core/cms-core'\nimport type { OperationError, OperationResult } from '@elytracms/core/operations'\nimport type { ReferenceTarget } from '@elytracms/core/persistence'\nimport { defaultViewState } from '../lib/cms-views'\nimport type { TableViewState } from '../lib/cms-views'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n  FieldAccess,\n} from '../lib/collection-view/collection-view-source'\nimport { runBulkAction } from './cms/bulk-actions'\nimport type { BulkAction, BulkReport, BulkSetField } from './cms/bulk-actions'\n\n/**\n * The shared scaffold behind the primitive-rail `CollectionViewSource` hooks\n * (EC-327) — assets, users, redirects. All three hand-rolled identical\n * `viewState`/`lastError` state, an identical `setViewState` updater-fn\n * wrapper, an identical `if (!result.ok) setLastError(...)` error-mapping\n * shape (assets' `remove` diverges — see {@link OkResult} below), and a large\n * final `useMemo` assembling the same ~20-field {@link CollectionViewSource}.\n * The 4th rail (`useCmsCollectionViewSource`) does NOT reduplicate this — it\n * delegates to the ambient `CmsStore` — so this scaffold is scoped to the\n * three self-contained rails, not a fully generic replacement for the CMS\n * adapter.\n *\n * Genuinely divergent per-rail behaviour is a PARAMETER, never hidden here:\n * users' principal-based `fieldAccess`, users' no-op vs. redirects/assets'\n * registry-driven `validate`, redirects-only `create`, and — the one save/\n * remove result-shape mismatch — assets' `remove()` returns an\n * `outcome`-discriminated result where users/redirects use `{ ok }`; each rail\n * supplies its own `normalizeSaveResult`/`normalizeRemoveResult` to reconcile\n * whichever shape its store returns into `lastError`.\n */\n\n/** The common `{ ok: true; … } | { ok: false; message }` store-result shape —\n *  users' and redirects' save/remove, and assets' `updateMetadata` (save). */\nexport type OkResult = { ok: true } | { ok: false; message: string }\n\n/** The default normalizer for an {@link OkResult}: a failure maps to a\n *  surfaced {@link OperationError}; a success maps to no error at all. */\nexport function normalizeOkResult(result: OkResult): OperationError | null {\n  return result.ok ? null : { code: 'unknown', message: result.message }\n}\n\n/**\n * Project a lens document's values into a meta bag (EC-311/EC-240/EC-303):\n * every entry whose key is NOT one of the rail's canonical/identity field\n * names round-trips through the record's open `meta` bag. Shared by the users\n * (`IDENTITY_FIELDS`) and redirects (`CANONICAL_REDIRECT_FIELDS`) rails — the\n * assets rail's projection is schema-FIELDS-driven inclusion (iterating the\n * schema's declared fields, not the document's value keys), a genuinely\n * different shape that stays bespoke in `assets-collection-view-source.ts`.\n */\nexport function metaBagProjection(\n  values: Record<string, unknown>,\n  canonicalNames: ReadonlySet<string>,\n): Record<string, unknown> {\n  const meta: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(values)) {\n    if (!canonicalNames.has(key)) meta[key] = value\n  }\n  return meta\n}\n\n/** Wrap a raw store write (save/remove) so a normalized failure surfaces via\n *  `setError` — the factory's error-mapping plumbing, pulled out as a plain\n *  function (no hook) so it is unit-testable without a `renderHook` harness. */\nexport function createErrorMappedWriter<TArg, TResult, TExtra = never>(\n  write: (arg: TArg, extra?: TExtra) => Promise<TResult>,\n  normalize: (result: TResult) => OperationError | null,\n  setError: (error: OperationError) => void,\n): (arg: TArg, extra?: TExtra) => void {\n  // `extra` (EC-616): a record save's base, forwarded untouched.\n  return (arg: TArg, extra?: TExtra) => {\n    void write(arg, extra).then((result) => {\n      const error = normalize(result)\n      if (error) setError(error)\n    })\n  }\n}\n\n/** The store-facing input of {@link runRailBulkAction} — plain data/functions,\n *  so the rail bulk path is unit-testable without a hook harness. */\nexport interface RailBulkInput {\n  collectionId: string\n  /** Current rail rows (lens documents) — the runner's lookup + validation input. */\n  documents: readonly CmsDocument[]\n  titleOf(ref: DocumentRef): string\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  /**\n   * Dispatch ONE already-confirmed delete (the EC-173 reference dialog ran\n   * before anything reaches this) and reconcile the rail store's result shape\n   * into an operation-shaped outcome — a failure here is a visible per-item\n   * failure in the report, never a swallowed one.\n   */\n  removeConfirmed(ref: DocumentRef): Promise<OperationResult<unknown>>\n}\n\n/**\n * The primitive rails' bulk runner (EC-433): the SAME `runBulkAction` machinery\n * the CMS rail uses ([[client-data-flow-one-cache]] — no parallel data flow),\n * wired to the rail's own store delete. Only `delete` is dispatchable — the\n * rails have no publish lifecycle and no bulk set-field — and an unsupported\n * action fails each item HONESTLY in the report rather than silently no-oping\n * (the exact bug this replaces: the assets rail's bulk delete confirmed into a\n * missing `source.bulk` and dropped the whole action on the floor).\n */\nexport function runRailBulkAction(\n  input: RailBulkInput,\n  ids: readonly string[],\n  action: BulkAction,\n  setField?: BulkSetField,\n): Promise<BulkReport> {\n  return runBulkAction(\n    {\n      documents: input.documents,\n      titleOf: input.titleOf,\n      validate: input.validate,\n      // A rail store patches its own cache/state inside a succeeded remove\n      // (assets/users/redirects all do), and publish/unpublish/set-field never\n      // succeed here (dispatch rejects them), so the session-apply hooks have\n      // nothing left to apply.\n      applyState: () => undefined,\n      applyDelete: () => undefined,\n      dispatch: (bulkAction, ref) =>\n        bulkAction === 'delete'\n          ? input.removeConfirmed(ref)\n          : Promise.resolve<OperationResult<unknown>>({\n              ok: false,\n              error: {\n                code: 'unknown',\n                message: `Bulk ${bulkAction} is not supported in this view.`,\n              },\n            }),\n    },\n    input.collectionId,\n    ids,\n    action,\n    setField,\n  )\n}\n\n/** The fields shared by {@link RailAdapter} and the pure assembly input —\n *  everything the factory copies straight onto the assembled source, or\n *  defaults when a rail omits it. */\ninterface RailViewSourceCore {\n  readonly projectId: string\n  readonly schema: CollectionDef\n  readonly capabilities: CollectionViewCapabilities\n  readonly localeConfig: LocaleConfig\n  documents(): CmsDocument[]\n  get(ref: DocumentRef): CmsDocument | undefined\n  titleOf(ref: DocumentRef): string\n  /** Default `() => []` — none of the three rails carry cross-collection relation fields (v1). */\n  referenceCandidates?(collectionId: string): CmsDocument[]\n  /** Default `[schema]` — the rail's own schema is the only collection in scope. */\n  collections?: readonly CollectionDef[]\n  detailPath?(id: string): string\n  listPath?: string\n  /** Default `field => field.form?.readOnly ?? false`. */\n  isFieldReadOnly?(field: FieldDef): boolean\n  /** Principal-based tri-state — only the users rail supplies one. */\n  fieldAccess?(field: FieldDef, record?: CmsDocument): FieldAccess\n  /**\n   * How this rail's records are addressed in the reference index (EC-433) —\n   * only the assets rail supplies one (`{ type: 'asset' }`); absent ⇒ the\n   * confirm dialog's default document-shaped lookup.\n   */\n  referenceTarget?(ref: DocumentRef): ReferenceTarget\n  validate(doc: CmsDocument): CmsValidationIssue[]\n  create(): DocumentRef\n}\n\n/** A rail's input to {@link useRailViewSource}: its store-facing reads/writes,\n *  capability profile, and lens projections. `TSaveResult`/`TRemoveResult` are\n *  each rail's own store-result shape — reconciled to `lastError` by the\n *  rail's own `normalizeSaveResult`/`normalizeRemoveResult`. */\nexport interface RailAdapter<TSaveResult, TRemoveResult> extends RailViewSourceCore {\n  /** `base`: the record as the editor opened it (EC-616 — see `RecordWrites.save`). */\n  save(doc: CmsDocument, base?: CmsDocument): Promise<TSaveResult>\n  remove(ref: DocumentRef): Promise<TRemoveResult>\n  /**\n   * The delete the BULK path dispatches (EC-433) — always post-confirmation\n   * (the EC-173 reference dialog ran first). Defaults to {@link remove}; the\n   * assets rail overrides it to pass `confirmInUse: true` so a confirmed bulk\n   * delete of a referenced asset actually deletes (mirroring the detail\n   * surface's confirmed delete) instead of re-blocking on the usage gate.\n   */\n  bulkRemove?(ref: DocumentRef): Promise<TRemoveResult>\n  normalizeSaveResult(result: TSaveResult): OperationError | null\n  normalizeRemoveResult(result: TRemoveResult): OperationError | null\n}\n\n/** The already-resolved state + error-wrapped writes {@link useRailViewSource}\n *  hands to the pure assembly function below. */\ninterface RailViewSourceAssemblyInput extends RailViewSourceCore {\n  lastError: OperationError | null\n  clearLastError(): void\n  viewState: TableViewState\n  setViewState: CollectionViewSource['setViewState']\n  save(doc: CmsDocument, base?: CmsDocument): void\n  remove(ref: DocumentRef): void\n  /**\n   * The rail bulk runner (EC-433). Assembled onto the source ONLY when\n   * `capabilities.bulk` is set — the `CollectionViewSource` contract is\n   * \"method present iff the flag is\" — so a bulk-less rail's list never\n   * half-offers the affordance.\n   */\n  bulk?: CollectionViewSource['bulk']\n}\n\n/**\n * Pure assembly of a {@link CollectionViewSource} from a rail's resolved\n * fields + state. Exported (and taking plain data/functions, no hook) so it is\n * directly unit-testable — this workspace runs vitest in `environment: 'node'`\n * (no `renderHook`); {@link useRailViewSource} is a thin `useState`/`useMemo`\n * wrapper around it.\n */\nexport function assembleRailViewSource(input: RailViewSourceAssemblyInput): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    referenceTarget,\n    validate,\n    create,\n    lastError,\n    clearLastError,\n    viewState,\n    setViewState,\n    save,\n    remove,\n    bulk,\n  } = input\n  return {\n    collectionId: schema.id,\n    schema,\n    capabilities,\n    projectId,\n    localeConfig,\n    activeLocale: localeConfig.default,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates: referenceCandidates ?? (() => []),\n    collections: collections ?? [schema],\n    ...(detailPath ? { detailPath } : {}),\n    ...(listPath !== undefined ? { listPath } : {}),\n    isFieldReadOnly: isFieldReadOnly ?? ((field: FieldDef) => field.form?.readOnly ?? false),\n    ...(fieldAccess ? { fieldAccess } : {}),\n    ...(referenceTarget ? { referenceTarget } : {}),\n    validate,\n    lastError,\n    clearLastError,\n    viewState: () => viewState,\n    setViewState,\n    create,\n    // EC-595 A2: a rail record is written whole, on the editor's explicit Save.\n    writes: { kind: 'record', save },\n    remove,\n    // Present iff the capability flag is set (the CollectionViewSource contract).\n    ...(capabilities.bulk && bulk ? { bulk } : {}),\n  }\n}\n\n/**\n * The shared scaffold factory (EC-327) behind the assets/users/redirects rail\n * `CollectionViewSource` hooks: `viewState`/`lastError` state, the\n * `setViewState` updater-fn wrapper, the error-mapped save/remove wiring (via\n * the rail's own result normalizer), and the final assembled source. See the\n * module doc for what stays a per-rail parameter rather than being absorbed\n * here.\n */\nexport function useRailViewSource<TSaveResult, TRemoveResult>(\n  adapter: RailAdapter<TSaveResult, TRemoveResult>,\n): CollectionViewSource {\n  const {\n    projectId,\n    schema,\n    capabilities,\n    localeConfig,\n    documents,\n    get,\n    titleOf,\n    referenceCandidates,\n    collections,\n    detailPath,\n    listPath,\n    isFieldReadOnly,\n    fieldAccess,\n    referenceTarget,\n    validate,\n    create,\n    save: rawSave,\n    remove: rawRemove,\n    bulkRemove,\n    normalizeSaveResult,\n    normalizeRemoveResult,\n  } = adapter\n\n  const [viewState, setViewStateRaw] = useState<TableViewState>(() => defaultViewState(schema))\n  const [lastError, setLastError] = useState<OperationError | null>(null)\n\n  const setViewState = useCallback<CollectionViewSource['setViewState']>((update) => {\n    setViewStateRaw((prev) => (typeof update === 'function' ? update(prev) : update))\n  }, [])\n  const clearLastError = useCallback(() => setLastError(null), [])\n\n  const save = useCallback(createErrorMappedWriter(rawSave, normalizeSaveResult, setLastError), [\n    rawSave,\n    normalizeSaveResult,\n  ])\n  const remove = useCallback(\n    createErrorMappedWriter(rawRemove, normalizeRemoveResult, setLastError),\n    [rawRemove, normalizeRemoveResult],\n  )\n\n  // The rail bulk runner (EC-433): the shared `runBulkAction` machinery over\n  // the rail's own confirmed delete, its store result reconciled into an\n  // operation-shaped outcome (a failing remove is a visible per-item failure).\n  // Assembled onto the source only when `capabilities.bulk` is set (below).\n  const bulk = useCallback(\n    (ids: readonly string[], action: BulkAction, setField?: BulkSetField): Promise<BulkReport> =>\n      runRailBulkAction(\n        {\n          collectionId: schema.id,\n          documents: documents(),\n          titleOf,\n          validate,\n          removeConfirmed: async (ref) => {\n            const result = await (bulkRemove ?? rawRemove)(ref)\n            const error = normalizeRemoveResult(result)\n            return error ? { ok: false, error } : { ok: true, value: undefined }\n          },\n        },\n        ids,\n        action,\n        setField,\n      ),\n    [schema.id, documents, titleOf, validate, bulkRemove, rawRemove, normalizeRemoveResult],\n  )\n\n  return useMemo(\n    () =>\n      assembleRailViewSource({\n        projectId,\n        schema,\n        capabilities,\n        localeConfig,\n        documents,\n        get,\n        titleOf,\n        referenceCandidates,\n        collections,\n        detailPath,\n        listPath,\n        isFieldReadOnly,\n        fieldAccess,\n        referenceTarget,\n        validate,\n        create,\n        lastError,\n        clearLastError,\n        viewState,\n        setViewState,\n        save,\n        remove,\n        bulk,\n      }),\n    [\n      projectId,\n      schema,\n      capabilities,\n      localeConfig,\n      documents,\n      get,\n      titleOf,\n      referenceCandidates,\n      collections,\n      detailPath,\n      listPath,\n      isFieldReadOnly,\n      fieldAccess,\n      referenceTarget,\n      validate,\n      create,\n      lastError,\n      clearLastError,\n      viewState,\n      setViewState,\n      save,\n      remove,\n      bulk,\n    ],\n  )\n}\n"]}

package/dist/components/records/record-lens.d.ts

@@ -0,0 +1,51 @@
+import type { CmsDocument, CollectionDef } from '@elytracms/core/cms-core';
+import type { AnyRecordKind, RecordEntryOf, RecordWriteOf } from '@elytracms/core/persistence';
+/**
+ * EC-616 — the projections between a record kind and the portable list/edit surfaces
+ * (AD-19): a record rail edits a record as a LENS document (`{ collection, id, values }`)
+ * over a `CollectionDef`. Pure — no React — so the mapping that decides what a save
+ * writes is unit-testable on its own (it is the one place the write is derived from the
+ * edited lens; a slip here silently corrupts a record).
+ *
+ * - **Read** ({@link recordToLensDocument}): the stored `meta` bag spread FIRST, then
+ *   the kind's columns — a canonical column always wins over a same-named meta key
+ *   (RESIDUE-3c: spread last, a stored `meta.to` displayed as the redirect's target and a
+ *   re-save wrote it into the canonical `to`).
+ * - **Write** ({@link lensDocumentToRecordWrite}): every lens value keyed by a column is
+ *   that column; every other key round-trips through the open `meta` bag (EC-311 Tier 2
+ *   — a mount's additive field). A column the document does not carry is left out, so the
+ *   stored value is kept (EC-577: a create default applies once, in the adapter's
+ *   transaction — never restated here). A REQUIRED text column is always sent (`''` when
+ *   blank): the editor owns it, and an empty one is refused visibly by the write's
+ *   validation rather than kept silently. `meta` is omitted when no additive value exists,
+ *   so a rail with no additive fields never touches the bag.
+ */
+/** The kind's columns (its declared fields; `meta` is the bag, not a column). */
+export declare function recordColumnNames(kind: AnyRecordKind): ReadonlySet<string>;
+/** A stored record as the lens document the portable surfaces edit. */
+export declare function recordToLensDocument<K extends AnyRecordKind>(kind: K, entry: RecordEntryOf<K>): CmsDocument;
+/**
+ * An edited lens document as the record write (see the module header).
+ *
+ * **With `base`** — the lens document of the record as the editor OPENED it — the write
+ * carries only what the editor changed (EC-616, the multi-session baseline): a column whose
+ * value differs from the base, and the changed `meta` keys as a per-key `metaPatch` (a key the
+ * editor removed is `null`). Every other column is ABSENT, so the EC-577 rule keeps the stored
+ * value — a column another writer changed after the editor opened the record survives the
+ * editor's save. With nothing changed the write is just the id (a no-op edit).
+ *
+ * **Without `base`** (a record the editor is creating) the write is whole, as it always was.
+ */
+export declare function lensDocumentToRecordWrite<K extends AnyRecordKind>(kind: K, doc: CmsDocument, base?: CmsDocument): RecordWriteOf<K>;
+/**
+ * The DEFAULT lens of a kind: one field per column whose type the portable form edits
+ * (text, boolean, number, select — derived from the column's zod type), labelled from its
+ * name. A column of another shape (an object, a list) is not in the lens: the rail never
+ * writes it, so the stored value is kept on every save (EC-577). A mount refines the lens
+ * by name through `nav.rail(kind, { fields })` (EC-311 — the same override mechanism the
+ * built-in rails use), or passes its own `schema`.
+ */
+export declare function recordLensDef(kind: AnyRecordKind, options?: {
+    label?: string;
+    titleField?: string;
+}): CollectionDef;

package/dist/components/records/record-lens.js

@@ -0,0 +1,156 @@
+import { collectionDefSchema, semanticValueEqual } from '@elytracms/core/cms-core';
+import { metaBagProjection } from '../rail-view-source.js';
+/**
+ * EC-616 — the projections between a record kind and the portable list/edit surfaces
+ * (AD-19): a record rail edits a record as a LENS document (`{ collection, id, values }`)
+ * over a `CollectionDef`. Pure — no React — so the mapping that decides what a save
+ * writes is unit-testable on its own (it is the one place the write is derived from the
+ * edited lens; a slip here silently corrupts a record).
+ *
+ * - **Read** ({@link recordToLensDocument}): the stored `meta` bag spread FIRST, then
+ *   the kind's columns — a canonical column always wins over a same-named meta key
+ *   (RESIDUE-3c: spread last, a stored `meta.to` displayed as the redirect's target and a
+ *   re-save wrote it into the canonical `to`).
+ * - **Write** ({@link lensDocumentToRecordWrite}): every lens value keyed by a column is
+ *   that column; every other key round-trips through the open `meta` bag (EC-311 Tier 2
+ *   — a mount's additive field). A column the document does not carry is left out, so the
+ *   stored value is kept (EC-577: a create default applies once, in the adapter's
+ *   transaction — never restated here). A REQUIRED text column is always sent (`''` when
+ *   blank): the editor owns it, and an empty one is refused visibly by the write's
+ *   validation rather than kept silently. `meta` is omitted when no additive value exists,
+ *   so a rail with no additive fields never touches the bag.
+ */
+/** The kind's columns (its declared fields; `meta` is the bag, not a column). */
+export function recordColumnNames(kind) {
+    return new Set(Object.keys(kind.fields));
+}
+/** A stored record as the lens document the portable surfaces edit. */
+export function recordToLensDocument(kind, entry) {
+    const record = entry;
+    const columns = {};
+    for (const column of recordColumnNames(kind)) {
+        if (record[column] !== undefined)
+            columns[column] = record[column];
+    }
+    return {
+        collection: kind.kind,
+        id: String(record.id),
+        values: { ...(record.meta ?? {}), ...columns },
+    };
+}
+function defOf(field) {
+    return field._zod.def;
+}
+/** Is this column a required text column (no default, not optional)? */
+function isRequiredText(field) {
+    return defOf(field).type === 'string';
+}
+/** The column's own definition, below any optional/default/nullable wrapper. */
+function unwrapped(field) {
+    let def = defOf(field);
+    while ((def.type === 'optional' || def.type === 'default' || def.type === 'nullable') && def.innerType) {
+        def = def.innerType._zod.def;
+    }
+    return def;
+}
+/** A lens value as the write sends it for one column (a required text column is always a string). */
+function columnWriteValue(field, value) {
+    return isRequiredText(field) ? (typeof value === 'string' ? value : '') : value;
+}
+/**
+ * An edited lens document as the record write (see the module header).
+ *
+ * **With `base`** — the lens document of the record as the editor OPENED it — the write
+ * carries only what the editor changed (EC-616, the multi-session baseline): a column whose
+ * value differs from the base, and the changed `meta` keys as a per-key `metaPatch` (a key the
+ * editor removed is `null`). Every other column is ABSENT, so the EC-577 rule keeps the stored
+ * value — a column another writer changed after the editor opened the record survives the
+ * editor's save. With nothing changed the write is just the id (a no-op edit).
+ *
+ * **Without `base`** (a record the editor is creating) the write is whole, as it always was.
+ */
+export function lensDocumentToRecordWrite(kind, doc, base) {
+    const values = doc.values ?? {};
+    const write = { id: doc.id };
+    const columns = recordColumnNames(kind);
+    if (!base) {
+        for (const [column, field] of Object.entries(kind.fields)) {
+            const value = columnWriteValue(field, values[column]);
+            if (value !== undefined)
+                write[column] = value;
+        }
+        const meta = metaBagProjection(values, columns);
+        if (Object.keys(meta).length > 0)
+            write.meta = meta;
+        return write;
+    }
+    const before = base.values ?? {};
+    for (const [column, field] of Object.entries(kind.fields)) {
+        const value = values[column];
+        if (semanticValueEqual(value, before[column]))
+            continue;
+        // A cleared optional column is `null` on the wire (EC-577: clear), never a silent absence.
+        write[column] = value === undefined ? (isRequiredText(field) ? '' : null) : columnWriteValue(field, value);
+    }
+    const meta = metaBagProjection(values, columns);
+    const baseMeta = metaBagProjection(before, columns);
+    const metaPatch = {};
+    for (const key of new Set([...Object.keys(meta), ...Object.keys(baseMeta)])) {
+        if (semanticValueEqual(meta[key], baseMeta[key]))
+            continue;
+        metaPatch[key] = meta[key] === undefined ? null : meta[key];
+    }
+    if (Object.keys(metaPatch).length > 0)
+        write.metaPatch = metaPatch;
+    return write;
+}
+/** The lens field type a column edits as (unwrapping optional/default); `undefined` = not lens-editable. */
+function lensFieldType(field) {
+    switch (unwrapped(field).type) {
+        case 'string':
+            return 'text';
+        case 'boolean':
+            return 'boolean';
+        case 'number':
+            return 'number';
+        case 'enum':
+            return 'select';
+        default:
+            return undefined;
+    }
+}
+function humanize(name) {
+    const spaced = name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ');
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+ * The DEFAULT lens of a kind: one field per column whose type the portable form edits
+ * (text, boolean, number, select — derived from the column's zod type), labelled from its
+ * name. A column of another shape (an object, a list) is not in the lens: the rail never
+ * writes it, so the stored value is kept on every save (EC-577). A mount refines the lens
+ * by name through `nav.rail(kind, { fields })` (EC-311 — the same override mechanism the
+ * built-in rails use), or passes its own `schema`.
+ */
+export function recordLensDef(kind, options = {}) {
+    const fields = [];
+    for (const [name, field] of Object.entries(kind.fields)) {
+        const type = lensFieldType(field);
+        if (!type)
+            continue;
+        const entry = { name, type, form: { label: humanize(name) } };
+        if (type === 'select') {
+            entry.options = Object.values(unwrapped(field).entries ?? {}).map((value) => ({ value: String(value), label: String(value) }));
+        }
+        fields.push(entry);
+    }
+    const titleField = options.titleField ?? fields.find((field) => field.type === 'text')?.name;
+    return collectionDefSchema.parse({
+        id: kind.kind,
+        // A record kind is not a CMS `kind`; 'document' just satisfies the lens schema.
+        kind: 'document',
+        ...(titleField ? { titleField } : {}),
+        form: { label: options.label ?? humanize(kind.module) },
+        fields,
+    });
+}
+//# sourceMappingURL=record-lens.js.map

package/dist/components/records/record-lens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-lens.js","sourceRoot":"","sources":["../../../src/components/records/record-lens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAGlF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAA0B,IAAO,EAAE,KAAuB;IAC5F,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,KAAK,MAAM,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IACpE,CAAC;IACD,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,IAAI;QACrB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,EAAE,EAAE,GAAG,CAAE,MAAM,CAAC,IAA4C,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE;KACxF,CAAA;AACH,CAAC;AAYD,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAQ,KAAuC,CAAC,IAAI,CAAC,GAAG,CAAA;AAC1D,CAAC;AAED,wEAAwE;AACxE,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAA;AACvC,CAAC;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACtB,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACvG,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAA;IAC9B,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,qGAAqG;AACrG,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAc;IACtD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AACjF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAO,EACP,GAAgB,EAChB,IAAkB;IAElB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAA;IAC/B,MAAM,KAAK,GAA4B,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAA;IACrD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;YACrD,IAAI,KAAK,KAAK,SAAS;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;QAChD,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;QACnD,OAAO,KAAyB,CAAA;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAAE,SAAQ;QACvD,2FAA2F;QAC3F,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC5G,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnD,MAAM,SAAS,GAA4B,EAAE,CAAA;IAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,SAAQ;QAC1D,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;IAClE,OAAO,KAAyB,CAAA;AAClC,CAAC;AAED,4GAA4G;AAC5G,SAAS,aAAa,CAAC,KAAc;IACnC,QAAQ,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,MAAM,CAAA;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAA;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAA;QACjB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAA;QACjB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACjF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,UAAmD,EAAE;IACtG,MAAM,MAAM,GAA8B,EAAE,CAAA;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QACtF,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;QAChI,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,IAAI,CAAA;IAC5F,OAAO,mBAAmB,CAAC,KAAK,CAAC;QAC/B,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,gFAAgF;QAChF,IAAI,EAAE,UAAU;QAChB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QACvD,MAAM;KACP,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { collectionDefSchema, semanticValueEqual } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport type { AnyRecordKind, RecordEntryOf, RecordWriteOf } from '@elytracms/core/persistence'\nimport { metaBagProjection } from '../rail-view-source'\n\n/**\n * EC-616 — the projections between a record kind and the portable list/edit surfaces\n * (AD-19): a record rail edits a record as a LENS document (`{ collection, id, values }`)\n * over a `CollectionDef`. Pure — no React — so the mapping that decides what a save\n * writes is unit-testable on its own (it is the one place the write is derived from the\n * edited lens; a slip here silently corrupts a record).\n *\n * - **Read** ({@link recordToLensDocument}): the stored `meta` bag spread FIRST, then\n *   the kind's columns — a canonical column always wins over a same-named meta key\n *   (RESIDUE-3c: spread last, a stored `meta.to` displayed as the redirect's target and a\n *   re-save wrote it into the canonical `to`).\n * - **Write** ({@link lensDocumentToRecordWrite}): every lens value keyed by a column is\n *   that column; every other key round-trips through the open `meta` bag (EC-311 Tier 2\n *   — a mount's additive field). A column the document does not carry is left out, so the\n *   stored value is kept (EC-577: a create default applies once, in the adapter's\n *   transaction — never restated here). A REQUIRED text column is always sent (`''` when\n *   blank): the editor owns it, and an empty one is refused visibly by the write's\n *   validation rather than kept silently. `meta` is omitted when no additive value exists,\n *   so a rail with no additive fields never touches the bag.\n */\n\n/** The kind's columns (its declared fields; `meta` is the bag, not a column). */\nexport function recordColumnNames(kind: AnyRecordKind): ReadonlySet<string> {\n  return new Set(Object.keys(kind.fields))\n}\n\n/** A stored record as the lens document the portable surfaces edit. */\nexport function recordToLensDocument<K extends AnyRecordKind>(kind: K, entry: RecordEntryOf<K>): CmsDocument {\n  const record = entry as Record<string, unknown>\n  const columns: Record<string, unknown> = {}\n  for (const column of recordColumnNames(kind)) {\n    if (record[column] !== undefined) columns[column] = record[column]\n  }\n  return {\n    collection: kind.kind,\n    id: String(record.id),\n    values: { ...((record.meta as Record<string, unknown> | undefined) ?? {}), ...columns },\n  }\n}\n\n/**\n * A column's zod definition, read through `_zod.def` rather than `instanceof`: a kind is\n * declared in whichever package owns it (an addon), whose `zod` may be a different copy\n * than this one — `instanceof` across copies is silently false.\n */\ninterface ZodDefView {\n  type: string\n  innerType?: { _zod: { def: ZodDefView } }\n  entries?: Record<string, unknown>\n}\nfunction defOf(field: unknown): ZodDefView {\n  return (field as { _zod: { def: ZodDefView } })._zod.def\n}\n\n/** Is this column a required text column (no default, not optional)? */\nfunction isRequiredText(field: unknown): boolean {\n  return defOf(field).type === 'string'\n}\n\n/** The column's own definition, below any optional/default/nullable wrapper. */\nfunction unwrapped(field: unknown): ZodDefView {\n  let def = defOf(field)\n  while ((def.type === 'optional' || def.type === 'default' || def.type === 'nullable') && def.innerType) {\n    def = def.innerType._zod.def\n  }\n  return def\n}\n\n/** A lens value as the write sends it for one column (a required text column is always a string). */\nfunction columnWriteValue(field: unknown, value: unknown): unknown {\n  return isRequiredText(field) ? (typeof value === 'string' ? value : '') : value\n}\n\n/**\n * An edited lens document as the record write (see the module header).\n *\n * **With `base`** — the lens document of the record as the editor OPENED it — the write\n * carries only what the editor changed (EC-616, the multi-session baseline): a column whose\n * value differs from the base, and the changed `meta` keys as a per-key `metaPatch` (a key the\n * editor removed is `null`). Every other column is ABSENT, so the EC-577 rule keeps the stored\n * value — a column another writer changed after the editor opened the record survives the\n * editor's save. With nothing changed the write is just the id (a no-op edit).\n *\n * **Without `base`** (a record the editor is creating) the write is whole, as it always was.\n */\nexport function lensDocumentToRecordWrite<K extends AnyRecordKind>(\n  kind: K,\n  doc: CmsDocument,\n  base?: CmsDocument,\n): RecordWriteOf<K> {\n  const values = doc.values ?? {}\n  const write: Record<string, unknown> = { id: doc.id }\n  const columns = recordColumnNames(kind)\n  if (!base) {\n    for (const [column, field] of Object.entries(kind.fields)) {\n      const value = columnWriteValue(field, values[column])\n      if (value !== undefined) write[column] = value\n    }\n    const meta = metaBagProjection(values, columns)\n    if (Object.keys(meta).length > 0) write.meta = meta\n    return write as RecordWriteOf<K>\n  }\n  const before = base.values ?? {}\n  for (const [column, field] of Object.entries(kind.fields)) {\n    const value = values[column]\n    if (semanticValueEqual(value, before[column])) continue\n    // A cleared optional column is `null` on the wire (EC-577: clear), never a silent absence.\n    write[column] = value === undefined ? (isRequiredText(field) ? '' : null) : columnWriteValue(field, value)\n  }\n  const meta = metaBagProjection(values, columns)\n  const baseMeta = metaBagProjection(before, columns)\n  const metaPatch: Record<string, unknown> = {}\n  for (const key of new Set([...Object.keys(meta), ...Object.keys(baseMeta)])) {\n    if (semanticValueEqual(meta[key], baseMeta[key])) continue\n    metaPatch[key] = meta[key] === undefined ? null : meta[key]\n  }\n  if (Object.keys(metaPatch).length > 0) write.metaPatch = metaPatch\n  return write as RecordWriteOf<K>\n}\n\n/** The lens field type a column edits as (unwrapping optional/default); `undefined` = not lens-editable. */\nfunction lensFieldType(field: unknown): FieldDef['type'] | undefined {\n  switch (unwrapped(field).type) {\n    case 'string':\n      return 'text'\n    case 'boolean':\n      return 'boolean'\n    case 'number':\n      return 'number'\n    case 'enum':\n      return 'select'\n    default:\n      return undefined\n  }\n}\n\nfunction humanize(name: string): string {\n  const spaced = name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ')\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1)\n}\n\n/**\n * The DEFAULT lens of a kind: one field per column whose type the portable form edits\n * (text, boolean, number, select — derived from the column's zod type), labelled from its\n * name. A column of another shape (an object, a list) is not in the lens: the rail never\n * writes it, so the stored value is kept on every save (EC-577). A mount refines the lens\n * by name through `nav.rail(kind, { fields })` (EC-311 — the same override mechanism the\n * built-in rails use), or passes its own `schema`.\n */\nexport function recordLensDef(kind: AnyRecordKind, options: { label?: string; titleField?: string } = {}): CollectionDef {\n  const fields: Record<string, unknown>[] = []\n  for (const [name, field] of Object.entries(kind.fields)) {\n    const type = lensFieldType(field)\n    if (!type) continue\n    const entry: Record<string, unknown> = { name, type, form: { label: humanize(name) } }\n    if (type === 'select') {\n      entry.options = Object.values(unwrapped(field).entries ?? {}).map((value) => ({ value: String(value), label: String(value) }))\n    }\n    fields.push(entry)\n  }\n  const titleField = options.titleField ?? fields.find((field) => field.type === 'text')?.name\n  return collectionDefSchema.parse({\n    id: kind.kind,\n    // A record kind is not a CMS `kind`; 'document' just satisfies the lens schema.\n    kind: 'document',\n    ...(titleField ? { titleField } : {}),\n    form: { label: options.label ?? humanize(kind.module) },\n    fields,\n  })\n}\n"]}

package/dist/components/records/record-rail.d.ts

@@ -0,0 +1,86 @@
+import type { ReactNode } from 'react';
+import type { CollectionDef } from '@elytracms/core/cms-core';
+import type { AnyRecordKind, RecordEntryOf, RecordWriteOf } from '@elytracms/core/persistence';
+import type { CollectionViewCapabilities, CollectionViewSource } from '../../lib/collection-view/collection-view-source.js';
+/** The default capability profile of a record rail: create, edit, remove, bulk delete — content, not administration. */
+export declare const RECORD_RAIL_CAPABILITIES: CollectionViewCapabilities;
+/** The one query key of a kind's records in a project. */
+export declare function recordListKey(kind: AnyRecordKind, projectId: string): readonly [string, string, string];
+/**
+ * A kind's records in a project, read through the shared operations cache — the ONE query
+ * a rail and any reader outside it (the rail foot's URL-map validation reads redirects)
+ * share. One key, one cache entry: a save's `cache.patch` updates both at once.
+ */
+export declare function useRecordList<K extends AnyRecordKind>(kind: K, projectId: string): import("@tanstack/react-query").UseQueryResult<RecordEntryOf<K>[]>;
+export interface RecordRailStore<K extends AnyRecordKind = AnyRecordKind> {
+    kind: K;
+    projectId: string;
+    status: 'loading' | 'ready' | 'error';
+    errorMessage?: string;
+    /** The persisted records, in the kind's order. Unsaved drafts are excluded. */
+    records: readonly RecordEntryOf<K>[];
+    /** One record: a local unsaved draft if present, else a persisted record. */
+    get(id: string): RecordEntryOf<K> | undefined;
+    /** Mint a blank in-memory draft and return its id (the "New" navigation target). */
+    createDraft(): string;
+    /** Persist a create/modify; drops the matching draft on success. */
+    save(input: RecordWriteOf<K>): Promise<{
+        ok: true;
+        record: RecordEntryOf<K>;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Delete a persisted record, or silently discard an unsaved draft. */
+    remove(id: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+    /** Re-list from the backend. */
+    refresh(): Promise<void>;
+}
+/** The record rail store of the nearest {@link RecordRailProvider}. */
+export declare function useRecordRail<K extends AnyRecordKind>(): RecordRailStore<K>;
+export declare function RecordRailProvider<K extends AnyRecordKind>({ kind, projectId, children, }: {
+    kind: K;
+    projectId: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * The columns a blank "New" draft shows: each column's CREATE default (a new redirect
+ * reads enabled + permanent — the reason you create one is for it to work), and `''` for
+ * a required text column. The save then sends what the editor saw; the adapter still
+ * applies the defaults itself for a write that leaves them out (EC-577).
+ */
+export declare function recordDraftColumns(kind: AnyRecordKind): Record<string, unknown>;
+/** How a rail addresses its list and one record's detail (the view's own route segment). */
+export interface RecordRailPaths {
+    listPath: string;
+    detailPath(id: string): string;
+}
+/**
+ * The {@link CollectionViewSource} of a record rail (must be mounted under its
+ * {@link RecordRailProvider}). `schema` is the rail's lens — the kind's default lens or a
+ * mount-customized one (EC-311 overrides by name; additive fields persist in `meta`).
+ */
+export declare function useRecordCollectionViewSource<K extends AnyRecordKind>(kind: K, projectId: string, schema: CollectionDef, paths: RecordRailPaths, capabilities?: CollectionViewCapabilities): CollectionViewSource;
+export interface RecordRailModuleProps<K extends AnyRecordKind> {
+    kind: K;
+    projectId: string;
+    /** `null` → the list; an id → that record's detail. */
+    recordId: string | null;
+    schema: CollectionDef;
+    paths: RecordRailPaths;
+    capabilities?: CollectionViewCapabilities;
+    /** The rail's label, for its loading / failure states. */
+    label: string;
+    /** Optional copy for the loading / failure states (default: the generic catalog keys). */
+    messages?: {
+        loading?: () => string;
+        loadFailed?: () => string;
+    };
+}
+/** The surface of a record rail: the portable list, or one record's detail. */
+export declare function RecordRailModule<K extends AnyRecordKind>(props: RecordRailModuleProps<K>): import("react").JSX.Element;