@bettercms-ai/kit 0.1.0 → 1.0.0

package/adapters/prod-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prod-types.js","names":[],"sources":["../../src/kit/adapters/prod-types.ts"],"sourcesContent":["/**\n * PROD SHAPES — the production schema language and stored values, typed locally so the kit stays a package that could\n * leave the repo (it may not import @bettercms-ai/types, and the dashboard's pin predates F1 / F1.x-props anyway).\n *\n * Mirrors the backend at F1 + F1.x-props + link objects + tags / rating / code (72ea2b68d), then reference props\n * (73a120c50), validation parity (dd021ceba), option meta (ab15fe893), V2 chrome keys and types (98e48b9e3, 324580b2e),\n * the V2 icon vocabulary (e126bf33d) and the localized flag (279a10490) — origin/dev 81f385ff3:\n *   packages/types/src/content-model.ts, component.ts, link-value.ts, button-look.ts, dock-icon-names.ts, video-value.ts\n *   src/lib/validation/schemas/content.ts (baseField, fieldUiSchema, chromeUiProblems, fieldsets, MAX_FIELD_DEPTH)\n *   src/lib/validation/schemas/components.ts (componentPropDefSchema, subFieldSchema, propUiSchema, propValidationHardening)\n *   src/lib/content/validation-parity.ts, src/lib/content/dock-vocabulary.ts (TAB_MAX, TAB_NAME_MAX)\n * When the backend widens, widen these and the adapters together; the round-trip test then shrinks the lossy ledger.\n */\n\n/* ── Limits the backend enforces ─────────────────────────────────────── */\n/** Field levels one schema may nest (a top-level field, or a prop, is level 1). */\nexport const MAX_FIELD_DEPTH = 10;\n/** Tabs (`kind: \"tab\"` fieldsets) one screen may hold, and a tab name's length. */\nexport const TAB_MAX = 3;\nexport const TAB_NAME_MAX = 20;\nexport const FIELDSETS_MAX = 30;\nexport const FIELDSET_NAME_MAX = 60;\nexport const FIELDSET_DESCRIPTION_MAX = 500;\nexport const FIELD_HELP_MAX = 500;\nexport const PROP_HELP_MAX = 200;\nexport const PROP_PLACEHOLDER_MAX = 120;\nexport const HELP_MORE_MAX = 2000;\nexport const LOCK_REASON_MAX = 200;\nexport const ITEM_LABEL_MAX = 24;\nexport const PREVIEW_FALLBACK_MAX = 60;\nexport const PROP_GROUP_LABEL_MAX = 32;\nexport const PATTERN_MAX = 200;\n/** A tags value's tag length (TAG_VALUE_MAX_LENGTH), a code value's length (CODE_MAX_LENGTH), a rating's max with none set. */\nexport const TAG_VALUE_MAX_LENGTH = 64;\nexport const CODE_MAX_LENGTH = 100_000;\nexport const RATING_DEFAULT_MAX = 5;\n/** ratingConfigSchema: config.max a whole 1–10; (max − min) / step whole and at most this many stops. */\nexport const RATING_MAX = 10;\nexport const RATING_MAX_STOPS = 100;\n/** tagsConfigSchema: config.min 0–500, config.max 1–500. */\nexport const TAGS_ITEMS_MAX = 500;\n/** A choice option's description (OPTION_DESCRIPTION_MAX): one line. */\nexport const OPTION_DESCRIPTION_MAX = 140;\n/** config.patternMessage (PATTERN_MESSAGE_MAX), config.unit on a number (NUMBER_UNIT_MAX). */\nexport const PATTERN_MESSAGE_MAX = 200;\nexport const NUMBER_UNIT_MAX = 24;\n/** fieldUiSchema: ui.rows 1–40, ui.placeholder 1–120, ui.itemTitle 1–60, ui.synced.from 1–64. */\nexport const UI_ROWS_MAX = 40;\nexport const UI_PLACEHOLDER_MAX = 120;\nexport const ITEM_TITLE_MAX = 60;\nexport const SYNCED_FROM_MAX = 64;\n/** ui.itemName is an identifier: a letter, then letters, digits or _ (≤ 64). */\nexport const ITEM_NAME_RE = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;\n/** propUiSchema group: description 1–200, order 0–99. */\nexport const PROP_GROUP_DESCRIPTION_MAX = 200;\nexport const PROP_GROUP_ORDER_MAX = 99;\n/** numberScaleSchema: token value 1–32, label 1–24, title 1–60, css 1–60; 1–50 steps; at most 20 presets. */\nexport const SCALE_TOKEN_VALUE_MAX = 32;\nexport const SCALE_LABEL_MAX = 24;\nexport const SCALE_TITLE_MAX = 60;\nexport const SCALE_CSS_MAX = 60;\nexport const SCALE_STEPS_MAX = 50;\nexport const SCALE_PRESETS_MAX = 20;\n/** The video block's transcript cap (VIDEO_TRANSCRIPT_MAX). */\nexport const VIDEO_TRANSCRIPT_MAX = 100_000;\n\n/* ── Icons: the closed dock vocabulary (packages/types/src/dock-icon-names.ts at e126bf33d: 472 names, Sanity's set\n * plus every distinct V2 corpus icon but `map`; copied verbatim from that generated file, regenerate from it) ── */\nexport const DOCK_ICON_NAMES = [\n  \"abc\", \"access-denied\", \"activity\", \"add\", \"add-circle\", \"add-comment\", \"add-document\", \"add-user\", \"address-book\",\n  \"adjustments\", \"adjustments-horizontal\", \"alarm\", \"alert-triangle\", \"align-left\", \"api\", \"app-window\", \"apple\",\n  \"apps\", \"archive\", \"arrow-back-up\", \"arrow-down\", \"arrow-guide\", \"arrow-left\", \"arrow-right\", \"arrow-top-right\",\n  \"arrow-up\", \"arrows-diagonal\", \"arrows-down\", \"arrows-exchange\", \"arrows-horizontal\", \"arrows-left-right\",\n  \"arrows-shuffle\", \"arrows-sort\", \"article\", \"aspect-ratio\", \"asterisk\", \"award\", \"axis-x\", \"backpack\", \"badge\",\n  \"badge-cc\", \"badges\", \"bar-chart\", \"basket\", \"bell\", \"bill\", \"binary-document\", \"block-content\", \"block-element\",\n  \"blockquote\", \"bold\", \"bolt\", \"book\", \"book-2\", \"bookmark\", \"bookmark-filled\", \"books\", \"bottle\", \"box\",\n  \"brand-dribbble\", \"brand-facebook\", \"brand-instagram\", \"brand-linkedin\", \"brand-pinterest\", \"brand-tiktok\",\n  \"brand-x\", \"brand-youtube\", \"briefcase\", \"broadcast\", \"browser\", \"bug\", \"building\", \"building-skyscraper\",\n  \"building-store\", \"bulb-filled\", \"bulb-outline\", \"calculator\", \"calendar\", \"calendar-dollar\", \"calendar-event\",\n  \"calendar-exclamation\", \"calendar-off\", \"calendar-plus\", \"calendar-star\", \"calendar-time\", \"camera\", \"campfire\",\n  \"carousel-horizontal\", \"case\", \"cash\", \"category\", \"category-2\", \"chart-area\", \"chart-arrows\", \"chart-bar\",\n  \"chart-bar-popular\", \"chart-donut\", \"chart-dots\", \"chart-line\", \"chart-upward\", \"check\", \"checkbox\", \"checklist\",\n  \"checkmark\", \"checkmark-circle\", \"chef-hat\", \"chevron-down\", \"chevron-left\", \"chevron-right\", \"chevron-up\",\n  \"chevrons-right\", \"circle\", \"circle-check\", \"circle-dot\", \"circle-number-1\", \"circle-plus\", \"click\", \"clipboard\",\n  \"clipboard-image\", \"clipboard-text\", \"clock\", \"clock-check\", \"clock-hour-4\", \"close\", \"close-circle\", \"code\",\n  \"code-block\", \"cog\", \"collapse\", \"color-wheel\", \"columns\", \"columns-2\", \"columns-3\", \"comment\", \"component\",\n  \"compose\", \"compose-sparkles\", \"confetti\", \"controls\", \"cookie\", \"copy\", \"credit-card\", \"crop\", \"cube\",\n  \"currency-dollar\", \"dashboard\", \"database\", \"database-search\", \"desktop\", \"device-desktop\", \"device-mobile\",\n  \"device-tablet\", \"devices\", \"diamond\", \"discount\", \"document\", \"document-pdf\", \"document-remove\", \"document-sheet\",\n  \"document-text\", \"document-video\", \"document-word\", \"document-zip\", \"documents\", \"door-exit\", \"dot\",\n  \"double-chevron-down\", \"double-chevron-left\", \"double-chevron-right\", \"double-chevron-up\", \"double-quote\",\n  \"download\", \"drag-handle\", \"drop\", \"droplet\", \"droplet-half\", \"earth-americas\", \"earth-globe\", \"edit\", \"egg\",\n  \"ellipsis-horizontal\", \"ellipsis-vertical\", \"empty\", \"enter\", \"enter-right\", \"envelope\", \"equal\", \"error-filled\",\n  \"error-outline\", \"error-screen\", \"expand\", \"eye-closed\", \"eye-off\", \"eye-open\", \"face-happy\", \"face-indifferent\",\n  \"face-sad\", \"feather\", \"feedback\", \"file\", \"file-certificate\", \"file-code\", \"file-download\", \"file-text\", \"filter\",\n  \"flag\", \"flame\", \"flask\", \"focus-2\", \"folder\", \"folders\", \"forms\", \"frame\", \"generate\", \"gift\", \"git-branch\",\n  \"github\", \"grid-dots\", \"groq\", \"hammer\", \"hand-finger\", \"hanger\", \"hash\", \"headphones\", \"headset\", \"heart\",\n  \"heart-filled\", \"heart-handshake\", \"help-circle\", \"highlight\", \"history\", \"home\", \"hourglass\", \"ice-cream\",\n  \"id-badge\", \"id-badge-2\", \"image\", \"image-remove\", \"images\", \"inbox\", \"infinity\", \"info-circle\", \"info-filled\",\n  \"info-outline\", \"info-square-rounded\", \"inline\", \"inline-element\", \"input-search\", \"insert-above\", \"insert-below\",\n  \"italic\", \"joystick\", \"json\", \"language\", \"launch\", \"layout\", \"layout-align-center\", \"layout-board\",\n  \"layout-board-split\", \"layout-bottombar\", \"layout-bottombar-expand\", \"layout-cards\", \"layout-columns\",\n  \"layout-dashboard\", \"layout-grid\", \"layout-list\", \"layout-navbar\", \"layout-rows\", \"layout-sidebar\",\n  \"layout-sidebar-right\", \"leaf\", \"leave\", \"lemon\", \"library-photo\", \"lifebuoy\", \"link\", \"link-removed\", \"linkedin\",\n  \"list\", \"list-check\", \"list-details\", \"list-numbers\", \"list-tree\", \"lock\", \"logo-js\", \"logo-ts\", \"mail\", \"map-2\",\n  \"map-pin\", \"map-pins\", \"marker\", \"marker-removed\", \"master-detail\", \"math-function\", \"meat\", \"menu\", \"message\",\n  \"message-2\", \"message-check\", \"message-circle\", \"message-circle-2\", \"message-plus\", \"message-star\", \"microphone\",\n  \"microphone-slash\", \"mobile-device\", \"mood-empty\", \"moon\", \"movie\", \"news\", \"notes\", \"number\", \"ok-hand\", \"olist\",\n  \"overage\", \"package\", \"packages\", \"palette\", \"panel-left\", \"panel-right\", \"paperclip\", \"pause\", \"pencil\", \"phone\",\n  \"photo\", \"photo-scan\", \"photo-search\", \"pig-money\", \"pin\", \"pin-filled\", \"pin-removed\", \"play\", \"player-play\",\n  \"player-track-next\", \"playlist-add\", \"plug\", \"plug-connected\", \"plus-minus\", \"point\", \"presentation\", \"printer\",\n  \"progress-50\", \"progress-75\", \"projects\", \"publish\", \"qrcode\", \"quote\", \"read-only\", \"receipt\", \"recycle\", \"redo\",\n  \"refresh\", \"remove\", \"remove-circle\", \"repeat\", \"reset\", \"restore\", \"retrieve\", \"retry\", \"revert\", \"robot\",\n  \"rocket\", \"rosette\", \"route\", \"ruler\", \"ruler-measure\", \"salad\", \"scale\", \"schema\", \"school\", \"search\", \"section\",\n  \"select\", \"send\", \"server\", \"settings\", \"share\", \"shield-check\", \"shield-lock\", \"shopping-bag\", \"shopping-cart\",\n  \"shopping-cart-plus\", \"signature\", \"sitemap\", \"slideshow\", \"sort\", \"sort-descending\", \"spacing-vertical\", \"sparkle\",\n  \"sparkles\", \"speakerphone\", \"spinner\", \"split-horizontal\", \"split-vertical\", \"square\", \"stack\", \"stack-2\",\n  \"stack-compact\", \"stairs\", \"stairs-up\", \"star\", \"star-filled\", \"stars\", \"stop\", \"strikethrough\", \"string\",\n  \"subtask\", \"sun\", \"superscript\", \"sync\", \"table\", \"table-options\", \"tablet-device\", \"tag\", \"tags\", \"target\", \"task\",\n  \"template\", \"tent\", \"terminal\", \"terminal-2\", \"text\", \"th-large\", \"th-list\", \"thumb-up\", \"thumbs-down\", \"thumbs-up\",\n  \"ticket\", \"tiers\", \"timeline\", \"toggle-arrow-right\", \"toggle-right\", \"token\", \"tool\", \"tools-kitchen-2\", \"transfer\",\n  \"translate\", \"trash\", \"trend-upward\", \"triangle-outline\", \"trolley\", \"truck\", \"truck-delivery\", \"truncate\",\n  \"twitter\", \"typography\", \"ulist\", \"unarchive\", \"underline\", \"undo\", \"unknown\", \"unlink\", \"unlock\", \"unpublish\",\n  \"upload\", \"user\", \"user-circle\", \"user-plus\", \"user-search\", \"user-star\", \"users\", \"users-group\", \"versions\",\n  \"video\", \"vocabulary\", \"vs\", \"warning-filled\", \"warning-outline\", \"weight\", \"world\", \"wrench\", \"zoom-question\",\n] as const;\nexport type DockIconName = (typeof DOCK_ICON_NAMES)[number];\nexport const DOCK_ICON_NAME_SET: ReadonlySet<string> = new Set<string>(DOCK_ICON_NAMES);\n\n/* ── Content model fields ────────────────────────────────────────────── */\nexport type ProdFieldType =\n  | \"text\" | \"richtext\" | \"document\" | \"image\" | \"boolean\" | \"number\" | \"select\"\n  | \"reference\" | \"multi-reference\" | \"multiReference\" | \"array\" | \"date\" | \"datetime\"\n  | \"longtext\" | \"slug\" | \"email\" | \"phone\" | \"link\" | \"color\" | \"json\" | \"file\"\n  | \"component-ref\" | \"modular\" | \"sections\" | \"location\" | \"button\" | \"multiselect\" | \"icon\" | \"object\"\n  | \"tags\" | \"rating\" | \"code\"\n  /** V2 video: a URL string or `{ url, poster?, autoplay?, loop?, transcript? }` (VideoValue). */\n  | \"video\"\n  /** Legacy input only: normalized to `array` + zones on write, still read. */\n  | \"group\" | \"repeater\";\n\nexport type OpenMode = \"inline\" | \"drill\" | \"popover\" | \"dialog\";\nexport type ShowIfOp = \"eq\" | \"neq\" | \"in\" | \"isSet\" | \"notEmpty\" | \"empty\";\nexport interface ShowIfRule {\n  field: string;\n  op: ShowIfOp;\n  value?: string | string[];\n}\nexport interface ShowIf {\n  match: \"all\" | \"any\";\n  rules: ShowIfRule[];\n}\n\nexport type UiLayout = \"list\" | \"grid\" | \"table\" | \"rows\" | \"chips\" | \"gallery\";\n/** ui.control (UI_CONTROLS): the leaf controls, the V2 control layouts among them. */\nexport const UI_CONTROLS = [\"segmented\", \"slider\", \"rating\", \"dropdown\", \"radio\", \"cards\", \"grid\", \"switch\", \"checkbox\"] as const;\nexport type UiControl = (typeof UI_CONTROLS)[number];\n/** The V2 control layouts and the types each fits (CONTROL_TYPES); segmented / slider / rating have their own rules. */\nexport const CONTROL_TYPES: Readonly<Partial<Record<UiControl, readonly string[]>>> = {\n  dropdown: [\"select\"],\n  radio: [\"select\"],\n  cards: [\"select\", \"multiselect\"],\n  grid: [\"select\"],\n  switch: [\"boolean\"],\n  checkbox: [\"boolean\", \"multiselect\"],\n};\n/** A row preview: child keys or dotted paths (V2), a literal fallback, and an icon shown while there is no media. */\nexport interface UiPreview {\n  title?: string;\n  subtitle?: string;\n  media?: string;\n  fallback?: string;\n  icon?: DockIconName;\n}\nexport interface FieldUi {\n  collapsed?: boolean;\n  preview?: UiPreview;\n  layout?: UiLayout;\n  reorderable?: boolean;\n  control?: UiControl;\n  icon?: DockIconName;\n  itemLabel?: string;\n  /** text / longtext: the lines a text box opens with (1–40). */\n  rows?: number;\n  /** a field's placeholder when its config is strict (a prop keeps its own `placeholder`). */\n  placeholder?: string;\n  /** a list's item type: its identifier and its title (V2 `of[0].name` / `title`). */\n  itemName?: string;\n  itemTitle?: string;\n  /** the value comes from a global: an edit applies everywhere. */\n  synced?: { from: string };\n  /** link / image / button: a plain string or the object. */\n  valueShape?: \"string\" | \"object\";\n  /** V2 field access (D58): the editor gates, the backend stores. */\n  access?: { view?: \"schema.view\"; edit?: \"schema.manage\" };\n  /** true = never shown in the form; false ≡ absent. */\n  hidden?: boolean;\n  /** modular: per block slug, how a row of that block type reads (V2 `of[i].icon` / `preview`). */\n  blocks?: Record<string, { icon?: DockIconName; preview?: UiPreview }>;\n  input?: { name: string; writes?: string[] };\n}\n\nexport type ScaleUnit = \"px\" | \"%\" | \"rem\" | \"em\" | \"vw\" | \"vh\";\nexport interface ScaleCustomValue {\n  value: number;\n  unit: ScaleUnit;\n}\nexport interface ScaleTokenStep {\n  value: string;\n  label: string;\n  title?: string;\n  px?: number;\n  css?: string;\n}\nexport type ScaleBound = number | Partial<Record<ScaleUnit, number>>;\n/**\n * A number's `config.scale` (CPO D41): a stepped range, numeric steps or token steps, units, presets, and the custom\n * escape hatch (a boolean, or its bounds). A token scale stores the token string; a custom value `{ value, unit }`.\n */\nexport interface NumberScale {\n  steps: { min: number; max: number; step?: number } | Array<{ value: number; label?: string }> | ScaleTokenStep[];\n  units?: ScaleUnit[];\n  defaultUnit?: ScaleUnit;\n  allowCustom?: boolean | { min?: ScaleBound; max?: ScaleBound; units?: ScaleUnit[]; step?: number };\n  presets?: Array<{ label?: string; value: number | string | ScaleCustomValue }>;\n}\n\nexport interface ArrayZoneConfig {\n  nonRepeatable?: ContentModelField[];\n  repeatable?: { fields: ContentModelField[]; minItems?: number; maxItems?: number };\n}\n\n/** One choice: a bare value, or `{ label, value }` with optional chrome (a dock icon, one line ≤ 140 under the label). */\nexport interface ChoiceOption {\n  label: string;\n  value: string;\n  icon?: DockIconName;\n  description?: string;\n}\nexport type SelectOption = string | ChoiceOption;\n\n/** The typed keys of a field's `config` bag; the bag itself stays loose on scalar types. */\nexport interface FieldConfig {\n  /** primitive array: scalars, or images, links or rich text (each item judged by its own type). */\n  itemType?: \"text\" | \"number\" | \"date\" | \"image\" | \"link\" | \"richtext\";\n  zones?: ArrayZoneConfig;\n  contentModelId?: string;\n  polymorphic?: boolean;\n  allowedModelSlugs?: string[];\n  min?: number;\n  max?: number;\n  step?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  /** text / longtext: the message shown when the pattern does not match (≤ 200, needs `pattern`). */\n  patternMessage?: string;\n  /** number: the error bounds (V2 validation.min / max); they win over min / max. */\n  validation?: { min?: number; max?: number };\n  /** number: what it counts (\"%\", \"USD\"), 1–24 characters. */\n  unit?: string;\n  placeholder?: string;\n  includeTime?: boolean;\n  /** \"site\", an IANA zone name, true (the editor picks a zone) or false (none). */\n  timezone?: string | boolean;\n  blockSlugs?: string[];\n  minItems?: number;\n  maxItems?: number;\n  allowedSections?: string[];\n  componentIds?: string[];\n  scale?: NumberScale;\n  /** multiselect: its choices; with `allowCustom` it is free tags. tags: its suggestions. */\n  options?: SelectOption[];\n  allowCustom?: boolean;\n  /** code: the language, and the languages an editor may pick (strict config, with tags' and rating's). */\n  language?: string;\n  languages?: string[];\n  /**\n   * text: \"url\" marks a text field the kit edits as a URL (V2 `url`). The backend keeps a text field's config as sent and\n   * enforces its minLength / maxLength / pattern, which a link field would not; it reads no other meaning into the key.\n   */\n  inputType?: \"url\";\n  [key: string]: unknown;\n}\n\nexport interface ContentModelField {\n  key: string;\n  label: string;\n  type: ProdFieldType;\n  helpText?: string;\n  required?: boolean;\n  unique?: boolean;\n  defaultValue?: unknown;\n  /** select: strings or { label, value }. */\n  options?: SelectOption[];\n  config?: FieldConfig | null;\n  /** object (and legacy group / repeater): child fields. */\n  fields?: ContentModelField[];\n  openMode?: OpenMode;\n  helpMore?: string;\n  advanced?: boolean;\n  recommendedMax?: number;\n  fieldsetId?: string;\n  placement?: \"cover\" | \"title\" | \"excerpt\" | \"body\" | \"inline\" | \"panel\";\n  showIf?: ShowIf;\n  readOnly?: true | \"developer\";\n  lockReason?: string;\n  /** V2 per-field localization: once any field is marked, a translation owns only its localized values. */\n  localized?: boolean;\n  ui?: FieldUi;\n  searchable?: boolean;\n  [key: string]: unknown;\n}\n\nexport type FieldsetKind = \"group\" | \"row\" | \"tab\";\nexport interface Fieldset {\n  id: string;\n  name: string;\n  description?: string;\n  kind?: FieldsetKind;\n  icon?: DockIconName;\n  collapsed?: boolean;\n  tab?: string;\n  collapsible?: boolean;\n  columns?: 1 | 2;\n  layout?: \"stack\" | \"breakpoints\";\n}\n\n/** A content model as the adapters read and write it (server-owned ids and timestamps left out). */\nexport interface ProdContentModel {\n  name: string;\n  slug: string;\n  description?: string;\n  kind?: \"model\" | \"block\";\n  fields: ContentModelField[];\n  fieldsets?: Fieldset[];\n}\n\n/* ── Component props ─────────────────────────────────────────────────── */\nexport const COMPONENT_PROP_TYPES = [\n  \"text\", \"richtext\", \"image\", \"url\", \"boolean\", \"number\", \"select\", \"group\", \"table\", \"slot\", \"form\",\n  \"link\", \"button\", \"date\", \"color\", \"file\", \"icon\", \"multiselect\",\n  \"object\", \"datetime\", \"slug\", \"email\", \"phone\", \"json\", \"location\", \"tags\", \"rating\", \"code\",\n  /** an entry id (or `{ entryId, modelSlug }`) and a list of them, hydrated on delivery; no definition default. */\n  \"reference\", \"multi-reference\",\n  /** a video value, a list of `config.itemType` values, multi-line text. */\n  \"video\", \"array\", \"longtext\",\n] as const;\nexport type ComponentPropType = (typeof COMPONENT_PROP_TYPES)[number];\nexport type ComponentSubFieldType = Exclude<ComponentPropType, \"slot\" | \"form\">;\n\nexport const COMPONENT_CATEGORIES = [\n  \"navbar\", \"footer\", \"button\", \"section\", \"slider\", \"tabs\", \"form\", \"custom\", \"hero\", \"content\", \"social-proof\", \"conversion\",\n] as const;\nexport type ComponentCategory = (typeof COMPONENT_CATEGORIES)[number];\n\nexport interface PropGroup {\n  id: string;\n  label?: string;\n  kind?: \"group\" | \"row\";\n  icon?: DockIconName;\n  collapsed?: boolean;\n  /** V2 fieldset keys, on the defining prop: a line under the header (≤ 200), side by side, a static header, a\n   * breakpoint switcher, and its place among the groups (0–99; absent = where its first prop sits). */\n  description?: string;\n  columns?: 1 | 2;\n  collapsible?: boolean;\n  layout?: \"stack\" | \"breakpoints\";\n  order?: number;\n}\nexport type PropUi = FieldUi & { group?: PropGroup };\n\nexport interface ComponentSubField {\n  key: string;\n  label: string;\n  type: ComponentSubFieldType;\n  defaultValue?: unknown;\n  required?: boolean;\n  helpText?: string;\n  placeholder?: string;\n  /** strings or { label, value } (subFieldOptionSchema). */\n  options?: SelectOption[];\n  helpMore?: string;\n  advanced?: boolean;\n  recommendedMax?: number;\n  /** on a table's sub-field: no two rows share it; on a list: no item repeats. */\n  unique?: boolean;\n  openMode?: OpenMode;\n  showIf?: ShowIf;\n  /** the prop's ui, inline group included (V2 fieldsets nest). */\n  ui?: PropUi;\n  readOnly?: true | \"developer\";\n  lockReason?: string;\n  localized?: boolean;\n  fields?: ComponentSubField[];\n  config?: { fields?: ComponentSubField[]; options?: SelectOption[] } & Record<string, unknown>;\n}\n\nexport interface ComponentPropDef {\n  key: string;\n  label: string;\n  /**\n   * Where the override writes inside the component's blockJson. Binding, not schema: the V2 language has no twin, so\n   * fromTypeSchema leaves it unset and the host binds it (componentize lane) before the save.\n   */\n  target?: { blockId: string; path: string };\n  type: ComponentPropType;\n  defaultValue?: unknown;\n  required?: boolean;\n  helpText?: string;\n  placeholder?: string;\n  showIf?: ShowIf;\n  helpMore?: string;\n  advanced?: boolean;\n  recommendedMax?: number;\n  /** a list prop's items (a table's rows) distinct; refused on a top-level scalar (unique_prop_scope). */\n  unique?: boolean;\n  openMode?: OpenMode;\n  readOnly?: true | \"developer\";\n  lockReason?: string;\n  localized?: boolean;\n  config?: {\n    componentIds?: string[];\n    multiple?: boolean;\n    minItems?: number;\n    maxItems?: number;\n    options?: SelectOption[];\n    fields?: ComponentSubField[];\n    min?: number;\n    max?: number;\n    step?: number;\n    /** number: the error bounds (they win over min / max). */\n    validation?: { min?: number; max?: number };\n    /** text / url / longtext / richtext: length (richtext: its plain text). text / url / longtext: a pattern and its message. */\n    minLength?: number;\n    maxLength?: number;\n    pattern?: string;\n    patternMessage?: string;\n    /** reference / multi-reference: the target model, or polymorphic with an allowlist of model slugs. */\n    contentModelId?: string;\n    polymorphic?: boolean;\n    allowedModelSlugs?: string[];\n    /** array: what the list holds. */\n    itemType?: \"text\" | \"number\" | \"date\" | \"image\" | \"link\" | \"richtext\";\n  } & Record<string, unknown>;\n  ui?: PropUi;\n}\n\n/** A component as the adapters read and write it. */\nexport interface ProdComponent {\n  name: string;\n  slug: string;\n  description?: string;\n  category?: ComponentCategory;\n  props: ComponentPropDef[];\n}\n\n/* ── Stored values ───────────────────────────────────────────────────── */\nexport const LINK_RELS = [\"nofollow\", \"sponsored\", \"ugc\"] as const;\nexport type LinkRel = (typeof LINK_RELS)[number];\nexport const LINK_VALUE_TYPES = [\"url\", \"page\", \"entry\", \"email\", \"phone\", \"anchor\", \"section\", \"file\"] as const;\nexport type LinkValueType = (typeof LINK_VALUE_TYPES)[number];\n/** The F1 link object (link-value.ts). A bare href string stays valid too. */\nexport interface ProdLinkValue {\n  type?: LinkValueType;\n  href: string;\n  title?: string;\n  newTab?: boolean;\n  target?: \"_self\" | \"_blank\";\n  rel?: LinkRel;\n  section?: string;\n  /** page / entry links: the target's id. */\n  ref?: string;\n}\n\nexport const BUTTON_VARIANTS = [\"primary\", \"secondary\", \"tertiary\", \"brand\", \"dark\", \"light\", \"outline\", \"link\"] as const;\nexport type ButtonVariant = (typeof BUTTON_VARIANTS)[number];\nexport const BUTTON_SIZES = [\"sm\", \"md\", \"lg\"] as const;\n/** One button as one value (button-look.ts ButtonValue). */\nexport interface ProdButtonValue {\n  label: string;\n  href: string | ProdLinkValue;\n  variant?: ButtonVariant;\n  size?: (typeof BUTTON_SIZES)[number];\n  arrow?: boolean;\n  icon?: DockIconName | null;\n  newTab?: boolean;\n  rel?: LinkRel;\n  /** Stretch across the column (backend button_full_width_invalid refuses a non-boolean a write brings). */\n  fullWidth?: boolean;\n}\n\n/** 0–1 fractions of the image cut from each edge. */\nexport interface ProdImageCrop {\n  top: number;\n  right: number;\n  bottom: number;\n  left: number;\n}\n/** The normalized image value (field-value-normalize.ts): other keys are dropped on write. */\nexport interface ProdImageValue {\n  id?: string;\n  url: string;\n  name?: string;\n  altText?: string;\n  /** 0–1 fractions. */\n  focal?: { x: number; y: number };\n  crop?: ProdImageCrop;\n}\n\n/** The V2 video value's object form (video-value.ts): exactly the video block's props. A bare URL string is valid too. */\nexport const VIDEO_VALUE_KEYS = [\"url\", \"poster\", \"autoplay\", \"loop\", \"transcript\"] as const;\nexport interface ProdVideoValue {\n  url: string;\n  poster?: string;\n  autoplay?: boolean;\n  loop?: boolean;\n  transcript?: string;\n}\n\n/** A polymorphic reference value. */\nexport interface ProdPolymorphicRef {\n  entryId: string;\n  modelSlug: string;\n}\n/** What a `form` prop stores. */\nexport interface ProdFormRef {\n  formId: string;\n}\n"],"mappings":"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"}

package/adapters/schema.d.ts

@@ -0,0 +1,115 @@
+/**
+ * SCHEMA ADAPTERS — the production schema language ↔ the V2 schema language (TypeSchema).
+ *
+ *   toTypeSchema(model)          prod content model {fields, fieldsets}  → TypeSchema
+ *   propsToTypeSchema(component) prod component props (ComponentPropDef[]) → TypeSchema
+ *   fromTypeSchema(v2, "fields") TypeSchema → prod content model, plus every V2 feature prod cannot hold
+ *   fromTypeSchema(v2, "props")  TypeSchema → prod component props, likewise
+ *   planFromProd / planToProd    one field's stored prod value ↔ its V2 value, by the plan a read hands back
+ *                                (ToTypeSchemaOptions.plans) or `leafValuePlan` builds for a leaf field
+ *
+ * The read side takes BOTH prod dialects: the old shapes (group / repeater, array zones, showIf eq / neq / in / isSet)
+ * and the F1 keys (object, openMode, advanced, helpMore, recommendedMax, config.scale, ui.layout rows / chips /
+ * gallery, ui.preview.fallback, fieldset collapsible / columns / layout, notEmpty / empty), and the F1.x keys landed on
+ * origin/dev 81f385ff3 (validation parity, option meta, the V2 chrome keys and types, reference / video / array / longtext
+ * props, prop group keys and nesting, the V2 icon vocabulary, localized). What V2 cannot show is reported through
+ * `onLoss`, never dropped silently.
+ *
+ * The write side returns `{ schema, lossy, catalog }`: `toTypeSchema(fromTypeSchema(v2, t).schema)` equals `v2` minus
+ * exactly the `lossy` and `catalog` paths. `lossy` is what prod drops; `catalog` is metadata the dock never stores, set
+ * by the host at seeding time (block icon, category, kind, variants…). Storage stays prod's; value shapes go through
+ * ./values.
+ */
+import type { FieldSchema, ScaleSchema, TypeSchema } from "../schema/types";
+import { type CatalogItem, type LossyItem } from "./lossy";
+import { type ComponentCategory, type ProdComponent, type ProdContentModel } from "./prod-types";
+import { type ListItemType, type RatingScale } from "./values";
+export type { CatalogItem, LossyItem } from "./lossy";
+export type AdapterTarget = "fields" | "props";
+export interface FromTypeSchemaResult<S> {
+    schema: S;
+    /**
+     * fields lane: the kind:'block' models a modular field's config.blockSlugs names, one per item type (created before
+     * the model that uses them). Empty in the props lane.
+     */
+    blockModels: ProdContentModel[];
+    lossy: LossyItem[];
+    catalog: CatalogItem[];
+}
+export interface ToTypeSchemaOptions {
+    /** Prod features V2 cannot show (a neq condition, a table layout, a component slot…), reported as they are dropped. */
+    onLoss?: (item: {
+        path: string;
+        feature: string;
+        reason: string;
+    }) => void;
+    /** The block models a modular field's blockSlugs name: each item type's fields are read from its model. */
+    blockModels?: ProdContentModel[];
+    /**
+     * Filled with each top-level field's value plan (field name → plan): how its stored prod value crosses to the V2 value
+     * and back, through `planFromProd` / `planToProd`. The same plan this read used for the field's initialValue.
+     */
+    plans?: Map<string, ValuePlan>;
+}
+/**
+ * V2 block-picker category (KitCategory, and the core examples' own) → the nearest prod ComponentCategory. A category
+ * with no row has no prod twin; the server defaults the component to "custom".
+ */
+export declare const CATEGORY_TO_PROD: Readonly<Record<string, ComponentCategory>>;
+/** How a value of one field crosses to prod and back: per-type adapters, recursing through objects and list rows. */
+export type ValuePlan = VPlan;
+type VPlan = {
+    k: "link" | "button" | "image" | "form" | "ref" | "refs" | "number" | "video" | "as-is";
+} | {
+    k: "datetime";
+    zone?: string;
+}
+/** a date: passes as stored; only an unreadable stored shape is named */
+ | {
+    k: "date";
+}
+/** a list of one primitive (config.itemType): each item through its type's adapter */
+ | {
+    k: "list";
+    item: ListItemType;
+}
+/** a number with a V2 scale: a number, a token string or a custom { value, unit } */
+ | {
+    k: "scale";
+    scale: ScaleSchema;
+} | {
+    k: "rating";
+    scale: RatingScale;
+} | {
+    k: "object";
+    fields: Map<string, VPlan>;
+} | {
+    k: "rows";
+    zoned: boolean;
+    fields: Map<string, VPlan>;
+}
+/** modular rows: V2 {_key, _type, ...fields} ↔ prod {__id, __type (block slug), data}; item type name → its fields' plans */
+ | {
+    k: "modular";
+    types: Map<string, Map<string, VPlan>>;
+};
+/**
+ * The plan for ONE leaf field read from prod type `prodType` (a link, an image, a reference…), for a host that edits a
+ * single field's value outside a whole read (the dock's legacy controls). Objects and lists need the read's own plan
+ * (`ToTypeSchemaOptions.plans`), which knows which lists are zoned or modular.
+ */
+export declare function leafValuePlan(f: FieldSchema, prodType: string): ValuePlan;
+/**
+ * A V2 value → what prod stores. `lost` (optional) collects every V2 key prod cannot keep, as a path under the value
+ * ("cta/style", "(value)" for the value itself): a caller that finds any must refuse the write and name them.
+ */
+export declare function planToProd(plan: ValuePlan, v: unknown, lost?: string[], at?: string): unknown;
+/** A stored prod value → the V2 value. `loss(rel, reason)`: what the prod value carries that the V2 value cannot (rel is
+ *  under the value, "/0/modelSlug"); a caller that hears any must not write the value back through V2. */
+export declare function planFromProd(plan: ValuePlan, v: unknown, loss?: (rel: string, reason: string) => void, rel?: string): unknown;
+export declare function fromTypeSchema(v2: TypeSchema, target: "fields"): FromTypeSchemaResult<ProdContentModel>;
+export declare function fromTypeSchema(v2: TypeSchema, target: "props"): FromTypeSchemaResult<ProdComponent>;
+/** A prod content model (both dialects) → TypeSchema. */
+export declare function toTypeSchema(model: ProdContentModel, opts?: ToTypeSchemaOptions): TypeSchema;
+/** A prod component's props → TypeSchema (kind "block"); prop groups read back as fieldsets. */
+export declare function propsToTypeSchema(component: ProdComponent, opts?: ToTypeSchemaOptions): TypeSchema;