@cardstack/boxel-cli 0.13.0-unstable.4 → 0.13.0-unstable.6

package/bundled-test-harness/assets/enum-field-test-Gja3bzt5.js

@@ -1,935 +0,0 @@
-import { s as __toESM } from "./chunk-Rp0pCe6z.js";
-import { r as initializeDeferredDecorator, t as decorateFieldV2 } from "./runtime--fcdnjmJ-BoCBNIsz.js";
-import { Vo as getField } from "./runtime-common-BTaLJEw-.js";
-import { M as fields, x as PermissionsContextName } from "./constants-Icc0nFW-.js";
-import { wt as setComponentTemplate } from "./cache-DtDz7X5V-Wn8jRDfL.js";
-import { H as templateFactory } from "./index-DaCZcoCY-CgzbilMy.js";
-import "./component-BJO47HTh.js";
-import "./template-factory-ds9s0u8l.js";
-import { d as click } from "./dist-BOAdzfkP.js";
-import { n as IconComponent$1, t as IconComponent } from "./arrow-up-C7RnOkkT.js";
-import { t as IconComponent$2 } from "./minus-DMc5soaB.js";
-import { t as require_qunit } from "./qunit-C-Foo4Nd.js";
-import { H as testModuleRealm, M as setupCardLogs, P as setupIntegrationTestRealm, lt as setupRenderingTest, nt as provide, t as setupMockMatrix } from "./mock-matrix-Dd8k0DNa.js";
-import { r as getService } from "./dist-CPfIHBla.js";
-import { Y as serializeCard } from "./field-support-DClsIsjq.js";
-import { A as field, D as createFromSerialized, H as linksTo, L as getQueryableValue, T as containsMany, a as CardDef, s as Component, w as contains } from "./card-api-Cc8uZunB.js";
-import { t as string_default } from "./string-5IAMEUit.js";
-import { a as enumValues, i as enumOptions, n as enumConfig, r as enumField } from "./enum-BUHTdLPH.js";
-import { t as renderCard } from "./render-component-B15Z0e2v.js";
-//#region tests/integration/enum-field-test.gts
-var import_qunit = /* @__PURE__ */ __toESM(require_qunit());
-var loader;
-(0, import_qunit.module)("Integration | enumField", function(hooks) {
-	setupRenderingTest(hooks);
-	let mockMatrixUtils = setupMockMatrix(hooks);
-	hooks.beforeEach(function() {
-		provide(PermissionsContextName, {
-			canWrite: true,
-			canRead: true
-		});
-		loader = getService("loader-service").loader;
-	});
-	setupCardLogs(hooks, async () => await loader.import("@cardstack/base/card-api"));
-	(0, import_qunit.test)("edit renders a dropdown with the enum options", async function(assert) {
-		assert.expect(4);
-		assert.strictEqual(typeof enumField, "function", "enumField factory exists (intentional fail until implemented)");
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let task = new Task({ priority: "Low" });
-		await renderCard(loader, task, "edit");
-		assert.dom(".boxel-select").exists("renders a BoxelSelect trigger");
-		await click(".boxel-select");
-		assert.dom(".boxel-select__dropdown .boxel-select-option-text").exists({ count: 3 }, "shows all enum options");
-		let primLabels = Array.from(document.querySelectorAll(".boxel-select__dropdown .boxel-select-option-text")).map((el) => (el.textContent || "").trim());
-		assert.deepEqual(primLabels, [
-			"High",
-			"Medium",
-			"Low"
-		], "dropdown shows correct primitive labels in order");
-	});
-	(0, import_qunit.test)("programmatic set outside options does not throw (UI remains constrained)", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let task = new Task({ priority: "Low" });
-		task.priority = "Urgent";
-		assert.strictEqual(task.priority, "Urgent", "value can be set programmatically");
-		assert.deepEqual(enumValues(task, "priority"), [
-			"High",
-			"Medium",
-			"Low"
-		]);
-	});
-	(0, import_qunit.test)("enumValues helper returns configured options", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let values = enumValues(new Task({ priority: "High" }), "priority");
-		assert.ok(Array.isArray(values), "enumValues returns an array");
-		assert.deepEqual(values, [
-			"High",
-			"Medium",
-			"Low"
-		], "enumValues returns configured options in order");
-	});
-	(0, import_qunit.test)("containsMany renders dropdowns for each enum item and supports add", async function(assert) {
-		assert.expect(4);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "LECn428i",
-						"block": "[[[8,[30,1,[\"priorities\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let task = new Task({ priorities: ["High", "Low"] });
-		await renderCard(loader, task, "edit");
-		assert.dom("[data-test-contains-many=\"priorities\"]").exists("containsMany editor is rendered");
-		assert.dom("[data-test-contains-many=\"priorities\"] .boxel-select").exists({ count: 2 }, "renders two selects for two items");
-		await click("[data-test-contains-many=\"priorities\"] [data-test-add-new]");
-		assert.dom("[data-test-contains-many=\"priorities\"] .boxel-select").exists({ count: 3 }, "renders third select after add");
-		await click(document.querySelectorAll("[data-test-contains-many=\"priorities\"] .boxel-select")[2]);
-		assert.dom(".boxel-select__dropdown .boxel-select-option-text").exists({ count: 3 }, "shows all enum options");
-	});
-	(0, import_qunit.test)("containsMany programmatic set outside options does not throw", async function(assert) {
-		assert.expect(1);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-		}
-		let t = new Task({ priorities: ["High"] });
-		t.priorities = ["High", "Urgent"];
-		assert.deepEqual(t.priorities, ["High", "Urgent"], "values can be set programmatically");
-	});
-	(0, import_qunit.test)("serialization round-trip preserves enum value(s)", async function(assert) {
-		assert.expect(4);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-		}
-		await setupIntegrationTestRealm({
-			skipBootIndex: true,
-			mockMatrixUtils,
-			contents: { "test-cards.gts": { Task } }
-		});
-		let t1 = new Task({ priority: "Medium" });
-		let doc1 = serializeCard(t1, {});
-		let t1b = await createFromSerialized(doc1.data, doc1, new URL(`${testModuleRealm}`));
-		assert.strictEqual(t1b.priority, "Medium", "single enum value round-trips");
-		let doc2 = serializeCard(new Task({ priorities: ["Low", "High"] }), {});
-		let t2b = await createFromSerialized(doc2.data, doc2, new URL(`${testModuleRealm}`));
-		assert.ok(Array.isArray(t2b.priorities), "plural enum round-trips as array");
-		assert.deepEqual(t2b.priorities, ["Low", "High"], "plural enum values round-trip in order");
-		assert.strictEqual(t1.priority, "Medium", "original single remains unchanged");
-	});
-	(0, import_qunit.test)("queryableValue delegates to base field for enums", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-		}
-		let task = new Task({
-			priority: "High",
-			priorities: ["Low", "Medium"]
-		});
-		let singleField = getField(task, "priority");
-		let pluralField = getField(task, "priorities");
-		let qSingle = getQueryableValue(singleField, task.priority);
-		let qPlural = getQueryableValue(pluralField, task.priorities);
-		assert.strictEqual(qSingle, "High", "single enum queryableValue is scalar string");
-		assert.deepEqual(qPlural, ["Low", "Medium"], "plural enum queryableValue is array of strings");
-	});
-	(0, import_qunit.test)("single enum accepts null and serializes as null", async function(assert) {
-		assert.expect(3);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let t = new Task({ priority: null });
-		let q = getQueryableValue(getField(t, "priority"), t.priority);
-		assert.strictEqual(q, null, "queryableValue for null is null");
-		await setupIntegrationTestRealm({
-			skipBootIndex: true,
-			mockMatrixUtils,
-			contents: { "test-cards.gts": { Task } }
-		});
-		let doc = serializeCard(t, {});
-		assert.ok(doc.data?.attributes, "has attributes");
-		let attrPriority = doc.data.attributes.priority;
-		assert.strictEqual(Object.prototype.hasOwnProperty.call(doc.data.attributes, "priority") ? attrPriority : null, null, "serializes priority as null when set to null (or omits attribute)");
-	});
-	(0, import_qunit.test)("containsMany enum handles empty arrays and null members", async function(assert) {
-		assert.expect(4);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-		}
-		let t1 = new Task({ priorities: [] });
-		let q = getQueryableValue(getField(t1, "priorities"), t1.priorities);
-		assert.strictEqual(q, null, "queryableValue for empty array is null");
-		await setupIntegrationTestRealm({
-			skipBootIndex: true,
-			mockMatrixUtils,
-			contents: { "test-cards.gts": { Task } }
-		});
-		let doc = serializeCard(new Task({ priorities: [null, "Medium"] }), {});
-		assert.ok(doc.data?.attributes, "has attributes");
-		let arr = doc.data.attributes.priorities;
-		assert.ok(Array.isArray(arr), "serialized priorities is an array");
-		assert.deepEqual(arr, [null, "Medium"], "preserves null element in array");
-	});
-	(0, import_qunit.test)("enumField edit respects @canEdit (computed fields are displayed as embedded format)", async function(assert) {
-		assert.expect(3);
-		const PriorityField = enumField(string_default, { options: [
-			"High",
-			"Medium",
-			"Low"
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorityRaw", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priorityRaw = (initializeDeferredDecorator(this, "priorityRaw"), void 0);
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField, { computeVia: function() {
-						return this.priorityRaw;
-					} });
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let t = new Task({ priorityRaw: "High" });
-		await renderCard(loader, t, "edit");
-		assert.dom("[data-test-field=\"priorityRaw\"] .boxel-select").hasAttribute("aria-disabled", "false", "non-computed enum should be enabled");
-		assert.dom("[data-test-field=\"priority\"] .boxel-select").doesNotExist("computed enum should not render in edit format");
-		assert.dom("[data-test-field=\"priority\"]").hasText("Priority High", "computed enum renders as embedded format showing current value");
-	});
-	(0, import_qunit.test)("rich options API renders labels and stores primitive values", async function(assert) {
-		assert.expect(10);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priority: "medium" });
-		await renderCard(loader, t, "edit");
-		await click(".boxel-select");
-		assert.dom(".boxel-select__dropdown .boxel-select-option-text").exists({ count: 3 }, "renders three option rows");
-		let richLabels = Array.from(document.querySelectorAll(".boxel-select__dropdown .boxel-select-option-text")).map((el) => (el.textContent || "").trim());
-		assert.deepEqual(richLabels, [
-			"High",
-			"Medium",
-			"Low"
-		], "dropdown shows correct rich labels in order");
-		assert.dom(".boxel-select__dropdown .lucide.lucide-arrow-up").exists();
-		assert.dom(".boxel-select__dropdown .lucide.lucide-minus").exists();
-		assert.dom(".boxel-select__dropdown .lucide.lucide-arrow-down").exists();
-		let rich = enumOptions(t, "priority");
-		assert.ok(Array.isArray(rich), "enumOptions returns an array");
-		assert.strictEqual(rich[0]?.value, "high", "enumOptions exposes value");
-		assert.strictEqual(rich[0]?.label, "High", "enumOptions exposes label");
-		assert.strictEqual(rich[1]?.label, "Medium", "enumOptions exposes label");
-		assert.strictEqual(rich[2]?.label, "Low", "enumOptions exposes label");
-	});
-	(0, import_qunit.test)("enumOptions returns objects for primitive enums", async function(assert) {
-		assert.expect(3);
-		const StatusField = enumField(string_default, { options: ["Open", "Closed"] });
-		class Ticket extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "status", [field], function() {
-					return contains(StatusField);
-				});
-			}
-			#status = (initializeDeferredDecorator(this, "status"), void 0);
-		}
-		let options = enumOptions(new Ticket({ status: "Open" }), "status");
-		assert.ok(Array.isArray(options), "returns array");
-		assert.strictEqual(options[0]?.value, "Open", "value preserved");
-		assert.strictEqual(options[0]?.label, "Open", "label defaults to String(value)");
-	});
-	(0, import_qunit.test)("enumValues returns primitive values for rich enums", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let values = enumValues(new Task({ priority: "medium" }), "priority");
-		assert.ok(Array.isArray(values), "returns array");
-		assert.deepEqual(values, [
-			"high",
-			"medium",
-			"low"
-		], "returns primitive values derived from rich options");
-	});
-	(0, import_qunit.test)("enumOptions exposes icon for rich enums", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let options = enumOptions(new Task({ priority: "high" }), "priority");
-		assert.strictEqual(options[0]?.icon, IconComponent, "icon is propagated");
-		assert.strictEqual(options[1]?.icon, IconComponent$2, "icon is propagated");
-	});
-	(0, import_qunit.test)("trigger shows selected label and icon for rich enum", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priority: "medium" });
-		await renderCard(loader, t, "edit");
-		assert.dom(".boxel-select .option-title").exists("trigger shows selected label element");
-		assert.dom(".boxel-select .lucide.lucide-minus").exists("trigger shows selected icon");
-	});
-	(0, import_qunit.test)("selecting an option updates single enum value and trigger", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priority: "medium" });
-		await renderCard(loader, t, "edit");
-		await click(".boxel-select");
-		await click("[data-test-option=\"2\"]");
-		assert.strictEqual(t.priority, "low", "model value updates to selected value");
-		assert.dom(".boxel-select .lucide.lucide-arrow-down").exists("trigger shows selected icon");
-	});
-	(0, import_qunit.test)("selecting an option updates containsMany item", async function(assert) {
-		assert.expect(1);
-		const PriorityField = enumField(string_default, { options: [
-			{
-				value: "high",
-				label: "High",
-				icon: IconComponent
-			},
-			{
-				value: "medium",
-				label: "Medium",
-				icon: IconComponent$2
-			},
-			{
-				value: "low",
-				label: "Low",
-				icon: IconComponent$1
-			}
-		] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "LECn428i",
-						"block": "[[[8,[30,1,[\"priorities\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priorities: ["high", "low"] });
-		await renderCard(loader, t, "edit");
-		await click(document.querySelectorAll("[data-test-contains-many=\"priorities\"] .boxel-select")[1]);
-		await click("[data-test-option=\"1\"]");
-		assert.deepEqual(t.priorities, ["high", "medium"], "second item updates");
-	});
-	(0, import_qunit.test)("dynamic options provider resolves options per instance (intentional fail until implemented)", async function(assert) {
-		assert.expect(1);
-		class CrmApp extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "globalPriorityOptions", [field], function() {
-					return containsMany(string_default);
-				});
-			}
-			#globalPriorityOptions = (initializeDeferredDecorator(this, "globalPriorityOptions"), void 0);
-		}
-		const PriorityField = enumField(string_default, { options: function() {
-			return this.crmApp?.globalPriorityOptions;
-		} });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "crmApp", [field], function() {
-					return linksTo(CrmApp);
-				});
-			}
-			#crmApp = (initializeDeferredDecorator(this, "crmApp"), void 0);
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let t = new Task({
-			crmApp: new CrmApp({ globalPriorityOptions: ["High", "Low"] }),
-			priority: "High"
-		});
-		const enumValues = (await loader.import("@cardstack/base/enum")).enumValues;
-		let values = enumValues(t, "priority");
-		assert.deepEqual(values, ["High", "Low"], "resolves enum values from linked card");
-	});
-	(0, import_qunit.test)("single-value: explicit null option renders with label and can be selected (intentional fail until implemented)", async function(assert) {
-		assert.expect(5);
-		const PriorityField = enumField(string_default, { options: [{
-			value: null,
-			label: "None"
-		}, "High"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		await setupIntegrationTestRealm({
-			skipBootIndex: true,
-			mockMatrixUtils,
-			contents: { "test-cards.gts": { Task } }
-		});
-		let t = new Task({ priority: null });
-		const enumValues = (await loader.import("@cardstack/base/enum")).enumValues;
-		assert.deepEqual(enumValues(t, "priority"), [null, "High"], "enumValues includes explicit null");
-		await renderCard(loader, t, "edit");
-		await click(".boxel-select");
-		let labels = Array.from(document.querySelectorAll(".boxel-select__dropdown .boxel-select-option-text")).map((el) => (el.textContent || "").trim());
-		assert.deepEqual(labels, ["None", "High"], "dropdown renders explicit null label and other options");
-		await click("[data-test-option=\"0\"]");
-		assert.strictEqual(t.priority, null, "selecting labeled null sets value to null");
-		let doc = serializeCard(t, {});
-		let t2 = await createFromSerialized(doc.data, doc, new URL(`${testModuleRealm}`));
-		assert.strictEqual(t2.priority, null, "serialized/deserialized value stays null");
-		assert.dom(".boxel-select .option-title").hasText("None", "trigger shows null label");
-	});
-	(0, import_qunit.test)("single-value: placeholder shown when value is null and null is not in options; can be customized via unsetLabel (intentional fail until implemented)", async function(assert) {
-		assert.expect(5);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class TaskA extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-			static embedded = class Embedded extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "IDHcHaIi",
-						"block": "[[[8,[30,1,[\"priority\"]],null,[[\"@format\"],[\"atom\"]],null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let a = new TaskA({ priority: null });
-		await renderCard(loader, a, "edit");
-		assert.dom(".boxel-select .boxel-trigger-placeholder").hasText("Choose…", "uses default placeholder");
-		await renderCard(loader, a, "embedded");
-		assert.dom(".option-title").hasText("—", "atom renders unset fallback dash");
-		class TaskB extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField, { configuration: () => ({ enum: {
-						options: ["High", "Low"],
-						unsetLabel: "Select one"
-					} }) });
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let b = new TaskB({ priority: null });
-		await renderCard(loader, b, "edit");
-		assert.dom(".boxel-select .boxel-trigger-placeholder").hasText("Select one", "uses configured unsetLabel");
-		assert.deepEqual(enumValues(a, "priority"), ["High", "Low"], "enumValues excludes null when not provided");
-		assert.deepEqual(enumValues(b, "priority"), ["High", "Low"], "enumValues excludes null even with unsetLabel");
-	});
-	(0, import_qunit.test)("containsMany: explicit null option can be chosen per item (intentional fail until implemented)", async function(assert) {
-		assert.expect(3);
-		const PriorityField = enumField(string_default, { options: [{
-			value: null,
-			label: "None"
-		}, "High"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priorities", [field], function() {
-					return containsMany(PriorityField);
-				});
-			}
-			#priorities = (initializeDeferredDecorator(this, "priorities"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "LECn428i",
-						"block": "[[[8,[30,1,[\"priorities\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		await setupIntegrationTestRealm({
-			skipBootIndex: true,
-			mockMatrixUtils,
-			contents: { "test-cards.gts": { Task } }
-		});
-		let t = new Task({ priorities: ["High", "High"] });
-		await renderCard(loader, t, "edit");
-		await click(document.querySelectorAll("[data-test-contains-many=\"priorities\"] .boxel-select")[1]);
-		await click("[data-test-option=\"0\"]");
-		assert.deepEqual(t.priorities, ["High", null], "second item set to null");
-		assert.deepEqual(enumValues(t, "priorities"), [null, "High"], "enumValues includes null when provided");
-		let doc = serializeCard(t, {});
-		let t2 = await createFromSerialized(doc.data, doc, new URL(`${testModuleRealm}`));
-		assert.deepEqual(t2.priorities, ["High", null], "plural serialization preserves null items");
-	});
-	(0, import_qunit.test)("atom-only: renders dash for null when unsetLabel is not provided", async function(assert) {
-		assert.expect(1);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static embedded = class Embedded extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "IDHcHaIi",
-						"block": "[[[8,[30,1,[\"priority\"]],null,[[\"@format\"],[\"atom\"]],null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priority: null });
-		await renderCard(loader, t, "embedded");
-		assert.dom(".option-title").hasText("—", "atom renders default dash for null");
-	});
-	(0, import_qunit.test)("atom-only: renders String(@model) when value not in options (value fallback)", async function(assert) {
-		assert.expect(2);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static embedded = class Embedded extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "IDHcHaIi",
-						"block": "[[[8,[30,1,[\"priority\"]],null,[[\"@format\"],[\"atom\"]],null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({ priority: "Unexpected" });
-		await renderCard(loader, t, "embedded");
-		assert.dom(".option-title").hasText("Unexpected", "atom renders raw value when no matching option");
-		assert.dom("[data-test-enum-atom-fallback]").exists("atom sets fallback marker for unmatched value");
-	});
-	(0, import_qunit.test)("throws error for duplicate primitive option values", async function(assert) {
-		assert.expect(1);
-		const PriorityField = enumField(string_default, { options: ["High", "High"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField);
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let t = new Task({ priority: "High" });
-		assert.throws(() => {
-			enumOptions(t, "priority");
-		}, /duplicate option value/i, "duplicate values should throw");
-	});
-	(0, import_qunit.test)("throws error for duplicate values provided via usage-level configuration", async function(assert) {
-		assert.expect(1);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField, { configuration: enumConfig(() => ({ options: ["Low", "Low"] })) });
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-		}
-		let t = new Task({ priority: "Low" });
-		assert.throws(() => {
-			enumOptions(t, "priority");
-		}, /duplicate option value/i, "duplicate values via usage-level config should throw");
-	});
-	(0, import_qunit.test)("usage-level configuration function supplies options for contains() using parent instance", async function(assert) {
-		assert.expect(3);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "customOptions", [field], function() {
-					return containsMany(string_default);
-				});
-			}
-			#customOptions = (initializeDeferredDecorator(this, "customOptions"), void 0);
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField, { configuration: enumConfig(function() {
-						return { options: this.customOptions };
-					}) });
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({
-			customOptions: ["Urgent", "Normal"],
-			priority: "Normal"
-		});
-		const enumValues = (await loader.import("@cardstack/base/enum")).enumValues;
-		assert.deepEqual(enumValues(t, "priority"), ["Urgent", "Normal"], "enumValues reflects usage-level options (replacing defaults)");
-		await renderCard(loader, t, "edit");
-		await click(".boxel-select");
-		assert.dom(".boxel-select__dropdown .boxel-select-option-text").exists({ count: 2 }, "editor shows usage-level options");
-		let usageLabels = Array.from(document.querySelectorAll(".boxel-select__dropdown .boxel-select-option-text")).map((el) => (el.textContent || "").trim());
-		assert.deepEqual(usageLabels, ["Urgent", "Normal"], "dropdown shows options from parent instance configuration");
-	});
-	(0, import_qunit.test)("a field override keeps the per-usage configuration of the field it narrows", async function(assert) {
-		assert.expect(5);
-		const PriorityField = enumField(string_default, { options: ["High", "Low"] });
-		class NarrowedPriorityField extends PriorityField {}
-		class Task extends CardDef {
-			static {
-				decorateFieldV2(this.prototype, "priority", [field], function() {
-					return contains(PriorityField, { configuration: enumConfig(() => ({ options: ["Urgent", "Normal"] })) });
-				});
-			}
-			#priority = (initializeDeferredDecorator(this, "priority"), void 0);
-			static edit = class Edit extends Component {
-				static {
-					setComponentTemplate(templateFactory({
-						"id": "Ix17IXkT",
-						"block": "[[[8,[30,1,[\"priority\"]],null,null,null]],[\"@fields\"],[]]",
-						"moduleName": "/home/runner/work/boxel/boxel/packages/host/tests/integration/enum-field-test.gts",
-						"isStrictMode": true
-					}), this);
-				}
-			};
-		}
-		let t = new Task({
-			priority: "Normal",
-			[fields]: { priority: NarrowedPriorityField }
-		});
-		let narrowed = getField(t, "priority");
-		assert.strictEqual(narrowed?.card, NarrowedPriorityField, "the field resolves to the narrowed subtype");
-		assert.strictEqual(narrowed?.fieldType, "contains", "and is still the contains field it was declared as");
-		assert.deepEqual(enumValues(t, "priority"), ["Urgent", "Normal"], "the per-usage options survive the override");
-		await renderCard(loader, t, "edit");
-		await click(".boxel-select");
-		let labels = Array.from(document.querySelectorAll(".boxel-select__dropdown .boxel-select-option-text")).map((el) => (el.textContent || "").trim());
-		assert.dom(".boxel-select__dropdown .boxel-select-option-text").exists({ count: 2 }, "the editor offers the per-usage options");
-		assert.deepEqual(labels, ["Urgent", "Normal"], "dropdown shows the options the field was declared with");
-	});
-});
-//#endregion