dineway 0.1.45 → 0.1.46

package/dist/{runtime-1bE80cmL.d.mts → runtime-Cd-kjPfN.d.mts}

@@ -1,17 +1,18 @@
-import { a as ContentSeoInput, c as FindManyOptions, l as FindManyResult, o as CreateContentInput, r as ContentItem, t as BylineSummary, u as UpdateContentInput } from "./types-DvwHUku7.mjs";
-import { t as Database } from "./types-C-CMfzSl.mjs";
-import { A as PageMetadataContribution, B as PluginDefinition, D as PageFragmentContribution, H as PluginManifest, J as RequestMeta, O as PageFragmentEvent, W as PluginStorageConfig, X as ResolvedPlugin, a as CommentAfterModerateEvent, g as EmailMessage, h as CronEvent, j as PageMetadataEvent, r as CommentAfterCreateEvent, s as CommentBeforeCreateEvent, tt as StandardPluginDefinition, w as MediaItem$1 } from "./types-BIM7jwxr.mjs";
-import { a as Collection, b as UpdateFieldInput, c as CollectionWithFields, d as CreateFieldInput, p as Field, u as CreateCollectionInput, y as UpdateCollectionInput } from "./types-t7_nCCA9.mjs";
-import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-BgE6gMFI.mjs";
-import { t as DatabaseDescriptor } from "./adapters-kZjS7plb.mjs";
-import { d as MediaProviderDescriptor } from "./types-cn-fvYQ1.mjs";
-import { xt as PortableTextBlock$1 } from "./index-Ct0pjZwW.mjs";
-import { S as ContentBylineInput } from "./index-BwOO3vu2.mjs";
-import { d as Storage } from "./types-BYjPylrZ.mjs";
+import { _ as UpdateFieldInput, f as FieldValidation, g as UpdateCollectionInput, i as CollectionWithFields, o as CreateCollectionInput, s as CreateFieldInput, t as Collection, u as Field } from "./types-DEAQG87T.mjs";
+import { a as ContentSeoInput, c as FindManyOptions, l as FindManyResult, o as CreateContentInput, r as ContentItem, t as BylineSummary, u as UpdateContentInput } from "./types-B7_vSiPD.mjs";
+import { t as Database } from "./types-DYKtk8f1.mjs";
+import { A as PageMetadataContribution, B as PluginDefinition, D as PageFragmentContribution, H as PluginManifest, J as RequestMeta, O as PageFragmentEvent, W as PluginStorageConfig, X as ResolvedPlugin, a as CommentAfterModerateEvent, g as EmailMessage, h as CronEvent, j as PageMetadataEvent, r as CommentAfterCreateEvent, s as CommentBeforeCreateEvent, tt as StandardPluginDefinition, w as MediaItem$1 } from "./types-UGmU5sWx.mjs";
+import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-Dryvv7LH.mjs";
+import { t as DatabaseDescriptor } from "./adapters-OQCImOL7.mjs";
+import { _ as MediaValue, m as MediaProviderDescriptor } from "./placeholder-CXfoCtCd.mjs";
+import { S as ContentBylineInput } from "./index-DJVaYiUV.mjs";
+import { d as Storage } from "./types-DZpT-PnG.mjs";
+import { i as SiteSettings, r as SiteSettingKey } from "./types-nP9vGUFq.mjs";
 import { Kysely } from "kysely";
-import { z } from "zod";
-import { MiddlewareHandler } from "astro";
+import { z } from "astro/zod";
+import { z as z$1 } from "zod";
 import { LiveLoader } from "astro/loaders";
+import { MiddlewareHandler } from "astro";
 
 //#region src/api/types.d.ts
 /**
@@ -20,6 +21,11 @@ import { LiveLoader } from "astro/loaders";
 interface ListResponse<T> {
   items: T[];
   nextCursor?: string;
+  /**
+   * Total number of rows matching filters, ignoring pagination. Optional so
+   * list handlers that do not surface a count do not need an extra query.
+   */
+  total?: number;
 }
 /**
  * Content API responses
@@ -131,7 +137,7 @@ type ParseResult<T> = T | Response;
  * Returns the validated data on success, or a 400 Response on failure.
  * Replaces all `(await request.json()) as T` casts.
  */
-declare function parseBody<T extends z.ZodType>(request: Request, schema: T): Promise<ParseResult<z.infer<T>>>;
+declare function parseBody<T extends z$1.ZodType>(request: Request, schema: T): Promise<ParseResult<z$1.infer<T>>>;
 /**
  * Parse and validate URL search params against a Zod schema.
  *
@@ -139,7 +145,7 @@ declare function parseBody<T extends z.ZodType>(request: Request, schema: T): Pr
  * Zod coercion handles string -> number/boolean conversion.
  * Replaces manual `url.searchParams.get()` + `parseInt()` patterns.
  */
-declare function parseQuery<T extends z.ZodType>(url: URL, schema: T): ParseResult<z.infer<T>>;
+declare function parseQuery<T extends z$1.ZodType>(url: URL, schema: T): ParseResult<z$1.infer<T>>;
 /**
  * Type guard to check if a ParseResult is an error Response.
  * Usage: `if (isParseError(result)) return result;`
@@ -205,15 +211,21 @@ declare class OptionsRepository {
   deleteByPrefix(prefix: string): Promise<number>;
 }
 //#endregion
+//#region src/database/errors.d.ts
+/**
+ * Database error types. Keep these free of driver imports so public barrels can
+ * re-export them without loading native database drivers for unused dialects.
+ */
+declare class DinewayDatabaseError extends Error {
+  cause?: unknown | undefined;
+  constructor(message: string, cause?: unknown | undefined);
+}
+//#endregion
 //#region src/database/connection.d.ts
 interface DatabaseConfig {
   url: string;
   authToken?: string;
 }
-declare class DinewayDatabaseError extends Error {
-  cause?: unknown | undefined;
-  constructor(message: string, cause?: unknown | undefined);
-}
 //#endregion
 //#region src/database/repositories/content.d.ts
 /**
@@ -311,7 +323,14 @@ declare class ContentRepository {
     status?: string;
     authorId?: string;
     locale?: string;
+    q?: string;
+    searchColumns?: string[];
   }): Promise<number>;
+  /**
+   * Apply an optional case-insensitive substring search across handler-resolved
+   * columns. User input is treated literally by escaping LIKE wildcards.
+   */
+  private applySearchFilter;
   getStats(type: string): Promise<{
     total: number;
     published: number;
@@ -441,6 +460,8 @@ interface FindManyMediaOptions {
   /** Filter by MIME type. Entries ending with "/" are prefix matches; other entries are exact matches. */
   mimeType?: string | readonly string[];
   status?: MediaStatus | "all";
+  /** Case-insensitive substring matched against the filename, including extensions. */
+  q?: string;
 }
 /**
  * Media repository for database operations
@@ -532,6 +553,103 @@ interface Revision {
   createdAt: string;
 }
 //#endregion
+//#region src/database/repositories/comment.d.ts
+/** Public-facing comment shape — no private fields */
+interface PublicComment {
+  id: string;
+  parentId: string | null;
+  authorName: string;
+  isRegisteredUser: boolean;
+  body: string;
+  createdAt: string;
+  replies?: PublicComment[];
+}
+//#endregion
+//#region src/fields/types.d.ts
+/**
+ * SQLite column types that map from field types
+ */
+type ColumnType = "TEXT" | "REAL" | "INTEGER" | "JSON";
+/**
+ * Base field definition
+ *
+ * Note: schema uses z.ZodTypeAny to accommodate optional/default wrappers
+ */
+interface FieldDefinition<_T = unknown> {
+  type: string;
+  /**
+   * The SQLite column type to use when storing this field
+   */
+  columnType: ColumnType;
+  schema: z.ZodTypeAny;
+  options?: unknown;
+  ui?: FieldUIHints;
+  validation?: FieldValidation;
+}
+/**
+ * UI hints for admin rendering
+ */
+interface FieldUIHints {
+  widget?: string;
+  placeholder?: string;
+  helpText?: string;
+  rows?: number;
+  min?: number | string;
+  max?: number | string;
+  [key: string]: unknown;
+}
+/**
+ * Portable Text block structure
+ */
+interface PortableTextBlock$1 {
+  _type: string;
+  _key: string;
+  [key: string]: unknown;
+}
+/**
+ * @deprecated Use MediaValue instead. ImageValue is an alias for backwards compatibility.
+ */
+type ImageValue = MediaValue;
+/**
+ * File field value
+ */
+interface FileValue {
+  id: string;
+  url: string;
+  filename: string;
+  mimeType: string;
+  size: number;
+}
+//#endregion
+//#region src/fields/image.d.ts
+/**
+ * Image field
+ * References media items from the media library
+ */
+declare function image(options?: {
+  required?: boolean;
+  maxSize?: number;
+  allowedTypes?: string[];
+}): FieldDefinition<ImageValue | undefined>;
+//#endregion
+//#region src/fields/reference.d.ts
+/**
+ * Reference field
+ * References another content item by ID
+ */
+declare function reference(collection: string, options?: {
+  required?: boolean;
+}): FieldDefinition<string | undefined>;
+//#endregion
+//#region src/fields/portable-text.d.ts
+/**
+ * Portable Text field
+ * Stores structured content in Portable Text format
+ */
+declare function portableText(options?: {
+  required?: boolean;
+}): FieldDefinition<PortableTextBlock$1[] | undefined>;
+//#endregion
 //#region src/api/handlers/content.d.ts
 /**
  * Trashed content item with deletion timestamp
@@ -558,6 +676,7 @@ declare function handleContentList(db: Kysely<Database>, collection: string, par
   orderBy?: string;
   order?: "asc" | "desc";
   locale?: string;
+  q?: string;
 }): Promise<ApiResult<ContentListResponse>>;
 /**
  * Get single content item
@@ -600,6 +719,7 @@ declare function handleContentUpdate(db: Kysely<Database>, collection: string, i
   status?: string;
   authorId?: string | null;
   bylines?: ContentBylineInput[];
+  locale?: string;
   _rev?: string;
   seo?: ContentSeoInput;
   publishedAt?: string | null;
@@ -770,6 +890,7 @@ declare function handleMediaList(db: Kysely<Database>, params: {
   cursor?: string;
   limit?: number;
   mimeType?: string | readonly string[];
+  q?: string;
 }): Promise<ApiResult<MediaListResponse>>;
 /**
  * Get single media item
@@ -972,6 +1093,22 @@ declare class SchemaRegistry {
   private slugToLabel;
 }
 //#endregion
+//#region src/schema/query.d.ts
+/**
+ * Get collection metadata by slug.
+ *
+ * @example
+ * ```ts
+ * import { getCollectionInfo } from "dineway";
+ *
+ * const info = await getCollectionInfo("posts");
+ * if (info?.commentsEnabled) {
+ *   // render comment UI
+ * }
+ * ```
+ */
+declare function getCollectionInfo(slug: string): Promise<Collection | null>;
+//#endregion
 //#region src/sections/types.d.ts
 /**
  * Section source types
@@ -1285,6 +1422,14 @@ interface PortableTextCodeBlock {
   language?: string;
   filename?: string;
 }
+/**
+ * HTML block (raw HTML content)
+ */
+interface PortableTextHtmlBlock {
+  _type: "htmlBlock";
+  _key: string;
+  html: string;
+}
 /**
  * Unknown/custom block (preserved for plugin compatibility)
  */
@@ -1296,7 +1441,7 @@ interface PortableTextUnknownBlock {
 /**
  * Any Portable Text block
  */
-type PortableTextBlock = PortableTextTextBlock | PortableTextImageBlock | PortableTextCodeBlock | PortableTextUnknownBlock;
+type PortableTextBlock = PortableTextTextBlock | PortableTextImageBlock | PortableTextCodeBlock | PortableTextHtmlBlock | PortableTextUnknownBlock;
 /**
  * ProseMirror JSON types (simplified for TipTap)
  */
@@ -1345,145 +1490,35 @@ declare function hashString(content: string): Promise<string>;
  */
 declare function computeContentHash(content: Uint8Array | ArrayBuffer): Promise<string>;
 //#endregion
-//#region src/after.d.ts
+//#region src/utils/url.d.ts
 /**
- * Defer work past the current synchronous path.
+ * URL scheme validation utilities
  *
- * Use this for best-effort bookkeeping that should not block runtime
- * initialization or response handling. Node keeps the process alive for
- * pending work; callers that need stronger durability should await their own
- * operation instead of using this helper.
+ * Prevents XSS via dangerous URL schemes (javascript:, data:, vbscript:, etc.)
+ * by allowlisting known-safe schemes before rendering into href attributes.
  */
-type AfterCallback = () => void | Promise<void>;
-declare function after(fn: AfterCallback): void;
-//#endregion
-//#region src/i18n/config.d.ts
 /**
- * Dineway i18n Configuration
+ * Returns the URL unchanged if it uses a safe scheme, otherwise returns "#".
  *
- * Reads locale configuration from the virtual module (sourced from Astro config).
- * Initialized during runtime startup, then available via getI18nConfig().
- */
-interface I18nConfig {
-  defaultLocale: string;
-  locales: string[];
-  fallback?: Record<string, string>;
-  prefixDefaultLocale?: boolean;
-}
-/**
- * Get the current i18n config.
- * Returns null if i18n is not configured.
- */
-declare function getI18nConfig(): I18nConfig | null;
-/**
- * Check if i18n is enabled.
- * Returns true when multiple locales are configured.
- */
-declare function isI18nEnabled(): boolean;
-/**
- * Resolve fallback locale chain for a given locale.
- * Returns array of locales to try, from most preferred to least.
- * Always ends with defaultLocale.
+ * Use this at the render layer as the primary defense against XSS via
+ * dangerous URL schemes like `javascript:`, `data:`, or `vbscript:`.
+ *
+ * @example
+ * ```ts
+ * sanitizeHref("https://example.com")        // "https://example.com"
+ * sanitizeHref("/about")                      // "/about"
+ * sanitizeHref("#section")                    // "#section"
+ * sanitizeHref("mailto:a@b.com")              // "mailto:a@b.com"
+ * sanitizeHref("javascript:alert(1)")         // "#"
+ * sanitizeHref("data:text/html,<script>")     // "#"
+ * sanitizeHref("")                            // "#"
+ * ```
  */
-declare function getFallbackChain(locale: string): string[];
-//#endregion
-//#region src/preview/sidecar-client.d.ts
+declare function sanitizeHref(url: string | undefined | null): string;
 /**
- * Preview sidecar protocol helpers.
- *
- * These utilities define the signed URL and snapshot-auth contract shared
- * by preview sidecars and the source site serving snapshot exports.
+ * Returns true if the URL uses a safe scheme for rendering in href attributes.
  */
-interface PreviewSidecarSignature {
-  source: string;
-  exp: number;
-  sig: string;
-}
-interface PreviewSidecarClient {
-  signPreviewUrl(previewBase: string, source: string, secret: string, ttl?: number): Promise<string>;
-  buildSnapshotSignatureHeader(signature: PreviewSidecarSignature): string;
-}
-declare function signPreviewUrl(previewBase: string, source: string, secret: string, ttl?: number): Promise<string>;
-declare function buildPreviewSignatureHeader(signature: PreviewSidecarSignature): string;
-declare function parsePreviewSignatureHeader(header: string): PreviewSidecarSignature | null;
-declare function verifyPreviewSignature(source: string, exp: number, sig: string, secret: string): Promise<boolean>;
-declare const defaultPreviewSidecarClient: PreviewSidecarClient;
-//#endregion
-//#region src/preview/session-database-factory.d.ts
-interface SessionDatabaseInfo {
-  id: string;
-  dbPath: string;
-  createdAt: number;
-  expiresAt: number;
-  lastTouchedAt: number;
-}
-interface SessionDatabaseHandle {
-  created: boolean;
-  session: SessionDatabaseInfo;
-  db: Kysely<Database>;
-  close(): Promise<void>;
-}
-interface SessionCleanupResult {
-  removedSessionIds: string[];
-  removedPaths: string[];
-}
-interface SessionOpenOptions {
-  id: string;
-  now?: number;
-}
-interface SessionOpenOrCreateOptions extends SessionOpenOptions {
-  ttlMs: number;
-}
-interface SessionDatabaseFactory {
-  open(input: SessionOpenOptions): Promise<SessionDatabaseHandle | null>;
-  openOrCreate(input: SessionOpenOrCreateOptions): Promise<SessionDatabaseHandle>;
-  destroy(id: string): Promise<boolean>;
-  cleanup(now?: number): Promise<SessionCleanupResult>;
-  close(): Promise<void>;
-}
-interface FileSessionDatabaseFactoryOptions {
-  rootDir: string;
-  maxDiskBytes?: number;
-  registryFileName?: string;
-  sessionsDirName?: string;
-}
-declare class SessionDatabaseLimitError extends Error {
-  constructor(message?: string);
-}
-declare class FileSessionDatabaseFactory implements SessionDatabaseFactory {
-  private readonly options;
-  private readonly registry;
-  private readonly sessionsDir;
-  private readonly maxDiskBytes;
-  constructor(options: FileSessionDatabaseFactoryOptions);
-  open(input: SessionOpenOptions): Promise<SessionDatabaseHandle | null>;
-  openOrCreate(input: SessionOpenOrCreateOptions): Promise<SessionDatabaseHandle>;
-  destroy(id: string): Promise<boolean>;
-  cleanup(now?: number): Promise<SessionCleanupResult>;
-  close(): Promise<void>;
-  private createHandle;
-  private getSessionRow;
-  private toSessionInfo;
-  private deleteSession;
-  private getActiveDiskBytes;
-  private getDbPath;
-  private getManagedPaths;
-  private listSessionRows;
-  private listDbPathRows;
-}
-//#endregion
-//#region src/preview/middleware.d.ts
-interface FilePreviewMiddlewareConfig {
-  rootDir?: string;
-  secret: string;
-  ttlSeconds?: number;
-  cookieName?: string;
-  snapshotPath?: string;
-  maxSessionDiskBytes?: number;
-  sessionFactory?: SessionDatabaseFactory;
-  fetch?: typeof globalThis.fetch;
-}
-declare function createFilePreviewMiddleware(config: FilePreviewMiddlewareConfig): MiddlewareHandler;
+declare function isSafeHref(url: string): boolean;
 //#endregion
 //#region src/loader.d.ts
 /**
@@ -1493,17 +1528,28 @@ type EntryData = Record<string, unknown>;
 /**
  * Sort direction
  */
-type SortDirection = "asc" | "desc";
+type SortDirection$1 = "asc" | "desc";
 /**
  * Order by specification - field name to direction
  * @example { created_at: "desc" } - Sort by created_at descending
  * @example { title: "asc" } - Sort by title ascending
  */
-type OrderBySpec = Record<string, SortDirection>;
+type OrderBySpec$1 = Record<string, SortDirection$1>;
+/**
+ * Range filter for comparison operators on field values.
+ * ISO 8601 timestamps sort lexicographically in the same order as time.
+ */
+interface WhereRange {
+  gt?: string;
+  gte?: string;
+  lt?: string;
+  lte?: string;
+}
+type WhereValue = string | string[] | WhereRange;
 /**
  * Filter for loadCollection - type is required
  */
-interface CollectionFilter {
+interface CollectionFilter$1 {
   type: string;
   status?: "draft" | "published" | "archived";
   limit?: number;
@@ -1513,14 +1559,17 @@ interface CollectionFilter {
    */
   cursor?: string;
   /**
-   * Filter by field values or taxonomy terms
+   * Filter by field values, taxonomy terms, or ranges.
+   *
+   * Taxonomy names are detected automatically and filtered via JOIN.
+   * Other keys are treated as content table column filters.
    */
-  where?: Record<string, string | string[]>;
+  where?: Record<string, WhereValue>;
   /**
    * Order results by field(s)
    * @default { created_at: "desc" }
    */
-  orderBy?: OrderBySpec;
+  orderBy?: OrderBySpec$1;
   /**
    * Filter by locale (e.g. 'en', 'fr').
    * When set, only returns content in this locale.
@@ -1577,37 +1626,485 @@ declare function getDb(): Promise<Kysely<Database>>;
  * };
  * ```
  */
-declare function dinewayLoader(): LiveLoader<EntryData, EntryFilter, CollectionFilter>;
+declare function dinewayLoader(): LiveLoader<EntryData, EntryFilter, CollectionFilter$1>;
 //#endregion
-//#region src/plugins/define-plugin.d.ts
+//#region src/visual-editing/editable.d.ts
 /**
- * Define a Dineway plugin.
+ * Visual editing annotation system
  *
- * **Standard format** -- the canonical format for plugins that work in both
- * trusted and sandboxed modes. No id/version -- those come from the descriptor.
+ * Creates Proxy objects that emit data-dineway-ref attributes when spread onto elements.
+ */
+interface CMSAnnotation {
+  collection: string;
+  id: string;
+  field?: string;
+  /** Entry status — only present on entry-level annotations (not field-level) */
+  status?: string;
+  /** Whether the entry has unpublished draft changes */
+  hasDraft?: boolean;
+}
+/** The shape returned when spreading an edit annotation onto an element */
+interface FieldAnnotation {
+  "data-dineway-ref": string;
+}
+interface EditableOptions {
+  /** Entry status: "draft", "published", "scheduled" */
+  status?: string;
+  /** true when draftRevisionId exists and differs from liveRevisionId */
+  hasDraft?: boolean;
+}
+/**
+ * Create an editable proxy for an entry.
  *
- * @example
- * ```typescript
- * import { definePlugin } from "dineway";
+ * Usage:
+ * - `{...entry.edit}` - entry-level annotation (includes status/hasDraft)
+ * - `{...entry.edit.title}` - field-level annotation
+ * - `{...entry.edit['nested.field']}` - nested field (bracket notation)
+ */
+declare function createEditable(collection: string, id: string, options?: EditableOptions): EditProxy;
+/**
+ * Create a noop proxy for production mode.
+ * Spreading this produces no attributes.
+ */
+declare function createNoop(): EditProxy;
+/**
+ * Visual editing proxy type.
  *
- * export default definePlugin({
- *   hooks: {
- *     "content:afterSave": {
- *       handler: async (event, ctx) => {
- *         await ctx.kv.set("lastSave", Date.now());
- *       },
- *     },
- *   },
- *   routes: {
- *     status: {
- *       handler: async (routeCtx, ctx) => ({ ok: true }),
- *     },
- *   },
- * });
- * ```
+ * Spread directly onto elements for entry-level annotations: `{...entry.edit}`
+ * Access a field for field-level annotations: `{...entry.edit.title}`
  *
- * **Native format** -- for plugins that need React admin, direct DB access,
- * or other capabilities not available in the sandbox.
+ * In production, spreading produces no attributes (noop).
+ */
+type EditProxy = {
+  readonly [field: string]: Partial<FieldAnnotation>;
+};
+//#endregion
+//#region src/query.d.ts
+/**
+ * Collection type registry for type-safe queries.
+ *
+ * This interface is extended by the generated dineway-env.d.ts file
+ * to provide type inference for collection names and their data shapes.
+ *
+ * @example
+ * ```ts
+ * // In dineway-env.d.ts (generated):
+ * declare module "dineway" {
+ *   interface DinewayCollections {
+ *     posts: { title: string; content: PortableTextBlock[]; };
+ *     pages: { title: string; body: PortableTextBlock[]; };
+ *   }
+ * }
+ *
+ * // Then in your code:
+ * const { entries } = await getDinewayCollection("posts");
+ * // entries[0].data.title is typed as string
+ * ```
+ */
+interface DinewayCollections {}
+/**
+ * Helper type to infer the data type for a collection.
+ * Returns the registered type if known, otherwise falls back to Record<string, unknown>.
+ */
+type InferCollectionData<T extends string> = T extends keyof DinewayCollections ? DinewayCollections[T] : Record<string, unknown>;
+/**
+ * Sort direction
+ */
+type SortDirection = "asc" | "desc";
+/**
+ * Order by specification - field name to direction
+ * @example { created_at: "desc" } - Sort by created_at descending
+ * @example { title: "asc" } - Sort by title ascending
+ * @example { published_at: "desc", title: "asc" } - Multi-field sort
+ */
+type OrderBySpec = Record<string, SortDirection>;
+interface CollectionFilter {
+  status?: "draft" | "published" | "archived";
+  limit?: number;
+  /**
+   * Opaque cursor for keyset pagination.
+   * Pass the `nextCursor` value from a previous result to fetch the next page.
+   * @example
+   * ```ts
+   * const cursor = Astro.url.searchParams.get("cursor") ?? undefined;
+   * const { entries, nextCursor } = await getDinewayCollection("posts", {
+   *   limit: 10,
+   *   cursor,
+   * });
+   * ```
+   */
+  cursor?: string;
+  /**
+   * Filter by field values, taxonomy terms, or ranges.
+   *
+   * Taxonomy names are detected automatically and filtered via JOIN.
+   * Other keys are treated as content table column filters.
+   *
+   * @example { category: 'news' } - Filter by taxonomy term
+   * @example { category: ['news', 'featured'] } - Filter by multiple terms (OR)
+   * @example { series: 'main' } - Exact match on a content field
+   * @example { published_at: { gte: '2024-01-01', lt: '2025-01-01' } } - Date range
+   */
+  where?: Record<string, WhereValue>;
+  /**
+   * Order results by field(s)
+   * @default { created_at: "desc" }
+   * @example { created_at: "desc" } - Sort by created_at descending (default)
+   * @example { title: "asc" } - Sort by title ascending
+   * @example { published_at: "desc", title: "asc" } - Multi-field sort
+   */
+  orderBy?: OrderBySpec;
+  /**
+   * Filter by locale. When set, only returns entries in this locale.
+   * Only relevant when i18n is configured.
+   * @example "en" — English entries only
+   * @example "fr" — French entries only
+   */
+  locale?: string;
+}
+interface ContentEntry<T = Record<string, unknown>> {
+  id: string;
+  data: T;
+  /** Visual editing annotations. Spread onto elements: {...entry.edit.title} */
+  edit: EditProxy;
+}
+/** Cache hint returned by the content loader for route caching */
+interface CacheHint {
+  tags?: string[];
+  lastModified?: Date;
+}
+/**
+ * Result from getDinewayCollection
+ */
+interface CollectionResult<T> {
+  /** The entries (empty array if error or none found) */
+  entries: ContentEntry<T>[];
+  /** Error if the query failed */
+  error?: Error;
+  /** Cache hint for route caching (pass to Astro.cache.set()) */
+  cacheHint: CacheHint;
+  /**
+   * Opaque cursor for the next page.
+   * Undefined when there are no more results.
+   * Pass this as `cursor` in the next query to get the next page.
+   */
+  nextCursor?: string;
+}
+/**
+ * Result from getDinewayEntry
+ */
+interface EntryResult<T> {
+  /** The entry, or null if not found */
+  entry: ContentEntry<T> | null;
+  /** Error if the query failed (not set for "not found", only for actual errors) */
+  error?: Error;
+  /** Whether we're in preview mode (valid token was provided) */
+  isPreview: boolean;
+  /** Set when a fallback locale was used instead of the requested locale */
+  fallbackLocale?: string;
+  /** Cache hint for route caching (pass to Astro.cache.set()) */
+  cacheHint: CacheHint;
+}
+/** Edit metadata attached to PT arrays in edit mode */
+interface EditFieldMeta {
+  collection: string;
+  id: string;
+  field: string;
+}
+/**
+ * Read edit metadata from a value (returns undefined if not tagged).
+ * Uses Object.getOwnPropertyDescriptor to access Symbol-keyed property
+ * without an unsafe type assertion.
+ */
+declare function getEditMeta(value: unknown): EditFieldMeta | undefined;
+/**
+ * Get all entries of a content type
+ *
+ * Returns { entries, error } for graceful error handling.
+ *
+ * When dineway-env.d.ts is generated, the collection name will be
+ * type-checked and the return type will be inferred automatically.
+ *
+ * @example
+ * ```ts
+ * import { getDinewayCollection } from "dineway";
+ *
+ * const { entries: posts, error } = await getDinewayCollection("posts");
+ * if (error) {
+ *   console.error("Failed to load posts:", error);
+ *   return;
+ * }
+ * // posts[0].data.title is typed (if dineway-env.d.ts exists)
+ *
+ * // With filters
+ * const { entries: drafts } = await getDinewayCollection("posts", { status: "draft" });
+ * ```
+ */
+declare function getDinewayCollection<T extends string, D = InferCollectionData<T>>(type: T, filter?: CollectionFilter): Promise<CollectionResult<D>>;
+/**
+ * Get a single entry by type and ID/slug
+ *
+ * Returns { entry, error, isPreview } for graceful error handling.
+ * - entry is null if not found (not an error)
+ * - error is set only for actual errors (db issues, etc.)
+ *
+ * Preview mode is detected automatically from request context (ALS).
+ * When the URL has a valid `_preview` token, the middleware sets preview
+ * context and this function serves draft revision data if available.
+ *
+ * @example
+ * ```ts
+ * import { getDinewayEntry } from "dineway";
+ *
+ * // Simple usage — preview just works via middleware
+ * const { entry: post, isPreview, error } = await getDinewayEntry("posts", "my-slug");
+ * if (!post) return Astro.redirect("/404");
+ * ```
+ */
+declare function getDinewayEntry<T extends string, D = InferCollectionData<T>>(type: T, id: string, options?: {
+  locale?: string;
+}): Promise<EntryResult<D>>;
+/**
+ * Translation summary for a single locale variant
+ */
+interface TranslationSummary {
+  /** Content item ID */
+  id: string;
+  /** Locale code (e.g. "en", "fr") */
+  locale: string;
+  /** URL slug */
+  slug: string | null;
+  /** Current status */
+  status: string;
+}
+/**
+ * Result from getTranslations
+ */
+interface TranslationsResult {
+  /** The translation group ID (shared across locales) */
+  translationGroup: string;
+  /** All locale variants in this group */
+  translations: TranslationSummary[];
+  /** Error if the query failed */
+  error?: Error;
+}
+/**
+ * Get all translations of a content item.
+ *
+ * Given a content entry, returns all locale variants that share the same
+ * translation group. This is useful for building language switcher UI.
+ *
+ * @example
+ * ```ts
+ * import { getDinewayEntry, getTranslations } from "dineway";
+ *
+ * const { entry: post } = await getDinewayEntry("posts", "hello-world", { locale: "en" });
+ * const { translations } = await getTranslations("posts", post.data.id);
+ * // translations = [{ id: "...", locale: "en", slug: "hello-world", status: "published" }, ...]
+ * ```
+ */
+declare function getTranslations(type: string, id: string): Promise<TranslationsResult>;
+/**
+ * Result from resolveDinewayPath
+ */
+interface ResolvePathResult<T = Record<string, unknown>> {
+  /** The matched entry */
+  entry: ContentEntry<T>;
+  /** The collection slug that matched */
+  collection: string;
+  /** Extracted parameters from the URL pattern (e.g. { slug: "my-post" }) */
+  params: Record<string, string>;
+}
+/**
+ * Resolve a URL path to a content entry by matching against collection URL patterns.
+ *
+ * Loads all collections with a `urlPattern` set, converts each pattern to a regex,
+ * and tests the given path. On match, extracts the slug and fetches the entry.
+ *
+ * @example
+ * ```ts
+ * import { resolveDinewayPath } from "dineway";
+ *
+ * // Given pages with urlPattern "/{slug}" and posts with "/blog/{slug}":
+ * const result = await resolveDinewayPath("/blog/hello-world");
+ * if (result) {
+ *   console.log(result.collection); // "posts"
+ *   console.log(result.params.slug); // "hello-world"
+ *   console.log(result.entry.data); // post data
+ * }
+ * ```
+ */
+declare function resolveDinewayPath<T = Record<string, unknown>>(path: string): Promise<ResolvePathResult<T> | null>;
+//#endregion
+//#region src/after.d.ts
+/**
+ * Defer work past the current synchronous path.
+ *
+ * Use this for best-effort bookkeeping that should not block runtime
+ * initialization or response handling. Node keeps the process alive for
+ * pending work; callers that need stronger durability should await their own
+ * operation instead of using this helper.
+ */
+type AfterCallback = () => void | Promise<void>;
+declare function after(fn: AfterCallback): void;
+//#endregion
+//#region src/i18n/config.d.ts
+/**
+ * Dineway i18n Configuration
+ *
+ * Reads locale configuration from the virtual module (sourced from Astro config).
+ * Initialized during runtime startup, then available via getI18nConfig().
+ */
+interface I18nConfig {
+  defaultLocale: string;
+  locales: string[];
+  fallback?: Record<string, string>;
+  prefixDefaultLocale?: boolean;
+}
+/**
+ * Get the current i18n config.
+ * Returns null if i18n is not configured.
+ */
+declare function getI18nConfig(): I18nConfig | null;
+/**
+ * Check if i18n is enabled.
+ * Returns true when multiple locales are configured.
+ */
+declare function isI18nEnabled(): boolean;
+/**
+ * Resolve fallback locale chain for a given locale.
+ * Returns array of locales to try, from most preferred to least.
+ * Always ends with defaultLocale.
+ */
+declare function getFallbackChain(locale: string): string[];
+//#endregion
+//#region src/preview/sidecar-client.d.ts
+/**
+ * Preview sidecar protocol helpers.
+ *
+ * These utilities define the signed URL and snapshot-auth contract shared
+ * by preview sidecars and the source site serving snapshot exports.
+ */
+interface PreviewSidecarSignature {
+  source: string;
+  exp: number;
+  sig: string;
+}
+interface PreviewSidecarClient {
+  signPreviewUrl(previewBase: string, source: string, secret: string, ttl?: number): Promise<string>;
+  buildSnapshotSignatureHeader(signature: PreviewSidecarSignature): string;
+}
+declare function signPreviewUrl(previewBase: string, source: string, secret: string, ttl?: number): Promise<string>;
+declare function buildPreviewSignatureHeader(signature: PreviewSidecarSignature): string;
+declare function parsePreviewSignatureHeader(header: string): PreviewSidecarSignature | null;
+declare function verifyPreviewSignature(source: string, exp: number, sig: string, secret: string): Promise<boolean>;
+declare const defaultPreviewSidecarClient: PreviewSidecarClient;
+//#endregion
+//#region src/preview/session-database-factory.d.ts
+interface SessionDatabaseInfo {
+  id: string;
+  dbPath: string;
+  createdAt: number;
+  expiresAt: number;
+  lastTouchedAt: number;
+}
+interface SessionDatabaseHandle {
+  created: boolean;
+  session: SessionDatabaseInfo;
+  db: Kysely<Database>;
+  close(): Promise<void>;
+}
+interface SessionCleanupResult {
+  removedSessionIds: string[];
+  removedPaths: string[];
+}
+interface SessionOpenOptions {
+  id: string;
+  now?: number;
+}
+interface SessionOpenOrCreateOptions extends SessionOpenOptions {
+  ttlMs: number;
+}
+interface SessionDatabaseFactory {
+  open(input: SessionOpenOptions): Promise<SessionDatabaseHandle | null>;
+  openOrCreate(input: SessionOpenOrCreateOptions): Promise<SessionDatabaseHandle>;
+  destroy(id: string): Promise<boolean>;
+  cleanup(now?: number): Promise<SessionCleanupResult>;
+  close(): Promise<void>;
+}
+interface FileSessionDatabaseFactoryOptions {
+  rootDir: string;
+  maxDiskBytes?: number;
+  registryFileName?: string;
+  sessionsDirName?: string;
+}
+declare class SessionDatabaseLimitError extends Error {
+  constructor(message?: string);
+}
+declare class FileSessionDatabaseFactory implements SessionDatabaseFactory {
+  private readonly options;
+  private readonly registry;
+  private readonly sessionsDir;
+  private readonly maxDiskBytes;
+  constructor(options: FileSessionDatabaseFactoryOptions);
+  open(input: SessionOpenOptions): Promise<SessionDatabaseHandle | null>;
+  openOrCreate(input: SessionOpenOrCreateOptions): Promise<SessionDatabaseHandle>;
+  destroy(id: string): Promise<boolean>;
+  cleanup(now?: number): Promise<SessionCleanupResult>;
+  close(): Promise<void>;
+  private createHandle;
+  private getSessionRow;
+  private toSessionInfo;
+  private deleteSession;
+  private getActiveDiskBytes;
+  private getDbPath;
+  private getManagedPaths;
+  private listSessionRows;
+  private listDbPathRows;
+}
+//#endregion
+//#region src/preview/middleware.d.ts
+interface FilePreviewMiddlewareConfig {
+  rootDir?: string;
+  secret: string;
+  ttlSeconds?: number;
+  cookieName?: string;
+  snapshotPath?: string;
+  maxSessionDiskBytes?: number;
+  sessionFactory?: SessionDatabaseFactory;
+  fetch?: typeof globalThis.fetch;
+}
+declare function createFilePreviewMiddleware(config: FilePreviewMiddlewareConfig): MiddlewareHandler;
+//#endregion
+//#region src/plugins/define-plugin.d.ts
+/**
+ * Define a Dineway plugin.
+ *
+ * **Standard format** -- the canonical format for plugins that work in both
+ * trusted and sandboxed modes. No id/version -- those come from the descriptor.
+ *
+ * @example
+ * ```typescript
+ * import { definePlugin } from "dineway";
+ *
+ * export default definePlugin({
+ *   hooks: {
+ *     "content:afterSave": {
+ *       handler: async (event, ctx) => {
+ *         await ctx.kv.set("lastSave", Date.now());
+ *       },
+ *     },
+ *   },
+ *   routes: {
+ *     status: {
+ *       handler: async (routeCtx, ctx) => ({ ok: true }),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * **Native format** -- for plugins that need React admin, direct DB access,
+ * or other capabilities not available in the sandbox.
  *
  * @example
  * ```typescript
@@ -1642,10 +2139,10 @@ declare function definePlugin(definition: StandardPluginDefinition): StandardPlu
  *
  * Every JSON.parse of a manifest.json should validate through this.
  */
-declare const pluginManifestSchema: z.ZodObject<{
-  id: z.ZodString;
-  version: z.ZodString;
-  capabilities: z.ZodArray<z.ZodEnum<{
+declare const pluginManifestSchema: z$1.ZodObject<{
+  id: z$1.ZodString;
+  version: z$1.ZodString;
+  capabilities: z$1.ZodArray<z$1.ZodEnum<{
     "network:request": "network:request";
     "network:request:unrestricted": "network:request:unrestricted";
     "content:read": "content:read";
@@ -1658,12 +2155,12 @@ declare const pluginManifestSchema: z.ZodObject<{
     "hooks.email-events:register": "hooks.email-events:register";
     "hooks.page-fragments:register": "hooks.page-fragments:register";
   }>>;
-  allowedHosts: z.ZodArray<z.ZodString>;
-  storage: z.ZodRecord<z.ZodString, z.ZodObject<{
-    indexes: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-    uniqueIndexes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
-  }, z.core.$strip>>;
-  hooks: z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+  allowedHosts: z$1.ZodArray<z$1.ZodString>;
+  storage: z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
+    indexes: z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodArray<z$1.ZodString>]>>;
+    uniqueIndexes: z$1.ZodOptional<z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodArray<z$1.ZodString>]>>>;
+  }, z$1.core.$strip>>;
+  hooks: z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodEnum<{
     "plugin:install": "plugin:install";
     "plugin:activate": "plugin:activate";
     "plugin:deactivate": "plugin:deactivate";
@@ -1686,8 +2183,8 @@ declare const pluginManifestSchema: z.ZodObject<{
     "comment:afterModerate": "comment:afterModerate";
     "page:metadata": "page:metadata";
     "page:fragments": "page:fragments";
-  }>, z.ZodObject<{
-    name: z.ZodEnum<{
+  }>, z$1.ZodObject<{
+    name: z$1.ZodEnum<{
       "plugin:install": "plugin:install";
       "plugin:activate": "plugin:activate";
       "plugin:deactivate": "plugin:deactivate";
@@ -1711,85 +2208,85 @@ declare const pluginManifestSchema: z.ZodObject<{
       "page:metadata": "page:metadata";
       "page:fragments": "page:fragments";
     }>;
-    exclusive: z.ZodOptional<z.ZodBoolean>;
-    priority: z.ZodOptional<z.ZodNumber>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-  }, z.core.$strip>]>>;
-  routes: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    name: z.ZodString;
-    public: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>]>>;
-  admin: z.ZodObject<{
-    entry: z.ZodOptional<z.ZodString>;
-    settingsSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
-      type: z.ZodLiteral<"string">;
-      default: z.ZodOptional<z.ZodString>;
-      multiline: z.ZodOptional<z.ZodBoolean>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"number">;
-      default: z.ZodOptional<z.ZodNumber>;
-      min: z.ZodOptional<z.ZodNumber>;
-      max: z.ZodOptional<z.ZodNumber>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"boolean">;
-      default: z.ZodOptional<z.ZodBoolean>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"select">;
-      options: z.ZodArray<z.ZodObject<{
-        value: z.ZodString;
-        label: z.ZodString;
-      }, z.core.$strip>>;
-      default: z.ZodOptional<z.ZodString>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"secret">;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"url">;
-      default: z.ZodOptional<z.ZodString>;
-      placeholder: z.ZodOptional<z.ZodString>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"email">;
-      default: z.ZodOptional<z.ZodString>;
-      placeholder: z.ZodOptional<z.ZodString>;
-      label: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>], "type">>>;
-    pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      path: z.ZodString;
-      label: z.ZodString;
-      icon: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    widgets: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      id: z.ZodString;
-      size: z.ZodOptional<z.ZodEnum<{
+    exclusive: z$1.ZodOptional<z$1.ZodBoolean>;
+    priority: z$1.ZodOptional<z$1.ZodNumber>;
+    timeout: z$1.ZodOptional<z$1.ZodNumber>;
+  }, z$1.core.$strip>]>>;
+  routes: z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodObject<{
+    name: z$1.ZodString;
+    public: z$1.ZodOptional<z$1.ZodBoolean>;
+  }, z$1.core.$strip>]>>;
+  admin: z$1.ZodObject<{
+    entry: z$1.ZodOptional<z$1.ZodString>;
+    settingsSchema: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+      type: z$1.ZodLiteral<"string">;
+      default: z$1.ZodOptional<z$1.ZodString>;
+      multiline: z$1.ZodOptional<z$1.ZodBoolean>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"number">;
+      default: z$1.ZodOptional<z$1.ZodNumber>;
+      min: z$1.ZodOptional<z$1.ZodNumber>;
+      max: z$1.ZodOptional<z$1.ZodNumber>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"boolean">;
+      default: z$1.ZodOptional<z$1.ZodBoolean>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"select">;
+      options: z$1.ZodArray<z$1.ZodObject<{
+        value: z$1.ZodString;
+        label: z$1.ZodString;
+      }, z$1.core.$strip>>;
+      default: z$1.ZodOptional<z$1.ZodString>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"secret">;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"url">;
+      default: z$1.ZodOptional<z$1.ZodString>;
+      placeholder: z$1.ZodOptional<z$1.ZodString>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+      type: z$1.ZodLiteral<"email">;
+      default: z$1.ZodOptional<z$1.ZodString>;
+      placeholder: z$1.ZodOptional<z$1.ZodString>;
+      label: z$1.ZodString;
+      description: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>], "type">>>;
+    pages: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      path: z$1.ZodString;
+      label: z$1.ZodString;
+      icon: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>>>;
+    widgets: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      id: z$1.ZodString;
+      size: z$1.ZodOptional<z$1.ZodEnum<{
         full: "full";
         half: "half";
         third: "third";
       }>>;
-      title: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    fieldWidgets: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      name: z.ZodString;
-      label: z.ZodString;
-      fieldTypes: z.ZodArray<z.ZodEnum<{
+      title: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>>>;
+    fieldWidgets: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+      name: z$1.ZodString;
+      label: z$1.ZodString;
+      fieldTypes: z$1.ZodArray<z$1.ZodEnum<{
         string: "string";
         number: "number";
         boolean: "boolean";
         file: "file";
+        image: "image";
         slug: "slug";
         datetime: "datetime";
-        image: "image";
         text: "text";
         integer: "integer";
         select: "select";
@@ -1799,15 +2296,15 @@ declare const pluginManifestSchema: z.ZodObject<{
         json: "json";
         repeater: "repeater";
       }>>;
-      elements: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        type: z.ZodString;
-        action_id: z.ZodString;
-        label: z.ZodOptional<z.ZodString>;
-      }, z.core.$loose>>>;
-    }, z.core.$strip>>>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-type ValidatedPluginManifest = z.infer<typeof pluginManifestSchema>;
+      elements: z$1.ZodOptional<z$1.ZodArray<z$1.ZodObject<{
+        type: z$1.ZodString;
+        action_id: z$1.ZodString;
+        label: z$1.ZodOptional<z$1.ZodString>;
+      }, z$1.core.$loose>>>;
+    }, z$1.core.$strip>>>;
+  }, z$1.core.$strip>;
+}, z$1.core.$strip>;
+type ValidatedPluginManifest = z$1.infer<typeof pluginManifestSchema>;
 //#endregion
 //#region src/plugins/hooks.d.ts
 type HookNameV2 = "plugin:install" | "plugin:activate" | "plugin:deactivate" | "plugin:uninstall" | "content:beforeSave" | "content:afterSave" | "content:beforeDelete" | "content:afterDelete" | "content:afterPublish" | "content:afterUnpublish" | "media:beforeUpload" | "media:afterUpload" | "cron" | "email:beforeSend" | "email:deliver" | "email:afterSend" | "comment:beforeCreate" | "comment:moderate" | "comment:afterCreate" | "comment:afterModerate" | "page:metadata" | "page:fragments";
@@ -2776,6 +3273,221 @@ interface PreviewToolbarConfig {
 }
 declare function renderPreviewToolbar(config: PreviewToolbarConfig): string;
 //#endregion
+//#region src/settings/index.d.ts
+/**
+ * Get a single site setting by key
+ *
+ * Returns `undefined` if the setting has not been configured.
+ * For media settings (logo, favicon), the URL is resolved automatically.
+ *
+ * @param key - The setting key (e.g., "title", "logo", "social")
+ * @returns The setting value, or undefined if not set
+ *
+ * @example
+ * ```ts
+ * import { getSiteSetting } from "dineway";
+ *
+ * const title = await getSiteSetting("title");
+ * const logo = await getSiteSetting("logo");
+ * console.log(logo?.url); // Resolved URL
+ * ```
+ */
+declare function getSiteSetting<K extends SiteSettingKey>(key: K): Promise<SiteSettings[K] | undefined>;
+/**
+ * Get all site settings
+ *
+ * Returns all configured settings. Unset values are undefined.
+ * Media references (logo/favicon) are resolved to include URLs.
+ *
+ * @example
+ * ```ts
+ * import { getSiteSettings } from "dineway";
+ *
+ * const settings = await getSiteSettings();
+ * console.log(settings.title); // "My Site"
+ * console.log(settings.logo?.url); // "/_dineway/api/media/file/abc123"
+ * ```
+ */
+declare function getSiteSettings(): Promise<Partial<SiteSettings>>;
+/**
+ * Set site settings (internal function used by admin API)
+ *
+ * Merges provided settings with existing ones. Only provided fields are updated.
+ * Media references should include just the mediaId; URLs are resolved on read.
+ *
+ * @param settings - Partial settings object with values to update
+ * @param db - Kysely database instance
+ * @returns Promise that resolves when settings are saved
+ *
+ * @internal
+ *
+ * @example
+ * ```ts
+ * // Update multiple settings at once
+ * await setSiteSettings({
+ *   title: "My Site",
+ *   tagline: "Welcome",
+ *   logo: { mediaId: "med_123", alt: "Logo" }
+ * }, db);
+ * ```
+ */
+declare function setSiteSettings(settings: Partial<SiteSettings>, db: Kysely<Database>): Promise<void>;
+/**
+ * Get a single plugin setting by key.
+ *
+ * Plugin settings are stored in the options table under
+ * `plugin:<pluginId>:settings:<key>`.
+ */
+declare function getPluginSetting<T = unknown>(pluginId: string, key: string): Promise<T | undefined>;
+/**
+ * Get all persisted plugin settings for a plugin.
+ *
+ * Defaults declared in `admin.settingsSchema` are not materialized
+ * automatically; callers should apply their own fallback defaults.
+ */
+declare function getPluginSettings(pluginId: string): Promise<Record<string, unknown>>;
+//#endregion
+//#region src/comments/query.d.ts
+interface GetCommentsOptions {
+  collection: string;
+  contentId: string;
+  threaded?: boolean;
+}
+interface GetCommentsResult {
+  items: PublicComment[];
+  total: number;
+}
+/**
+ * Get approved comments for a content item.
+ *
+ * @example
+ * ```ts
+ * import { getComments } from "dineway";
+ *
+ * const { items, total } = await getComments({
+ *   collection: "posts",
+ *   contentId: post.id,
+ *   threaded: true,
+ * });
+ * ```
+ */
+declare function getComments(options: GetCommentsOptions): Promise<GetCommentsResult>;
+/**
+ * Get the count of approved comments for a content item.
+ *
+ * @example
+ * ```ts
+ * import { getCommentCount } from "dineway";
+ *
+ * const count = await getCommentCount("posts", post.id);
+ * ```
+ */
+declare function getCommentCount(collection: string, contentId: string): Promise<number>;
+//#endregion
+//#region src/menus/types.d.ts
+/**
+ * Menu item types
+ */
+type MenuItemType = string;
+/**
+ * Menu item as returned to templates (with resolved URL)
+ */
+interface MenuItem {
+  id: string;
+  label: string;
+  url: string;
+  target?: string;
+  titleAttr?: string;
+  cssClasses?: string;
+  children: MenuItem[];
+}
+/**
+ * Menu as returned to templates
+ */
+interface Menu {
+  id: string;
+  name: string;
+  label: string;
+  items: MenuItem[];
+  locale: string;
+  translationGroup: string | null;
+}
+/**
+ * Input for creating a menu item
+ */
+interface CreateMenuItemInput {
+  type: MenuItemType;
+  label: string;
+  /**
+   * Identifier of the referenced entity. For content and taxonomy items it is
+   * the target row's translation_group.
+   */
+  referenceCollection?: string;
+  referenceId?: string;
+  customUrl?: string;
+  target?: string;
+  titleAttr?: string;
+  cssClasses?: string;
+  parentId?: string;
+  sortOrder?: number;
+}
+/**
+ * Input for updating a menu item
+ */
+interface UpdateMenuItemInput {
+  label?: string;
+  customUrl?: string;
+  target?: string;
+  titleAttr?: string;
+  cssClasses?: string;
+  parentId?: string | null;
+  sortOrder?: number;
+}
+/**
+ * Input for creating a menu
+ */
+interface CreateMenuInput {
+  name: string;
+  label: string;
+  locale?: string;
+  /** Existing menu id to join as a locale translation. */
+  translationOf?: string;
+}
+/**
+ * Input for updating a menu
+ */
+interface UpdateMenuInput {
+  label?: string;
+}
+/**
+ * Input for reordering menu items
+ */
+interface ReorderMenuItemsInput {
+  items: Array<{
+    id: string;
+    parentId: string | null;
+    sortOrder: number;
+  }>;
+}
+//#endregion
+//#region src/menus/index.d.ts
+interface MenuQueryOptions {
+  locale?: string;
+}
+/**
+ * Get menu by name with resolved URLs.
+ */
+declare function getMenu(name: string, options?: MenuQueryOptions): Promise<Menu | null>;
+/**
+ * Get all menus without items.
+ */
+declare function getMenus(options?: MenuQueryOptions): Promise<Array<{
+  id: string;
+  name: string;
+  label: string;
+  locale: string;
+}>>;
+//#endregion
 //#region src/bylines/index.d.ts
 /**
  * Get a byline by ID.
@@ -2804,7 +3516,177 @@ declare function getByline(id: string): Promise<BylineSummary | null>;
  * }
  * ```
  */
-declare function getBylineBySlug(slug: string): Promise<BylineSummary | null>;
+declare function getBylineBySlug(slug: string, options?: {
+  locale?: string;
+}): Promise<BylineSummary | null>;
+//#endregion
+//#region src/taxonomies/types.d.ts
+/**
+ * Taxonomy types for Dineway Agentic Web builder
+ */
+/**
+ * Taxonomy definition - describes a taxonomy like "category" or "tag"
+ */
+interface TaxonomyDef {
+  id: string;
+  name: string;
+  label: string;
+  labelSingular?: string;
+  hierarchical: boolean;
+  collections: string[];
+  locale: string;
+  translationGroup: string | null;
+}
+/**
+ * Taxonomy term - a specific term within a taxonomy (e.g., "News" in "category")
+ */
+interface TaxonomyTerm {
+  id: string;
+  name: string;
+  slug: string;
+  label: string;
+  parentId?: string;
+  description?: string;
+  children: TaxonomyTerm[];
+  count?: number;
+  locale: string;
+  translationGroup: string | null;
+}
+/**
+ * Flat version for DB row
+ */
+interface TaxonomyTermRow {
+  id: string;
+  name: string;
+  slug: string;
+  label: string;
+  parent_id: string | null;
+  data: string | null;
+  locale: string;
+  translation_group: string | null;
+}
+/**
+ * Input for creating a term
+ */
+interface CreateTermInput {
+  slug: string;
+  label: string;
+  parentId?: string;
+  description?: string;
+  locale?: string;
+  /** Existing term id to join as a locale translation. */
+  translationOf?: string;
+}
+/**
+ * Input for updating a term
+ */
+interface UpdateTermInput {
+  slug?: string;
+  label?: string;
+  parentId?: string | null;
+  description?: string;
+}
+//#endregion
+//#region src/taxonomies/index.d.ts
+interface TaxonomyQueryOptions {
+  locale?: string;
+}
+/**
+ * Get every taxonomy definition for the active locale.
+ */
+declare function getTaxonomyDefs(options?: TaxonomyQueryOptions): Promise<TaxonomyDef[]>;
+/**
+ * Get a single taxonomy definition by name, following the locale fallback chain.
+ */
+declare function getTaxonomyDef(name: string, options?: TaxonomyQueryOptions): Promise<TaxonomyDef | null>;
+/**
+ * Get all terms for a taxonomy in the active locale.
+ */
+declare function getTaxonomyTerms(taxonomyName: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm[]>;
+/**
+ * Get a single term by taxonomy and slug, following the locale fallback chain.
+ */
+declare function getTerm(taxonomyName: string, slug: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm | null>;
+/**
+ * Get terms assigned to an entry, resolved into the active locale.
+ */
+declare function getEntryTerms(collection: string, entryId: string, taxonomyName?: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm[]>;
+/**
+ * Get terms for multiple entries in one taxonomy.
+ */
+declare function getTermsForEntries(collection: string, entryIds: string[], taxonomyName: string, options?: TaxonomyQueryOptions): Promise<Map<string, TaxonomyTerm[]>>;
+/**
+ * Get entries by term.
+ */
+declare function getEntriesByTerm(collection: string, taxonomyName: string, termSlug: string, options?: TaxonomyQueryOptions): Promise<Array<{
+  id: string;
+  data: Record<string, unknown>;
+}>>;
+//#endregion
+//#region src/widgets/types.d.ts
+type WidgetType = "content" | "menu" | "component";
+interface Widget {
+  id: string;
+  type: WidgetType;
+  title?: string;
+  content?: PortableTextBlock$1[];
+  menuName?: string;
+  componentId?: string;
+  componentProps?: Record<string, unknown>;
+}
+interface WidgetArea {
+  id: string;
+  name: string;
+  label: string;
+  description?: string;
+  widgets: Widget[];
+}
+interface WidgetComponentDef {
+  id: string;
+  label: string;
+  description?: string;
+  props: Record<string, PropDef>;
+}
+interface PropDef {
+  type: "string" | "number" | "boolean" | "select";
+  label: string;
+  default?: unknown;
+  options?: Array<{
+    value: string;
+    label: string;
+  }>;
+}
+interface CreateWidgetAreaInput {
+  name: string;
+  label: string;
+  description?: string;
+}
+interface CreateWidgetInput {
+  type: WidgetType;
+  title?: string;
+  content?: PortableTextBlock$1[];
+  menuName?: string;
+  componentId?: string;
+  componentProps?: Record<string, unknown>;
+}
+interface UpdateWidgetInput extends Partial<CreateWidgetInput> {}
+interface ReorderWidgetsInput {
+  widgetIds: string[];
+}
+//#endregion
+//#region src/widgets/index.d.ts
+/**
+ * Get a widget area by name, with all its widgets
+ */
+declare function getWidgetArea(name: string): Promise<WidgetArea | null>;
+/**
+ * Get all widget areas with their widgets
+ */
+declare function getWidgetAreas(): Promise<WidgetArea[]>;
+/**
+ * Get available widget components (for admin UI)
+ */
+declare function getWidgetComponents(): WidgetComponentDef[];
 //#endregion
 //#region src/search/types.d.ts
 /**
@@ -3600,4 +4482,4 @@ declare global {
   var __dinewayConfig: DinewayConfig | undefined;
 }
 //#endregion
-export { createPluginManager as $, isParseError as $n, SandboxOptions as $t, dropSessionDatabaseTables as A, handleContentDelete as An, verifyPreviewSignature as At, GeneratePreviewTokenOptions as B, handleContentSchedule as Bn, prosemirrorToPortableText as Bt, getByline as C, handleRevisionList as Cn, SessionOpenOrCreateOptions as Ct, AppliedSnapshotMeta as D, handleContentCountScheduled as Dn, defaultPreviewSidecarClient as Dt, renderPreviewToolbar as E, handleContentCompare as En, buildPreviewSignatureHeader as Et, getPreviewToken as F, handleContentList as Fn, AfterCallback as Ft, parseContentId as G, CreateMediaInput as Gn, PortableTextSpan as Gt, VerifyPreviewTokenOptions as H, handleContentUnpublish as Hn, PortableTextImageBlock as Ht, isPreviewRequest as I, handleContentListTrashed as In, after as It, createNodeSandboxRunner as J, ContentRepository as Jn, ProseMirrorDocument as Jt, verifyPreviewToken as K, MediaItem as Kn, PortableTextTextBlock as Kt, GetPreviewUrlOptions as L, handleContentPermanentDelete as Ln, computeContentHash as Lt, Snapshot as M, handleContentDuplicate as Mn, getFallbackChain as Mt, renderPreviewLoadingPage as N, handleContentGet as Nn, getI18nConfig as Nt, ApplySnapshotToDatabaseOptions as O, handleContentCountTrashed as On, parsePreviewSignatureHeader as Ot, isBlockedInPreview as P, handleContentGetIncludingTrashed as Pn, isI18nEnabled as Pt, PluginManager as Q, ParseResult as Qn, SandboxEmailSendCallback as Qt, buildPreviewUrl as R, handleContentPublish as Rn, hashString as Rt, Suggestion as S, handleRevisionGet as Sn, SessionOpenOptions as St, PreviewToolbarConfig as T, generateManifest as Tn, PreviewSidecarSignature as Tt, VerifyPreviewTokenResult as U, handleContentUnschedule as Un, PortableTextLinkMark as Ut, PreviewTokenPayload as V, handleContentTranslations as Vn, PortableTextCodeBlock as Vt, generatePreviewToken as W, handleContentUpdate as Wn, PortableTextMarkDef as Wt, SandboxNotAvailableError as X, DinewayDatabaseError as Xn, ProseMirrorNode as Xt, NoopSandboxRunner as Y, DatabaseConfig as Yn, ProseMirrorMark as Yt, createNoopSandboxRunner as Z, OptionsRepository as Zn, SandboxEmailMessage as Zt, SearchOptions as _, handleMediaGet as _n, SessionCleanupResult as _t, S3StorageConfig as a, getSections as an, ApiContext as ar, ValidatedPluginManifest as at, SearchStats as b, RevisionListResponse as bn, SessionDatabaseInfo as bt, extractSearchableFields as c, Section as cn, FieldDescriptor as cr, CollectionFilter as ct, search as d, SchemaError as dn, dinewayLoader as dt, SandboxRunner as en, parseBody as er, PluginRouteError as et, searchCollection as f, SchemaRegistry as fn, getDb as ft, SearchConfig as g, handleMediaDelete as gn, FileSessionDatabaseFactoryOptions as gt, CollectionSearchOptions as h, handleMediaCreate as hn, FileSessionDatabaseFactory as ht, LocalStorageConfig as i, getSection as in, handleError as ir, createHookPipeline as it, getAppliedSnapshotMeta as j, handleContentDiscardDraft as jn, I18nConfig as jt, applySnapshotToDatabase as k, handleContentCreate as kn, signPreviewUrl as kt, getSearchStats as l, SectionSource as ln, ListResponse as lr, EntryData as lt, FTSManager as m, MediaResponse as mn, createFilePreviewMiddleware as mt, PluginDescriptor as n, SandboxedPlugin as nn, apiError as nr, HookPipeline as nt, StorageDescriptor as o, CreateSectionInput as on, ContentListResponse as or, pluginManifestSchema as ot, searchWithDb as p, MediaListResponse as pn, FilePreviewMiddlewareConfig as pt, NodeSandboxRunner as q, MediaRepository as qn, PortableTextUnknownBlock as qt, getStoredConfig as r, SerializedRequest as rn, apiSuccess as rr, HookResult as rt, extractPlainText as s, GetSectionsOptions as sn, ContentResponse as sr, definePlugin as st, DinewayConfig as t, SandboxRunnerFactory as tn, parseQuery as tr, EmailPipeline as tt, getSuggestions as u, UpdateSectionInput as un, ManifestResponse as ur, EntryFilter as ut, SearchResponse as v, handleMediaList as vn, SessionDatabaseFactory as vt, getBylineBySlug as w, handleRevisionRestore as wn, PreviewSidecarClient as wt, SuggestOptions as x, RevisionResponse as xn, SessionDatabaseLimitError as xt, SearchResult as y, handleMediaUpdate as yn, SessionDatabaseHandle as yt, getPreviewUrl as z, handleContentRestore as zn, portableTextToProsemirror as zt };
+export { Menu as $, portableTextToProsemirror as $n, handleContentPermanentDelete as $r, FileSessionDatabaseFactory as $t, UpdateWidgetInput as A, ApiContext as Ai, TranslationSummary as An, MediaResponse as Ar, PreviewTokenPayload as At, getTerm as B, createEditable as Bn, handleRevisionRestore as Br, createNoopSandboxRunner as Bt, getWidgetArea as C, ParseResult as Ci, CollectionResult as Cn, Section as Cr, isBlockedInPreview as Ct, CreateWidgetInput as D, apiError as Di, EntryResult as Dn, SchemaError as Dr, buildPreviewUrl as Dt, CreateWidgetAreaInput as E, parseQuery as Ei, EditFieldMeta as En, getCollectionInfo as Er, GetPreviewUrlOptions as Et, getEntriesByTerm as F, ManifestResponse as Fi, getTranslations as Fn, handleMediaUpdate as Fr, verifyPreviewToken as Ft, TaxonomyTermRow as G, WhereRange as Gn, handleContentCreate as Gr, HookPipeline as Gt, CreateTermInput as H, CollectionFilter$1 as Hn, handleContentCompare as Hr, createPluginManager as Ht, getEntryTerms as I, resolveDinewayPath as In, RevisionListResponse as Ir, NodeSandboxRunner as It, getBylineBySlug as J, getDb as Jn, handleContentDuplicate as Jr, ValidatedPluginManifest as Jt, UpdateTermInput as K, WhereValue as Kn, handleContentDelete as Kr, HookResult as Kt, getTaxonomyDef as L, CMSAnnotation as Ln, RevisionResponse as Lr, createNodeSandboxRunner as Lt, WidgetArea as M, ContentResponse as Mi, getDinewayCollection as Mn, handleMediaDelete as Mr, VerifyPreviewTokenResult as Mt, WidgetComponentDef as N, FieldDescriptor as Ni, getDinewayEntry as Nn, handleMediaGet as Nr, generatePreviewToken as Nt, PropDef as O, apiSuccess as Oi, InferCollectionData as On, SchemaRegistry as Or, getPreviewUrl as Ot, WidgetType as P, ListResponse as Pi, getEditMeta as Pn, handleMediaList as Pr, parseContentId as Pt, CreateMenuItemInput as Q, hashString as Qn, handleContentListTrashed as Qr, createFilePreviewMiddleware as Qt, getTaxonomyDefs as R, EditProxy as Rn, handleRevisionGet as Rr, NoopSandboxRunner as Rt, Suggestion as S, OptionsRepository as Si, CollectionFilter as Sn, GetSectionsOptions as Sr, renderPreviewLoadingPage as St, getWidgetComponents as T, parseBody as Ti, DinewayCollections as Tn, UpdateSectionInput as Tr, isPreviewRequest as Tt, TaxonomyDef as U, EntryData as Un, handleContentCountScheduled as Ur, PluginRouteError as Ut, getTermsForEntries as V, createNoop as Vn, generateManifest as Vr, PluginManager as Vt, TaxonomyTerm as W, EntryFilter as Wn, handleContentCountTrashed as Wr, EmailPipeline as Wt, getMenus as X, sanitizeHref as Xn, handleContentGetIncludingTrashed as Xr, definePlugin as Xt, getMenu as Y, isSafeHref as Yn, handleContentGet as Yr, pluginManifestSchema as Yt, CreateMenuInput as Z, computeContentHash as Zn, handleContentList as Zr, FilePreviewMiddlewareConfig as Zt, SearchOptions as _, MediaItem as _i, getI18nConfig as _n, SandboxedPlugin as _r, ApplySnapshotToDatabaseOptions as _t, S3StorageConfig as a, handleContentUnschedule as ai, SessionDatabaseLimitError as an, PortableTextMarkDef as ar, GetCommentsOptions as at, SearchStats as b, DatabaseConfig as bi, after as bn, getSections as br, getAppliedSnapshotMeta as bt, extractSearchableFields as c, reference as ci, PreviewSidecarClient as cn, PortableTextUnknownBlock as cr, getComments as ct, search as d, FieldUIHints as di, defaultPreviewSidecarClient as dn, ProseMirrorNode as dr, getSiteSetting as dt, handleContentPublish as ei, FileSessionDatabaseFactoryOptions as en, prosemirrorToPortableText as er, MenuItem as et, searchCollection as f, FileValue as fi, parsePreviewSignatureHeader as fn, SandboxEmailMessage as fr, getSiteSettings as ft, SearchConfig as g, CreateMediaInput as gi, getFallbackChain as gn, SandboxRunnerFactory as gr, AppliedSnapshotMeta as gt, CollectionSearchOptions as h, PublicComment as hi, I18nConfig as hn, SandboxRunner as hr, renderPreviewToolbar as ht, LocalStorageConfig as i, handleContentUnpublish as ii, SessionDatabaseInfo as in, PortableTextLinkMark as ir, UpdateMenuItemInput as it, Widget as j, ContentListResponse as ji, TranslationsResult as jn, handleMediaCreate as jr, VerifyPreviewTokenOptions as jt, ReorderWidgetsInput as k, handleError as ki, ResolvePathResult as kn, MediaListResponse as kr, GeneratePreviewTokenOptions as kt, getSearchStats as l, image as li, PreviewSidecarSignature as ln, ProseMirrorDocument as lr, getPluginSetting as lt, FTSManager as m, PortableTextBlock$1 as mi, verifyPreviewSignature as mn, SandboxOptions as mr, PreviewToolbarConfig as mt, PluginDescriptor as n, handleContentSchedule as ni, SessionDatabaseFactory as nn, PortableTextHtmlBlock as nr, ReorderMenuItemsInput as nt, StorageDescriptor as o, handleContentUpdate as oi, SessionOpenOptions as on, PortableTextSpan as or, GetCommentsResult as ot, searchWithDb as p, ImageValue as pi, signPreviewUrl as pn, SandboxEmailSendCallback as pr, setSiteSettings as pt, getByline as q, dinewayLoader as qn, handleContentDiscardDraft as qr, createHookPipeline as qt, getStoredConfig as r, handleContentTranslations as ri, SessionDatabaseHandle as rn, PortableTextImageBlock as rr, UpdateMenuInput as rt, extractPlainText as s, portableText as si, SessionOpenOrCreateOptions as sn, PortableTextTextBlock as sr, getCommentCount as st, DinewayConfig as t, handleContentRestore as ti, SessionCleanupResult as tn, PortableTextCodeBlock as tr, MenuItemType as tt, getSuggestions as u, FieldDefinition as ui, buildPreviewSignatureHeader as un, ProseMirrorMark as ur, getPluginSettings as ut, SearchResponse as v, MediaRepository as vi, isI18nEnabled as vn, SerializedRequest as vr, applySnapshotToDatabase as vt, getWidgetAreas as w, isParseError as wi, ContentEntry as wn, SectionSource as wr, getPreviewToken as wt, SuggestOptions as x, DinewayDatabaseError as xi, CacheHint as xn, CreateSectionInput as xr, Snapshot as xt, SearchResult as y, ContentRepository as yi, AfterCallback as yn, getSection as yr, dropSessionDatabaseTables as yt, getTaxonomyTerms as z, FieldAnnotation as zn, handleRevisionList as zr, SandboxNotAvailableError as zt };