@nuasite/collections-admin 0.43.0-beta.1

package/dist/types/app.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 './styles.css';
+export interface CollectionsAdminAppProps {
+    /**
+     * Base URL the cms-sidecar is mounted under (the host adds the `/cms/v1`
+     * prefix). In webmaster this is `/app/project/:slug/session/:sessionId/cms`.
+     */
+    apiBase: string;
+    /** Optional close affordance shown in the header (e.g. to collapse the WM tab). */
+    onClose?: () => void;
+}
+export declare function CollectionsAdminApp({ apiBase, onClose }: CollectionsAdminAppProps): import("react").JSX.Element;
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,cAAc,CAAA;AA2PrB,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,wBAAwB,+BAkDjF"}

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.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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.
+ */
+import type { CollectionDefinition, CollectionEntry, CollectionEntryInfo } from '@nuasite/cms-types';
+/** Stable error codes the sidecar exposes, each mapped to an HTTP status. */
+export type CmsErrorCode = 'not_found' | 'conflict' | 'validation' | 'parse_error' | 'io_error' | 'unsupported' | 'unauthorized';
+/** JSON body returned for every non-2xx response that is not a conflict. */
+export interface CmsApiError {
+    error: string;
+    code: CmsErrorCode;
+    sourcePath?: string;
+}
+/** A static page route discovered under `src/pages` (pathname-only). */
+export interface CmsPageEntry {
+    pathname: string;
+    title?: string;
+}
+/** Features the sidecar advertises so the UI can degrade gracefully. */
+export interface CmsCapabilities {
+    coreVersion: string;
+    features: string[];
+}
+/** `GET /project` — the whole structural model in one call. */
+export interface CmsProjectModel {
+    collections: CollectionDefinition[];
+    pages: CmsPageEntry[];
+    capabilities: CmsCapabilities;
+}
+/** `GET …/entries` — projected entries plus an opaque continuation cursor. */
+export interface CmsEntriesListResult {
+    entries: CollectionEntryInfo[];
+    cursor?: string;
+    hasMore: boolean;
+}
+/**
+ * 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 declare class CmsClientError extends Error {
+    readonly status: number;
+    readonly code: CmsErrorCode | 'forbidden' | 'unknown';
+    constructor(status: number, code: CmsErrorCode | 'forbidden' | 'unknown', message: string);
+    /** Session cookie missing/expired upstream — the user must re-authenticate. */
+    get isUnauthorized(): boolean;
+    /** Authenticated but lacks access to this project. */
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+}
+export interface GetEntriesOptions {
+    /** "slug,title" | "*" ; absent = light header (slug/title/draft/pathname). */
+    fields?: string;
+    /** Draft filter — defaults to `'false'` (published only) on the sidecar. */
+    draft?: 'true' | 'false' | 'all';
+    /** Opaque continuation cursor from a previous page's `cursor`. */
+    cursor?: string;
+    limit?: number;
+}
+export interface CmsClient {
+    getProject(): Promise<CmsProjectModel>;
+    getCollections(): Promise<CollectionDefinition[]>;
+    getEntries(collection: string, options?: GetEntriesOptions): Promise<CmsEntriesListResult>;
+    getEntry(collection: string, slug: string): Promise<CollectionEntry>;
+}
+export declare function createClient(apiBase: string): CmsClient;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAMpG,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GACrB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,aAAa,GACb,UAAU,GACV,aAAa,GACb,cAAc,CAAA;AAEjB,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,YAAY,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,YAAY,EAAE,eAAe,CAAA;CAC7B;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CAChB;AAMD;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS;gBAD5C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,EACrD,OAAO,EAAE,MAAM;IAMhB,+EAA+E;IAC/E,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,sDAAsD;IACtD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;CACD;AAMD,MAAM,WAAW,iBAAiB;IACjC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;IAChC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AA6BD,MAAM,WAAW,SAAS;IACzB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;IACtC,cAAc,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACjD,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC1F,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACpE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAuEvD"}

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/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

@@ -0,0 +1,10 @@
+/**
+ * `@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, type CollectionsAdminAppProps } from './app';
+export { FIELD_TYPES, isFieldType } from '@nuasite/cms-types';
+export { type CmsApiError, type CmsCapabilities, type CmsClient, CmsClientError, type CmsEntriesListResult, type CmsErrorCode, type CmsPageEntry, type CmsProjectModel, createClient, type GetEntriesOptions, } from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,iBAAiB,GACtB,MAAM,UAAU,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';