@saacms/admin 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @saacms/admin
+
+**Status: placeholder (v0.1.0).** This package is intentionally empty.
+
+The full admin UI scaffold lands in a follow-up implementation pass. When it
+does, this package will become a Vite + React 19 application that ships as the
+single editor experience across every host adapter (per ADR 0017: "the admin UI
+is React + shadcn (Puck-driven), regardless of host").
+
+## Planned shape
+
+The follow-up will introduce, roughly in this order:
+
+- **Vite + React 19** project, bundled into the host's build output and mounted
+  at `/admin/[[...slug]]` (or each host's equivalent route).
+- **shadcn/ui** as the component primitive layer for the app shell, dialogs,
+  forms, and Performance / Cache-debug tabs.
+- **Puck** as the visual block-tree composer for Pages and templates
+  (per ADR 0004 dual-mode authoring).
+- **Monaco** as the lazily-loaded power-user fallback for raw Page-JSON,
+  Block-prop, and Collection-schema editing (per ADR 0022 §D5).
+- **Better Auth UI** wrapped for the sign-in / multi-provider OAuth flow
+  (per ADR 0022 §D4).
+- **Floating dev launcher** injected into the user's running site in dev mode
+  so the editor opens as an overlay over the current page rather than forcing a
+  navigation to `/admin` (per ADR 0022 §D2; adopted from Nuxt Studio).
+- **Iframe-free real-time preview** — the editor's preview pane is the
+  production render path itself, via ADR 0004's preview-fetch + DOM-teleport
+  (per ADR 0022 §D3).
+- **Editor UI internationalisation** wired from day one even though content
+  i18n is deferred per ADR 0016 (per ADR 0022 §D7).
+
+## What's here today
+
+Only `src/index.ts` with a marker constant and a `adminMountInfo()` function
+that reports `{ route: "/admin", status: "placeholder" }`. This exists so that
+the monorepo's project-references graph resolves and `tsc --build` stays
+typecheck-clean while we sequence the real UI work.
+
+No React, shadcn, Puck, Monaco, or Better Auth dependencies are pulled in yet
+— they land alongside the actual implementation.
+
+## Related ADRs
+
+- [ADR 0017 — Monorepo package layout](../../docs/adr/0017-monorepo-package-layout.md)
+- [ADR 0022 — Performance and DX philosophy](../../docs/adr/0022-performance-and-dx-philosophy.md)

package/dist/api-client.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Thin typed client over the saacms runtime HTTP API (the CRUD + OpenAPI
+ * routes built in prior rounds, mounted at `/api/saacms/v1`).
+ *
+ * Transport is injected (`fetchFn`, default global `fetch`) — same
+ * testability discipline as `cli/logs`: the whole client is unit-testable
+ * against canned `Response`s with no real network.
+ *
+ * Wire contracts mirrored here (all owned by `@saacms/core/runtime`):
+ *   - List → `{ data: [], _links: { next: { href } | null }, _meta }`
+ *   - Read/Update → `{ data, _links }` ; Create (201) → `{ data: { …, id } }`
+ *   - Errors → RFC 9457 `application/problem+json`: `{ type, title, status,
+ *     detail?, … }` where `type` is `https://saacms.dev/errors/<code>` and
+ *     `extensions` (e.g. `issues`) are merged flat at the top level.
+ */
+/** Error thrown for non-success runtime responses (carries Problem Details). */
+export declare class AdminApiError extends Error {
+    readonly status: number;
+    /** Last path segment of the Problem Details `type` URI (e.g. `forbidden`). */
+    readonly code: string;
+    /** Structured validation issues from a 422 Problem Details document. */
+    readonly issues?: unknown;
+    constructor(message: string, init: {
+        status: number;
+        code: string;
+        issues?: unknown;
+    });
+}
+export interface AdminApiClientOptions {
+    /** API base path. Default `/api/saacms/v1`. */
+    readonly basePath?: string;
+    /** Injected transport; defaults to the global `fetch`. */
+    readonly fetchFn?: typeof fetch;
+}
+export interface ListOpts {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly sort?: string;
+    readonly filter?: string;
+}
+export interface ListResult {
+    readonly data: ReadonlyArray<unknown>;
+    readonly next: string | null;
+}
+export declare class AdminApiClient {
+    private readonly basePath;
+    private readonly fetchFn;
+    constructor(options?: AdminApiClientOptions);
+    private url;
+    /** GET a collection list; parses the HATEOAS envelope. */
+    list(collection: string, opts?: ListOpts): Promise<ListResult>;
+    /** GET a single record. 404 → `null`; other non-2xx → throw. */
+    get(collection: string, id: string): Promise<unknown | null>;
+    /** POST a new record. 201 → `{ id, data }`; 422 → throw with `issues`. */
+    create(collection: string, body: unknown): Promise<{
+        id: string;
+        data: unknown;
+    }>;
+    /** PATCH a record. Sends `If-Match` when `etag` given; 412 → throw. */
+    update(collection: string, id: string, patch: unknown, etag?: string): Promise<unknown>;
+    /** DELETE a record (204 expected). Sends `If-Match` when `etag` given. */
+    remove(collection: string, id: string, etag?: string): Promise<void>;
+    /**
+     * Save (upsert) the Draft tree for a Page — `PUT /drafts/:pageId`. This is
+     * *Save draft*, NOT Publish (Publish stays the deliberate `saacms publish`).
+     * Sends `If-Match` when `etag` is given (optimistic concurrency); a stale
+     * tag → the runtime's 412 surfaces as an `AdminApiError` (`code:
+     * "precondition-failed"`), a malformed tree → 422 with `issues`.
+     * Returns the stored Draft `data` and the fresh weak `ETag`.
+     */
+    saveDraft(pageId: string, tree: unknown, etag?: string): Promise<{
+        data: unknown;
+        etag: string | null;
+    }>;
+    /**
+     * Load the current Draft tree for a Page — `GET /drafts/:pageId`.
+     * 404 → `null` (no Draft, or not accessible — non-enumeration); other
+     * non-2xx → throw. Returns the Draft `data` + its weak `ETag`.
+     */
+    loadDraft(pageId: string): Promise<{
+        data: unknown;
+        etag: string | null;
+    } | null>;
+    /**
+     * Discard the Draft for a Page (revert to last Published) —
+     * `DELETE /drafts/:pageId` (204 expected, idempotent). Sends `If-Match`
+     * when `etag` is given.
+     */
+    discardDraft(pageId: string, etag?: string): Promise<void>;
+    /** GET the runtime's OpenAPI document. */
+    openapi(): Promise<unknown>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;gBAGvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ3D;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAoDD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,OAAO,GAAE,qBAA0B;IAK/C,OAAO,CAAC,GAAG;IAWX,0DAA0D;IACpD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBxE,gEAAgE;IAC1D,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQlE,0EAA0E;IACpE,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAazC,uEAAuE;IACjE,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC;IAgBnB,0EAA0E;IACpE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1E;;;;;;;OAOG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAmBlD;;;;OAIG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAWzD;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAKlC"}

package/dist/editor/AdminShell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @saacms/admin v0.2 — outer admin shell (THIN React glue).
+ *
+ * Left nav from the pure {@link ./nav.ts} `buildNavModel` selector; routes
+ * between a Collection list view and {@link ./SaacmsEditor.tsx}. No testable
+ * logic lives here — list/manifest/nav logic is the v0.1 layer + the pure
+ * selector (both unit-tested). Validated by `tsc --build` only.
+ */
+import type { SaacmsConfig } from "@saacms/core";
+import { AdminApiClient } from "../api-client.ts";
+export interface AdminShellProps {
+    readonly config: SaacmsConfig;
+    readonly api?: AdminApiClient;
+}
+export declare function AdminShell(props: AdminShellProps): JSX.Element;
+//# sourceMappingURL=AdminShell.d.ts.map

package/dist/editor/AdminShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminShell.d.ts","sourceRoot":"","sources":["../../src/editor/AdminShell.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAKjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAA;CAC9B;AAoDD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CA4D9D"}

package/dist/editor/PatternMapper.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @saacms/admin v0.2 — PURE data bridge between Puck and the saacms runtime.
+ *
+ * THIS is where the real editor logic lives, and where ≥90% of the test
+ * coverage sits. Per the package's structural-typing discipline (and because
+ * bun:test has no DOM and the repo bans jsdom/RTL), every non-trivial
+ * transformation is a pure, side-effect-free function unit-tested against
+ * plain objects + a mock `AdminApiClient`. The React/Puck `.tsx` files are
+ * thin glue validated only by `tsc --build`.
+ *
+ * Wire shapes
+ * -----------
+ * Puck `Data` (structurally; we do not import `@measured/puck` here):
+ *   { root: { props?: {...} } | {...flat}, content: PuckNode[], zones? }
+ *   PuckNode = { type: string, props: { id: string, ...rest } }
+ *
+ * saacms draft tree — the runtime/Pattern API's stored layout shape (Pages
+ * carry `layout?: unknown` "Stored Puck tree JSON … validated at runtime";
+ * ADR 0025 Patterns are stored content `{ name, tree }`). We normalise to a
+ * stable canonical tree so it diffs cleanly and round-trips:
+ *   { root: { props: {...} }, nodes: SaacmsNode[] }
+ *   SaacmsNode = { block: string, id: string, props: {...} }
+ */
+import type { AdminApiClient } from "../api-client.ts";
+import type { PuckConfig } from "../puck-types.ts";
+export interface PuckNode {
+    readonly type: string;
+    readonly props: Readonly<Record<string, unknown>> & {
+        readonly id?: unknown;
+    };
+}
+export interface PuckData {
+    readonly root: Readonly<Record<string, unknown>>;
+    readonly content: ReadonlyArray<PuckNode>;
+    readonly zones?: Readonly<Record<string, ReadonlyArray<PuckNode>>>;
+}
+export interface SaacmsNode {
+    readonly block: string;
+    readonly id: string;
+    readonly props: Readonly<Record<string, unknown>>;
+}
+export interface SaacmsDraftTree {
+    readonly root: {
+        readonly props: Readonly<Record<string, unknown>>;
+    };
+    readonly nodes: ReadonlyArray<SaacmsNode>;
+}
+export interface SaacmsDraft {
+    readonly tree: SaacmsDraftTree;
+}
+/** Map Puck `Data` → the canonical saacms draft tree. */
+export declare function puckDataToDraft(puckData: PuckData): SaacmsDraft;
+/**
+ * Inverse of {@link puckDataToDraft}. `puckConfig` is consulted to drop nodes
+ * whose block type the editor cannot render (defensive — a stale Pattern may
+ * reference a Block the Developer has since removed); the round-trip stays
+ * structurally stable for any tree whose blocks are all registered.
+ */
+export declare function draftToPuckData(draft: SaacmsDraft, puckConfig: PuckConfig): PuckData;
+export type EditorSaveErrorCode = "validation" | "precondition-failed" | "forbidden" | "not-found" | "empty-selection" | "unknown";
+/**
+ * The single typed failure the editor surfaces. `puckOnPublishHandler` /
+ * `savePatternHandler` translate an `AdminApiError` (or a guard failure) into
+ * this; `formatSaveError` turns it into Owner-facing copy.
+ */
+export declare class EditorSaveError extends Error {
+    readonly code: EditorSaveErrorCode;
+    readonly status?: number;
+    readonly issues?: unknown;
+    constructor(message: string, init: {
+        code: EditorSaveErrorCode;
+        status?: number;
+        issues?: unknown;
+    });
+}
+export interface PublishDeps {
+    readonly api: AdminApiClient;
+    readonly collection: string;
+    /** Present → PATCH that record; absent → POST a new one. */
+    readonly id?: string;
+    /** Optimistic-concurrency tag forwarded as `If-Match` on update. */
+    readonly etag?: string;
+}
+/**
+ * Build the async publish handler the editor hands to `<Puck onPublish>`.
+ * Pure w.r.t. the injected `api` (mock it in tests). Maps the Puck tree to a
+ * draft, then create-or-updates; any `AdminApiError` becomes a typed
+ * {@link EditorSaveError} (422 keeps `.issues`, 412 → `precondition-failed`).
+ */
+export declare function puckOnPublishHandler(deps: PublishDeps): (puckData: PuckData) => Promise<{
+    id: string;
+}>;
+export interface PatternSelection {
+    /** Owner-given Pattern name. */
+    readonly name: string;
+    /** The selected Puck content sub-tree (the chosen Block instances). */
+    readonly nodes: ReadonlyArray<PuckNode>;
+    /** Optional preset root props for the saved arrangement. */
+    readonly root?: Readonly<Record<string, unknown>>;
+}
+export interface SavePatternDeps {
+    readonly api: AdminApiClient;
+}
+/**
+ * Map a selected sub-tree to a draft tree and `POST /patterns` (a Pattern is
+ * stored content `{ name, tree }`, persisted via the same row API as any
+ * Collection record — ADR 0025 Zone 1). Pure w.r.t. `deps.api`.
+ *
+ * Rejects with an `empty-selection` {@link EditorSaveError} when the name is
+ * blank or nothing is selected — nothing is sent to the server.
+ */
+export declare function savePatternHandler(deps: SavePatternDeps, selection: PatternSelection): Promise<{
+    id: string;
+}>;
+/**
+ * Human, Owner-facing one-liner for a save failure. Never leaks stack traces
+ * or server internals — the Owner never leaves the editor (ADR 0025).
+ */
+export declare function formatSaveError(err: EditorSaveError): string;
+//# sourceMappingURL=PatternMapper.d.ts.map

package/dist/editor/PatternMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternMapper.d.ts","sourceRoot":"","sources":["../../src/editor/PatternMapper.ts"],"names":[],"mappings":"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"}

package/dist/editor/SaacmsEditor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @saacms/admin v0.2 — the Puck editor surface (THIN React glue).
+ *
+ * This component contains no testable logic: it wires the v0.1 headless layer
+ * (`buildPuckConfig`) + the pure {@link ./PatternMapper.ts} bridge into
+ * `<Puck>`. It is validated by `tsc --build` only — bun:test has no DOM and
+ * the repo bans jsdom/RTL, so React is never rendered in a unit test (see the
+ * package header and ADR 0022 §"test strategy"). All branching logic it needs
+ * is delegated to pure, unit-tested functions in `PatternMapper.ts`.
+ */
+import type { Data } from "@measured/puck";
+import type { SaacmsConfig } from "@saacms/core";
+import { AdminApiClient } from "../api-client.ts";
+export interface SaacmsEditorProps {
+    readonly config: SaacmsConfig;
+    readonly collection: string;
+    readonly recordId?: string;
+    readonly api: AdminApiClient;
+    /**
+     * Page id this editor is editing. When present, the "Save draft"
+     * affordance persists the current tree to `PUT /drafts/:pageId` — this is
+     * *Save draft* (free, no CI), NOT Publish.
+     */
+    readonly pageId?: string;
+    /** Initial Puck tree (e.g. fetched record layout). Defaults to empty. */
+    readonly initialData?: Partial<Data>;
+}
+export declare function SaacmsEditor(props: SaacmsEditorProps): JSX.Element;
+//# sourceMappingURL=SaacmsEditor.d.ts.map

package/dist/editor/SaacmsEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SaacmsEditor.d.ts","sourceRoot":"","sources":["../../src/editor/SaacmsEditor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAUjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAqCD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAkGlE"}

package/dist/editor/nav.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @saacms/admin v0.2 — PURE nav selector for the admin shell.
+ *
+ * Kept in its own React/Puck-free module so `buildNavModel` is unit-testable
+ * in bun:test without dragging in the DOM (the shell `.tsx` imports it; tests
+ * import only this file). Collection labels reuse the v0.1 `adminManifest`
+ * projection (`CollectionDef.label ?? PascalCase(slug)`) — single source of
+ * truth, not re-derived.
+ */
+import type { SaacmsConfig } from "@saacms/core";
+export type NavEntryKind = "collection" | "patterns";
+export interface NavEntry {
+    readonly kind: NavEntryKind;
+    /** Route segment under `/admin/` (collection slug, or `patterns`). */
+    readonly slug: string;
+    readonly label: string;
+}
+export interface NavModel {
+    readonly entries: ReadonlyArray<NavEntry>;
+}
+/**
+ * Left-nav model: one entry per Collection (labelled exactly as the manifest
+ * does) followed by the always-present Patterns entry. Zero collections →
+ * just the Patterns entry (no throw).
+ */
+export declare function buildNavModel(config: SaacmsConfig): NavModel;
+//# sourceMappingURL=nav.d.ts.map

package/dist/editor/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/editor/nav.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,CAAA;AAEpD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;CAC1C;AASD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAQ5D"}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @saacms/admin — v0.2: the real Puck + React editor shell.
+ *
+ * v0.1 was the pure, testable headless data layer (`buildPuckConfig` /
+ * `AdminApiClient` / `adminManifest`). v0.2 mounts the actual editor on top
+ * of it — every export below is still here (full back-compat) plus:
+ *
+ *   - `SaacmsEditor` / `AdminShell` / `mountAdmin` — the React + `<Puck>`
+ *     shell the host's `/admin/*` route renders.
+ *   - `puckDataToDraft` / `draftToPuckData` / `puckOnPublishHandler` /
+ *     `savePatternHandler` / `formatSaveError` / `buildNavModel` — the PURE,
+ *     fully unit-tested bridge where all the real logic lives.
+ *
+ * Test strategy (deliberate): bun:test has no DOM and the repo bans
+ * jsdom/RTL, so **all non-trivial logic is in pure functions** (the v0.1
+ * discipline) covered by `editor.test.ts`; the React/Puck `.tsx` files are
+ * THIN glue validated by `tsc --build` + a successful build, never by
+ * rendered unit tests. Same structural-typing rule the codebase uses for
+ * platform libs.
+ *
+ * The placeholder surface (`adminMountInfo` / `AdminMountInfo` /
+ * `AdminMountStatus` / `adminPlaceholderVersion`) is kept exported for
+ * back-compat with anything already importing it.
+ */
+export type { PuckConfig, PuckComponentConfig } from "./puck-types.ts";
+export { buildPuckConfig, pascalCase } from "./puck-config.ts";
+export { AdminApiClient, AdminApiError, type AdminApiClientOptions, type ListOpts, type ListResult, } from "./api-client.ts";
+export { adminManifest, ADMIN_ROUTE, type AdminManifest } from "./manifest.ts";
+export { puckDataToDraft, draftToPuckData, puckOnPublishHandler, savePatternHandler, formatSaveError, EditorSaveError, type PuckData, type PuckNode, type SaacmsDraft, type SaacmsDraftTree, type SaacmsNode, type EditorSaveErrorCode, type PublishDeps, type SavePatternDeps, type PatternSelection, } from "./editor/PatternMapper.ts";
+export { buildNavModel, type NavModel, type NavEntry, type NavEntryKind, } from "./editor/nav.ts";
+export { SaacmsEditor, type SaacmsEditorProps } from "./editor/SaacmsEditor.tsx";
+export { AdminShell, type AdminShellProps } from "./editor/AdminShell.tsx";
+export { mountAdmin, type MountAdminOptions, type AdminHandle, } from "./mount.tsx";
+export declare const adminPlaceholderVersion: "0.1.0-placeholder";
+export type AdminMountStatus = "placeholder";
+export interface AdminMountInfo {
+    readonly route: string;
+    readonly status: AdminMountStatus;
+}
+/**
+ * Back-compat shim. Delegates to the admin route constant; richer surface is
+ * `adminManifest(config)`.
+ */
+export declare function adminMountInfo(): AdminMountInfo;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAG9E,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAQpB,eAAO,MAAM,uBAAuB,EAAG,mBAA4B,CAAA;AAEnE,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAE/C"}

package/dist/index.js

@@ -0,0 +1,634 @@
+// src/puck-config.ts
+import { schemaToPuckFields } from "@saacms/core";
+function pascalCase(slug) {
+  return slug.split(/[-_\s]+/).filter((t) => t.length > 0).map((t) => t.charAt(0).toUpperCase() + t.slice(1)).join("");
+}
+function isAstNode(v) {
+  return typeof v === "object" && v !== null && typeof v._tag === "string";
+}
+function isTypeLiteral(n) {
+  return n._tag === "TypeLiteral" && Array.isArray(n.propertySignatures);
+}
+function peelRefinements(n) {
+  let t = n;
+  while (t._tag === "Refinement" && isAstNode(t.from)) {
+    t = t.from;
+  }
+  return t;
+}
+function schemaAst(schema) {
+  const ast = schema.ast;
+  return isAstNode(ast) ? ast : undefined;
+}
+function deriveDefaultProps(blockSchema) {
+  const root = schemaAst(blockSchema);
+  if (root === undefined || !isTypeLiteral(root))
+    return;
+  const out = {};
+  for (const ps of root.propertySignatures) {
+    if (ps.isOptional)
+      continue;
+    const base = peelRefinements(ps.type);
+    const key = String(ps.name);
+    if (base._tag === "StringKeyword")
+      out[key] = "";
+    else if (base._tag === "NumberKeyword")
+      out[key] = 0;
+    else if (base._tag === "BooleanKeyword")
+      out[key] = false;
+  }
+  return Object.keys(out).length > 0 ? out : undefined;
+}
+function buildPuckConfig(config) {
+  const blocks = config.blocks ?? [];
+  const entries = blocks.map((block) => {
+    const collShaped = { slug: block.slug, schema: block.schema };
+    const fields = schemaToPuckFields(collShaped);
+    const defaultProps = deriveDefaultProps(block.schema);
+    const component = defaultProps !== undefined ? { fields, defaultProps } : { fields };
+    return [pascalCase(block.slug), component];
+  }).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  const components = {};
+  for (const [key, component] of entries)
+    components[key] = component;
+  return { components, root: { fields: {} } };
+}
+// src/api-client.ts
+class AdminApiError extends Error {
+  status;
+  code;
+  issues;
+  constructor(message, init) {
+    super(message);
+    this.name = "AdminApiError";
+    this.status = init.status;
+    this.code = init.code;
+    if (init.issues !== undefined)
+      this.issues = init.issues;
+  }
+}
+var DEFAULT_BASE_PATH = "/api/saacms/v1";
+var STATUS_CODE = {
+  401: "unauthorized",
+  403: "forbidden",
+  404: "not-found",
+  409: "conflict",
+  412: "precondition-failed",
+  415: "unsupported-media-type",
+  422: "unprocessable-entity",
+  500: "internal-error"
+};
+function isRecord(v) {
+  return typeof v === "object" && v !== null;
+}
+function codeFromProblem(body, status) {
+  if (isRecord(body) && typeof body.type === "string") {
+    const seg = body.type.split("/").filter((s) => s.length > 0).pop();
+    if (seg !== undefined && seg.length > 0)
+      return seg;
+  }
+  return STATUS_CODE[status] ?? "error";
+}
+async function readProblem(res) {
+  try {
+    return await res.json();
+  } catch {
+    return;
+  }
+}
+async function errorFrom(res) {
+  const body = await readProblem(res);
+  const code = codeFromProblem(body, res.status);
+  const title = isRecord(body) && typeof body.title === "string" ? body.title : `Request failed with status ${res.status}`;
+  const issues = isRecord(body) ? body.issues ?? (isRecord(body.extensions) ? body.extensions.issues : undefined) : undefined;
+  return new AdminApiError(title, { status: res.status, code, issues });
+}
+
+class AdminApiClient {
+  basePath;
+  fetchFn;
+  constructor(options = {}) {
+    this.basePath = options.basePath ?? DEFAULT_BASE_PATH;
+    this.fetchFn = options.fetchFn ?? fetch;
+  }
+  url(path, query) {
+    let u = `${this.basePath}${path}`;
+    if (query !== undefined) {
+      const qs = Object.entries(query).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
+      if (qs.length > 0)
+        u += `?${qs}`;
+    }
+    return u;
+  }
+  async list(collection, opts = {}) {
+    const query = {};
+    if (opts.limit !== undefined)
+      query.limit = String(opts.limit);
+    if (opts.cursor !== undefined)
+      query.cursor = opts.cursor;
+    if (opts.sort !== undefined)
+      query.sort = opts.sort;
+    if (opts.filter !== undefined)
+      query.filter = opts.filter;
+    const res = await this.fetchFn(this.url(`/${collection}`, query));
+    if (!res.ok)
+      throw await errorFrom(res);
+    const body = await res.json();
+    const data = isRecord(body) && Array.isArray(body.data) ? body.data : [];
+    let next = null;
+    if (isRecord(body) && isRecord(body._links)) {
+      const n = body._links.next;
+      if (isRecord(n) && typeof n.href === "string")
+        next = n.href;
+    }
+    return { data, next };
+  }
+  async get(collection, id) {
+    const res = await this.fetchFn(this.url(`/${collection}/${id}`));
+    if (res.status === 404)
+      return null;
+    if (!res.ok)
+      throw await errorFrom(res);
+    const body = await res.json();
+    return isRecord(body) ? body.data ?? null : null;
+  }
+  async create(collection, body) {
+    const res = await this.fetchFn(this.url(`/${collection}`), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok)
+      throw await errorFrom(res);
+    const env = await res.json();
+    const data = isRecord(env) ? env.data : undefined;
+    const id = isRecord(data) ? String(data.id) : "";
+    return { id, data };
+  }
+  async update(collection, id, patch, etag) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (etag !== undefined)
+      headers["If-Match"] = etag;
+    const res = await this.fetchFn(this.url(`/${collection}/${id}`), {
+      method: "PATCH",
+      headers,
+      body: JSON.stringify(patch)
+    });
+    if (!res.ok)
+      throw await errorFrom(res);
+    const body = await res.json();
+    return isRecord(body) ? body.data : undefined;
+  }
+  async remove(collection, id, etag) {
+    const headers = {};
+    if (etag !== undefined)
+      headers["If-Match"] = etag;
+    const res = await this.fetchFn(this.url(`/${collection}/${id}`), {
+      method: "DELETE",
+      headers
+    });
+    if (res.status === 204)
+      return;
+    if (!res.ok)
+      throw await errorFrom(res);
+  }
+  async saveDraft(pageId, tree, etag) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (etag !== undefined)
+      headers["If-Match"] = etag;
+    const res = await this.fetchFn(this.url(`/drafts/${pageId}`), {
+      method: "PUT",
+      headers,
+      body: JSON.stringify(tree)
+    });
+    if (!res.ok)
+      throw await errorFrom(res);
+    const body = await res.json();
+    return {
+      data: isRecord(body) ? body.data ?? null : null,
+      etag: res.headers.get("ETag")
+    };
+  }
+  async loadDraft(pageId) {
+    const res = await this.fetchFn(this.url(`/drafts/${pageId}`));
+    if (res.status === 404)
+      return null;
+    if (!res.ok)
+      throw await errorFrom(res);
+    const body = await res.json();
+    return {
+      data: isRecord(body) ? body.data ?? null : null,
+      etag: res.headers.get("ETag")
+    };
+  }
+  async discardDraft(pageId, etag) {
+    const headers = {};
+    if (etag !== undefined)
+      headers["If-Match"] = etag;
+    const res = await this.fetchFn(this.url(`/drafts/${pageId}`), {
+      method: "DELETE",
+      headers
+    });
+    if (res.status === 204)
+      return;
+    if (!res.ok)
+      throw await errorFrom(res);
+  }
+  async openapi() {
+    const res = await this.fetchFn(this.url(`/openapi.json`));
+    if (!res.ok)
+      throw await errorFrom(res);
+    return await res.json();
+  }
+}
+// src/manifest.ts
+var ADMIN_ROUTE = "/admin";
+function adminManifest(config) {
+  const collections = (config.collections ?? []).map((c) => ({
+    slug: c.slug,
+    label: c.label ?? pascalCase(c.slug)
+  }));
+  const blocks = (config.blocks ?? []).map((b) => ({ slug: b.slug }));
+  return { route: ADMIN_ROUTE, collections, blocks, status: "ready" };
+}
+// src/editor/PatternMapper.ts
+function isRecord2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function rootProps(root) {
+  if (isRecord2(root.props))
+    return { ...root.props };
+  const { readOnly: _ro, ...flat } = root;
+  return { ...flat };
+}
+function nodeProps(props) {
+  const { id: _id, ...rest } = props;
+  return { ...rest };
+}
+function puckDataToDraft(puckData) {
+  const content = Array.isArray(puckData?.content) ? puckData.content : [];
+  const nodes = content.map((n, i) => ({
+    block: String(n.type),
+    id: typeof n.props?.id === "string" ? n.props.id : `node-${i}`,
+    props: nodeProps(n.props ?? {})
+  }));
+  return {
+    tree: {
+      root: { props: isRecord2(puckData?.root) ? rootProps(puckData.root) : {} },
+      nodes
+    }
+  };
+}
+function draftToPuckData(draft, puckConfig) {
+  const known = puckConfig?.components ?? {};
+  const nodes = draft?.tree?.nodes ?? [];
+  const content = nodes.filter((n) => Object.prototype.hasOwnProperty.call(known, n.block)).map((n) => ({ type: n.block, props: { id: n.id, ...n.props } }));
+  return {
+    root: { props: { ...draft?.tree?.root?.props ?? {} } },
+    content
+  };
+}
+
+class EditorSaveError extends Error {
+  code;
+  status;
+  issues;
+  constructor(message, init) {
+    super(message);
+    this.name = "EditorSaveError";
+    this.code = init.code;
+    if (init.status !== undefined)
+      this.status = init.status;
+    if (init.issues !== undefined)
+      this.issues = init.issues;
+  }
+}
+function isApiErrorLike(e) {
+  return isRecord2(e) && typeof e.status === "number" && typeof e.code === "string" && typeof e.message === "string";
+}
+function toEditorSaveError(e) {
+  if (e instanceof EditorSaveError)
+    return e;
+  if (isApiErrorLike(e)) {
+    let code = "unknown";
+    if (e.status === 422)
+      code = "validation";
+    else if (e.status === 412)
+      code = "precondition-failed";
+    else if (e.status === 403)
+      code = "forbidden";
+    else if (e.status === 404)
+      code = "not-found";
+    return new EditorSaveError(e.message, {
+      code,
+      status: e.status,
+      issues: e.issues
+    });
+  }
+  return new EditorSaveError(e instanceof Error ? e.message : "Unexpected error while saving.", { code: "unknown" });
+}
+function puckOnPublishHandler(deps) {
+  return async (puckData) => {
+    const draft = puckDataToDraft(puckData);
+    try {
+      if (deps.id !== undefined) {
+        await deps.api.update(deps.collection, deps.id, draft, deps.etag);
+        return { id: deps.id };
+      }
+      const created = await deps.api.create(deps.collection, draft);
+      return { id: created.id };
+    } catch (e) {
+      throw toEditorSaveError(e);
+    }
+  };
+}
+function savePatternHandler(deps, selection) {
+  const name = selection?.name?.trim() ?? "";
+  const nodes = selection?.nodes ?? [];
+  if (name.length === 0 || nodes.length === 0) {
+    return Promise.reject(new EditorSaveError("Select at least one section and give the Pattern a name before saving.", { code: "empty-selection" }));
+  }
+  const { tree } = puckDataToDraft({
+    root: selection.root ?? {},
+    content: nodes
+  });
+  return deps.api.create("patterns", { name, tree }).then((res) => ({ id: res.id })).catch((e) => Promise.reject(toEditorSaveError(e)));
+}
+function issueFieldList(issues) {
+  if (!Array.isArray(issues))
+    return "";
+  const parts = [];
+  for (const it of issues) {
+    if (!isRecord2(it))
+      continue;
+    const path = Array.isArray(it.path) ? it.path.join(".") : typeof it.path === "string" ? it.path : "";
+    const msg = typeof it.message === "string" ? it.message : "is invalid";
+    parts.push(path.length > 0 ? `${path}: ${msg}` : msg);
+  }
+  return parts.join("; ");
+}
+function formatSaveError(err) {
+  switch (err.code) {
+    case "validation": {
+      const list = issueFieldList(err.issues);
+      return list.length > 0 ? `Couldn't save — please fix: ${list}.` : "Couldn't save — some fields are invalid. Please review and try again.";
+    }
+    case "precondition-failed":
+      return "Someone else changed this since you opened it. Reload to get the latest version, then re-apply your changes.";
+    case "empty-selection":
+      return err.message;
+    case "forbidden":
+      return "You don't have permission to make this change.";
+    case "not-found":
+      return "This item no longer exists — it may have been deleted.";
+    default:
+      return "Something went wrong while saving. Please try again.";
+  }
+}
+// src/editor/nav.ts
+var PATTERNS_ENTRY = {
+  kind: "patterns",
+  slug: "patterns",
+  label: "Patterns"
+};
+function buildNavModel(config) {
+  const { collections } = adminManifest(config);
+  const collectionEntries = collections.map((c) => ({
+    kind: "collection",
+    slug: c.slug,
+    label: c.label
+  }));
+  return { entries: [...collectionEntries, PATTERNS_ENTRY] };
+}
+// src/editor/SaacmsEditor.tsx
+import { useMemo, useState } from "react";
+import { Puck } from "@measured/puck";
+import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
+var EMPTY_DATA = { root: { props: {} }, content: [], zones: {} };
+function toPuckConfig(headless) {
+  const components = {};
+  for (const [name, comp] of Object.entries(headless.components)) {
+    components[name] = {
+      fields: comp.fields,
+      defaultProps: comp.defaultProps,
+      render: (props) => /* @__PURE__ */ jsxDEV("div", {
+        "data-saacms-block": name,
+        children: String(props.title ?? props.label ?? name)
+      }, undefined, false, undefined, this)
+    };
+  }
+  return { components, root: { render: ({ children }) => /* @__PURE__ */ jsxDEV(Fragment, {
+    children
+  }, undefined, false, undefined, this) } };
+}
+function SaacmsEditor(props) {
+  const { config, collection, recordId, api, pageId, initialData } = props;
+  const puckConfig = useMemo(() => toPuckConfig(buildPuckConfig(config)), [config]);
+  const onPublish = useMemo(() => puckOnPublishHandler({ api, collection, id: recordId }), [api, collection, recordId]);
+  const [error, setError] = useState(null);
+  const [draftSaved, setDraftSaved] = useState(false);
+  const [savedPatternId, setSavedPatternId] = useState(null);
+  const [lastData, setLastData] = useState(initialData ?? EMPTY_DATA);
+  const [patternName, setPatternName] = useState("");
+  const handlePublish = (data) => {
+    setError(null);
+    onPublish(data).catch((e) => {
+      setError(e instanceof EditorSaveError ? e : null);
+    });
+  };
+  const handleSaveDraft = () => {
+    setError(null);
+    setDraftSaved(false);
+    if (pageId === undefined)
+      return;
+    const { tree } = puckDataToDraft(lastData);
+    api.saveDraft(pageId, tree).then(() => setDraftSaved(true)).catch((e) => {
+      setError(e instanceof EditorSaveError ? e : null);
+    });
+  };
+  const handleSavePattern = () => {
+    setError(null);
+    setSavedPatternId(null);
+    savePatternHandler({ api }, { name: patternName, nodes: lastData.content ?? [] }).then((res) => setSavedPatternId(res.id)).catch((e) => {
+      setError(e instanceof EditorSaveError ? e : null);
+    });
+  };
+  return /* @__PURE__ */ jsxDEV("div", {
+    "data-saacms-editor": true,
+    children: [
+      error !== null ? /* @__PURE__ */ jsxDEV("div", {
+        role: "alert",
+        "data-saacms-error-banner": true,
+        children: formatSaveError(error)
+      }, undefined, false, undefined, this) : null,
+      savedPatternId !== null ? /* @__PURE__ */ jsxDEV("div", {
+        role: "status",
+        "data-saacms-pattern-saved": true,
+        children: "Pattern saved."
+      }, undefined, false, undefined, this) : null,
+      draftSaved ? /* @__PURE__ */ jsxDEV("div", {
+        role: "status",
+        "data-saacms-draft-saved": true,
+        children: "Draft saved."
+      }, undefined, false, undefined, this) : null,
+      pageId !== undefined ? /* @__PURE__ */ jsxDEV("div", {
+        "data-saacms-draft-bar": true,
+        children: /* @__PURE__ */ jsxDEV("button", {
+          type: "button",
+          onClick: handleSaveDraft,
+          children: "Save draft"
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this) : null,
+      /* @__PURE__ */ jsxDEV("div", {
+        "data-saacms-pattern-bar": true,
+        children: [
+          /* @__PURE__ */ jsxDEV("input", {
+            "aria-label": "Pattern name",
+            value: patternName,
+            onChange: (e) => setPatternName(e.currentTarget.value),
+            placeholder: "Name this Pattern"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("button", {
+            type: "button",
+            onClick: handleSavePattern,
+            children: "Save selection as Pattern"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Puck, {
+        config: puckConfig,
+        data: lastData,
+        onChange: (d) => setLastData(d),
+        onPublish: handlePublish
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/editor/AdminShell.tsx
+import { useEffect, useMemo as useMemo2, useState as useState2 } from "react";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+function CollectionList(props) {
+  const { api, collection, onEdit, onNew } = props;
+  const [rows, setRows] = useState2([]);
+  useEffect(() => {
+    let live = true;
+    api.list(collection).then((r) => {
+      if (live)
+        setRows(r.data);
+    }).catch(() => {
+      if (live)
+        setRows([]);
+    });
+    return () => {
+      live = false;
+    };
+  }, [api, collection]);
+  return /* @__PURE__ */ jsxDEV2("div", {
+    "data-saacms-collection-list": true,
+    children: [
+      /* @__PURE__ */ jsxDEV2("button", {
+        type: "button",
+        onClick: onNew,
+        children: "New"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("ul", {
+        children: rows.map((row, i) => {
+          const id = typeof row === "object" && row !== null && "id" in row ? String(row.id) : String(i);
+          return /* @__PURE__ */ jsxDEV2("li", {
+            children: /* @__PURE__ */ jsxDEV2("button", {
+              type: "button",
+              onClick: () => onEdit(id),
+              children: id
+            }, undefined, false, undefined, this)
+          }, id, false, undefined, this);
+        })
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function AdminShell(props) {
+  const { config } = props;
+  const api = useMemo2(() => props.api ?? new AdminApiClient, [props.api]);
+  const nav = useMemo2(() => buildNavModel(config), [config]);
+  const [active, setActive] = useState2(nav.entries[0] ?? { kind: "patterns", slug: "patterns", label: "Patterns" });
+  const [editingId, setEditingId] = useState2(null);
+  const [creating, setCreating] = useState2(false);
+  const select = (entry) => {
+    setActive(entry);
+    setEditingId(null);
+    setCreating(false);
+  };
+  const inEditor = active.kind === "collection" && (editingId !== null || creating);
+  return /* @__PURE__ */ jsxDEV2("div", {
+    "data-saacms-admin-shell": true,
+    children: [
+      /* @__PURE__ */ jsxDEV2("nav", {
+        "aria-label": "Admin sections",
+        children: /* @__PURE__ */ jsxDEV2("ul", {
+          children: nav.entries.map((entry) => /* @__PURE__ */ jsxDEV2("li", {
+            children: /* @__PURE__ */ jsxDEV2("button", {
+              type: "button",
+              "aria-current": entry.slug === active.slug ? "page" : undefined,
+              onClick: () => select(entry),
+              children: entry.label
+            }, undefined, false, undefined, this)
+          }, entry.slug, false, undefined, this))
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("main", {
+        children: active.kind === "patterns" ? /* @__PURE__ */ jsxDEV2("div", {
+          "data-saacms-patterns-view": true,
+          children: "Patterns are composed and saved from inside the editor."
+        }, undefined, false, undefined, this) : inEditor ? /* @__PURE__ */ jsxDEV2(SaacmsEditor, {
+          config,
+          collection: active.slug,
+          recordId: editingId ?? undefined,
+          api
+        }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV2(CollectionList, {
+          api,
+          collection: active.slug,
+          onEdit: (id) => setEditingId(id),
+          onNew: () => setCreating(true)
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/mount.tsx
+import { createElement } from "react";
+import { createRoot } from "react-dom/client";
+function mountAdmin(el, opts) {
+  const root = createRoot(el);
+  root.render(createElement(AdminShell, { config: opts.config, api: opts.api }));
+  return { unmount: () => root.unmount() };
+}
+
+// src/index.ts
+var adminPlaceholderVersion = "0.1.0-placeholder";
+function adminMountInfo() {
+  return { route: "/admin", status: "placeholder" };
+}
+export {
+  savePatternHandler,
+  puckOnPublishHandler,
+  puckDataToDraft,
+  pascalCase,
+  mountAdmin,
+  formatSaveError,
+  draftToPuckData,
+  buildPuckConfig,
+  buildNavModel,
+  adminPlaceholderVersion,
+  adminMountInfo,
+  adminManifest,
+  SaacmsEditor,
+  EditorSaveError,
+  AdminShell,
+  AdminApiError,
+  AdminApiClient,
+  ADMIN_ROUTE
+};

package/dist/manifest.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Admin route manifest — the static description the (future) React shell uses
+ * to render its collection/block navigation. Replaces the old
+ * `adminMountInfo()` placeholder; a back-compat `adminMountInfo()` that
+ * delegates to the same route constant is kept in the barrel so nothing
+ * importing it breaks.
+ *
+ * Collection `label` is `CollectionDef.label ?? PascalCase(slug)` (per ADR
+ * 0011 the admin mounts at `/admin/*`).
+ */
+import type { SaacmsConfig } from "@saacms/core";
+/** Where the admin UI mounts in the host (ADR 0011). */
+export declare const ADMIN_ROUTE: "/admin";
+export interface AdminManifest {
+    readonly route: string;
+    readonly collections: ReadonlyArray<{
+        readonly slug: string;
+        readonly label: string;
+    }>;
+    readonly blocks: ReadonlyArray<{
+        readonly slug: string;
+    }>;
+    readonly status: "ready";
+}
+export declare function adminManifest(config: SaacmsConfig): AdminManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,wDAAwD;AACxD,eAAO,MAAM,WAAW,EAAG,QAAiB,CAAA;AAE5C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACvB,CAAC,CAAA;IACF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAOjE"}

package/dist/mount.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @saacms/admin v0.2 — host mount entry.
+ *
+ * The host's `/admin/*` route imports `mountAdmin` and calls it with a real
+ * DOM element. **SSR/import safety:** this module performs ZERO DOM access at
+ * import time — `createRoot` (and any `document`/`window` touch) happens only
+ * inside `mountAdmin`, so `await import("../mount.tsx")` resolves cleanly in
+ * Node with no DOM (proven by the editor test). Keep it that way.
+ */
+import type { SaacmsConfig } from "@saacms/core";
+import { AdminApiClient } from "./api-client.ts";
+export interface MountAdminOptions {
+    readonly config: SaacmsConfig;
+    /** Optional pre-built client; defaults to one on the conventional base path. */
+    readonly api?: AdminApiClient;
+}
+export interface AdminHandle {
+    /** Tear the React tree down (e.g. on host route unmount). */
+    readonly unmount: () => void;
+}
+/**
+ * Render `<AdminShell>` into `el`. The only place in the package that touches
+ * `react-dom/client`'s `createRoot`; called exclusively from the host at
+ * runtime, never at module load.
+ */
+export declare function mountAdmin(el: HTMLElement, opts: MountAdminOptions): AdminHandle;
+//# sourceMappingURL=mount.d.ts.map

package/dist/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,iBAAiB,GACtB,WAAW,CAMb"}

package/dist/puck-config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `buildPuckConfig(config)` — project a `SaacmsConfig` into a Puck editor
+ * config (see `puck-types.ts` for why the Puck types are structural).
+ *
+ * One Puck `component` per registered Block (`config.blocks ?? []`), keyed by
+ * the block slug PascalCased (`rich-text` → `RichText`). Each component's
+ * `fields` is delegated to core's `schemaToPuckFields` — the single source of
+ * truth for the schema→field projection; we never re-derive field configs.
+ *
+ * `schemaToPuckFields` takes a `CollectionDef` (it only reads `.slug` +
+ * `.schema`). A `BlockDef` carries exactly those two members plus block-only
+ * fields the projector ignores, so the adapter is the minimal structural
+ * `{ slug, schema }` — documented inline at the call site.
+ *
+ * `defaultProps` is a *shallow, statically-knowable* zero-value map (v0.1):
+ * required top-level String → "", Number → 0, Boolean → false; optional
+ * properties are omitted (Puck treats every field as optional UI-wise and the
+ * Effect Schema enforces required-ness server-side). Literal unions, arrays
+ * and nested objects are omitted here — deep default extraction is v0.2.
+ *
+ * Component keys are emitted in sorted order so the generated config diffs
+ * cleanly across builds.
+ */
+import type { SaacmsConfig } from "@saacms/core";
+import type { PuckConfig } from "./puck-types.ts";
+/**
+ * `rich-text` → `RichText`. Splits on `-`, `_` and whitespace; capitalises the
+ * first letter of each token. Empty input yields `""`.
+ */
+export declare function pascalCase(slug: string): string;
+export declare function buildPuckConfig(config: SaacmsConfig): PuckConfig;
+//# sourceMappingURL=puck-config.d.ts.map

package/dist/puck-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puck-config.d.ts","sourceRoot":"","sources":["../src/puck-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,cAAc,CAAA;AACzE,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,iBAAiB,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAkFD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAuBhE"}

package/dist/puck-types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Structural slice of `@measured/puck`'s `Config` type.
+ *
+ * Per the codebase convention (KvNamespaceLike / BetterAuthLike / …): external
+ * libraries are typed *structurally*, never taken as a hard dependency. The
+ * admin emits a Puck `Config`-shaped object so the (future) React shell can
+ * hand it straight to `<Puck config={…}>`, but this v0.1 headless layer must
+ * stay React/Puck-free and tsc-clean — so we mirror only the members we emit.
+ *
+ * `fields` reuses core's `PuckField` union (the schema→field projector in
+ * `@saacms/core` is the single source of truth — we do not re-derive it).
+ */
+import type { PuckFields } from "@saacms/core";
+export interface PuckComponentConfig {
+    readonly fields: PuckFields;
+    readonly defaultProps?: Readonly<Record<string, unknown>>;
+}
+export interface PuckConfig {
+    readonly components: Readonly<Record<string, PuckComponentConfig>>;
+    readonly root?: {
+        readonly fields?: PuckFields;
+    };
+}
+//# sourceMappingURL=puck-types.d.ts.map

package/dist/puck-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puck-types.d.ts","sourceRoot":"","sources":["../src/puck-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,CAAA;CACjD"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@saacms/admin",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --build --noEmit",
+    "prepack": "cp package.json package.json.pack-bak && bun run ../../scripts/prepack-pkg.ts",
+    "postpack": "mv package.json.pack-bak package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@saacms/core": "workspace:*",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "@measured/puck": "^0.16.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}