@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/core/facets.js

@@ -0,0 +1,334 @@
+//#region src/core/facets.ts
+/** Prod keys with no V2 concept (facet table §B.1): never written from V2, carried through a write from the stored definition. */
+var OUT_OF_DOMAIN = {
+	"prop target": "a prop's binding: props[].target (+ stale, origin)",
+	"host config": "HOST_CONFIG_KEYS + SERVER_CONFIG_KEYS in a field's or prop's config (adapters/lossy.ts)"
+};
+var corpusFix = (props, fields, bound) => ({
+	row: "B corpus-fix",
+	carrier: "value",
+	props: [props],
+	fields: [fields],
+	bound,
+	status: "landed"
+});
+var FACETS = {
+	ai: {
+		row: "A1",
+		carrier: "value",
+		props: ["props[].ai"],
+		fields: ["fields[].ai"],
+		status: "pending:C3"
+	},
+	category: {
+		row: "A2",
+		carrier: "value",
+		props: ["components.category"],
+		fields: ["content_models.v2.category"],
+		bound: "CATEGORY_ORDER",
+		status: "pending:C3+C5"
+	},
+	variants: {
+		row: "A3",
+		carrier: "value",
+		props: ["component_variant_groups (+ components.variant_group_id, variant_input_mappings; order/icon/description → component_variant_groups.v2.variants)"],
+		fields: ["fields[_variant] select + showIf {field:_variant}; content_models.v2.variants{slug → {icon, description}}"],
+		status: "pending:C4"
+	},
+	"block icon": {
+		row: "A4",
+		carrier: "value",
+		props: ["components.icon"],
+		fields: ["content_models.icon"],
+		bound: "DOCK_ICON_NAMES",
+		status: "pending:C1-model-settings"
+	},
+	"document preview": {
+		row: "A5",
+		carrier: "value",
+		props: ["components.preview"],
+		fields: ["content_models.list_preview"],
+		status: "pending:C3"
+	},
+	"document preview path": {
+		row: "B catalog",
+		carrier: "value",
+		props: ["components.preview (path rule widened)"],
+		fields: [],
+		status: "pending:C3"
+	},
+	"kind:global": {
+		row: "A6",
+		carrier: "value",
+		props: ["components.v2.shape"],
+		fields: ["content_models.v2.shape"],
+		status: "pending:C5"
+	},
+	"kind:entry (props)": {
+		row: "A6",
+		carrier: "value",
+		props: ["components.v2.shape"],
+		fields: [],
+		status: "pending:C5",
+		foldedInto: "kind:global"
+	},
+	"kind:block (fields)": {
+		row: "A6",
+		carrier: "value",
+		props: [],
+		fields: ["content_models.v2.shape"],
+		status: "pending:C5",
+		foldedInto: "kind:global"
+	},
+	"kind:page": {
+		row: "A22",
+		carrier: "value",
+		props: [],
+		fields: ["content_models.v2.shape"],
+		status: "pending:C5",
+		foldedInto: "kind:global"
+	},
+	"kind:object": {
+		row: "A6",
+		carrier: "value",
+		props: [],
+		fields: ["content_models.v2.shape"],
+		status: "pending:C5",
+		foldedInto: "kind:global"
+	},
+	"groups>3": {
+		row: "A7",
+		carrier: "value",
+		props: ["components.tabs"],
+		fields: ["content_models.fieldsets[kind:tab]"],
+		bound: "TAB_MAX",
+		status: "pending:C3+C8"
+	},
+	"item openMode": {
+		row: "A8",
+		carrier: "value",
+		props: ["config.item.openMode (object item)", "config.itemTypes[i].openMode (polymorphic)"],
+		fields: ["ui.blocks[slug].openMode (modular)"],
+		status: "pending:C3"
+	},
+	"reference target": {
+		row: "A9",
+		carrier: "value",
+		props: ["config.targets"],
+		fields: ["config.targets"],
+		bound: "REF_TARGET_KINDS",
+		status: "landed"
+	},
+	"type:slot": {
+		row: "A10",
+		carrier: "value",
+		props: ["props[] type slot (config.allow)"],
+		fields: ["fields[] type slot (config.blockSlugs)"],
+		bound: "SLOT_BLOCK_SLUGS_REQUIRED",
+		status: "landed"
+	},
+	"block model field": {
+		row: "A11",
+		carrier: "value",
+		props: [],
+		fields: ["kind:'block' model fields[]"],
+		bound: "BLOCK_FIELD_TYPES",
+		status: "pending:G7"
+	},
+	"shopify reference": {
+		row: "A12",
+		carrier: "excluded",
+		props: [],
+		fields: [],
+		status: "landed"
+	},
+	"type:table": {
+		row: "A13",
+		carrier: "value",
+		props: ["props[] type table (config.mode data)"],
+		fields: ["fields[] type table"],
+		status: "landed"
+	},
+	"group (nested)": {
+		row: "A14",
+		carrier: "value",
+		props: ["ui.tab {id}"],
+		fields: ["ui.tab {id} (nested field)"],
+		bound: "TAB_MAX",
+		status: "landed"
+	},
+	"fieldset collision": {
+		row: "A15",
+		carrier: "value",
+		props: ["ui.group {id}"],
+		fields: ["fieldsetId"],
+		bound: "TAB_FIELDSET_ID_UNIQUE",
+		status: "landed"
+	},
+	"segmented fallback": {
+		row: "A16",
+		carrier: "value",
+		props: ["ui.control segmented"],
+		fields: ["ui.control segmented"],
+		bound: "SEGMENTED_MAX",
+		status: "pending:C3"
+	},
+	"fieldset (derived)": {
+		row: "A17",
+		carrier: "value",
+		props: ["ui.group (prop group)"],
+		fields: ["content_models.fieldsets"],
+		status: "landed"
+	},
+	"itemNoun (derived)": {
+		row: "A18",
+		carrier: "value",
+		props: ["ui.itemLabel"],
+		fields: ["ui.itemTitle"],
+		status: "landed"
+	},
+	"reference filter": {
+		row: "A19",
+		carrier: "value",
+		props: ["config.filter"],
+		fields: ["config.filter"],
+		bound: "REFERENCE_FILTER_MAX",
+		status: "landed"
+	},
+	condition: {
+		row: "A20",
+		carrier: "value",
+		props: ["showIf (+ scope)"],
+		fields: ["showIf (+ scope)"],
+		bound: "SHOW_IF_SCOPES",
+		status: "pending:C3"
+	},
+	openMode: {
+		row: "A21",
+		carrier: "value",
+		props: ["props[].openMode"],
+		fields: ["fields[].openMode"],
+		bound: "OPEN_MODE_TYPES",
+		status: "pending:C9"
+	},
+	"slot allow": {
+		row: "A23",
+		carrier: "value",
+		props: ["config.allow"],
+		fields: ["config.blockSlugs"],
+		bound: "SLOT_ALLOW",
+		status: "landed"
+	},
+	"type:polymorphic-array": {
+		row: "B structural",
+		carrier: "value",
+		props: ["props[] type table (config.mode types)"],
+		fields: ["fields[] type modular"],
+		status: "pending:C3"
+	},
+	"item chrome (types)": {
+		row: "B structural",
+		carrier: "value",
+		props: ["config.itemTypes[i] {icon, preview}"],
+		fields: ["ui.blocks[slug] {icon, preview}"],
+		status: "pending:C3"
+	},
+	"type:primitive-array": {
+		row: "B decided",
+		carrier: "value",
+		props: ["config.itemType (widened)"],
+		fields: ["config.itemType (widened)"],
+		status: "pending:C3"
+	},
+	"depth>10": {
+		row: "B decided",
+		carrier: "value",
+		props: ["nesting"],
+		fields: ["nesting"],
+		bound: "DEPTH_MAX",
+		status: "landed"
+	},
+	slotSettings: {
+		row: "B decided (BUILD)",
+		carrier: "value",
+		props: ["config.settings: FieldDef[]"],
+		fields: ["config.settings: FieldDef[]"],
+		bound: "SLOT_SETTINGS_MAX",
+		status: "pending:C3"
+	},
+	"block placement": {
+		row: "B catalog",
+		carrier: "value",
+		props: ["components.v2.placement"],
+		fields: ["content_models.v2.placement"],
+		status: "pending:C5"
+	},
+	"seeded instance": {
+		row: "B catalog",
+		carrier: "excluded",
+		props: [],
+		fields: [],
+		status: "landed"
+	},
+	"not applicable (props)": {
+		row: "B catalog",
+		carrier: "excluded",
+		props: [],
+		fields: [],
+		status: "landed"
+	},
+	"type name": corpusFix("components.slug", "content_models.slug", "SLUG_RE"),
+	"group name>40": corpusFix("components.tabs[].id", "content_models.fieldsets[].id", "TAB_NAME_MAX"),
+	"group title": corpusFix("components.tabs[].name", "content_models.fieldsets[].name", "TAB_TITLE"),
+	"group default": corpusFix("components.tabs[0]", "content_models.fieldsets[0]", "TAB_DEFAULT_FIRST"),
+	"group icon": corpusFix("components.tabs[].icon", "content_models.fieldsets[].icon", "DOCK_ICON_NAMES"),
+	"group name collision": corpusFix("components.tabs[].name", "content_models.fieldsets[].name", "TAB_NAME_UNIQUE"),
+	"prop tab limit": corpusFix("components.tabs", "content_models.fieldsets", "PROP_TAB_MAX"),
+	"fieldset spans groups": corpusFix("ui.group.tab", "fieldsets[].tab", "FIELDSET_ONE_TAB"),
+	"fieldset (props)": corpusFix("ui.group (first prop)", "content_models.fieldsets", "PROP_GROUP_DEFINED_ON_USE"),
+	"fieldset name>limit": corpusFix("ui.group.label", "content_models.fieldsets[].name", "FIELDSET_NAME_MAX"),
+	"duplicate name": corpusFix("props[].key", "fields[].key", "KEY_UNIQUE"),
+	"reserved name": {
+		row: "B corpus-fix",
+		carrier: "value",
+		props: [],
+		fields: ["fields[].key"],
+		bound: "KEY_RESERVED + KEY_FORMAT",
+		status: "landed"
+	},
+	rows: corpusFix("ui.rows", "ui.rows", "UI_ROWS_MAX"),
+	synced: corpusFix("ui.synced", "ui.synced", "SYNCED_FROM_MAX"),
+	valueShape: corpusFix("ui.valueShape", "ui.valueShape", "VALUE_SHAPE_TYPES"),
+	"default value": corpusFix("props[].defaultValue", "fields[].defaultValue", "VALUE_SCHEMAS"),
+	icon: corpusFix("ui.icon", "ui.icon", "DOCK_ICON_NAMES"),
+	layout: corpusFix("ui.control / ui.layout", "ui.control / ui.layout", "CONTROL_TYPES"),
+	"help>limit": corpusFix("helpText / placeholder / helpMore", "helpText / ui.placeholder / helpMore", "HELP_CAPS"),
+	"option icon": corpusFix("options[].icon", "options[].icon", "DOCK_ICON_NAMES"),
+	"option description": corpusFix("options[].description", "options[].description", "OPTION_DESCRIPTION_MAX"),
+	access: corpusFix("ui.access", "ui.access", "ACCESS_CAPS"),
+	timezone: corpusFix("config.timezone", "config.timezone", "TIMEZONE"),
+	"reference order": corpusFix("config.contentModelId|allowedModelSlugs, config.targets", "config.contentModelId|allowedModelSlugs, config.targets", "REFERENCE_TO_ORDER"),
+	"numeric unit": corpusFix("config.unit", "config.unit", "NUMBER_UNIT_MAX"),
+	"rating bounds": corpusFix("config.min/max/step (rating)", "config.min/max/step (rating)", "RATING_BOUNDS"),
+	"scale rules": corpusFix("config.scale", "config.scale", "SCALE_RULES"),
+	"validation.patternMessage": corpusFix("config.patternMessage", "config.patternMessage", "PATTERN_MESSAGE_MAX"),
+	"validation.pattern": corpusFix("config.pattern", "config.pattern", "PATTERN_MAX"),
+	"validation.length": corpusFix("config.minLength/maxLength", "config.minLength/maxLength", "LENGTH_TYPES"),
+	"validation.items": corpusFix("config.minItems/maxItems", "config.minItems/maxItems", "LIST_ITEMS_CAP"),
+	"validation.unique": corpusFix("props[].unique", "fields[].unique", "UNIQUE_TYPES"),
+	"validation.recommendedMax": corpusFix("props[].recommendedMax", "fields[].recommendedMax", "RECOMMENDED_MAX"),
+	"item identity": corpusFix("ui.itemName / ui.itemTitle", "ui.itemName / ui.itemTitle", "ITEM_NAME_RE"),
+	"item settings": corpusFix("config.item", "config.item", "ARRAY_ITEM_SETTINGS"),
+	itemNoun: corpusFix("ui.itemLabel", "ui.itemLabel", "ITEM_LABEL_MAX"),
+	"item icon": corpusFix("ui.icon (list)", "ui.icon (list)", "DOCK_ICON_NAMES"),
+	"preview icon": corpusFix("ui.preview.icon", "ui.preview.icon", "DOCK_ICON_NAMES"),
+	"preview path": corpusFix("ui.preview.{title,subtitle,media}", "ui.preview.{title,subtitle,media}", "PREVIEW_PATH"),
+	"unsupported key": corpusFix("—", "—", "V2_SCHEMA_KEYS")
+};
+var facetOf = (feature) => FACETS[feature];
+/** The owner-signed exclusions: what may be lost by design (shopify until its pipeline, and two deliberate backend rules). */
+var EXCLUDED = Object.keys(FACETS).filter((f) => FACETS[f].carrier === "excluded");
+//#endregion
+export { EXCLUDED, FACETS, OUT_OF_DOMAIN, facetOf };
+
+//# sourceMappingURL=facets.js.map

package/dist/core/facets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.js","names":[],"sources":["../../src/core/facets.ts"],"sourcesContent":["/**\n * THE FACET TABLE (kit-facet-table.v3.md, G0b closed 2026-10-23): every V2 schema facet the adapter can name, with the\n * ONE prod key per lane that stores it. `satisfies Record<V2Facet, FacetRow>` makes it total: a feature added to\n * FEATURES or CATALOG (adapters/lossy.ts) without a row here fails tsc.\n *\n * Carriers are `value` (an explicit stored key) and `excluded` (owner-signed). A `bound` names the one shared constant\n * the V2 authoring rule and the prod zod rule both read: a value inside it is carried, one outside it is refused with\n * the facet's name. `status` is \"landed\" when the adapter carries the facet today, else the step that lands it.\n * Prod-only keys V2 has no concept of are not facets: OUT_OF_DOMAIN, preserved on every write (PBT P8).\n */\nimport type { CatalogFeature, LossyFeature } from \"../adapters/lossy\";\n\n/** Prod keys with no V2 concept (facet table §B.1): never written from V2, carried through a write from the stored definition. */\nexport const OUT_OF_DOMAIN = {\n  \"prop target\": \"a prop's binding: props[].target (+ stale, origin)\",\n  \"host config\": \"HOST_CONFIG_KEYS + SERVER_CONFIG_KEYS in a field's or prop's config (adapters/lossy.ts)\",\n} as const satisfies Partial<Record<CatalogFeature, string>>;\nexport type OutOfDomainFeature = keyof typeof OUT_OF_DOMAIN;\n\nexport type V2Facet = Exclude<LossyFeature | CatalogFeature, OutOfDomainFeature>;\n\nexport interface FacetRow {\n  /** facet table v3: an A row number, or the B group */\n  row: string;\n  carrier: \"value\" | \"excluded\";\n  /** the prod key(s) per lane, one per shape the facet takes; [] = the facet does not arise in that lane */\n  props: readonly string[];\n  fields: readonly string[];\n  /** the shared constant: inside it the facet is carried, outside it the facet is refused by name */\n  bound?: string;\n  status: \"landed\" | `pending:${string}`;\n  /** a facet stored at another facet's key (kind:page is the shape facet's value \"page\") */\n  foldedInto?: V2Facet;\n}\n\nconst corpusFix = (props: string, fields: string, bound: string): FacetRow => ({ row: \"B corpus-fix\", carrier: \"value\", props: [props], fields: [fields], bound, status: \"landed\" });\n\nexport const FACETS = {\n  /* ── A: hit by the corpus ── */\n  ai: { row: \"A1\", carrier: \"value\", props: [\"props[].ai\"], fields: [\"fields[].ai\"], status: \"pending:C3\" },\n  category: { row: \"A2\", carrier: \"value\", props: [\"components.category\"], fields: [\"content_models.v2.category\"], bound: \"CATEGORY_ORDER\", status: \"pending:C3+C5\" },\n  variants: {\n    row: \"A3\",\n    carrier: \"value\",\n    props: [\"component_variant_groups (+ components.variant_group_id, variant_input_mappings; order/icon/description → component_variant_groups.v2.variants)\"],\n    fields: [\"fields[_variant] select + showIf {field:_variant}; content_models.v2.variants{slug → {icon, description}}\"],\n    status: \"pending:C4\",\n  },\n  \"block icon\": { row: \"A4\", carrier: \"value\", props: [\"components.icon\"], fields: [\"content_models.icon\"], bound: \"DOCK_ICON_NAMES\", status: \"pending:C1-model-settings\" },\n  \"document preview\": { row: \"A5\", carrier: \"value\", props: [\"components.preview\"], fields: [\"content_models.list_preview\"], status: \"pending:C3\" },\n  \"document preview path\": { row: \"B catalog\", carrier: \"value\", props: [\"components.preview (path rule widened)\"], fields: [], status: \"pending:C3\" },\n  \"kind:global\": { row: \"A6\", carrier: \"value\", props: [\"components.v2.shape\"], fields: [\"content_models.v2.shape\"], status: \"pending:C5\" },\n  \"kind:entry (props)\": { row: \"A6\", carrier: \"value\", props: [\"components.v2.shape\"], fields: [], status: \"pending:C5\", foldedInto: \"kind:global\" },\n  \"kind:block (fields)\": { row: \"A6\", carrier: \"value\", props: [], fields: [\"content_models.v2.shape\"], status: \"pending:C5\", foldedInto: \"kind:global\" },\n  \"kind:page\": { row: \"A22\", carrier: \"value\", props: [], fields: [\"content_models.v2.shape\"], status: \"pending:C5\", foldedInto: \"kind:global\" },\n  \"kind:object\": { row: \"A6\", carrier: \"value\", props: [], fields: [\"content_models.v2.shape\"], status: \"pending:C5\", foldedInto: \"kind:global\" },\n  \"groups>3\": { row: \"A7\", carrier: \"value\", props: [\"components.tabs\"], fields: [\"content_models.fieldsets[kind:tab]\"], bound: \"TAB_MAX\", status: \"pending:C3+C8\" },\n  \"item openMode\": {\n    row: \"A8\",\n    carrier: \"value\",\n    props: [\"config.item.openMode (object item)\", \"config.itemTypes[i].openMode (polymorphic)\"],\n    fields: [\"ui.blocks[slug].openMode (modular)\"],\n    status: \"pending:C3\",\n  },\n  \"reference target\": { row: \"A9\", carrier: \"value\", props: [\"config.targets\"], fields: [\"config.targets\"], bound: \"REF_TARGET_KINDS\", status: \"landed\" },\n  \"type:slot\": { row: \"A10\", carrier: \"value\", props: [\"props[] type slot (config.allow)\"], fields: [\"fields[] type slot (config.blockSlugs)\"], bound: \"SLOT_BLOCK_SLUGS_REQUIRED\", status: \"landed\" },\n  \"block model field\": { row: \"A11\", carrier: \"value\", props: [], fields: [\"kind:'block' model fields[]\"], bound: \"BLOCK_FIELD_TYPES\", status: \"pending:G7\" },\n  \"shopify reference\": { row: \"A12\", carrier: \"excluded\", props: [], fields: [], status: \"landed\" },\n  \"type:table\": { row: \"A13\", carrier: \"value\", props: [\"props[] type table (config.mode data)\"], fields: [\"fields[] type table\"], status: \"landed\" },\n  \"group (nested)\": { row: \"A14\", carrier: \"value\", props: [\"ui.tab {id}\"], fields: [\"ui.tab {id} (nested field)\"], bound: \"TAB_MAX\", status: \"landed\" },\n  \"fieldset collision\": { row: \"A15\", carrier: \"value\", props: [\"ui.group {id}\"], fields: [\"fieldsetId\"], bound: \"TAB_FIELDSET_ID_UNIQUE\", status: \"landed\" },\n  \"segmented fallback\": { row: \"A16\", carrier: \"value\", props: [\"ui.control segmented\"], fields: [\"ui.control segmented\"], bound: \"SEGMENTED_MAX\", status: \"pending:C3\" },\n  \"fieldset (derived)\": { row: \"A17\", carrier: \"value\", props: [\"ui.group (prop group)\"], fields: [\"content_models.fieldsets\"], status: \"landed\" },\n  \"itemNoun (derived)\": { row: \"A18\", carrier: \"value\", props: [\"ui.itemLabel\"], fields: [\"ui.itemTitle\"], status: \"landed\" },\n  \"reference filter\": { row: \"A19\", carrier: \"value\", props: [\"config.filter\"], fields: [\"config.filter\"], bound: \"REFERENCE_FILTER_MAX\", status: \"landed\" },\n  condition: { row: \"A20\", carrier: \"value\", props: [\"showIf (+ scope)\"], fields: [\"showIf (+ scope)\"], bound: \"SHOW_IF_SCOPES\", status: \"pending:C3\" },\n  openMode: { row: \"A21\", carrier: \"value\", props: [\"props[].openMode\"], fields: [\"fields[].openMode\"], bound: \"OPEN_MODE_TYPES\", status: \"pending:C9\" },\n  \"slot allow\": { row: \"A23\", carrier: \"value\", props: [\"config.allow\"], fields: [\"config.blockSlugs\"], bound: \"SLOT_ALLOW\", status: \"landed\" },\n\n  /* ── B: in the code, not hit by the corpus ── */\n  \"type:polymorphic-array\": { row: \"B structural\", carrier: \"value\", props: [\"props[] type table (config.mode types)\"], fields: [\"fields[] type modular\"], status: \"pending:C3\" },\n  \"item chrome (types)\": { row: \"B structural\", carrier: \"value\", props: [\"config.itemTypes[i] {icon, preview}\"], fields: [\"ui.blocks[slug] {icon, preview}\"], status: \"pending:C3\" },\n  \"type:primitive-array\": { row: \"B decided\", carrier: \"value\", props: [\"config.itemType (widened)\"], fields: [\"config.itemType (widened)\"], status: \"pending:C3\" },\n  \"depth>10\": { row: \"B decided\", carrier: \"value\", props: [\"nesting\"], fields: [\"nesting\"], bound: \"DEPTH_MAX\", status: \"landed\" },\n  slotSettings: { row: \"B decided (BUILD)\", carrier: \"value\", props: [\"config.settings: FieldDef[]\"], fields: [\"config.settings: FieldDef[]\"], bound: \"SLOT_SETTINGS_MAX\", status: \"pending:C3\" },\n  \"block placement\": { row: \"B catalog\", carrier: \"value\", props: [\"components.v2.placement\"], fields: [\"content_models.v2.placement\"], status: \"pending:C5\" },\n  \"seeded instance\": { row: \"B catalog\", carrier: \"excluded\", props: [], fields: [], status: \"landed\" },\n  \"not applicable (props)\": { row: \"B catalog\", carrier: \"excluded\", props: [], fields: [], status: \"landed\" },\n  \"type name\": corpusFix(\"components.slug\", \"content_models.slug\", \"SLUG_RE\"),\n  \"group name>40\": corpusFix(\"components.tabs[].id\", \"content_models.fieldsets[].id\", \"TAB_NAME_MAX\"),\n  \"group title\": corpusFix(\"components.tabs[].name\", \"content_models.fieldsets[].name\", \"TAB_TITLE\"),\n  \"group default\": corpusFix(\"components.tabs[0]\", \"content_models.fieldsets[0]\", \"TAB_DEFAULT_FIRST\"),\n  \"group icon\": corpusFix(\"components.tabs[].icon\", \"content_models.fieldsets[].icon\", \"DOCK_ICON_NAMES\"),\n  \"group name collision\": corpusFix(\"components.tabs[].name\", \"content_models.fieldsets[].name\", \"TAB_NAME_UNIQUE\"),\n  \"prop tab limit\": corpusFix(\"components.tabs\", \"content_models.fieldsets\", \"PROP_TAB_MAX\"),\n  \"fieldset spans groups\": corpusFix(\"ui.group.tab\", \"fieldsets[].tab\", \"FIELDSET_ONE_TAB\"),\n  \"fieldset (props)\": corpusFix(\"ui.group (first prop)\", \"content_models.fieldsets\", \"PROP_GROUP_DEFINED_ON_USE\"),\n  \"fieldset name>limit\": corpusFix(\"ui.group.label\", \"content_models.fieldsets[].name\", \"FIELDSET_NAME_MAX\"),\n  \"duplicate name\": corpusFix(\"props[].key\", \"fields[].key\", \"KEY_UNIQUE\"),\n  \"reserved name\": { row: \"B corpus-fix\", carrier: \"value\", props: [], fields: [\"fields[].key\"], bound: \"KEY_RESERVED + KEY_FORMAT\", status: \"landed\" },\n  rows: corpusFix(\"ui.rows\", \"ui.rows\", \"UI_ROWS_MAX\"),\n  synced: corpusFix(\"ui.synced\", \"ui.synced\", \"SYNCED_FROM_MAX\"),\n  valueShape: corpusFix(\"ui.valueShape\", \"ui.valueShape\", \"VALUE_SHAPE_TYPES\"),\n  \"default value\": corpusFix(\"props[].defaultValue\", \"fields[].defaultValue\", \"VALUE_SCHEMAS\"),\n  icon: corpusFix(\"ui.icon\", \"ui.icon\", \"DOCK_ICON_NAMES\"),\n  layout: corpusFix(\"ui.control / ui.layout\", \"ui.control / ui.layout\", \"CONTROL_TYPES\"),\n  \"help>limit\": corpusFix(\"helpText / placeholder / helpMore\", \"helpText / ui.placeholder / helpMore\", \"HELP_CAPS\"),\n  \"option icon\": corpusFix(\"options[].icon\", \"options[].icon\", \"DOCK_ICON_NAMES\"),\n  \"option description\": corpusFix(\"options[].description\", \"options[].description\", \"OPTION_DESCRIPTION_MAX\"),\n  access: corpusFix(\"ui.access\", \"ui.access\", \"ACCESS_CAPS\"),\n  timezone: corpusFix(\"config.timezone\", \"config.timezone\", \"TIMEZONE\"),\n  \"reference order\": corpusFix(\"config.contentModelId|allowedModelSlugs, config.targets\", \"config.contentModelId|allowedModelSlugs, config.targets\", \"REFERENCE_TO_ORDER\"),\n  \"numeric unit\": corpusFix(\"config.unit\", \"config.unit\", \"NUMBER_UNIT_MAX\"),\n  \"rating bounds\": corpusFix(\"config.min/max/step (rating)\", \"config.min/max/step (rating)\", \"RATING_BOUNDS\"),\n  \"scale rules\": corpusFix(\"config.scale\", \"config.scale\", \"SCALE_RULES\"),\n  \"validation.patternMessage\": corpusFix(\"config.patternMessage\", \"config.patternMessage\", \"PATTERN_MESSAGE_MAX\"),\n  \"validation.pattern\": corpusFix(\"config.pattern\", \"config.pattern\", \"PATTERN_MAX\"),\n  \"validation.length\": corpusFix(\"config.minLength/maxLength\", \"config.minLength/maxLength\", \"LENGTH_TYPES\"),\n  \"validation.items\": corpusFix(\"config.minItems/maxItems\", \"config.minItems/maxItems\", \"LIST_ITEMS_CAP\"),\n  \"validation.unique\": corpusFix(\"props[].unique\", \"fields[].unique\", \"UNIQUE_TYPES\"),\n  \"validation.recommendedMax\": corpusFix(\"props[].recommendedMax\", \"fields[].recommendedMax\", \"RECOMMENDED_MAX\"),\n  \"item identity\": corpusFix(\"ui.itemName / ui.itemTitle\", \"ui.itemName / ui.itemTitle\", \"ITEM_NAME_RE\"),\n  \"item settings\": corpusFix(\"config.item\", \"config.item\", \"ARRAY_ITEM_SETTINGS\"),\n  itemNoun: corpusFix(\"ui.itemLabel\", \"ui.itemLabel\", \"ITEM_LABEL_MAX\"),\n  \"item icon\": corpusFix(\"ui.icon (list)\", \"ui.icon (list)\", \"DOCK_ICON_NAMES\"),\n  \"preview icon\": corpusFix(\"ui.preview.icon\", \"ui.preview.icon\", \"DOCK_ICON_NAMES\"),\n  \"preview path\": corpusFix(\"ui.preview.{title,subtitle,media}\", \"ui.preview.{title,subtitle,media}\", \"PREVIEW_PATH\"),\n  \"unsupported key\": corpusFix(\"—\", \"—\", \"V2_SCHEMA_KEYS\"),\n} as const satisfies Record<V2Facet, FacetRow>;\n\nexport const facetOf = (feature: string): FacetRow | undefined => (FACETS as Record<string, FacetRow>)[feature];\n\n/** The owner-signed exclusions: what may be lost by design (shopify until its pipeline, and two deliberate backend rules). */\nexport const EXCLUDED: readonly V2Facet[] = (Object.keys(FACETS) as V2Facet[]).filter((f) => FACETS[f].carrier === \"excluded\");\n"],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+/** @bettercms-ai/kit/core: the Core Schema, its facet table and the façades both lanes meet in (P2 C1). */
+export * from "./core";
+export * from "./facets";

package/dist/core/index.js

@@ -0,0 +1,3 @@
+import { EXCLUDED, FACETS, OUT_OF_DOMAIN, facetOf } from "./facets.js";
+import { CORE_VERSION, canonical, coreHash, coreJson, embedProd, embedV2, leafDiff, normProd, normV2, preserveOutOfDomain, roundTripCore } from "./core.js";
+export { CORE_VERSION, EXCLUDED, FACETS, OUT_OF_DOMAIN, canonical, coreHash, coreJson, embedProd, embedV2, facetOf, leafDiff, normProd, normV2, preserveOutOfDomain, roundTripCore };

package/dist/engine/array.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ARRAYS — compact PREVIEW ROWS that rest closed (CPO D8 + production; V2 HEAD 9829bf1 kit/engine/array.tsx): grip ·
+ * thumb · title + subtitle · validation dot · presence · always-visible ⋯ (Move up/down, Duplicate, Add above/below,
+ * Remove). Opening a row follows ONE rule (CPO D43): ≤3 simple fields expand inline, else it drills in (`openMode`
+ * overrides). Reorder by drag with layout animation; delete with an Undo toast; "Add {noun}" (a type menu when several
+ * item types); min/max honoured.
+ * Arrays of primitives render as a gallery (images), reference chips, or — for text, numbers and URLs — the ITEM LIST
+ * (CPO D47): one input per row, no drill. Arrays of one-field objects (`[{ text }]`) use the same item list. Small
+ * objects with an `included` / `isIncluded` switch get that switch as a check on the row itself.
+ *
+ * Host wiring (RowsHostContext): a drill row calls `drill(path)` (the frame push); without one it falls back to
+ * `form.navigate` while the form draws frames (`form.canNavigate`), else drill rows are inert (no button, no ›).
+ * Dialog items render the host's `NestedForm` (V2 kit-field NestedForm: its own navigation stack); without one the
+ * dialog shows the item's FieldList.
+ *
+ * Kit deviations from V2: sorting is `useDragReorder` (no @dnd-kit in the kit; it keeps dnd-kit's pointer and keyboard
+ * sensor semantics: Space / Enter picks up, arrows move, Space / Enter drops as one write, Escape cancels; the table editor's cross-list drag via
+ * `sortableId` is not ported); toasts come from KitServices (absent → silent); the gallery and reference-chip controls come from
+ * ARRAY_CONTROLS (registered by the controls lane); a host that never registered them edits the raw list (FallbackControl).
+ */
+import * as React from "react";
+import type { ComponentType } from "react";
+import type { FieldPath, FieldSchema } from "../schema/types";
+import type { ControlProps } from "../types";
+import { itemOpenMode, type Preview } from "../lib/schema";
+/** V2 kit-field NestedForm's props: a dialog's own SchemaForm over `fields`, writing into the parent form at `path`. */
+export interface NestedFormProps {
+    fields: FieldSchema[];
+    title: string;
+    icon?: string;
+    path: FieldPath;
+    navRef?: React.Ref<{
+        back: () => boolean;
+    }>;
+}
+export interface RowsHost {
+    /** Push a frame for an item / block path (F7b frames). Default: `form.navigate` while `form.canNavigate`. */
+    drill?: (path: FieldPath) => void;
+    /** Dialog-mode items: V2's NestedForm (own navigation stack). Default: the item's FieldList. */
+    NestedForm?: ComponentType<NestedFormProps>;
+}
+export declare const RowsHostContext: React.Context<RowsHost>;
+/** The frame push for a drill row, or undefined when nothing can draw the frame (the row is then inert). */
+export declare function useDrill(): ((path: FieldPath) => void) | undefined;
+/** Primitive-array controls V2 imports from controls/media (GalleryControl) and controls/reference (ReferencesControl). */
+export declare const ARRAY_CONTROLS: {
+    gallery?: ComponentType<ControlProps>;
+    references?: ComponentType<ControlProps>;
+};
+export declare function ArrayField({ field, path }: {
+    field: FieldSchema;
+    path: FieldPath;
+    parent?: Record<string, unknown>;
+}): import("react/jsx-runtime").JSX.Element;
+export declare const rowToggleField: (s?: FieldSchema) => FieldSchema | undefined;
+export interface RowModel {
+    id: string;
+    index: number;
+    item: unknown;
+    preview: Preview;
+    path: FieldPath;
+    chip?: string;
+    extra?: string;
+    /** an included-style switch that is OFF: the title reads muted */
+    dim?: boolean;
+}
+/** Shared list operations (arrays and slots). Remove shows an Undo toast; add can drill into the new item. */
+export declare function useListOps(field: FieldSchema, _path: FieldPath, list: unknown[], write: (next: unknown[]) => void, afterAdd?: (index: number) => void): {
+    atMax: boolean;
+    atMin: boolean;
+    add: (item: unknown, at?: number) => void;
+    duplicate: (i: number) => void;
+    move: (i: number, d: -1 | 1) => void;
+    reorder: (from: number, to: number) => void;
+    remove: (i: number, title: string) => void;
+    insertBlank: (at: number) => void;
+};
+export type ListOps = ReturnType<typeof useListOps>;
+/** The row list used by arrays AND slots. Without `onOpen` the rows are inert (a drill nothing can draw yet). */
+export declare function RowList({ field, rows, readOnly, layout, mode, openId, onOpen, onCloseInline, ops, renderInline, emptyLabel, addButton, leading, rowToggle, dialogNav, menuExtra, }: {
+    dialogNav?: React.RefObject<{
+        back: () => boolean;
+    } | null>;
+    field: FieldSchema;
+    rows: RowModel[];
+    readOnly: boolean;
+    layout: "list" | "grid";
+    mode: ReturnType<typeof itemOpenMode>;
+    openId: string | null;
+    onOpen?: (r: RowModel) => void;
+    onCloseInline: () => void;
+    ops: ListOps;
+    renderInline: (r: RowModel) => React.ReactNode;
+    emptyLabel: string;
+    addButton: React.ReactNode;
+    leading?: (r: RowModel) => React.ReactNode;
+    /** a control BEFORE the title button (never inside it): the included check of feature rows */
+    rowToggle?: (r: RowModel) => React.ReactNode;
+    /** extra items in a row's ⋯ menu, above Remove (a table row's "Move to group") */
+    menuExtra?: (r: RowModel) => React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;