@agntcms/next 0.2.0

package/dist/assets-Cyt9upqW.d.cts

@@ -0,0 +1,290 @@
+import { P as Page, w as PageSummary } from './form-BqY0H1V5.cjs';
+import { G as Global } from './global-CV23g5Bn.cjs';
+
+/** A page's publication mode. Used to select which storage bucket `readPage` reads from. */
+type PageMode = 'published' | 'draft';
+/**
+ * Lightweight summary of a history snapshot, returned by `listHistory`.
+ *
+ * `timestamp` is the filename stem (e.g. "2026-04-12T16-00-00.000Z"),
+ * not a parsed Date, because it is also used as the key for
+ * `readHistorySnapshot`. Keeping it as a string avoids lossy Date
+ * round-trips and keeps the API surface small.
+ */
+interface HistoryEntry {
+    readonly slug: string;
+    /** The filename stem, e.g. "2026-04-12T16-00-00.000Z". */
+    readonly timestamp: string;
+    /** File size in bytes. */
+    readonly size: number;
+}
+/**
+ * Lightweight summary of a draft page, returned by `listDrafts`.
+ *
+ * Kept intentionally small: the UI that lists drafts only needs "which
+ * pages have pending edits, and when were they last touched". Anything
+ * beyond this (author, diff stats, etc.) is out of scope for v1.
+ */
+interface DraftSummary {
+    readonly slug: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight list-entry for a published page, returned by `listPages`.
+ *
+ * BREAKING (v0.1.x → v0.1.y): renamed from `PageSummary` to
+ * `PublishedPageEntry` so the canonical `PageSummary` name can be claimed
+ * by the domain-layer metadata projection (`Omit<Page, 'sections'>`)
+ * exposed for blog-index-style listings (ARCHITECTURE.md §4). Templates
+ * that imported `PageSummary` from `@agntcms/next/server` to type the
+ * existing `listPages()` adapter return must rename their import — the
+ * shape (slug + updatedAt) is unchanged.
+ *
+ * Same shape as `DraftSummary` — kept as a separate type because the
+ * two collections have different semantic meaning and may diverge.
+ */
+interface PublishedPageEntry {
+    readonly slug: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Page-metadata-with-mtime tuple, returned by `listPageSummaries`.
+ *
+ * The adapter widens domain `PageSummary` (Omit<Page, 'sections'>) with
+ * an `updatedAt: Date` carrying the storage layer's "last modified"
+ * timestamp. The runtime uses this as the sort key when a page has no
+ * explicit `publishedAt` (ARCHITECTURE.md §4: mtime fallback). Adapters
+ * that don't track mtime (e.g. a remote API) MAY return the unix epoch
+ * to mean "unknown" — sorting will then put such pages at the end of a
+ * `'newest'` query and at the start of an `'oldest'` query, but never
+ * crash.
+ */
+interface PageSummaryEntry extends PageSummary {
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight summary of a global content block, returned by `listGlobals`.
+ */
+interface GlobalSummary {
+    readonly name: string;
+    readonly type: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight summary of a global history snapshot, returned by
+ * `listGlobalHistory`. Mirrors `HistoryEntry` for pages but keyed by
+ * global `name` instead of `slug`; the shape is kept symmetric so UI
+ * code that handles history listings can stay shape-agnostic.
+ */
+interface GlobalHistoryEntry {
+    readonly name: string;
+    /** The filename stem, e.g. "2026-04-12T16-00-00.000Z". */
+    readonly timestamp: string;
+    /** File size in bytes. */
+    readonly size: number;
+}
+/**
+ * Content storage adapter — the seam between the runtime and whatever
+ * persists pages and drafts. See the file header for the rationale
+ * behind this exact method set.
+ *
+ * All methods are async because a real implementation (FS, remote) is
+ * always IO-bound. Implementations MUST NOT throw for "not found"; they
+ * MUST return `null` from `readPage`.
+ */
+interface ContentStorageAdapter {
+    /**
+     * Read a page in the requested publication mode.
+     *
+     * Returns `null` when no file exists for `(slug, mode)`. Does NOT fall
+     * back across modes; composition is the runtime's responsibility.
+     */
+    readPage(slug: string, mode: PageMode): Promise<Page | null>;
+    /**
+     * Persist a draft of `page`. Overwrites any existing draft for the
+     * same slug. The draft storage bucket is distinct from the published
+     * bucket — `saveDraft` MUST NOT touch the published page.
+     */
+    saveDraft(page: Page): Promise<void>;
+    /**
+     * List all drafts currently on disk. Ordering is not specified by the
+     * contract; callers that need a particular order sort the result
+     * themselves.
+     */
+    listDrafts(): Promise<ReadonlyArray<DraftSummary>>;
+    /**
+     * List all published pages with minimal info (slug + mtime). Used by
+     * the admin pages list. Ordering is not specified by the contract;
+     * callers that need a particular order sort the result themselves.
+     */
+    listPages(): Promise<ReadonlyArray<PublishedPageEntry>>;
+    /**
+     * List published pages with metadata (slug + seo + tags + excerpt +
+     * coverImage + publishedAt + mtime). Used by the runtime's `listPages`
+     * (ARCHITECTURE.md §4) for blog-index-style queries.
+     *
+     * Distinct from the lighter `listPages()` because reading every page
+     * just to drop sections is wasteful for large sites; a dedicated
+     * summary read lets implementations parse only the metadata block.
+     * The default FS adapter still parses the whole file (small saving),
+     * but a remote adapter could expose a real summary endpoint.
+     *
+     * Ordering is not specified — the runtime sorts after the read.
+     */
+    listPageSummaries(): Promise<ReadonlyArray<PageSummaryEntry>>;
+    /**
+     * Promote the draft for `slug` to published, and write a new full
+     * snapshot into history (ARCHITECTURE.md §4: versioning is full
+     * snapshots, not patches). Returns the `Page` that was published so
+     * the runtime can thread it into its git-commit helper without an
+     * extra round-trip.
+     *
+     * Implementations MUST reject (throw) when no draft exists for the
+     * given slug — publishing nothing is meaningless and silent no-ops
+     * hide bugs in the edit flow.
+     */
+    publishDraft(slug: string): Promise<Page>;
+    /**
+     * Delete ONLY the draft for `slug`. Used by the "discard draft" flow.
+     *
+     * The published page and history are untouched — this operation is
+     * reversible in the sense that the live page remains, and the user can
+     * always reconstruct the discarded draft by editing again. Throws if no
+     * draft exists for the given slug (silent success would mask a caller
+     * bug, same discipline as `publishDraft`).
+     */
+    deleteDraft(slug: string): Promise<void>;
+    /** Delete a published page. Also removes its draft if one exists. History is preserved. */
+    readonly deletePage: (slug: string) => Promise<void>;
+    /**
+     * Unpublish a page: remove it from the live site while preserving
+     * editable content and version history. Behaviour depends on the
+     * current state of `slug`:
+     *
+     *   - No published page exists → throws. There is nothing to unpublish,
+     *     and silently succeeding would mask a caller bug.
+     *   - Published exists, no draft → the published page is converted
+     *     into a draft (so the editor still has something to work with),
+     *     and the published file is removed. Net: live URL 404s, draft
+     *     retained with the last-published content.
+     *   - Published exists, draft exists → only the published file is
+     *     removed. The draft is already the newer version (publishDraft
+     *     deletes the draft on publish, so any coexisting draft is by
+     *     definition post-publish) and is left untouched.
+     *
+     * History is NEVER touched by this method — the last publish already
+     * wrote a snapshot, and restore-from-history remains the recovery
+     * path if the user changes their mind.
+     */
+    unpublishPage(slug: string): Promise<void>;
+    /** List history snapshots for a page, newest first. Returns [] if no history exists. */
+    listHistory(slug: string): Promise<ReadonlyArray<HistoryEntry>>;
+    /** Read a specific history snapshot by slug and timestamp. Returns null if not found. */
+    readHistorySnapshot(slug: string, timestamp: string): Promise<Page | null>;
+    /**
+     * Atomically rename a page slug. Renames the published page, draft
+     * (if any), and history directory (if any). Throws if the source
+     * slug does not exist or the target slug already exists.
+     */
+    renamePage(fromSlug: string, toSlug: string): Promise<void>;
+    /** Read a global by name. Returns null if not found. */
+    readGlobal(name: string): Promise<Global | null>;
+    /**
+     * Save (create or overwrite) a global. No draft/publish cycle.
+     *
+     * Implementations MUST write a full-snapshot history entry on every
+     * save (same "full snapshot" rule as pages, ARCHITECTURE.md §4), with
+     * the same semantic de-dup: a save whose content deep-equals the most
+     * recent history snapshot does NOT create a new history entry.
+     */
+    saveGlobal(global: Global): Promise<void>;
+    /** List all globals. Ordering is not specified by the contract. */
+    listGlobals(): Promise<ReadonlyArray<GlobalSummary>>;
+    /** Delete a global by name. Throws if not found. */
+    deleteGlobal(name: string): Promise<void>;
+    /**
+     * List history snapshots for a global, newest first. Returns [] if
+     * no history exists for `name`. Mirrors `listHistory` for pages.
+     */
+    listGlobalHistory(name: string): Promise<ReadonlyArray<GlobalHistoryEntry>>;
+    /**
+     * Read a specific history snapshot by global name and timestamp.
+     * Returns null if not found. Mirrors `readHistorySnapshot` for pages.
+     */
+    readGlobalHistorySnapshot(name: string, timestamp: string): Promise<Global | null>;
+    /**
+     * Roll a global back to a specific history snapshot. Reads the
+     * snapshot and re-saves it via `saveGlobal`, which will decide
+     * whether a new history entry is written based on de-dup.
+     *
+     * Throws if the snapshot does not exist — there is nothing to roll
+     * back to in that case, and silent success would mask caller bugs
+     * (same discipline as `publishDraft` for pages).
+     */
+    rollbackGlobal(name: string, timestamp: string): Promise<void>;
+}
+
+/**
+ * Input for an asset upload. `bytes` is the raw file body, `filename`
+ * is a hint for naming and extension, `contentType` is the MIME type
+ * the adapter should associate with the uploaded object.
+ */
+interface AssetUploadInput {
+    readonly bytes: Uint8Array;
+    readonly filename: string;
+    readonly contentType: string;
+}
+/**
+ * Result of an asset upload. `url` is the public URL the uploaded bytes
+ * are served under; `filename` is the stored name the adapter chose
+ * (used by `EditableImage` to reference the asset independently of the
+ * URL base). The picker modal uses `filename` when inserting a freshly
+ * uploaded asset into the section payload.
+ */
+interface AssetUploadResult {
+    readonly url: string;
+    readonly filename: string;
+}
+/**
+ * A single entry in the result of `AssetStorageAdapter.list()`. Carries
+ * everything the image picker UI needs to render a card: the stored
+ * filename (for display + section-payload value), the public URL (for
+ * the `<img src>`), the content type when known, and the modification
+ * timestamp so the adapter can sort newest-first.
+ */
+interface AssetListEntry {
+    readonly filename: string;
+    readonly url: string;
+    readonly contentType: string | undefined;
+    readonly modifiedAt: Date;
+}
+/**
+ * Asset storage adapter — the seam between the runtime and whatever
+ * persists user-uploaded binary assets (primarily images via the
+ * EditableImage flow, per ARCHITECTURE.md §6).
+ *
+ * Two methods: `upload` ingests new bytes; `list` enumerates existing
+ * assets for the image picker. See the file header for why there is no
+ * `resolve` method.
+ */
+interface AssetStorageAdapter {
+    /**
+     * Persist the given bytes as an asset and return a public URL that
+     * serves them, alongside the stored filename. Implementations MUST
+     * NOT mutate `input.bytes`.
+     *
+     * The URL format is adapter-defined. For the default FS adapter
+     * (T-006), it is a path under `/assets/...` served by Next.js static
+     * file handling. For a remote adapter, it could be an absolute URL.
+     * Callers treat the returned string as opaque.
+     */
+    upload(input: AssetUploadInput): Promise<AssetUploadResult>;
+    /**
+     * Enumerate every asset in the store, newest first. Used by the image
+     * picker modal to let the user browse and re-insert existing assets
+     * without re-uploading.
+     */
+    list(): Promise<readonly AssetListEntry[]>;
+}
+
+export type { AssetStorageAdapter as A, ContentStorageAdapter as C, DraftSummary as D, GlobalSummary as G, HistoryEntry as H, PageMode as P, AssetUploadInput as a, AssetUploadResult as b, PageSummaryEntry as c, PublishedPageEntry as d };

package/dist/assets-P8OCigDG.d.ts

@@ -0,0 +1,290 @@
+import { P as Page, w as PageSummary } from './form-BqY0H1V5.js';
+import { G as Global } from './global-CV23g5Bn.js';
+
+/** A page's publication mode. Used to select which storage bucket `readPage` reads from. */
+type PageMode = 'published' | 'draft';
+/**
+ * Lightweight summary of a history snapshot, returned by `listHistory`.
+ *
+ * `timestamp` is the filename stem (e.g. "2026-04-12T16-00-00.000Z"),
+ * not a parsed Date, because it is also used as the key for
+ * `readHistorySnapshot`. Keeping it as a string avoids lossy Date
+ * round-trips and keeps the API surface small.
+ */
+interface HistoryEntry {
+    readonly slug: string;
+    /** The filename stem, e.g. "2026-04-12T16-00-00.000Z". */
+    readonly timestamp: string;
+    /** File size in bytes. */
+    readonly size: number;
+}
+/**
+ * Lightweight summary of a draft page, returned by `listDrafts`.
+ *
+ * Kept intentionally small: the UI that lists drafts only needs "which
+ * pages have pending edits, and when were they last touched". Anything
+ * beyond this (author, diff stats, etc.) is out of scope for v1.
+ */
+interface DraftSummary {
+    readonly slug: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight list-entry for a published page, returned by `listPages`.
+ *
+ * BREAKING (v0.1.x → v0.1.y): renamed from `PageSummary` to
+ * `PublishedPageEntry` so the canonical `PageSummary` name can be claimed
+ * by the domain-layer metadata projection (`Omit<Page, 'sections'>`)
+ * exposed for blog-index-style listings (ARCHITECTURE.md §4). Templates
+ * that imported `PageSummary` from `@agntcms/next/server` to type the
+ * existing `listPages()` adapter return must rename their import — the
+ * shape (slug + updatedAt) is unchanged.
+ *
+ * Same shape as `DraftSummary` — kept as a separate type because the
+ * two collections have different semantic meaning and may diverge.
+ */
+interface PublishedPageEntry {
+    readonly slug: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Page-metadata-with-mtime tuple, returned by `listPageSummaries`.
+ *
+ * The adapter widens domain `PageSummary` (Omit<Page, 'sections'>) with
+ * an `updatedAt: Date` carrying the storage layer's "last modified"
+ * timestamp. The runtime uses this as the sort key when a page has no
+ * explicit `publishedAt` (ARCHITECTURE.md §4: mtime fallback). Adapters
+ * that don't track mtime (e.g. a remote API) MAY return the unix epoch
+ * to mean "unknown" — sorting will then put such pages at the end of a
+ * `'newest'` query and at the start of an `'oldest'` query, but never
+ * crash.
+ */
+interface PageSummaryEntry extends PageSummary {
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight summary of a global content block, returned by `listGlobals`.
+ */
+interface GlobalSummary {
+    readonly name: string;
+    readonly type: string;
+    readonly updatedAt: Date;
+}
+/**
+ * Lightweight summary of a global history snapshot, returned by
+ * `listGlobalHistory`. Mirrors `HistoryEntry` for pages but keyed by
+ * global `name` instead of `slug`; the shape is kept symmetric so UI
+ * code that handles history listings can stay shape-agnostic.
+ */
+interface GlobalHistoryEntry {
+    readonly name: string;
+    /** The filename stem, e.g. "2026-04-12T16-00-00.000Z". */
+    readonly timestamp: string;
+    /** File size in bytes. */
+    readonly size: number;
+}
+/**
+ * Content storage adapter — the seam between the runtime and whatever
+ * persists pages and drafts. See the file header for the rationale
+ * behind this exact method set.
+ *
+ * All methods are async because a real implementation (FS, remote) is
+ * always IO-bound. Implementations MUST NOT throw for "not found"; they
+ * MUST return `null` from `readPage`.
+ */
+interface ContentStorageAdapter {
+    /**
+     * Read a page in the requested publication mode.
+     *
+     * Returns `null` when no file exists for `(slug, mode)`. Does NOT fall
+     * back across modes; composition is the runtime's responsibility.
+     */
+    readPage(slug: string, mode: PageMode): Promise<Page | null>;
+    /**
+     * Persist a draft of `page`. Overwrites any existing draft for the
+     * same slug. The draft storage bucket is distinct from the published
+     * bucket — `saveDraft` MUST NOT touch the published page.
+     */
+    saveDraft(page: Page): Promise<void>;
+    /**
+     * List all drafts currently on disk. Ordering is not specified by the
+     * contract; callers that need a particular order sort the result
+     * themselves.
+     */
+    listDrafts(): Promise<ReadonlyArray<DraftSummary>>;
+    /**
+     * List all published pages with minimal info (slug + mtime). Used by
+     * the admin pages list. Ordering is not specified by the contract;
+     * callers that need a particular order sort the result themselves.
+     */
+    listPages(): Promise<ReadonlyArray<PublishedPageEntry>>;
+    /**
+     * List published pages with metadata (slug + seo + tags + excerpt +
+     * coverImage + publishedAt + mtime). Used by the runtime's `listPages`
+     * (ARCHITECTURE.md §4) for blog-index-style queries.
+     *
+     * Distinct from the lighter `listPages()` because reading every page
+     * just to drop sections is wasteful for large sites; a dedicated
+     * summary read lets implementations parse only the metadata block.
+     * The default FS adapter still parses the whole file (small saving),
+     * but a remote adapter could expose a real summary endpoint.
+     *
+     * Ordering is not specified — the runtime sorts after the read.
+     */
+    listPageSummaries(): Promise<ReadonlyArray<PageSummaryEntry>>;
+    /**
+     * Promote the draft for `slug` to published, and write a new full
+     * snapshot into history (ARCHITECTURE.md §4: versioning is full
+     * snapshots, not patches). Returns the `Page` that was published so
+     * the runtime can thread it into its git-commit helper without an
+     * extra round-trip.
+     *
+     * Implementations MUST reject (throw) when no draft exists for the
+     * given slug — publishing nothing is meaningless and silent no-ops
+     * hide bugs in the edit flow.
+     */
+    publishDraft(slug: string): Promise<Page>;
+    /**
+     * Delete ONLY the draft for `slug`. Used by the "discard draft" flow.
+     *
+     * The published page and history are untouched — this operation is
+     * reversible in the sense that the live page remains, and the user can
+     * always reconstruct the discarded draft by editing again. Throws if no
+     * draft exists for the given slug (silent success would mask a caller
+     * bug, same discipline as `publishDraft`).
+     */
+    deleteDraft(slug: string): Promise<void>;
+    /** Delete a published page. Also removes its draft if one exists. History is preserved. */
+    readonly deletePage: (slug: string) => Promise<void>;
+    /**
+     * Unpublish a page: remove it from the live site while preserving
+     * editable content and version history. Behaviour depends on the
+     * current state of `slug`:
+     *
+     *   - No published page exists → throws. There is nothing to unpublish,
+     *     and silently succeeding would mask a caller bug.
+     *   - Published exists, no draft → the published page is converted
+     *     into a draft (so the editor still has something to work with),
+     *     and the published file is removed. Net: live URL 404s, draft
+     *     retained with the last-published content.
+     *   - Published exists, draft exists → only the published file is
+     *     removed. The draft is already the newer version (publishDraft
+     *     deletes the draft on publish, so any coexisting draft is by
+     *     definition post-publish) and is left untouched.
+     *
+     * History is NEVER touched by this method — the last publish already
+     * wrote a snapshot, and restore-from-history remains the recovery
+     * path if the user changes their mind.
+     */
+    unpublishPage(slug: string): Promise<void>;
+    /** List history snapshots for a page, newest first. Returns [] if no history exists. */
+    listHistory(slug: string): Promise<ReadonlyArray<HistoryEntry>>;
+    /** Read a specific history snapshot by slug and timestamp. Returns null if not found. */
+    readHistorySnapshot(slug: string, timestamp: string): Promise<Page | null>;
+    /**
+     * Atomically rename a page slug. Renames the published page, draft
+     * (if any), and history directory (if any). Throws if the source
+     * slug does not exist or the target slug already exists.
+     */
+    renamePage(fromSlug: string, toSlug: string): Promise<void>;
+    /** Read a global by name. Returns null if not found. */
+    readGlobal(name: string): Promise<Global | null>;
+    /**
+     * Save (create or overwrite) a global. No draft/publish cycle.
+     *
+     * Implementations MUST write a full-snapshot history entry on every
+     * save (same "full snapshot" rule as pages, ARCHITECTURE.md §4), with
+     * the same semantic de-dup: a save whose content deep-equals the most
+     * recent history snapshot does NOT create a new history entry.
+     */
+    saveGlobal(global: Global): Promise<void>;
+    /** List all globals. Ordering is not specified by the contract. */
+    listGlobals(): Promise<ReadonlyArray<GlobalSummary>>;
+    /** Delete a global by name. Throws if not found. */
+    deleteGlobal(name: string): Promise<void>;
+    /**
+     * List history snapshots for a global, newest first. Returns [] if
+     * no history exists for `name`. Mirrors `listHistory` for pages.
+     */
+    listGlobalHistory(name: string): Promise<ReadonlyArray<GlobalHistoryEntry>>;
+    /**
+     * Read a specific history snapshot by global name and timestamp.
+     * Returns null if not found. Mirrors `readHistorySnapshot` for pages.
+     */
+    readGlobalHistorySnapshot(name: string, timestamp: string): Promise<Global | null>;
+    /**
+     * Roll a global back to a specific history snapshot. Reads the
+     * snapshot and re-saves it via `saveGlobal`, which will decide
+     * whether a new history entry is written based on de-dup.
+     *
+     * Throws if the snapshot does not exist — there is nothing to roll
+     * back to in that case, and silent success would mask caller bugs
+     * (same discipline as `publishDraft` for pages).
+     */
+    rollbackGlobal(name: string, timestamp: string): Promise<void>;
+}
+
+/**
+ * Input for an asset upload. `bytes` is the raw file body, `filename`
+ * is a hint for naming and extension, `contentType` is the MIME type
+ * the adapter should associate with the uploaded object.
+ */
+interface AssetUploadInput {
+    readonly bytes: Uint8Array;
+    readonly filename: string;
+    readonly contentType: string;
+}
+/**
+ * Result of an asset upload. `url` is the public URL the uploaded bytes
+ * are served under; `filename` is the stored name the adapter chose
+ * (used by `EditableImage` to reference the asset independently of the
+ * URL base). The picker modal uses `filename` when inserting a freshly
+ * uploaded asset into the section payload.
+ */
+interface AssetUploadResult {
+    readonly url: string;
+    readonly filename: string;
+}
+/**
+ * A single entry in the result of `AssetStorageAdapter.list()`. Carries
+ * everything the image picker UI needs to render a card: the stored
+ * filename (for display + section-payload value), the public URL (for
+ * the `<img src>`), the content type when known, and the modification
+ * timestamp so the adapter can sort newest-first.
+ */
+interface AssetListEntry {
+    readonly filename: string;
+    readonly url: string;
+    readonly contentType: string | undefined;
+    readonly modifiedAt: Date;
+}
+/**
+ * Asset storage adapter — the seam between the runtime and whatever
+ * persists user-uploaded binary assets (primarily images via the
+ * EditableImage flow, per ARCHITECTURE.md §6).
+ *
+ * Two methods: `upload` ingests new bytes; `list` enumerates existing
+ * assets for the image picker. See the file header for why there is no
+ * `resolve` method.
+ */
+interface AssetStorageAdapter {
+    /**
+     * Persist the given bytes as an asset and return a public URL that
+     * serves them, alongside the stored filename. Implementations MUST
+     * NOT mutate `input.bytes`.
+     *
+     * The URL format is adapter-defined. For the default FS adapter
+     * (T-006), it is a path under `/assets/...` served by Next.js static
+     * file handling. For a remote adapter, it could be an absolute URL.
+     * Callers treat the returned string as opaque.
+     */
+    upload(input: AssetUploadInput): Promise<AssetUploadResult>;
+    /**
+     * Enumerate every asset in the store, newest first. Used by the image
+     * picker modal to let the user browse and re-insert existing assets
+     * without re-uploading.
+     */
+    list(): Promise<readonly AssetListEntry[]>;
+}
+
+export type { AssetStorageAdapter as A, ContentStorageAdapter as C, DraftSummary as D, GlobalSummary as G, HistoryEntry as H, PageMode as P, AssetUploadInput as a, AssetUploadResult as b, PageSummaryEntry as c, PublishedPageEntry as d };