@nuasite/collections-admin 0.43.0-beta.3 → 0.43.0-beta.4

package/dist/types/app.js

@@ -0,0 +1,240 @@
+/**
+ * collections-admin SPA — read-only milestone (cms-headless F3.1).
+ *
+ * Host-agnostic: driven only by an `apiBase` prop, with internal view-state
+ * navigation (list → entries → detail) via React state — never the host router.
+ * That keeps the same component usable as a webmaster tab today and at
+ * `/_nua/admin` for local dev later (F7).
+ *
+ * Read-only: browse collections, list entries (sparse projection + cursor
+ * pagination), and view a single entry's frontmatter + markdown body. Mutations
+ * (editor/media/conflict) arrive in F3.2.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { CmsClientError, createClient } from './client';
+import { FieldRow } from './field-view';
+import './styles.css';
+function useAsync(load, deps) {
+    const [state, setState] = useState({ data: null, error: null, loading: true });
+    const [nonce, setNonce] = useState(0);
+    const loadRef = useRef(load);
+    loadRef.current = load;
+    // `load` is read through a ref; re-runs are driven by the explicit `deps` and
+    // the reload `nonce` so the effect deps stay stable and lint-clean.
+    const effectDeps = [...deps, nonce];
+    useEffect(() => {
+        let active = true;
+        setState({ data: null, error: null, loading: true });
+        loadRef.current().then((data) => {
+            if (active)
+                setState({ data, error: null, loading: false });
+        }, (error) => {
+            if (active)
+                setState({ data: null, error: error instanceof Error ? error : new Error(String(error)), loading: false });
+        });
+        return () => {
+            active = false;
+        };
+    }, effectDeps);
+    const reload = useCallback(() => setNonce((n) => n + 1), []);
+    return { ...state, reload };
+}
+// ============================================================================
+// Presentational primitives
+// ============================================================================
+function Spinner({ label }) {
+    return (<div className="nua-cadmin-state">
+			<div className="nua-cadmin-spinner"/>
+			<div>{label}</div>
+		</div>);
+}
+function ErrorState({ error, onRetry }) {
+    const title = error instanceof CmsClientError && error.isUnauthorized
+        ? 'Session expired'
+        : error instanceof CmsClientError && error.isForbidden
+            ? 'No access'
+            : 'Something went wrong';
+    return (<div className="nua-cadmin-error">
+			<div className="nua-cadmin-error-title">{title}</div>
+			<div>{error.message}</div>
+			{onRetry ? <button type="button" className="nua-cadmin-retry" onClick={onRetry}>Try again</button> : null}
+		</div>);
+}
+function EmptyState({ label }) {
+    return <div className="nua-cadmin-state">{label}</div>;
+}
+// ============================================================================
+// Collection list
+// ============================================================================
+function CollectionList({ client, onOpen }) {
+    const { data, error, loading, reload } = useAsync(() => client.getCollections(), [client]);
+    if (loading)
+        return <Spinner label="Loading collections…"/>;
+    if (error)
+        return <ErrorState error={error} onRetry={reload}/>;
+    if (!data || data.length === 0)
+        return <EmptyState label="No collections found in this project."/>;
+    return (<div className="nua-cadmin-list">
+			{data.map((collection) => (<button key={collection.name} type="button" className="nua-cadmin-card" onClick={() => onOpen(collection.name)}>
+					<span className="nua-cadmin-card-main">
+						<span className="nua-cadmin-card-label">{collection.label || collection.name}</span>
+						<span className="nua-cadmin-card-sub">
+							{collection.name}
+							{collection.type ? ` · ${collection.type}` : ''}
+							{` · ${collection.fileExtension}`}
+						</span>
+					</span>
+					<span className="nua-cadmin-badge">{collection.entryCount} {collection.entryCount === 1 ? 'entry' : 'entries'}</span>
+				</button>))}
+		</div>);
+}
+// ============================================================================
+// Entries table (sparse projection + cursor pagination)
+// ============================================================================
+const ENTRIES_PAGE_SIZE = 50;
+const ENTRIES_FIELDS = 'slug,title,draft,pathname';
+function EntriesTable({ client, collection, onOpen }) {
+    const [rows, setRows] = useState([]);
+    const [cursor, setCursor] = useState(undefined);
+    const [hasMore, setHasMore] = useState(false);
+    const [error, setError] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [loadingMore, setLoadingMore] = useState(false);
+    const loadPage = useCallback(async (nextCursor, append) => {
+        if (append)
+            setLoadingMore(true);
+        else
+            setLoading(true);
+        setError(null);
+        try {
+            const result = await client.getEntries(collection, {
+                fields: ENTRIES_FIELDS,
+                draft: 'all',
+                limit: ENTRIES_PAGE_SIZE,
+                cursor: nextCursor,
+            });
+            setRows((prev) => (append ? [...prev, ...result.entries] : result.entries));
+            setCursor(result.cursor);
+            setHasMore(result.hasMore);
+        }
+        catch (e) {
+            setError(e instanceof Error ? e : new Error(String(e)));
+        }
+        finally {
+            setLoading(false);
+            setLoadingMore(false);
+        }
+    }, [client, collection]);
+    useEffect(() => {
+        setRows([]);
+        setCursor(undefined);
+        setHasMore(false);
+        void loadPage(undefined, false);
+    }, [loadPage]);
+    if (loading)
+        return <Spinner label="Loading entries…"/>;
+    if (error)
+        return <ErrorState error={error} onRetry={() => void loadPage(undefined, false)}/>;
+    if (rows.length === 0)
+        return <EmptyState label="This collection has no entries."/>;
+    return (<div>
+			<table className="nua-cadmin-table">
+				<thead>
+					<tr>
+						<th>Slug</th>
+						<th>Title</th>
+						<th>Draft</th>
+						<th>Pathname</th>
+					</tr>
+				</thead>
+				<tbody>
+					{rows.map((entry) => (<tr key={entry.slug} className="nua-cadmin-row" onClick={() => onOpen(entry.slug)}>
+							<td className="nua-cadmin-cell-mono">{entry.slug}</td>
+							<td>{entry.title ?? <span className="nua-cadmin-field-empty">—</span>}</td>
+							<td>{entry.draft ? <span className="nua-cadmin-badge nua-cadmin-badge-draft">draft</span> : ''}</td>
+							<td className="nua-cadmin-cell-mono">{entry.pathname ?? '—'}</td>
+						</tr>))}
+				</tbody>
+			</table>
+			{hasMore ? (<button type="button" className="nua-cadmin-load-more" disabled={loadingMore} onClick={() => void loadPage(cursor, true)}>
+					{loadingMore ? 'Loading…' : 'Load more'}
+				</button>) : null}
+		</div>);
+}
+// ============================================================================
+// Entry detail
+// ============================================================================
+/**
+ * Order the collection's fields for display: `publish-toggle`/`publish-date`
+ * roles and `sidebar`/`header` positioned fields first, then the rest in schema
+ * order. Hidden fields are dropped.
+ */
+function orderFields(fields) {
+    const visible = fields.filter((f) => !f.hidden);
+    const pinned = visible.filter((f) => f.role !== undefined || f.position !== undefined);
+    const rest = visible.filter((f) => f.role === undefined && f.position === undefined);
+    return [...pinned, ...rest];
+}
+function EntryDetail({ client, collections, collection, slug }) {
+    const { data, error, loading, reload } = useAsync(() => client.getEntry(collection, slug), [client, collection, slug]);
+    const def = useMemo(() => collections.find((c) => c.name === collection), [collections, collection]);
+    if (loading)
+        return <Spinner label="Loading entry…"/>;
+    if (error)
+        return <ErrorState error={error} onRetry={reload}/>;
+    if (!data)
+        return <EmptyState label="Entry not found."/>;
+    const fieldDefs = def ? orderFields(def.fields) : [];
+    const renderedNames = new Set(fieldDefs.map((f) => f.name));
+    // Frontmatter keys present on the entry but absent from the inferred schema.
+    const extraKeys = Object.keys(data.frontmatter).filter((k) => !renderedNames.has(k));
+    return (<div>
+			<div className="nua-cadmin-fields">
+				{fieldDefs.length === 0 && extraKeys.length === 0 ? <EmptyState label="No frontmatter fields."/> : null}
+				{fieldDefs.map((field) => (<FieldRow key={field.name} field={field} raw={data.frontmatter[field.name]?.value}/>))}
+				{extraKeys.map((key) => (<FieldRow key={key} field={{ name: key, type: 'text', required: false }} raw={data.frontmatter[key]?.value}/>))}
+			</div>
+
+			<h3 className="nua-cadmin-section-title">Body</h3>
+			{data.body.trim() === ''
+            ? <EmptyState label="This entry has no markdown body."/>
+            : <pre className="nua-cadmin-body-content">{data.body}</pre>}
+		</div>);
+}
+export function CollectionsAdminApp({ apiBase, onClose }) {
+    const client = useMemo(() => createClient(apiBase), [apiBase]);
+    const [state, setState] = useState({ view: 'list' });
+    // The collection definitions are needed by the detail view to drive field
+    // rendering; load them once at the root and pass down.
+    const collectionsState = useAsync(() => client.getCollections(), [client]);
+    const collections = collectionsState.data ?? [];
+    const goList = useCallback(() => setState({ view: 'list' }), []);
+    const goEntries = useCallback((collection) => setState({ view: 'entries', collection }), []);
+    const goDetail = useCallback((collection, slug) => setState({ view: 'detail', collection, slug }), []);
+    const activeCollection = state.view !== 'list'
+        ? collections.find((c) => c.name === state.collection)
+        : undefined;
+    const collectionLabel = activeCollection ? (activeCollection.label || activeCollection.name) : (state.view !== 'list' ? state.collection : '');
+    return (<div className="nua-cadmin">
+			<div className="nua-cadmin-header">
+				{state.view === 'entries' ? (<button type="button" className="nua-cadmin-back" onClick={goList}>← Collections</button>) : null}
+				{state.view === 'detail' ? (<button type="button" className="nua-cadmin-back" onClick={() => goEntries(state.collection)}>← {collectionLabel}</button>) : null}
+
+				{state.view === 'list' ? <h2 className="nua-cadmin-title">Collections</h2> : null}
+				{state.view === 'entries' ? <h2 className="nua-cadmin-title">{collectionLabel}</h2> : null}
+				{state.view === 'detail' ? (<h2 className="nua-cadmin-title">
+						{collectionLabel}
+						<span className="nua-cadmin-crumb"> / {state.slug}</span>
+					</h2>) : null}
+
+				<span className="nua-cadmin-spacer"/>
+				{onClose ? <button type="button" className="nua-cadmin-close" aria-label="Close" onClick={onClose}>×</button> : null}
+			</div>
+
+			<div className="nua-cadmin-body">
+				{state.view === 'list' ? <CollectionList client={client} onOpen={goEntries}/> : null}
+				{state.view === 'entries' ? <EntriesTable client={client} collection={state.collection} onOpen={(slug) => goDetail(state.collection, slug)}/> : null}
+				{state.view === 'detail' ? <EntryDetail client={client} collections={collections} collection={state.collection} slug={state.slug}/> : null}
+			</div>
+		</div>);
+}

package/dist/types/client.js

@@ -0,0 +1,134 @@
+/**
+ * Typed read-only client over the cms-sidecar `/cms/v1` HTTP contract.
+ *
+ * The host (webmaster BFF, or a local dev proxy in F7) mounts the sidecar under
+ * an `apiBase` and adds the `/cms/v1` prefix itself — so this client requests
+ * `${apiBase}/project`, `${apiBase}/collections`, etc. (never `/cms/v1/...`).
+ *
+ * The structural model (collections/entries/fields) is reused 1:1 from
+ * `@nuasite/cms-types`. The thin HTTP envelope (project model, sparse entries
+ * list, error codes) mirrors the sidecar's wire types; it is declared here
+ * because those types are not part of the `@nuasite/cms-types` contract surface.
+ */
+// ============================================================================
+// Client error
+// ============================================================================
+/**
+ * Thrown for any non-2xx response. Carries the parsed sidecar error code so the
+ * UI can distinguish auth failures (`unauthorized`/`forbidden`) from a missing
+ * collection/entry (`not_found`) or a generic failure.
+ */
+export class CmsClientError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'CmsClientError';
+    }
+    /** Session cookie missing/expired upstream — the user must re-authenticate. */
+    get isUnauthorized() {
+        return this.code === 'unauthorized' || this.status === 401;
+    }
+    /** Authenticated but lacks access to this project. */
+    get isForbidden() {
+        return this.code === 'forbidden' || this.status === 403;
+    }
+    get isNotFound() {
+        return this.code === 'not_found' || this.status === 404;
+    }
+}
+// ============================================================================
+// Client
+// ============================================================================
+function isApiError(value) {
+    return typeof value === 'object'
+        && value !== null
+        && 'error' in value
+        && typeof value.error === 'string'
+        && 'code' in value
+        && typeof value.code === 'string';
+}
+const KNOWN_ERROR_CODES = [
+    'not_found',
+    'conflict',
+    'validation',
+    'parse_error',
+    'io_error',
+    'unsupported',
+    'unauthorized',
+];
+function isErrorCode(value) {
+    return KNOWN_ERROR_CODES.includes(value);
+}
+export function createClient(apiBase) {
+    // Normalise: drop a trailing slash so `${base}${path}` joins cleanly.
+    const base = apiBase.endsWith('/') ? apiBase.slice(0, -1) : apiBase;
+    async function request(path) {
+        const response = await fetch(`${base}${path}`, {
+            method: 'GET',
+            credentials: 'include',
+            headers: { accept: 'application/json' },
+        });
+        if (!response.ok) {
+            throw await toError(response);
+        }
+        // Successful responses are always JSON in the read-only surface.
+        const value = await response.json();
+        return value;
+    }
+    async function toError(response) {
+        // 403 is produced by the BFF (project scope), not the sidecar, so it has no
+        // sidecar `code`; surface it as a distinct `forbidden`.
+        if (response.status === 403) {
+            const message = await readErrorMessage(response, 'You do not have access to this project.');
+            return new CmsClientError(403, 'forbidden', message);
+        }
+        const body = await response.json().catch(() => null);
+        if (isApiError(body) && isErrorCode(body.code)) {
+            return new CmsClientError(response.status, body.code, body.error);
+        }
+        if (response.status === 401) {
+            return new CmsClientError(401, 'unauthorized', 'Your session has expired. Please reload.');
+        }
+        return new CmsClientError(response.status, 'unknown', `Request failed (${response.status})`);
+    }
+    async function readErrorMessage(response, fallback) {
+        const body = await response.json().catch(() => null);
+        if (isApiError(body))
+            return body.error;
+        if (typeof body === 'object' && body !== null && 'error' in body) {
+            const err = body.error;
+            if (typeof err === 'object' && err !== null && 'message' in err && typeof err.message === 'string') {
+                return err.message;
+            }
+        }
+        return fallback;
+    }
+    return {
+        getProject() {
+            return request('/project');
+        },
+        getCollections() {
+            return request('/collections');
+        },
+        getEntries(collection, options = {}) {
+            const params = new URLSearchParams();
+            if (options.fields !== undefined)
+                params.set('fields', options.fields);
+            if (options.draft !== undefined)
+                params.set('draft', options.draft);
+            if (options.cursor !== undefined)
+                params.set('cursor', options.cursor);
+            if (options.limit !== undefined)
+                params.set('limit', String(options.limit));
+            const query = params.toString();
+            const suffix = query === '' ? '' : `?${query}`;
+            return request(`/collections/${encodeURIComponent(collection)}/entries${suffix}`);
+        },
+        getEntry(collection, slug) {
+            return request(`/collections/${encodeURIComponent(collection)}/entries/${encodeURIComponent(slug)}`);
+        },
+    };
+}

package/dist/types/entry-create.d.ts

@@ -7,7 +7,7 @@
  * native draft model as the editor.
  */
 import type { CollectionDefinition } from '@nuasite/cms-types';
-import { type CmsClient } from './client';
+import { type CmsClient } from '@nuasite/cms-client';
 export declare function EntryCreate({ client, definition, collection, onCreated, onCancel }: {
     client: CmsClient;
     definition: CollectionDefinition | undefined;

package/dist/types/entry-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-create.d.ts","sourceRoot":"","sources":["../../src/entry-create.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,oBAAoB,CAAA;AAE/E,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,UAAU,CAAA;AAQzD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IACpF,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAA;CACpB,+BA0FA"}
+{"version":3,"file":"entry-create.d.ts","sourceRoot":"","sources":["../../src/entry-create.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,oBAAoB,CAAA;AAE/E,OAAO,EAAE,KAAK,SAAS,EAAkE,MAAM,qBAAqB,CAAA;AAOpH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IACpF,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAA;CACpB,+BA0FA"}

package/dist/types/entry-editor.d.ts

@@ -18,7 +18,7 @@
  * + `serverHash`; "use ours" re-PATCHes with `baseHash = serverHash` (force-over).
  */
 import type { CollectionDefinition } from '@nuasite/cms-types';
-import type { CmsClient } from './client';
+import { type CmsClient } from '@nuasite/cms-client';
 export declare function EntryEditor({ client, definition, collection, slug, onDeleted, onRenamed }: {
     client: CmsClient;
     definition: CollectionDefinition | undefined;

package/dist/types/entry-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-editor.d.ts","sourceRoot":"","sources":["../../src/entry-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,oBAAoB,CAAA;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,UAAU,CAAA;AAgHtD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,+BA4MA"}
+{"version":3,"file":"entry-editor.d.ts","sourceRoot":"","sources":["../../src/entry-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,oBAAoB,CAAA;AAE/E,OAAO,EAAE,KAAK,SAAS,EAAgH,MAAM,qBAAqB,CAAA;AA8GlK,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE;IAC3F,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,+BA4MA"}

package/dist/types/field-editor.d.ts

@@ -8,7 +8,7 @@
  * widgets reach the sidecar through the injected `EditorContext`.
  */
 import type { FieldDefinition } from '@nuasite/cms-types';
-import type { CmsClient } from './client';
+import { type CmsClient } from '@nuasite/cms-client';
 /** Cross-cutting services a widget may need (media uploads, reference lookups). */
 export interface EditorContext {
     client: CmsClient;

package/dist/types/field-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-editor.d.ts","sourceRoot":"","sources":["../../src/field-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,oBAAoB,CAAA;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIzC,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,SAAS,CAAA;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,UAAU,gBAAgB;IACzB,KAAK,EAAE,eAAe,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,GAAG,EAAE,aAAa,CAAA;CAClB;AAwQD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,gBAAgB,+BA2C5E"}
+{"version":3,"file":"field-editor.d.ts","sourceRoot":"","sources":["../../src/field-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,oBAAoB,CAAA;AAEpE,OAAO,EAAE,KAAK,SAAS,EAAsF,MAAM,qBAAqB,CAAA;AAGxI,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,SAAS,CAAA;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,UAAU,gBAAgB;IACzB,KAAK,EAAE,eAAe,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,GAAG,EAAE,aAAa,CAAA;CAClB;AAwQD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,gBAAgB,+BA2C5E"}

package/dist/types/field-view.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Read-only field rendering, driven by a collection's `FieldDefinition`.
+ *
+ * Scalar types (text/number/boolean/date/select/image/url/email/tel/color) show
+ * their value directly; structural types (array/object/reference) show their
+ * structure. Nothing here mutates — editing arrives in F3.2.
+ */
+import type { FieldDefinition } from '@nuasite/cms-types';
+export declare function FieldValueView({ field, raw }: {
+    field: FieldDefinition;
+    raw: string | undefined;
+}): import("react").JSX.Element;
+export declare function FieldRow({ field, raw }: {
+    field: FieldDefinition;
+    raw: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=field-view.d.ts.map

package/dist/types/field-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-view.d.ts","sourceRoot":"","sources":["../../src/field-view.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,oBAAoB,CAAA;AAgDpE,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,+BAmBjG;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,+BAU3F"}

package/dist/types/field-view.js

@@ -0,0 +1,77 @@
+/**
+ * Read-only field rendering, driven by a collection's `FieldDefinition`.
+ *
+ * Scalar types (text/number/boolean/date/select/image/url/email/tel/color) show
+ * their value directly; structural types (array/object/reference) show their
+ * structure. Nothing here mutates — editing arrives in F3.2.
+ */
+/**
+ * Frontmatter values arrive from the sidecar already stringified
+ * (`{ value: string; line: number }`). For structural types the string is a
+ * JSON payload; we parse it best-effort for a structured render and fall back to
+ * the raw string when it is not JSON.
+ */
+function parseStructured(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return undefined;
+    if (!(trimmed.startsWith('{') || trimmed.startsWith('[')))
+        return raw;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return raw;
+    }
+}
+function StructuredValue({ raw }) {
+    const parsed = parseStructured(raw);
+    if (parsed === undefined) {
+        return <span className="nua-cadmin-field-empty">—</span>;
+    }
+    if (typeof parsed === 'string') {
+        return <span>{parsed}</span>;
+    }
+    return <pre className="nua-cadmin-field-structured">{JSON.stringify(parsed, null, 2)}</pre>;
+}
+function BooleanValue({ raw }) {
+    const on = raw === 'true' || raw === '1' || raw.toLowerCase() === 'yes';
+    return <span className={on ? 'nua-cadmin-bool-on' : 'nua-cadmin-bool-off'}>{on ? 'Yes' : 'No'}</span>;
+}
+function ImageValue({ raw }) {
+    if (raw === '')
+        return <span className="nua-cadmin-field-empty">—</span>;
+    const looksLikeUrl = /^(https?:\/\/|\/)/.test(raw);
+    return (<div>
+			{looksLikeUrl ? <img className="nua-cadmin-img" src={raw} alt=""/> : null}
+			<div className="nua-cadmin-cell-mono">{raw}</div>
+		</div>);
+}
+const STRUCTURAL_TYPES = new Set(['array', 'object', 'reference']);
+export function FieldValueView({ field, raw }) {
+    if (raw === undefined || raw === '') {
+        return <div className="nua-cadmin-field-value nua-cadmin-field-empty">—</div>;
+    }
+    let content;
+    switch (field.type) {
+        case 'boolean':
+            content = <BooleanValue raw={raw}/>;
+            break;
+        case 'image':
+        case 'file':
+            content = <ImageValue raw={raw}/>;
+            break;
+        default:
+            content = STRUCTURAL_TYPES.has(field.type) ? <StructuredValue raw={raw}/> : <span>{raw}</span>;
+    }
+    return <div className="nua-cadmin-field-value">{content}</div>;
+}
+export function FieldRow({ field, raw }) {
+    return (<div className="nua-cadmin-field">
+			<div className="nua-cadmin-field-label">
+				<span>{field.name}</span>
+				<span className="nua-cadmin-field-type">{field.type}{field.required ? " · required" : ""}</span>
+			</div>
+			<FieldValueView field={field} raw={raw}/>
+		</div>);
+}

package/dist/types/index.d.ts

@@ -7,6 +7,5 @@
  */
 export { CollectionsAdminApp, type CollectionsAdminAppProps } from './app';
 export { FIELD_TYPES, isFieldType } from '@nuasite/cms-types';
-export { type CmsApiError, type CmsCapabilities, type CmsClient, CmsClientError, type CmsConflict, type CmsEntriesListResult, type CmsErrorCode, type CmsPageEntry, type CmsProjectModel, createClient, type CreateEntryInput, type GetEntriesOptions, isMediaUnavailable, type MediaContext, type UpdateEntryInput, type UpdateEntryResult, } from './client';
-export type { EntryDraft } from './form-model';
+export { type CmsApiError, type CmsCapabilities, type CmsClient, CmsClientError, type CmsConflict, type CmsEntriesListResult, type CmsErrorCode, type CmsPageEntry, type CmsProjectModel, createClient, type CreateEntryInput, type EntryDraft, type GetEntriesOptions, isMediaUnavailable, type MediaContext, type UpdateEntryInput, type UpdateEntryResult, } from '@nuasite/cms-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAI1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAI1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAG7D,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,qBAAqB,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * `@nuasite/collections-admin` — read-only collections SPA over the cms-sidecar
+ * `/cms/v1` HTTP contract (cms-headless F3.1). Host-agnostic: mount
+ * `<CollectionsAdminApp apiBase={…} />` and it drives its own internal view-state
+ * navigation. Self-contained styles ship at `./styles.css` (imported by the app).
+ */
+export { CollectionsAdminApp } from './app';
+export { CmsClientError, createClient, } from './client';

package/dist/types/media-picker.d.ts

@@ -9,7 +9,7 @@
  * `listMedia`; on `unsupported`/`501` it disables upload and shows a hint while
  * keeping the manual URL field fully usable — the editor is never blocked on media.
  */
-import { type CmsClient } from './client';
+import { type CmsClient } from '@nuasite/cms-client';
 interface MediaPickerProps {
     client: CmsClient;
     value: string;

package/dist/types/media-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-picker.d.ts","sourceRoot":"","sources":["../../src/media-picker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,UAAU,CAAA;AAE7D,UAAU,gBAAgB;IACzB,MAAM,EAAE,SAAS,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AASD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,+BAiG1G"}
+{"version":3,"file":"media-picker.d.ts","sourceRoot":"","sources":["../../src/media-picker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,qBAAqB,CAAA;AAExE,UAAU,gBAAgB;IACzB,MAAM,EAAE,SAAS,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AASD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,+BAiG1G"}