@bettercms-ai/kit 1.0.0 → 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/{engine → dist/engine}/array.js

@@ -1,7 +1,7 @@
 import { cn } from "../lib/cn.js";
+import { useForm, useKitEnv, useKitServices } from "../context.js";
 import { ensureKeys, isObj, itemId, newKey, pathKey } from "../lib/path.js";
 import { KitIcon } from "../lib/icons.js";
-import { useForm, useKitEnv, useKitServices } from "../context.js";
 import { FieldLabelForContext } from "../ui/field-context.js";
 import { Button } from "../ui/button.js";
 import { Menu, MenuContent, MenuItem, MenuLabel, MenuSeparator, MenuTrigger, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, Popover, PopoverAnchor, PopoverContent, Tooltip } from "../ui/overlay.js";
@@ -10,13 +10,13 @@ import { IssueDot, Thumb } from "./bits.js";
 import { FieldShell, PeerStack } from "./field-shell.js";
 import { INSET_LINE, InsetScope } from "./grouping.js";
 import { FieldList } from "./field-list.js";
-import { ItemList, arrayMove, useDragReorder } from "./item-list.js";
+import { ItemList, OrderLockSlot, arrayMove, useDragReorder } from "./item-list.js";
 import { CONTROLS, FallbackControl, useFieldAccess } from "./kit-field.js";
 import * as React from "react";
-import { IconArrowDown, IconArrowUp, IconArrowsDiagonal, IconCheck, IconChevronDown, IconChevronRight, IconCopy, IconDots, IconGripVertical, IconMinus, IconPlus, IconRowInsertBottom, IconRowInsertTop, IconTrash, IconX } from "@tabler/icons-react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { IconArrowDown, IconArrowUp, IconArrowsDiagonal, IconCheck, IconChevronDown, IconChevronRight, IconCopy, IconDots, IconGripVertical, IconMinus, IconPlus, IconRowInsertBottom, IconRowInsertTop, IconTrash, IconX } from "@tabler/icons-react";
 import { AnimatePresence, motion } from "framer-motion";
-//#region src/kit/engine/array.tsx
+//#region src/engine/array.tsx
 /**
 * 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,
@@ -222,7 +222,8 @@ function InlineList({ field, item, path, list, readOnly }) {
 	const Control = CONTROLS[item.type] ?? FallbackControl;
 	const max = field.validation?.max;
 	const ids = list.map((_, i) => `p${i}`);
-	const sort = useDragReorder(ids, (from, to) => form.setAt(path, arrayMove(list, from, to)), { disabled: readOnly });
+	const sort = useDragReorder(ids, (from, to) => form.setAt(path, arrayMove(list, from, to)), { disabled: readOnly || !!field.orderLocked });
+	const ops = useListOps(field, path, list, (next) => form.setAt(path, next));
 	const rowControl = (v, i) => /* @__PURE__ */ jsx(Control, {
 		field: {
 			...item,
@@ -242,7 +243,8 @@ function InlineList({ field, item, path, list, readOnly }) {
 				labelId: `${pathKey(path)}-${i}-label`,
 				sort,
 				readOnly,
-				onRemove: () => form.setAt(path, list.filter((_, j) => j !== i)),
+				orderLocked: !!field.orderLocked,
+				onRemove: () => ops.remove(i, `${item.title} ${i + 1}`),
 				children: [/* @__PURE__ */ jsx("span", {
 					id: `${pathKey(path)}-${i}-label`,
 					className: "sr-only",
@@ -268,13 +270,13 @@ function InlineList({ field, item, path, list, readOnly }) {
 		]
 	});
 }
-function InlineRow({ id, labelId, sort, children, onRemove, readOnly }) {
+function InlineRow({ id, labelId, sort, children, onRemove, readOnly, orderLocked }) {
 	return /* @__PURE__ */ jsxs("div", {
 		ref: sort.register(id),
 		style: sort.style(id),
 		className: cn("group/il flex items-start gap-1", sort.active === id && "relative z-10"),
 		children: [
-			readOnly ? null : /* @__PURE__ */ jsx("button", {
+			readOnly ? null : orderLocked ? /* @__PURE__ */ jsx(OrderLockSlot, { className: "mt-1.5" }) : /* @__PURE__ */ jsx("button", {
 				type: "button",
 				"aria-label": "Drag to reorder",
 				...sort.handle(id),
@@ -493,7 +495,7 @@ function AddItemButton({ field, onAdd, disabled }) {
 function RowList({ field, rows, readOnly, layout, mode, openId, onOpen, onCloseInline, ops, renderInline, emptyLabel, addButton, leading, rowToggle, dialogNav, menuExtra }) {
 	const sort = useDragReorder(rows.map((r) => r.id), ops.reorder, {
 		axis: layout === "grid" ? "grid" : "y",
-		disabled: readOnly,
+		disabled: readOnly || !!field.orderLocked,
 		distance: 5
 	});
 	const openRow = rows.find((r) => r.id === openId);
@@ -580,6 +582,13 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 		warnings: 0
 	};
 	const peers = Object.entries(env.presence).filter(([k]) => k === pathKey(r.path) || k.startsWith(`${pathKey(r.path)}.`)).flatMap(([, p]) => p);
+	const nChanged = env.review?.count(r.path) ?? 0;
+	const changeBar = nChanged ? /* @__PURE__ */ jsx("span", {
+		"aria-hidden": true,
+		className: "pointer-events-none absolute inset-y-1.5 left-0 z-[1] w-0.5 rounded-full",
+		style: { background: env.review.color(r.path) ?? "var(--kit-warning)" }
+	}) : null;
+	const changedNote = nChanged ? `${nChanged} changed` : "";
 	const menu = readOnly ? null : /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
 		"aria-label": `${r.preview.title} actions`,
 		onClick: (e) => e.stopPropagation(),
@@ -594,13 +603,13 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 		children: [
 			/* @__PURE__ */ jsx(MenuItem, {
 				icon: /* @__PURE__ */ jsx(IconArrowUp, { stroke: 1.5 }),
-				disabled: r.index === 0,
+				disabled: !!field.orderLocked || r.index === 0,
 				onClick: () => ops.move(r.index, -1),
 				children: "Move up"
 			}),
 			/* @__PURE__ */ jsx(MenuItem, {
 				icon: /* @__PURE__ */ jsx(IconArrowDown, { stroke: 1.5 }),
-				disabled: r.index === count - 1,
+				disabled: !!field.orderLocked || r.index === count - 1,
 				onClick: () => ops.move(r.index, 1),
 				children: "Move down"
 			}),
@@ -633,7 +642,7 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 			})
 		]
 	})] });
-	const grip = readOnly ? null : /* @__PURE__ */ jsx("button", {
+	const grip = readOnly ? null : field.orderLocked ? /* @__PURE__ */ jsx(OrderLockSlot, { className: "h-7 items-center" }) : /* @__PURE__ */ jsx("button", {
 		type: "button",
 		"aria-label": `Reorder ${r.preview.title}`,
 		onClick: (e) => e.stopPropagation(),
@@ -698,7 +707,8 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 						errors: roll.errors,
 						warnings: roll.warnings,
 						className: "absolute left-2 top-2 ring-2 ring-kit-surface"
-					})
+					}),
+					changeBar
 				]
 			})
 		});
@@ -733,9 +743,12 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 				className: "shrink-0 rounded-kit-md bg-kit-muted px-1 text-kit-2xs font-medium text-kit-fg-2",
 				children: r.chip
 			}) : null]
-		}), r.extra ?? r.preview.subtitle ? /* @__PURE__ */ jsx("span", {
+		}), (r.extra ?? r.preview.subtitle) || changedNote ? /* @__PURE__ */ jsxs("span", {
 			className: "block truncate text-kit-xs text-kit-fg-3",
-			children: r.extra ?? r.preview.subtitle
+			children: [changedNote ? /* @__PURE__ */ jsxs("span", {
+				className: "text-kit-fg-2",
+				children: [changedNote, r.extra ?? r.preview.subtitle ? " · " : ""]
+			}) : null, r.extra ?? r.preview.subtitle]
 		}) : null]
 	})] });
 	const rowInner = /* @__PURE__ */ jsxs("div", {
@@ -744,7 +757,7 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 			if (!onOpen || !e.currentTarget.contains(target) || target.closest("button,[role^=menuitem],a,input")) return;
 			onOpen();
 		},
-		className: cn("group/row flex min-h-12 items-center gap-2 py-1.5 pl-1.5 pr-2 transition-colors", onOpen && "cursor-pointer", open ? "bg-kit-subtle" : onOpen && "hover:bg-kit-subtle"),
+		className: cn(onOpen ? "group/row flex min-h-12 cursor-pointer items-center gap-2 py-1.5 pl-1.5 pr-2 transition-colors" : "group/row flex min-h-12 items-center gap-2 py-1.5 pl-1.5 pr-2 transition-colors", open ? "bg-kit-subtle" : onOpen && "hover:bg-kit-subtle"),
 		children: [
 			grip,
 			toggle,
@@ -755,7 +768,7 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 				"aria-expanded": mode === "drill" ? void 0 : open,
 				"aria-controls": inlineMode && open ? bodyId : void 0,
 				"aria-haspopup": mode === "popover" || mode === "dialog" ? "dialog" : void 0,
-				"aria-label": `${verb} ${r.preview.title}${r.chip ? `, ${r.chip}` : ""}, ${r.index + 1} of ${count}`,
+				"aria-label": `${verb} ${r.preview.title}${r.chip ? `, ${r.chip}` : ""}${changedNote ? `, ${changedNote}` : ""}, ${r.index + 1} of ${count}`,
 				className: "flex min-w-0 flex-1 items-center gap-2.5 rounded-kit-md text-left outline-none",
 				children: titleInner
 			}) : /* @__PURE__ */ jsx("div", {
@@ -775,12 +788,12 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 			trailing
 		]
 	});
-	return /* @__PURE__ */ jsx("div", {
+	return /* @__PURE__ */ jsxs("div", {
 		ref: sort.register(r.id),
 		style: sort.style(r.id),
 		"data-row-id": r.id,
 		className: cn("relative border-b border-kit-line-subtle bg-kit-surface last:border-b-0", isDragging && "z-10 rounded-kit-lg shadow-kit-lg ring-1 ring-kit-line-strong"),
-		children: /* @__PURE__ */ jsxs(motion.div, {
+		children: [changeBar, /* @__PURE__ */ jsxs(motion.div, {
 			layout: !isDragging && !dragging ? "position" : false,
 			initial: dragging ? false : {
 				opacity: 0,
@@ -856,7 +869,7 @@ function Row({ r, count, field, readOnly, grid, mode, open, onOpen, ops, sort, l
 					})
 				}) : null
 			}) : null]
-		})
+		})]
 	});
 }
 /** The included / not-included check on a feature row (D47): a real checkbox, outside the row's open button. */
@@ -875,7 +888,7 @@ function RowCheck({ on, label, title, readOnly, onToggle }) {
 			},
 			className: "group/chk flex size-7 shrink-0 items-center justify-center rounded-kit-md transition-colors hover:bg-kit-hover disabled:pointer-events-none",
 			children: /* @__PURE__ */ jsx("span", {
-				className: cn("flex size-[18px] items-center justify-center rounded-full transition-colors", on ? "bg-kit-inverse text-kit-fg-inverse" : "border border-dashed border-kit-field-border-hover text-kit-fg-3 group-hover/chk:border-[var(--kit-emphasis-line)]"),
+				className: cn("flex size-[18px] items-center justify-center rounded-full transition-colors", on ? "bg-kit-control-checked text-kit-fg-inverse" : "border border-dashed border-kit-field-border-hover text-kit-fg-3 group-hover/chk:border-[var(--kit-emphasis-line)]"),
 				children: on ? /* @__PURE__ */ jsx(IconCheck, {
 					className: "size-3",
 					stroke: 2.5