emdash 0.39.0 → 0.40.0

package/dist/placeholder-MSEd8gty.d.mts

@@ -0,0 +1,306 @@
+//#region src/media/types.d.ts
+/**
+ * Media Provider Types
+ *
+ * Media providers are pluggable sources for browsing, uploading, and embedding media.
+ * They enable integration with external services (Unsplash, Cloudinary, Mux, etc.)
+ * alongside the built-in local media library.
+ */
+/**
+ * Serializable media provider configuration descriptor
+ * Returned by provider config functions (e.g., unsplash(), mux())
+ */
+interface MediaProviderDescriptor<TConfig = Record<string, unknown>> {
+  /** Unique identifier, used in MediaValue.provider */
+  id: string;
+  /** Display name for admin UI */
+  name: string;
+  /** Icon for tab UI (emoji or URL) */
+  icon?: string;
+  /** Module path exporting createMediaProvider function */
+  entrypoint: string;
+  /** Optional React component module for custom admin UI */
+  adminModule?: string;
+  /** Capability flags determine UI behavior */
+  capabilities: MediaProviderCapabilities;
+  /** Serializable config passed to createMediaProvider at runtime */
+  config: TConfig;
+}
+/**
+ * Provider capabilities determine what UI elements to show
+ */
+interface MediaProviderCapabilities {
+  /** Can list/browse media */
+  browse: boolean;
+  /** Supports text search */
+  search: boolean;
+  /** Can upload new media */
+  upload: boolean;
+  /** Can delete media */
+  delete: boolean;
+}
+/**
+ * Options for listing media
+ */
+interface MediaListOptions {
+  /** Pagination cursor */
+  cursor?: string;
+  /** Max items to return (default 20) */
+  limit?: number;
+  /** Search query (if capabilities.search is true) */
+  query?: string;
+  /** Filter by MIME type prefix, e.g., "image/", "video/" */
+  mimeType?: string;
+}
+/**
+ * Result from listing media
+ */
+interface MediaListResult {
+  items: MediaProviderItem[];
+  nextCursor?: string;
+}
+/**
+ * A media item as returned by a provider
+ * This is the provider's view of the item, before it's selected
+ */
+interface MediaProviderItem {
+  /** Provider-specific ID */
+  id: string;
+  /** Original filename */
+  filename: string;
+  /** MIME type */
+  mimeType: string;
+  /** File size in bytes (if known) */
+  size?: number;
+  /** Dimensions (for images/video) */
+  width?: number;
+  height?: number;
+  /** Default focal point for cover-cropped displays */
+  focalX?: number;
+  focalY?: number;
+  /** LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  /** Accessibility text */
+  alt?: string;
+  /** Preview URL for admin UI thumbnail */
+  previewUrl?: string;
+  /** Provider-specific metadata */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Input for uploading media
+ */
+interface MediaUploadInput {
+  file: File;
+  filename: string;
+  alt?: string;
+}
+/**
+ * Options for generating embed
+ */
+interface EmbedOptions {
+  /** Desired width (provider may use for optimization) */
+  width?: number;
+  /** Desired height */
+  height?: number;
+  /** Image format preference */
+  format?: "webp" | "avif" | "jpeg" | "png" | "auto";
+}
+/**
+ * Embed result types
+ */
+type EmbedResult = ImageEmbed | VideoEmbed | AudioEmbed | ComponentEmbed;
+interface ImageEmbed {
+  type: "image";
+  src: string;
+  srcset?: string;
+  sizes?: string;
+  width?: number;
+  height?: number;
+  /** LQIP blurhash placeholder for rendering before the image loads */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color */
+  dominantColor?: string;
+  alt?: string;
+  /** Base URL without transforms, for responsive image generation */
+  cdnBaseUrl?: string;
+  /** For providers with URL-based transforms (Cloudinary, imgix) */
+  getSrc?: (opts: {
+    width?: number;
+    height?: number;
+    format?: string;
+  }) => string;
+}
+interface VideoEmbed {
+  type: "video";
+  /** Single source URL */
+  src?: string;
+  /** Multiple sources for format fallback */
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  /** Poster/thumbnail image */
+  poster?: string;
+  width?: number;
+  height?: number;
+  /** Player controls */
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  playsinline?: boolean;
+  preload?: "none" | "metadata" | "auto";
+  crossorigin?: "anonymous" | "use-credentials";
+}
+interface AudioEmbed {
+  type: "audio";
+  src?: string;
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  preload?: "none" | "metadata" | "auto";
+}
+interface ComponentEmbed {
+  type: "component";
+  /** Package to import from, e.g., "@mux/player-react" */
+  package: string;
+  /** Named export (default export if not specified) */
+  export?: string;
+  /** Props to pass to the component */
+  props: Record<string, unknown>;
+}
+/**
+ * Options for thumbnail generation
+ */
+interface ThumbnailOptions {
+  /** Desired width */
+  width?: number;
+  /** Desired height */
+  height?: number;
+}
+/**
+ * Runtime media provider interface
+ * Implemented by provider entrypoints
+ */
+interface MediaProvider {
+  /**
+   * List/search media items
+   */
+  list(options: MediaListOptions): Promise<MediaListResult>;
+  /**
+   * Get a single item by ID (optional, for refresh/validation)
+   */
+  get?(id: string): Promise<MediaProviderItem | null>;
+  /**
+   * Upload new media (if capabilities.upload is true)
+   */
+  upload?(input: MediaUploadInput): Promise<MediaProviderItem>;
+  /**
+   * Delete media (if capabilities.delete is true)
+   */
+  delete?(id: string): Promise<void>;
+  /**
+   * Get embed information for rendering this media item
+   * Called at runtime when rendering content
+   */
+  getEmbed(value: MediaValue, options?: EmbedOptions): Promise<EmbedResult> | EmbedResult;
+  /**
+   * Get a thumbnail URL for admin display
+   * For images: returns a resized image URL
+   * For videos: returns a poster/thumbnail URL
+   */
+  getThumbnailUrl?(id: string, mimeType?: string, options?: ThumbnailOptions): string;
+}
+/**
+ * Function signature for provider entrypoint modules
+ */
+type CreateMediaProviderFn<TConfig = Record<string, unknown>> = (config: TConfig) => MediaProvider;
+/**
+ * Media value stored in content fields
+ * This is what gets persisted when media is selected
+ *
+ * For backwards compatibility:
+ * - `provider` defaults to "local" if not specified
+ * - `src` is supported for legacy data or external URLs
+ */
+interface MediaValue {
+  /** Provider ID, e.g., "local", "unsplash", "mux" (defaults to "local") */
+  provider?: string;
+  /** Provider-specific item ID */
+  id: string;
+  /** Direct URL (for local media or legacy data) */
+  src?: string;
+  /** Preview URL for admin display (external providers) */
+  previewUrl?: string;
+  /** Cached metadata for display without runtime lookup */
+  filename?: string;
+  mimeType?: string;
+  width?: number;
+  height?: number;
+  /** Default focal point copied when the media item is selected */
+  focalX?: number;
+  focalY?: number;
+  /** Cached LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** Cached LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  alt?: string;
+  /** Provider-specific data needed for embedding */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Convert a MediaProviderItem to a MediaValue for storage
+ */
+declare function mediaItemToValue(providerId: string, item: MediaProviderItem): MediaValue;
+//#endregion
+//#region src/media/normalize.d.ts
+/**
+ * Normalize a media field value into a consistent MediaValue shape.
+ *
+ * - `null`/`undefined` → `null`
+ * - Bare URL string → `{ provider: "external", id: "", src: url }`
+ * - Bare internal media URL → resolved via local provider's `get()`
+ * - Bare local media ID → resolved via local provider's `get()`
+ * - Object with `provider` + `id` → enriched with missing fields from provider
+ */
+declare function normalizeMediaValue(value: unknown, getProvider: (id: string) => MediaProvider | undefined): Promise<MediaValue | null>;
+//#endregion
+//#region src/media/placeholder.d.ts
+/**
+ * Image Placeholder Generation
+ *
+ * Generates blurhash and dominant color from image buffers for LQIP support.
+ * Decodes images via jpeg-js (pure JS) and upng-js (pure JS, uses pako for
+ * deflate). No Node-specific dependencies — works in Workers and Node SSR.
+ */
+interface PlaceholderData {
+  blurhash: string;
+  dominantColor: string;
+}
+/**
+ * Generate blurhash and dominant color from an image buffer.
+ * Returns null for non-image MIME types or on failure.
+ *
+ * @param dimensions - Optional pre-known dimensions. When present they are
+ *   trusted verbatim (the caller has typically already read them via
+ *   readDimensions); otherwise dimensions are read from this buffer's header.
+ *   Generation is skipped (returns null) when no dimensions are available at
+ *   all, or when the decoded size (width * height * 4) exceeds
+ *   MAX_DECODED_BYTES — both guards avoid OOM from unbounded decodes on
+ *   memory-constrained runtimes.
+ */
+declare function generatePlaceholder(buffer: Uint8Array, mimeType: string, dimensions?: {
+  width: number;
+  height: number;
+}): Promise<PlaceholderData | null>;
+//#endregion
+export { MediaValue as _, ComponentEmbed as a, mediaItemToValue as b, EmbedResult as c, MediaListResult as d, MediaProvider as f, MediaUploadInput as g, MediaProviderItem as h, AudioEmbed as i, ImageEmbed as l, MediaProviderDescriptor as m, generatePlaceholder as n, CreateMediaProviderFn as o, MediaProviderCapabilities as p, normalizeMediaValue as r, EmbedOptions as s, PlaceholderData as t, MediaListOptions as u, ThumbnailOptions as v, VideoEmbed as y };
+//# sourceMappingURL=placeholder-MSEd8gty.d.mts.map

package/dist/placeholder-MSEd8gty.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-MSEd8gty.d.mts","names":[],"sources":["../src/media/types.ts","../src/media/normalize.ts","../src/media/placeholder.ts"],"mappings":"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"}

package/dist/plan-xjcWrAah.mjs

@@ -0,0 +1,135 @@
+import { h as portableIdSchema, i as RECORD_KINDS } from "./kinds-CRu_T5T5.mjs";
+import { a as planTransformationSchema } from "./transformations-9gfpwY65.mjs";
+import { n as SITE_PACKAGE_FORMAT_VERSION } from "./version-BRZXVifl.mjs";
+import { z } from "zod";
+
+//#region src/transfer/format/plan.ts
+/**
+* Import plans, decisions, and the warning/blocker vocabulary.
+*
+* Analysis produces a {@link SiteImportPlan} with default decisions; the
+* caller may resubmit different decisions, which produces a new plan (and a
+* new plan digest). Execution requires the exact `{ packageDigest,
+* planDigest }` pair. The plan digest covers the whole plan object
+* (see `format/digest.ts`).
+*/
+const PLAN_BLOCKER_CODES = [
+	"package_invalid",
+	"unsupported_format",
+	"unsupported_feature",
+	"limit_exceeded",
+	"file_missing",
+	"file_mismatch",
+	"record_invalid",
+	"record_count_mismatch",
+	"record_order_invalid",
+	"duplicate_id",
+	"dangling_reference",
+	"reference_cycle",
+	"media_ref_invalid",
+	"media_blob_missing",
+	"media_blob_too_large",
+	"target_not_empty",
+	"locale_not_configured",
+	"field_type_unknown",
+	"principal_conflict",
+	"integer_out_of_range",
+	"value_constraint_violation",
+	"unique_violation"
+];
+const PLAN_WARNING_CODES = [
+	"media_row_missing",
+	"media_provider_external",
+	"soft_reference_dangling",
+	"redirect_loops_unchecked",
+	"issues_truncated"
+];
+const issueDetail = z.record(z.string().max(64), z.union([
+	z.string().max(1024),
+	z.number(),
+	z.boolean(),
+	z.null()
+]));
+function planIssueSchema(codes) {
+	return z.strictObject({
+		code: z.enum(codes),
+		message: z.string().max(1024),
+		kind: z.enum(RECORD_KINDS).optional(),
+		id: portableIdSchema.optional(),
+		count: z.number().int().nonnegative().optional(),
+		detail: issueDetail.optional()
+	});
+}
+const planBlockerSchema = planIssueSchema(PLAN_BLOCKER_CODES);
+const planWarningSchema = planIssueSchema(PLAN_WARNING_CODES);
+const SETTING_CHOICES = ["package", "target"];
+const siteImportDecisionsSchema = z.strictObject({
+	principalMappings: z.record(portableIdSchema, portableIdSchema.nullable()),
+	siteTitle: z.enum(SETTING_CHOICES),
+	siteTagline: z.enum(SETTING_CHOICES)
+});
+/** Decisions a caller may submit; omitted values keep the plan defaults. */
+const siteImportDecisionsInputSchema = z.strictObject({
+	principalMappings: z.record(portableIdSchema, portableIdSchema.nullable()).optional(),
+	siteTitle: z.enum(SETTING_CHOICES).optional(),
+	siteTagline: z.enum(SETTING_CHOICES).optional()
+});
+const planPrincipalSchema = z.strictObject({
+	id: portableIdSchema,
+	displayName: z.string().max(4096),
+	email: z.string().max(4096).optional(),
+	references: z.number().int().nonnegative(),
+	suggestedUserId: portableIdSchema.optional()
+});
+const settingValueSummary = z.strictObject({
+	package: z.string().max(4096).optional(),
+	target: z.string().max(4096).optional()
+});
+const siteImportPlanSchema = z.strictObject({
+	formatVersion: z.literal(SITE_PACKAGE_FORMAT_VERSION),
+	packageDigest: z.string().regex(/^sha256:[0-9a-f]{64}$/),
+	origin: z.strictObject({
+		siteId: portableIdSchema,
+		packageId: portableIdSchema,
+		createdAt: z.string().max(64),
+		createdByEmDashVersion: z.string().max(128)
+	}),
+	target: z.strictObject({
+		siteId: portableIdSchema,
+		dialect: z.enum(["sqlite", "postgres"]),
+		emdashVersion: z.string().max(128)
+	}),
+	counts: z.partialRecord(z.enum(RECORD_KINDS), z.number().int().nonnegative()),
+	bytes: z.strictObject({
+		records: z.number().int().nonnegative(),
+		media: z.number().int().nonnegative()
+	}),
+	principals: z.array(planPrincipalSchema),
+	settings: z.strictObject({
+		title: settingValueSummary,
+		tagline: settingValueSummary
+	}),
+	decisions: siteImportDecisionsSchema,
+	transformations: z.array(planTransformationSchema),
+	warnings: z.array(planWarningSchema),
+	blockers: z.array(planBlockerSchema),
+	estimatedSteps: z.number().int().nonnegative()
+});
+/** Merge submitted decisions over a plan's defaults. Unknown principal ids are ignored. */
+function mergeDecisions(defaults, input) {
+	if (!input) return defaults;
+	const principalMappings = { ...defaults.principalMappings };
+	for (const [principalId, userId] of Object.entries(input.principalMappings ?? {})) if (Object.hasOwn(principalMappings, principalId)) principalMappings[principalId] = userId;
+	return {
+		principalMappings,
+		siteTitle: input.siteTitle ?? defaults.siteTitle,
+		siteTagline: input.siteTagline ?? defaults.siteTagline
+	};
+}
+function isPlanExecutable(plan) {
+	return plan.blockers.length === 0;
+}
+
+//#endregion
+export { siteImportDecisionsInputSchema as a, planWarningSchema as i, mergeDecisions as n, siteImportPlanSchema as o, planBlockerSchema as r, isPlanExecutable as t };
+//# sourceMappingURL=plan-xjcWrAah.mjs.map

package/dist/plan-xjcWrAah.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-xjcWrAah.mjs","names":[],"sources":["../src/transfer/format/plan.ts"],"sourcesContent":["/**\n * Import plans, decisions, and the warning/blocker vocabulary.\n *\n * Analysis produces a {@link SiteImportPlan} with default decisions; the\n * caller may resubmit different decisions, which produces a new plan (and a\n * new plan digest). Execution requires the exact `{ packageDigest,\n * planDigest }` pair. The plan digest covers the whole plan object\n * (see `format/digest.ts`).\n */\n\nimport { z } from \"zod\";\n\nimport { portableIdSchema, RECORD_KINDS } from \"./kinds.js\";\nimport { planTransformationSchema } from \"./transformations.js\";\nimport { SITE_PACKAGE_FORMAT_VERSION } from \"./version.js\";\n\nexport const PLAN_BLOCKER_CODES = [\n\t\"package_invalid\",\n\t\"unsupported_format\",\n\t\"unsupported_feature\",\n\t\"limit_exceeded\",\n\t\"file_missing\",\n\t\"file_mismatch\",\n\t\"record_invalid\",\n\t\"record_count_mismatch\",\n\t\"record_order_invalid\",\n\t\"duplicate_id\",\n\t\"dangling_reference\",\n\t\"reference_cycle\",\n\t\"media_ref_invalid\",\n\t\"media_blob_missing\",\n\t\"media_blob_too_large\",\n\t\"target_not_empty\",\n\t\"locale_not_configured\",\n\t\"field_type_unknown\",\n\t\"principal_conflict\",\n\t\"integer_out_of_range\",\n\t\"value_constraint_violation\",\n\t\"unique_violation\",\n] as const;\n\nexport type PlanBlockerCode = (typeof PLAN_BLOCKER_CODES)[number];\n\nexport const PLAN_WARNING_CODES = [\n\t\"media_row_missing\",\n\t\"media_provider_external\",\n\t\"soft_reference_dangling\",\n\t\"redirect_loops_unchecked\",\n\t\"issues_truncated\",\n] as const;\n\nexport type PlanWarningCode = (typeof PLAN_WARNING_CODES)[number];\n\nconst issueDetail = z.record(\n\tz.string().max(64),\n\tz.union([z.string().max(1024), z.number(), z.boolean(), z.null()]),\n);\n\nfunction planIssueSchema<const Codes extends readonly [string, ...string[]]>(codes: Codes) {\n\treturn z.strictObject({\n\t\tcode: z.enum(codes),\n\t\tmessage: z.string().max(1024),\n\t\tkind: z.enum(RECORD_KINDS).optional(),\n\t\tid: portableIdSchema.optional(),\n\t\tcount: z.number().int().nonnegative().optional(),\n\t\tdetail: issueDetail.optional(),\n\t});\n}\n\nexport const planBlockerSchema = planIssueSchema(PLAN_BLOCKER_CODES);\nexport const planWarningSchema = planIssueSchema(PLAN_WARNING_CODES);\n\nexport type PlanBlocker = z.infer<typeof planBlockerSchema>;\nexport type PlanWarning = z.infer<typeof planWarningSchema>;\n\nexport const SETTING_CHOICES = [\"package\", \"target\"] as const;\n\nexport const siteImportDecisionsSchema = z.strictObject({\n\t/** Origin principal id → target user id, or null to drop the reference. */\n\tprincipalMappings: z.record(portableIdSchema, portableIdSchema.nullable()),\n\tsiteTitle: z.enum(SETTING_CHOICES),\n\tsiteTagline: z.enum(SETTING_CHOICES),\n});\n\nexport type SiteImportDecisions = z.infer<typeof siteImportDecisionsSchema>;\n\n/** Decisions a caller may submit; omitted values keep the plan defaults. */\nexport const siteImportDecisionsInputSchema = z.strictObject({\n\tprincipalMappings: z.record(portableIdSchema, portableIdSchema.nullable()).optional(),\n\tsiteTitle: z.enum(SETTING_CHOICES).optional(),\n\tsiteTagline: z.enum(SETTING_CHOICES).optional(),\n});\n\nexport type SiteImportDecisionsInput = z.infer<typeof siteImportDecisionsInputSchema>;\n\nexport const planPrincipalSchema = z.strictObject({\n\tid: portableIdSchema,\n\tdisplayName: z.string().max(4096),\n\temail: z.string().max(4096).optional(),\n\t/** Number of package references to this principal. */\n\treferences: z.number().int().nonnegative(),\n\t/** Target user whose email matches case-insensitively, if exactly one does. */\n\tsuggestedUserId: portableIdSchema.optional(),\n});\n\nexport type PlanPrincipal = z.infer<typeof planPrincipalSchema>;\n\nconst settingValueSummary = z.strictObject({\n\tpackage: z.string().max(4096).optional(),\n\ttarget: z.string().max(4096).optional(),\n});\n\nexport const siteImportPlanSchema = z.strictObject({\n\tformatVersion: z.literal(SITE_PACKAGE_FORMAT_VERSION),\n\tpackageDigest: z.string().regex(/^sha256:[0-9a-f]{64}$/),\n\torigin: z.strictObject({\n\t\tsiteId: portableIdSchema,\n\t\tpackageId: portableIdSchema,\n\t\tcreatedAt: z.string().max(64),\n\t\tcreatedByEmDashVersion: z.string().max(128),\n\t}),\n\ttarget: z.strictObject({\n\t\tsiteId: portableIdSchema,\n\t\tdialect: z.enum([\"sqlite\", \"postgres\"]),\n\t\temdashVersion: z.string().max(128),\n\t}),\n\tcounts: z.partialRecord(z.enum(RECORD_KINDS), z.number().int().nonnegative()),\n\tbytes: z.strictObject({\n\t\trecords: z.number().int().nonnegative(),\n\t\tmedia: z.number().int().nonnegative(),\n\t}),\n\tprincipals: z.array(planPrincipalSchema),\n\tsettings: z.strictObject({ title: settingValueSummary, tagline: settingValueSummary }),\n\tdecisions: siteImportDecisionsSchema,\n\ttransformations: z.array(planTransformationSchema),\n\twarnings: z.array(planWarningSchema),\n\tblockers: z.array(planBlockerSchema),\n\testimatedSteps: z.number().int().nonnegative(),\n});\n\nexport type SiteImportPlan = z.infer<typeof siteImportPlanSchema>;\n\n/** Merge submitted decisions over a plan's defaults. Unknown principal ids are ignored. */\nexport function mergeDecisions(\n\tdefaults: SiteImportDecisions,\n\tinput: SiteImportDecisionsInput | undefined,\n): SiteImportDecisions {\n\tif (!input) return defaults;\n\tconst principalMappings: Record<string, string | null> = { ...defaults.principalMappings };\n\tfor (const [principalId, userId] of Object.entries(input.principalMappings ?? {})) {\n\t\tif (Object.hasOwn(principalMappings, principalId)) principalMappings[principalId] = userId;\n\t}\n\treturn {\n\t\tprincipalMappings,\n\t\tsiteTitle: input.siteTitle ?? defaults.siteTitle,\n\t\tsiteTagline: input.siteTagline ?? defaults.siteTagline,\n\t};\n}\n\nexport function isPlanExecutable(plan: Pick<SiteImportPlan, \"blockers\">): boolean {\n\treturn plan.blockers.length === 0;\n}\n"],"mappings":"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"}

package/dist/plugin-test-runtime.d.mts

@@ -1,17 +1,18 @@
-import { a as CollectionWithFields } from "./types-DQeU2SR7.mjs";
-import "./parse-tj9XLNO_.mjs";
-import "./types-CbwqGOXm.mjs";
-import { Kt as PluginEditorDraftFieldSelector, Nn as UserInfo } from "./types-DEHidMEk.mjs";
-import "./options-DAknChnw.mjs";
-import "./entry-lock-DX7QkqEg.mjs";
-import { cr as EmDashRuntime, dr as RuntimeDependencies, gr as PluginContentCacheInvalidator, ji as TaxonomyRepository, ki as RedirectRepository, lr as PluginEditorExtensionDispatch, or as handlePluginSettingsGet, sr as handlePluginSettingsUpdate } from "./config-DS7e4EZ9.mjs";
-import "./runner-3gfxRsJG.mjs";
-import "./storage-query-CPctdMKX.mjs";
-import { T as BylineRepository } from "./index-CDwKDkTq.mjs";
-import { o as setI18nConfig, r as getI18nConfig } from "./config-D3HhLON3.mjs";
-import "./types-CCR3ivXE.mjs";
-import "./hreflang-BgS2FqhH.mjs";
-import "./validate-CyQ7I3xF.mjs";
+import { a as CollectionWithFields } from "./types-D2fvWd1i.mjs";
+import "./parse-CVgO-Qai.mjs";
+import { t as Database } from "./types-B7Lmsh1E.mjs";
+import { Kt as PluginEditorDraftFieldSelector, Nn as UserInfo } from "./types-Cr-Kg-3D.mjs";
+import "./options-SQCHQCPH.mjs";
+import "./entry-lock-DVhCt49A.mjs";
+import { Ii as RedirectRepository, Ri as TaxonomyRepository, cr as EmDashRuntime, dr as RuntimeDependencies, gr as PluginContentCacheInvalidator, lr as PluginEditorExtensionDispatch, or as handlePluginSettingsGet, sr as handlePluginSettingsUpdate } from "./config-5ii2haYu.mjs";
+import "./runner-D5_LzKXI.mjs";
+import "./storage-query-Bdv7A62k.mjs";
+import { T as BylineRepository } from "./index-D-hdtLe8.mjs";
+import { o as setI18nConfig, r as getI18nConfig } from "./config-Py43JK9r.mjs";
+import "./types-Cd-O03VG.mjs";
+import "./hreflang-D5uNnsGJ.mjs";
+import "./validate-CM79QXYE.mjs";
+import { Kysely } from "kysely";
 import { EditorDraftInvocationReceipt, EditorDraftPatchEffect, EditorDraftSnapshot } from "@emdash-cms/blocks";
 
 //#region src/plugins/http-route-dispatch.d.ts
@@ -93,5 +94,27 @@ declare function validateEditorDraftPatch(input: {
   allowedFields: ReadonlySet<string>;
 }): EditorDraftPatchEffect | EditorDraftValidationError;
 //#endregion
-export { BylineRepository, EmDashRuntime, type PluginApiRequestContext, RedirectRepository, type RuntimeDependencies, TaxonomyRepository, type UserInfo, dispatchPluginApiRequest, dispatchPluginEditorExtensionApiRequest, getI18nConfig, handlePluginSettingsGet, handlePluginSettingsUpdate, setI18nConfig, validateEditorDraftPatch, validateEditorDraftRequest };
+//#region src/database/repositories/taxonomy-def.d.ts
+/**
+ * A taxonomy's structure: the same in every locale. Stored once in
+ * `_emdash_taxonomy_def_groups`, keyed by name, and copied onto each locale's
+ * `_emdash_taxonomy_defs` row for code that reads it directly, such as the plugin
+ * sandbox bridges.
+ */
+interface TaxonomyStructure {
+  hierarchical: boolean;
+  collections: string[];
+}
+/**
+ * Write a taxonomy's structure for every locale and return its group id.
+ *
+ * Creates the group with `groupId` and `structure` when the name has none. An
+ * existing group changes only the fields in `overwrite`, so a caller holding an
+ * older read of the other field does not write it back. Every definition row of
+ * the name is then linked to the group and copies its values, including rows
+ * written without it.
+ */
+declare function saveTaxonomyStructure(db: Kysely<Database>, name: string, groupId: string, structure: TaxonomyStructure, overwrite?: Partial<TaxonomyStructure>): Promise<string>;
+//#endregion
+export { BylineRepository, EmDashRuntime, type PluginApiRequestContext, RedirectRepository, type RuntimeDependencies, TaxonomyRepository, type UserInfo, dispatchPluginApiRequest, dispatchPluginEditorExtensionApiRequest, getI18nConfig, handlePluginSettingsGet, handlePluginSettingsUpdate, saveTaxonomyStructure, setI18nConfig, validateEditorDraftPatch, validateEditorDraftRequest };
 //# sourceMappingURL=plugin-test-runtime.d.mts.map

package/dist/plugin-test-runtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-test-runtime.d.mts","names":[],"sources":["../src/plugins/http-route-dispatch.ts","../src/plugins/editor-draft.ts"],"mappings":";;;;;;;;;;;;;;;;;UAgFiB,uBAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;EACzB,cAAA,GAAiB,6BAAA;AAAA;;iBAII,wBAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA,sBAAA;EACA;AAAA,GACE,uBAAA,GAA0B,OAAA,CAAQ,QAAA;AAAA,UAiEpB,sCAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;AAAA;;iBAMJ,uCAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA;AAAA,GACE,sCAAA,GAAyC,OAAA,CAAQ,QAAA;;;KC5KxC,oBAAA;AAAA,UAQK,0BAAA;EAChB,IAAA,EAAM,oBAAA;EACN,OAAA;AAAA;AAAA,UAagB,2BAAA;EAChB,QAAA,EAAU,mBAAA;EACV,OAAA,EAAS,4BAAA;EACT,UAAA,EAAY,WAAA;EACZ,WAAA,EAAa,WAAA;AAAA;AAAA,iBA2DE,0BAAA,CAA2B,KAAA;EAC1C,OAAA;EACA,UAAA,EAAY,oBAAA;EACZ,KAAA;IAAS,EAAA;IAAY,MAAA;IAAuB,QAAA;EAAA;EAC5C,YAAA,GAAe,8BAAA;EACf,aAAA,GAAgB,8BAAA;EAChB,OAAA;EACA,QAAA;AAAA,IACG,2BAAA,GAA8B,0BAAA;AAAA,iBAwGlB,wBAAA,CAAyB,KAAA;EACxC,KAAA;EACA,UAAA,EAAY,oBAAA;EACZ,aAAA,EAAe,WAAA;AAAA,IACZ,sBAAA,GAAyB,0BAAA"}
+{"version":3,"file":"plugin-test-runtime.d.mts","names":[],"sources":["../src/plugins/http-route-dispatch.ts","../src/plugins/editor-draft.ts","../src/database/repositories/taxonomy-def.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAgFiB,uBAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;EACzB,cAAA,GAAiB,6BAAA;AAAA;;iBAII,wBAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA,sBAAA;EACA;AAAA,GACE,uBAAA,GAA0B,OAAA,CAAQ,QAAA;AAAA,UAiEpB,sCAAA;EAChB,OAAA,EAAS,aAAA;EACT,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA,EAAS,OAAA;EACT,IAAA,GAAO,QAAA;EACP,WAAA;EACA,sBAAA,GAAyB,6BAAA;AAAA;;iBAMJ,uCAAA,CAAA;EACrB,OAAA;EACA,QAAA;EACA,IAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,OAAA;EACA,IAAA;EACA,WAAA;EACA;AAAA,GACE,sCAAA,GAAyC,OAAA,CAAQ,QAAA;;;KC5KxC,oBAAA;AAAA,UAQK,0BAAA;EAChB,IAAA,EAAM,oBAAA;EACN,OAAA;AAAA;AAAA,UAagB,2BAAA;EAChB,QAAA,EAAU,mBAAA;EACV,OAAA,EAAS,4BAAA;EACT,UAAA,EAAY,WAAA;EACZ,WAAA,EAAa,WAAA;AAAA;AAAA,iBA2DE,0BAAA,CAA2B,KAAA;EAC1C,OAAA;EACA,UAAA,EAAY,oBAAA;EACZ,KAAA;IAAS,EAAA;IAAY,MAAA;IAAuB,QAAA;EAAA;EAC5C,YAAA,GAAe,8BAAA;EACf,aAAA,GAAgB,8BAAA;EAChB,OAAA;EACA,QAAA;AAAA,IACG,2BAAA,GAA8B,0BAAA;AAAA,iBAwGlB,wBAAA,CAAyB,KAAA;EACxC,KAAA;EACA,UAAA,EAAY,oBAAA;EACZ,aAAA,EAAe,WAAA;AAAA,IACZ,sBAAA,GAAyB,0BAAA;;;;;;;;;UCrNZ,iBAAA;EAChB,YAAA;EACA,WAAA;AAAA;;;AFgFD;;;;;;;iBExBsB,qBAAA,CACrB,EAAA,EAAI,MAAA,CAAO,QAAA,GACX,IAAA,UACA,OAAA,UACA,SAAA,EAAW,iBAAA,EACX,SAAA,GAAW,OAAA,CAAQ,iBAAA,IACjB,OAAA"}