emdash 0.36.0 → 0.37.0

package/dist/{index-DWbJrsAg.d.mts → index-BJNMCWmu.d.mts}

@@ -1,23 +1,25 @@
-import { r as ContentFieldFilters } from "./content-list-query-BhejKVqb.mjs";
-import { _ as UpdateCollectionInput, a as CollectionWithFields, c as CreateFieldInput, d as Field, p as FieldValidation, s as CreateCollectionInput, t as Collection, v as UpdateFieldInput } from "./types-Br-ERaxh.mjs";
-import { f as UpdateContentInput, i as ContentItem, l as FindManyOptions, o as ContentSeoInput, r as ContentDateField, s as CreateContentInput, t as BylineSummary, u as FindManyResult } from "./types-DJQxln7q.mjs";
-import { d as ContentListResponse, f as ContentResponse, h as ManifestResponse, u as ApiResult } from "./options-BhZIeFY1.mjs";
-import { t as Database } from "./types-DHxzBjbD.mjs";
-import { At as SettingField, B as FieldWidgetConfig, Bt as UserInfo, Ct as PublicPageContext, Dt as ResolvedPlugin, Q as MediaItem$1, Tt as RequestMeta, U as HttpAccess, Vt as WhereClause, _t as PluginManifest, at as PageMetadataEvent, bt as PluginStorageConfig, c as CommentBeforeCreateEvent, ht as PluginDefinition, i as CommentAfterCreateEvent, it as PageMetadataContribution, jt as StorageCollection, k as CronEvent, lt as PaginatedResult, nt as PageFragmentEvent, o as CommentAfterModerateEvent, pt as PluginCapability, tt as PageFragmentContribution, vt as PluginMcpManifestConfig, wt as QueryOptions, xt as PortableTextBlockConfig, z as EmailMessage } from "./types-Vg6f5i3s.mjs";
-import { $n as MediaUsageRepairResponse, Qn as MediaUsageRepairRequest, Rn as MediaUsageActivationAdvanceRequest, Xn as MediaUsageProgress, zn as MediaUsageActivationAdvanceResponse } from "./relations-C7B46bcU.mjs";
-import { _ as MediaValue, f as MediaProvider, m as MediaProviderDescriptor, p as MediaProviderCapabilities } from "./placeholder-BR4ZhVJl.mjs";
-import { T as ContentBylineInput } from "./index-6bRee8zb.mjs";
-import { r as DatabaseDescriptor } from "./adapters-CzL3H752.mjs";
-import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-BzBd3PeX.mjs";
-import { r as ObjectCacheDescriptor } from "./types-D5VVLr7J.mjs";
-import { d as Storage } from "./types-D_DWe7k9.mjs";
-import { i as SiteSettings, r as SiteSettingKey } from "./types-Blb-MRC3.mjs";
+import { r as ContentFieldFilters } from "./content-list-query-Btqd4uV2.mjs";
+import { _ as UpdateCollectionInput, a as CollectionWithFields, c as CreateFieldInput, d as Field, p as FieldValidation, s as CreateCollectionInput, t as Collection, v as UpdateFieldInput } from "./types-xDMtUFnO.mjs";
+import { f as UpdateContentInput, i as ContentItem, l as FindManyOptions, o as ContentSeoInput, r as ContentDateField, s as CreateContentInput, t as BylineSummary, u as FindManyResult } from "./types-BuHW4xDE.mjs";
+import { d as ContentListResponse, f as ContentResponse, u as ApiResult, v as ManifestResponse } from "./options-CYb4y7hM.mjs";
+import { t as Database } from "./types-FV23hEoW.mjs";
+import { At as SettingField, B as FieldWidgetConfig, Bt as UserInfo, Ct as PublicPageContext, Dt as ResolvedPlugin, Q as MediaItem$1, Tt as RequestMeta, U as HttpAccess, Vt as WhereClause, _t as PluginManifest, at as PageMetadataEvent, bt as PluginStorageConfig, c as CommentBeforeCreateEvent, ht as PluginDefinition, i as CommentAfterCreateEvent, it as PageMetadataContribution, jt as StorageCollection, k as CronEvent, lt as PaginatedResult, nt as PageFragmentEvent, o as CommentAfterModerateEvent, pt as PluginCapability, tt as PageFragmentContribution, vt as PluginMcpManifestConfig, wt as QueryOptions, xt as PortableTextBlockConfig, z as EmailMessage } from "./types-B6GrPic4.mjs";
+import { $n as MediaUsageRepairResponse, Qn as MediaUsageRepairRequest, Rn as MediaUsageActivationAdvanceRequest, Xn as MediaUsageProgress, zn as MediaUsageActivationAdvanceResponse } from "./relations-DnRK4YIT.mjs";
+import { _ as MediaValue, f as MediaProvider, m as MediaProviderDescriptor, p as MediaProviderCapabilities } from "./placeholder-4X9BrRrp.mjs";
+import { T as ContentBylineInput } from "./index-Du8K7bWa.mjs";
+import { r as DatabaseDescriptor } from "./adapters-BDQwg236.mjs";
+import { r as AuthProviderDescriptor, t as AuthDescriptor } from "./types-C00oyCZp.mjs";
+import { r as ObjectCacheDescriptor } from "./types-CPeXo1wF.mjs";
+import { d as Storage } from "./types-CXFkwEGC.mjs";
+import { i as SiteSettings, r as SiteSettingKey } from "./types-CDtkNSFQ.mjs";
 import { EmDashManifest } from "./astro/types.mjs";
 import { Dialect, Kysely, sql } from "kysely";
 import { z } from "astro/zod";
-import { z as z$1 } from "zod";
+import { ZodType, z as z$1 } from "zod";
 import { ManifestHookEntry, ManifestRouteEntry } from "@emdash-cms/plugin-types";
 import "@emdash-cms/registry-client/env";
+import "@emdash-cms/registry-client/direct-pds";
+import { Extension, Extensions, Mark, Node } from "@tiptap/core";
 import { LiveLoader } from "astro/loaders";
 
 //#region src/database/errors.d.ts
@@ -38,6 +40,7 @@ interface DatabaseConfig {
 }
 //#endregion
 //#region src/database/repositories/content.d.ts
+type ContentRevisionPrecondition = Pick<ContentItem, "version" | "updatedAt">;
 /**
  * Repository for content CRUD operations
  *
@@ -100,6 +103,7 @@ declare class ContentRepository {
    * Find many content items with filtering and pagination
    */
   findMany(type: string, options?: FindManyOptions): Promise<FindManyResult<ContentItem>>;
+  private normalizeScheduledAt;
   /**
    * Update content
    */
@@ -136,13 +140,19 @@ declare class ContentRepository {
   /**
    * Find trashed content items
    */
-  findTrashed(type: string, options?: Omit<FindManyOptions, "where">): Promise<FindManyResult<ContentItem & {
+  findTrashed(type: string, options?: Omit<FindManyOptions, "where"> & {
+    where?: {
+      locale?: string;
+    };
+  }): Promise<FindManyResult<ContentItem & {
     deletedAt: string;
   }>>;
   /**
    * Count trashed content items
    */
-  countTrashed(type: string): Promise<number>;
+  countTrashed(type: string, options?: {
+    locale?: string;
+  }): Promise<number>;
   /**
    * Apply the optional `q` filter.
    *
@@ -288,14 +298,14 @@ declare class ContentRepository {
    * `expectedScheduledAt` additionally fences changes made after a sweep
    * selected the row but before publication preparation began.
    */
-  publish(type: string, id: string, publishedAt?: string, requireDue?: boolean, expectedScheduledAt?: string, promoteRevision?: boolean, requireSlug?: boolean): Promise<ContentItem>;
+  publish(type: string, id: string, publishedAt?: string, requireDue?: boolean, expectedScheduledAt?: string, promoteRevision?: boolean, requireSlug?: boolean, expectedRevision?: ContentRevisionPrecondition): Promise<ContentItem>;
   /**
    * Unpublish content
    *
-   * Removes live pointer but preserves draft. If no draft exists,
-   * creates one from the live version so the content isn't lost.
+   * Removes live pointer but preserves the draft and publication date. If no
+   * draft exists, creates one from the live version so the content isn't lost.
    */
-  unpublish(type: string, id: string): Promise<ContentItem>;
+  unpublish(type: string, id: string, expectedRevision?: ContentRevisionPrecondition): Promise<ContentItem>;
   /**
    * Set the draft revision pointer for a content item.
    *
@@ -315,7 +325,7 @@ declare class ContentRepository {
    * Clears draft_revision_id. The content table columns already hold the
    * published version, so no data sync is needed.
    */
-  discardDraft(type: string, id: string): Promise<ContentItem>;
+  discardDraft(type: string, id: string, expectedRevision?: ContentRevisionPrecondition): Promise<ContentItem>;
   /**
    * Count content items with a pending schedule.
    * Includes both draft-scheduled (status='scheduled') and published
@@ -383,6 +393,7 @@ interface CreateMediaInput {
   dominantColor?: string;
   status?: MediaStatus;
   authorId?: string;
+  folderId?: string | null;
 }
 interface FindManyMediaOptions {
   limit?: number;
@@ -402,6 +413,12 @@ interface UpdateMediaInput extends FocalPointUpdate {
   height?: number;
   folderId?: string | null;
 }
+interface ReplaceReadyMediaInput {
+  size: number;
+  width: number;
+  height: number;
+  contentHash: string;
+}
 interface FindMediaPageOptions extends Omit<FindManyMediaOptions, "cursor"> {
   page: number;
 }
@@ -429,6 +446,7 @@ declare class MediaRepository {
     storageKey: string;
     contentHash?: string;
     authorId?: string;
+    folderId?: string | null;
   }): Promise<MediaItem>;
   createUploadAttempt(mediaId: string, storageKey: string): Promise<void>;
   hasUploadAttempt(storageKey: string): Promise<boolean>;
@@ -461,6 +479,7 @@ declare class MediaRepository {
    * Useful for idempotent imports
    */
   findByFilename(filename: string): Promise<MediaItem | null>;
+  findAvailableFilename(filename: string): Promise<string>;
   /**
    * Find media by content hash
    * Used for deduplication - same content = same hash
@@ -478,6 +497,7 @@ declare class MediaRepository {
    * Update media metadata
    */
   update(id: string, input: UpdateMediaInput): Promise<MediaItem | null>;
+  replaceReadyFile(id: string, expectedStorageKey: string, input: ReplaceReadyMediaInput): Promise<MediaItem | null>;
   /**
    * Delete media item
    */
@@ -626,11 +646,6 @@ interface PublicComment {
 }
 //#endregion
 //#region src/database/repositories/plugin-storage.d.ts
-/**
- * Plugin Storage Repository
- *
- * Implements the StorageCollection interface for a specific plugin and collection.
- */
 declare class PluginStorageRepository<T = unknown> implements StorageCollection<T> {
   private db;
   private pluginId;
@@ -702,7 +717,7 @@ type ColumnType = "TEXT" | "REAL" | "INTEGER" | "JSON";
 /**
  * Base field definition
  *
- * Note: schema uses z.ZodTypeAny to accommodate optional/default wrappers
+ * Note: schema uses z.ZodType to accommodate optional/default wrappers
  */
 interface FieldDefinition<_T = unknown> {
   type: string;
@@ -710,7 +725,7 @@ interface FieldDefinition<_T = unknown> {
    * The SQLite column type to use when storing this field
    */
   columnType: ColumnType;
-  schema: z.ZodTypeAny;
+  schema: z.ZodType;
   options?: unknown;
   ui?: FieldUIHints;
   validation?: FieldValidation;
@@ -813,6 +828,8 @@ interface TrashedContentItem {
   type: string;
   slug: string | null;
   status: string;
+  locale: string | null;
+  translationGroup: string | null;
   data: Record<string, unknown>;
   authorId: string | null;
   createdAt: string;
@@ -943,6 +960,7 @@ declare function handleContentPermanentDelete(db: Kysely<Database>, collection:
 declare function handleContentListTrashed(db: Kysely<Database>, collection: string, options?: {
   limit?: number;
   cursor?: string;
+  locale?: string;
 }): Promise<ApiResult<{
   items: TrashedContentItem[];
   nextCursor?: string;
@@ -950,7 +968,9 @@ declare function handleContentListTrashed(db: Kysely<Database>, collection: stri
 /**
  * Count trashed content items
  */
-declare function handleContentCountTrashed(db: Kysely<Database>, collection: string): Promise<ApiResult<{
+declare function handleContentCountTrashed(db: Kysely<Database>, collection: string, options?: {
+  locale?: string;
+}): Promise<ApiResult<{
   count: number;
 }>>;
 /**
@@ -971,6 +991,7 @@ declare function handleContentPublish(db: Kysely<Database>, collection: string,
   publishedAt?: string;
   requireScheduledDue?: boolean;
   expectedScheduledAt?: string;
+  _rev?: string;
 }): Promise<ApiResult<ContentResponse>>;
 /**
  * Unpublish content (revert to draft).
@@ -978,7 +999,9 @@ declare function handleContentPublish(db: Kysely<Database>, collection: string,
  * Wrapped in a transaction — unpublish may create a draft revision
  * from the live version then update the status, which is multi-step.
  */
-declare function handleContentUnpublish(db: Kysely<Database>, collection: string, id: string): Promise<ApiResult<ContentResponse>>;
+declare function handleContentUnpublish(db: Kysely<Database>, collection: string, id: string, options?: {
+  _rev?: string;
+}): Promise<ApiResult<ContentResponse>>;
 /**
  * Count scheduled content items
  */
@@ -988,7 +1011,9 @@ declare function handleContentCountScheduled(db: Kysely<Database>, collection: s
 /**
  * Discard draft changes (revert to live version)
  */
-declare function handleContentDiscardDraft(db: Kysely<Database>, collection: string, id: string): Promise<ApiResult<ContentResponse>>;
+declare function handleContentDiscardDraft(db: Kysely<Database>, collection: string, id: string, options?: {
+  _rev?: string;
+}): Promise<ApiResult<ContentResponse>>;
 /**
  * Compare live and draft revisions
  */
@@ -1028,6 +1053,9 @@ interface CollectionDefinition {
   };
 }
 type CollectionMap = Record<string, CollectionDefinition>;
+interface GenerateManifestOptions {
+  db?: Kysely<Database> | null;
+}
 /**
  * Generate admin manifest from collections
  */
@@ -1037,7 +1065,7 @@ declare function generateManifest(collections: CollectionMap, plugins?: Record<s
     component: string;
   }>;
   widgets?: string[];
-}>): Promise<ManifestResponse>;
+}>, options?: GenerateManifestOptions): Promise<ManifestResponse>;
 //#endregion
 //#region src/api/handlers/revision.d.ts
 interface RevisionListResponse {
@@ -1101,6 +1129,7 @@ declare function handleMediaCreate(db: Kysely<Database>, input: {
   blurhash?: string;
   dominantColor?: string;
   authorId?: string;
+  folderId?: string | null;
 }): Promise<ApiResult<MediaResponse>>;
 /**
  * Update media metadata
@@ -1112,6 +1141,12 @@ declare function handleMediaUpdate(db: Kysely<Database>, id: string, input: {
   height?: number;
   folderId?: string | null;
 } & FocalPointUpdate): Promise<ApiResult<MediaResponse>>;
+declare function handleMediaReplaceMetadata(db: Kysely<Database>, id: string, expectedStorageKey: string, input: {
+  size: number;
+  width: number;
+  height: number;
+  contentHash: string;
+}): Promise<ApiResult<MediaResponse>>;
 /**
  * Delete media item
  */
@@ -1149,6 +1184,10 @@ declare class SchemaError extends Error {
 declare class SchemaRegistry {
   private db;
   constructor(db: Kysely<Database>);
+  /**
+   * Notify the dev typegen hook that the schema has changed.
+   */
+  private notifyTypegen;
   /**
    * List all collections
    */
@@ -2625,9 +2664,10 @@ declare class HookPipeline {
   private runLifecycleHook;
   /**
    * Run content:beforeSave hooks
-   * Returns modified content from the pipeline
+   * Returns modified content from the pipeline. `id` is the existing item's
+   * ID when updating.
    */
-  runContentBeforeSave(content: Record<string, unknown>, collection: string, isNew: boolean): Promise<{
+  runContentBeforeSave(content: Record<string, unknown>, collection: string, isNew: boolean, id?: string): Promise<{
     content: Record<string, unknown>;
     results: HookResult<Record<string, unknown>>[];
   }>;
@@ -3622,6 +3662,7 @@ declare class EmDashRuntime {
   handleContentListTrashed(collection: string, params?: {
     cursor?: string;
     limit?: number;
+    locale?: string;
   }): Promise<ApiResult<{
     items: TrashedContentItem[];
     nextCursor?: string;
@@ -3634,7 +3675,9 @@ declare class EmDashRuntime {
     deleted: true;
     id: string;
   }>>;
-  handleContentCountTrashed(collection: string): Promise<ApiResult<{
+  handleContentCountTrashed(collection: string, params?: {
+    locale?: string;
+  }): Promise<ApiResult<{
     count: number;
   }>>;
   handleContentDuplicate(collection: string, id: string, authorId?: string): Promise<ApiResult<{
@@ -3644,14 +3687,19 @@ declare class EmDashRuntime {
     publishedAt?: string;
     requireScheduledDue?: boolean;
     expectedScheduledAt?: string;
+    _rev?: string;
+  }): Promise<ApiResult<ContentResponse>>;
+  handleContentUnpublish(collection: string, id: string, options?: {
+    _rev?: string;
   }): Promise<ApiResult<ContentResponse>>;
-  handleContentUnpublish(collection: string, id: string): Promise<ApiResult<ContentResponse>>;
   handleContentSchedule(collection: string, id: string, scheduledAt: string): Promise<ApiResult<ContentResponse>>;
   handleContentUnschedule(collection: string, id: string): Promise<ApiResult<ContentResponse>>;
   handleContentCountScheduled(collection: string): Promise<ApiResult<{
     count: number;
   }>>;
-  handleContentDiscardDraft(collection: string, id: string): Promise<ApiResult<ContentResponse>>;
+  handleContentDiscardDraft(collection: string, id: string, options?: {
+    _rev?: string;
+  }): Promise<ApiResult<ContentResponse>>;
   handleContentCompare(collection: string, id: string): Promise<ApiResult<{
     hasChanges: boolean;
     live: Record<string, unknown> | null;
@@ -3687,6 +3735,7 @@ declare class EmDashRuntime {
     blurhash?: string;
     dominantColor?: string;
     authorId?: string;
+    folderId?: string | null;
   }): Promise<ApiResult<MediaResponse>>;
   handleMediaUpdate(id: string, input: {
     alt?: string;
@@ -3697,6 +3746,12 @@ declare class EmDashRuntime {
     focalX?: number | null;
     focalY?: number | null;
   }): Promise<ApiResult<MediaResponse>>;
+  handleMediaReplaceMetadata(id: string, expectedStorageKey: string, input: {
+    size: number;
+    width: number;
+    height: number;
+    contentHash: string;
+  }): Promise<ApiResult<MediaResponse>>;
   handleMediaDelete(id: string): Promise<ApiResult<{
     deleted: true;
     storageKey: string;
@@ -3961,6 +4016,7 @@ interface PortableTextImageBlock {
   displayWidth?: number;
   /** Display height for this instance (overrides original) */
   displayHeight?: number;
+  alignment?: "left" | "center" | "right" | "wide" | "full";
 }
 /**
  * A single image inside a gallery block. Mirrors the shape produced by
@@ -4051,10 +4107,18 @@ interface ProseMirrorDocument {
 declare function prosemirrorToPortableText(doc: ProseMirrorDocument): PortableTextBlock[];
 //#endregion
 //#region src/content/converters/portable-text-to-prosemirror.d.ts
-/**
- * Convert Portable Text to ProseMirror document
- */
-declare function portableTextToProsemirror(blocks: PortableTextBlock[]): ProseMirrorDocument;
+interface PortableTextToProsemirrorOptions {
+  /**
+   * Preserve custom blocks and Portable Text keys through a ProseMirror round trip.
+   * Add `portableTextIdentityExtensions` to the TipTap schema when this is enabled.
+   */
+  preserveIdentity?: boolean;
+}
+/** Convert Portable Text to a ProseMirror document. */
+declare function portableTextToProsemirror(blocks: PortableTextBlock[], options?: PortableTextToProsemirrorOptions): ProseMirrorDocument;
+//#endregion
+//#region src/content/converters/portable-text-identity.d.ts
+declare const portableTextIdentityExtensions: Extensions;
 //#endregion
 //#region src/utils/hash.d.ts
 /**
@@ -4782,7 +4846,7 @@ declare function definePlugin<TStorage extends PluginStorageConfig>(definition:
  * to make them consistent (declaredAccess authoritative when present). Kept a
  * plain object (no `.transform`) because callers `.pick()`/`.extend()` it.
  */
-declare const pluginManifestSchema: z$1.ZodObject<{
+declare const pluginManifestSchema$1: z$1.ZodObject<{
   id: z$1.ZodString;
   version: z$1.ZodString;
   declaredAccess: z$1.ZodOptional<z$1.ZodObject<{
@@ -4985,8 +5049,8 @@ declare const pluginManifestSchema: z$1.ZodObject<{
         string: "string";
         number: "number";
         boolean: "boolean";
-        slug: "slug";
         file: "file";
+        slug: "slug";
         image: "image";
         datetime: "datetime";
         text: "text";
@@ -5006,7 +5070,7 @@ declare const pluginManifestSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>>;
   }, z$1.core.$strip>;
 }, z$1.core.$strip>;
-type ValidatedPluginManifest = z$1.infer<typeof pluginManifestSchema>;
+type ValidatedPluginManifest = z$1.infer<typeof pluginManifestSchema$1>;
 //#endregion
 //#region src/plugins/save-rejection.d.ts
 /**
@@ -5101,7 +5165,7 @@ declare class PluginManager {
   /**
    * Run content:beforeSave hooks across all active plugins
    */
-  runContentBeforeSave(content: Record<string, unknown>, collection: string, isNew: boolean): Promise<{
+  runContentBeforeSave(content: Record<string, unknown>, collection: string, isNew: boolean, id?: string): Promise<{
     content: Record<string, unknown>;
     results: HookResult<Record<string, unknown>>[];
   }>;
@@ -5553,6 +5617,16 @@ declare function getSiteSetting<K extends SiteSettingKey>(key: K): Promise<SiteS
  * ```
  */
 declare function getSiteSettings(): Promise<Partial<SiteSettings>>;
+/**
+ * Get all site settings with a Workers edge-cache hint.
+ *
+ * Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+ * settings can be purged automatically when site settings change.
+ */
+declare function getSiteSettingsWithCacheHint(): Promise<{
+  data: Partial<SiteSettings>;
+  cacheHint: CacheHint;
+}>;
 /**
  * Set site settings (internal function used by admin API)
  *
@@ -5749,6 +5823,16 @@ declare function getMenus(options?: MenuQueryOptions): Promise<Array<{
   label: string;
   locale: string;
 }>>;
+/**
+ * Get a menu by name with a Workers edge-cache hint.
+ *
+ * Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+ * this menu can be purged automatically when the menu is edited.
+ */
+declare function getMenuWithCacheHint(name: string, options?: MenuQueryOptions): Promise<{
+  data: Menu | null;
+  cacheHint: CacheHint;
+}>;
 //#endregion
 //#region src/bylines/index.d.ts
 /**
@@ -5951,12 +6035,27 @@ declare function getTaxonomyDef(name: string, options?: TaxonomyQueryOptions): P
  * the term list with callers that do.
  */
 declare function getTaxonomyTerms(taxonomyName: string, options?: TaxonomyTermsOptions): Promise<TaxonomyTerm[]>;
+/**
+ * Get all terms of a taxonomy with a Workers edge-cache hint.
+ *
+ * Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+ * a taxonomy facet can be purged automatically when taxonomy terms change.
+ */
+declare function getTaxonomyTermsWithCacheHint(taxonomyName: string, options?: TaxonomyTermsOptions): Promise<{
+  data: TaxonomyTerm[];
+  cacheHint: CacheHint;
+}>;
 /**
  * Get a single term by (taxonomy, slug). Honours the fallback chain — if the
  * slug exists in a fallback locale, we return that row (useful for deep-linking
  * to a term page when the translation is missing).
+ *
+ * The term row and its visible-entry count are loaded and cached separately: the
+ * row depends only on the taxonomy epoch, while the count adds an aggregate over
+ * the whole assignment pivot and every counted collection's content epoch. A
+ * caller that renders no count passes `includeCounts: false` and skips it.
  */
-declare function getTerm(taxonomyName: string, slug: string, options?: TaxonomyQueryOptions): Promise<TaxonomyTerm | null>;
+declare function getTerm(taxonomyName: string, slug: string, options?: TaxonomyTermsOptions): Promise<TaxonomyTerm | null>;
 /**
  * Terms assigned to a content entry, resolved into the active locale and then
  * the configured default locale.
@@ -6040,6 +6139,16 @@ interface ReorderWidgetsInput {
  * row with null widget columns, which we skip when mapping.
  */
 declare function getWidgetArea(name: string): Promise<WidgetArea | null>;
+/**
+ * Get a widget area by name with a Workers edge-cache hint.
+ *
+ * Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+ * this widget area can be purged automatically when its widgets change.
+ */
+declare function getWidgetAreaWithCacheHint(name: string): Promise<{
+  data: WidgetArea | null;
+  cacheHint: CacheHint;
+}>;
 /**
  * Get all widget areas with their widgets
  */
@@ -6449,5 +6558,5 @@ declare function extractPlainText(blocks: PortableTextBlock[] | string | null |
  */
 declare function extractSearchableFields(entry: Record<string, unknown>, fields: string[]): Record<string, string>;
 //#endregion
-export { MenuItem as $, PluginRouteError as $n, handleContentCreate as $r, ContentEntry as $t, WidgetType as A, ContentRepository as Ai, PortableTextCodeBlock as An, SchemaError as Ar, createPluginManager as At, CreateTermInput as B, ProseMirrorNode as Bn, handleMediaGet as Br, contentNamespaces as Bt, CreateWidgetInput as C, PortableTextBlock$1 as Ci, getDb as Cn, EmDashConfig as Cr, parseContentId as Ct, Widget as D, CreateMediaInput as Di, hashString as Dn, S3StorageConfig as Dr, createNoopSandboxRunner as Dt, UpdateWidgetInput as E, UserRepository as Ei, computeContentHash as En, LocalStorageConfig as Er, SandboxNotAvailableError as Et, getTaxonomyDefs as F, PortableTextSpan as Fn, markContentMediaUsageCollectionStaleSafely as Fr, definePlugin as Ft, getByline as G, Section as Gn, handleRevisionGet as Gr, invalidateObjectCache as Gt, TaxonomyTerm as H, getSections as Hn, handleMediaUpdate as Hr, invalidateCollectionCache as Ht, getTaxonomyTerms as I, PortableTextTextBlock as In, MediaListResponse as Ir, CacheNamespace as It, getMenu as J, EmDashRuntime as Jn, generateManifest as Jr, WaitUntilFn as Jt, getBylineBySlug as K, SectionSource as Kn, handleRevisionList as Kr, invalidateSchemaObjectCache as Kt, getTerm as L, PortableTextUnknownBlock as Ln, MediaResponse as Lr, CachedQueryOptions as Lt, getEntriesByTerm as M, EmDashDatabaseError as Mi, PortableTextImageBlock as Mn, handleMediaUsageActivationAdvance as Mr, isContentSaveRejection as Mt, getEntryTerms as N, PortableTextLinkMark as Nn, handleMediaUsageProgress as Nr, ValidatedPluginManifest as Nt, WidgetArea as O, MediaItem as Oi, portableTextToProsemirror as On, StorageDescriptor as Or, NodeCronScheduler as Ot, getTaxonomyDef as P, PortableTextMarkDef as Pn, handleMediaUsageRepair as Pr, pluginManifestSchema as Pt, Menu as Q, SystemCleanupFn as Qn, handleContentCountTrashed as Qr, CollectionResult as Qt, getTermsForEntries as R, ProseMirrorDocument as Rn, handleMediaCreate as Rr, cachedQuery as Rt, CreateWidgetAreaInput as S, ImageValue as Si, emdashLoader as Sn, getSandboxRouteErrorEnvelope as Sr, generatePreviewToken as St, ReorderWidgetsInput as T, PluginStorageRepository as Ti, sanitizeHref as Tn, getStoredConfig as Tr, NoopSandboxRunner as Tt, TaxonomyTermRow as U, CreateSectionInput as Un, RevisionListResponse as Ur, invalidateCommentObjectCache as Ut, TaxonomyDef as V, getSection as Vn, handleMediaList as Vr, invalidateBylineObjectCache as Vt, UpdateTermInput as W, GetSectionsOptions as Wn, RevisionResponse as Wr, invalidateMenuObjectCache as Wt, CreateMenuInput as X, PublishedRef as Xn, handleContentCompare as Xr, CacheHint as Xt, getMenus as Y, SandboxedPluginEntry as Yn, handleContentAuthors as Yr, after as Yt, CreateMenuItemInput as Z, CronScheduler as Zn, handleContentCountScheduled as Zr, CollectionFilter as Zt, SuggestOptions as _, file as _i, CollectionFilter$1 as _n, SandboxedPluginInstance as _r, getPreviewUrl as _t, search as a, handleContentList as ai, TranslationSummary as an, createHookPipeline as ar, GetCommentsResult as at, getWidgetAreas as b, FieldUIHints as bi, WhereRange as bn, createSandboxRouteErrorEnvelope as br, VerifyPreviewTokenOptions as bt, FTSManager as c, handleContentPublish as ci, getEmDashCollection as cn, SandboxEmailMessage as cr, getPluginSetting as ct, SearchConfig as d, handleContentTranslations as di, resolveEmDashPath as dn, SandboxRouteErrorCode as dr, getSiteSettings as dt, handleContentDelete as ei, EditFieldMeta as en, RouteCallerInput as er, MenuItemType as et, SearchOptions as f, handleContentUnpublish as fi, CMSAnnotation as fn, SandboxRouteErrorDetails as fr, setSiteSettings as ft, SearchTokenizer as g, reference as gi, createNoop as gn, SandboxUnavailableError as gr, buildPreviewUrl as gt, SearchStats as h, portableText as hi, createEditable as hn, SandboxRunnerFactory as hr, GetPreviewUrlOptions as ht, getSuggestions as i, handleContentGetIncludingTrashed as ii, ResolvePathResult as in, HookResult as ir, GetCommentsOptions as it, getAllTermsForEntries as j, DatabaseConfig as ji, PortableTextHtmlBlock as jn, SchemaRegistry as jr, ContentSaveRejectedError as jt, WidgetComponentDef as k, MediaRepository as ki, prosemirrorToPortableText as kn, getCollectionInfo as kr, PluginManager as kt, CollectionSearchOptions as l, handleContentRestore as li, getEmDashEntry as ln, SandboxEmailSendCallback as lr, getPluginSettings as lt, SearchResult as m, handleContentUpdate as mi, FieldAnnotation as mn, SandboxRunner as mr, isPreviewRequest as mt, extractSearchableFields as n, handleContentDuplicate as ni, EntryResult as nn, EmailPipeline as nr, UpdateMenuInput as nt, searchCollection as o, handleContentListTrashed as oi, TranslationsResult as on, createHttpAccess as or, getCommentCount as ot, SearchResponse as p, handleContentUnschedule as pi, EditProxy as pn, SandboxRouteErrorEnvelope as pr, getPreviewToken as pt, getEntriesByByline as q, UpdateSectionInput as qn, handleRevisionRestore as qr, invalidateTaxonomyObjectCache as qt, getSearchStats as r, handleContentGet as ri, InferCollectionData as rn, HookPipeline as rr, UpdateMenuItemInput as rt, searchWithDb as s, handleContentPermanentDelete as si, getEditMeta as sn, createUnrestrictedHttpAccess as sr, getComments as st, extractPlainText as t, handleContentDiscardDraft as ti, EmDashCollections as tn, RouteMeta as tr, ReorderMenuItemsInput as tt, SEARCH_TOKENIZERS as u, handleContentSchedule as ui, getTranslations as un, SandboxOptions as ur, getSiteSetting as ut, Suggestion as v, image as vi, EntryData as vn, SerializedRequest as vr, GeneratePreviewTokenOptions as vt, PropDef as w, CompoundSelectLimitedAdapter as wi, isSafeHref as wn, PluginDescriptor as wr, verifyPreviewToken as wt, getWidgetComponents as x, FileValue as xi, WhereValue as xn, getSandboxRouteErrorDetails as xr, VerifyPreviewTokenResult as xt, getWidgetArea as y, FieldDefinition as yi, EntryFilter as yn, createSandboxRouteError as yr, PreviewTokenPayload as yt, invalidateTermCache as z, ProseMirrorMark as zn, handleMediaDelete as zr, contentNamespace as zt };
-//# sourceMappingURL=index-DWbJrsAg.d.mts.map
+export { CreateMenuInput as $, UpdateSectionInput as $n, handleRevisionList as $r, after as $t, WidgetComponentDef as A, PortableTextBlock$1 as Ai, computeContentHash as An, PluginDescriptor as Ar, SandboxNotAvailableError as At, getTermsForEntries as B, PortableTextMarkDef as Bn, handleMediaUsageRepair as Br, CacheNamespace as Bt, CreateWidgetAreaInput as C, reference as Ci, EntryFilter as Cn, SandboxedPluginInstance as Cr, PreviewTokenPayload as Ct, UpdateWidgetInput as D, FieldUIHints as Di, getDb as Dn, getSandboxRouteErrorDetails as Dr, parseContentId as Dt, ReorderWidgetsInput as E, FieldDefinition as Ei, emdashLoader as En, createSandboxRouteErrorEnvelope as Er, generatePreviewToken as Et, getTaxonomyDef as F, MediaItem as Fi, prosemirrorToPortableText as Fn, getCollectionInfo as Fr, ContentSaveRejectedError as Ft, TaxonomyTermRow as G, ProseMirrorMark as Gn, handleMediaDelete as Gr, invalidateBylineObjectCache as Gt, CreateTermInput as H, PortableTextTextBlock as Hn, MediaListResponse as Hr, cachedQuery as Ht, getTaxonomyDefs as I, MediaRepository as Ii, PortableTextCodeBlock as In, SchemaError as Ir, isContentSaveRejection as It, getBylineBySlug as J, getSections as Jn, handleMediaReplaceMetadata as Jr, invalidateMenuObjectCache as Jt, UpdateTermInput as K, ProseMirrorNode as Kn, handleMediaGet as Kr, invalidateCollectionCache as Kt, getTaxonomyTerms as L, ContentRepository as Li, PortableTextHtmlBlock as Ln, SchemaRegistry as Lr, ValidatedPluginManifest as Lt, getAllTermsForEntries as M, PluginStorageRepository as Mi, portableTextIdentityExtensions as Mn, LocalStorageConfig as Mr, NodeCronScheduler as Mt, getEntriesByTerm as N, UserRepository as Ni, PortableTextToProsemirrorOptions as Nn, S3StorageConfig as Nr, PluginManager as Nt, Widget as O, FileValue as Oi, isSafeHref as On, getSandboxRouteErrorEnvelope as Or, verifyPreviewToken as Ot, getEntryTerms as P, CreateMediaInput as Pi, portableTextToProsemirror as Pn, StorageDescriptor as Pr, createPluginManager as Pt, getMenus as Q, SectionSource as Qn, handleRevisionGet as Qr, WaitUntilFn as Qt, getTaxonomyTermsWithCacheHint as R, DatabaseConfig as Ri, PortableTextImageBlock as Rn, handleMediaUsageActivationAdvance as Rr, pluginManifestSchema$1 as Rt, getWidgetComponents as S, portableText as Si, EntryData as Sn, SandboxUnavailableError as Sr, GeneratePreviewTokenOptions as St, PropDef as T, image as Ti, WhereValue as Tn, createSandboxRouteError as Tr, VerifyPreviewTokenResult as Tt, TaxonomyDef as U, PortableTextUnknownBlock as Un, MediaResponse as Ur, contentNamespace as Ut, invalidateTermCache as V, PortableTextSpan as Vn, markContentMediaUsageCollectionStaleSafely as Vr, CachedQueryOptions as Vt, TaxonomyTerm as W, ProseMirrorDocument as Wn, handleMediaCreate as Wr, contentNamespaces as Wt, getMenu as X, GetSectionsOptions as Xn, RevisionListResponse as Xr, invalidateSchemaObjectCache as Xt, getEntriesByByline as Y, CreateSectionInput as Yn, handleMediaUpdate as Yr, invalidateObjectCache as Yt, getMenuWithCacheHint as Z, Section as Zn, RevisionResponse as Zr, invalidateTaxonomyObjectCache as Zt, SuggestOptions as _, handleContentSchedule as _i, EditProxy as _n, SandboxRouteErrorCode as _r, getPreviewToken as _t, search as a, handleContentCountTrashed as ai, EmDashCollections as an, PluginRouteError as ar, UpdateMenuInput as at, getWidgetAreaWithCacheHint as b, handleContentUnschedule as bi, createNoop as bn, SandboxRunner as br, buildPreviewUrl as bt, FTSManager as c, handleContentDiscardDraft as ci, ResolvePathResult as cn, EmailPipeline as cr, GetCommentsResult as ct, SearchConfig as d, handleContentGetIncludingTrashed as di, getEditMeta as dn, createHookPipeline as dr, getPluginSetting as dt, handleRevisionRestore as ei, CacheHint as en, EmDashRuntime as er, CreateMenuItemInput as et, SearchOptions as f, handleContentList as fi, getEmDashCollection as fn, createHttpAccess as fr, getPluginSettings as ft, SearchTokenizer as g, handleContentRestore as gi, CMSAnnotation as gn, SandboxOptions as gr, setSiteSettings as gt, SearchStats as h, handleContentPublish as hi, resolveEmDashPath as hn, SandboxEmailSendCallback as hr, getSiteSettingsWithCacheHint as ht, getSuggestions as i, handleContentCountScheduled as ii, EditFieldMeta as in, SystemCleanupFn as ir, ReorderMenuItemsInput as it, WidgetType as j, CompoundSelectLimitedAdapter as ji, hashString as jn, getStoredConfig as jr, createNoopSandboxRunner as jt, WidgetArea as k, ImageValue as ki, sanitizeHref as kn, EmDashConfig as kr, NoopSandboxRunner as kt, CollectionSearchOptions as l, handleContentDuplicate as li, TranslationSummary as ln, HookPipeline as lr, getCommentCount as lt, SearchResult as m, handleContentPermanentDelete as mi, getTranslations as mn, SandboxEmailMessage as mr, getSiteSettings as mt, extractSearchableFields as n, handleContentAuthors as ni, CollectionResult as nn, PublishedRef as nr, MenuItem as nt, searchCollection as o, handleContentCreate as oi, EntryResult as on, RouteCallerInput as or, UpdateMenuItemInput as ot, SearchResponse as p, handleContentListTrashed as pi, getEmDashEntry as pn, createUnrestrictedHttpAccess as pr, getSiteSetting as pt, getByline as q, getSection as qn, handleMediaList as qr, invalidateCommentObjectCache as qt, getSearchStats as r, handleContentCompare as ri, ContentEntry as rn, CronScheduler as rr, MenuItemType as rt, searchWithDb as s, handleContentDelete as si, InferCollectionData as sn, RouteMeta as sr, GetCommentsOptions as st, extractPlainText as t, generateManifest as ti, CollectionFilter as tn, SandboxedPluginEntry as tr, Menu as tt, SEARCH_TOKENIZERS as u, handleContentGet as ui, TranslationsResult as un, HookResult as ur, getComments as ut, Suggestion as v, handleContentTranslations as vi, FieldAnnotation as vn, SandboxRouteErrorDetails as vr, isPreviewRequest as vt, CreateWidgetInput as w, file as wi, WhereRange as wn, SerializedRequest as wr, VerifyPreviewTokenOptions as wt, getWidgetAreas as x, handleContentUpdate as xi, CollectionFilter$1 as xn, SandboxRunnerFactory as xr, getPreviewUrl as xt, getWidgetArea as y, handleContentUnpublish as yi, createEditable as yn, SandboxRouteErrorEnvelope as yr, GetPreviewUrlOptions as yt, getTerm as z, EmDashDatabaseError as zi, PortableTextLinkMark as zn, handleMediaUsageProgress as zr, definePlugin as zt };
+//# sourceMappingURL=index-BJNMCWmu.d.mts.map