@aigne/aos 0.2.0-beta

package/dist/auto-surface/projectors/settings-shell.mjs

@@ -0,0 +1,114 @@
+//#region src/auto-surface/projectors/settings-shell.ts
+function projectSettingsShell(resolved, options = {}) {
+	const scope = options.scope ?? "all";
+	const groups = /* @__PURE__ */ new Map();
+	for (const resource of Object.values(resolved.resources)) {
+		if (scope !== "all" && !resource.availableScopes.includes(scope)) continue;
+		const presentation = resource.definition.presentations?.["settings-shell"];
+		const groupTitle = presentation?.group ?? "General";
+		const pageTitle = presentation?.page ?? "General";
+		const sectionTitle = presentation?.section ?? "General";
+		ensureSection(ensurePage(ensureGroup(groups, groupTitle, presentation).pages, pageTitle, presentation).sections, sectionTitle, presentation).node.fields.push(projectField(resource, presentation));
+	}
+	return {
+		projector: "settings-shell",
+		scope,
+		groups: sortGroups(groups)
+	};
+}
+function ensureGroup(groups, title, presentation) {
+	const id = slugify(title);
+	let group = groups.get(id);
+	if (!group) {
+		group = {
+			order: presentation?.groupOrder ?? 0,
+			pages: /* @__PURE__ */ new Map(),
+			node: {
+				kind: "group",
+				id,
+				title,
+				pages: []
+			}
+		};
+		groups.set(id, group);
+	}
+	return group;
+}
+function ensurePage(pages, title, presentation) {
+	const id = slugify(title);
+	let page = pages.get(id);
+	if (!page) {
+		page = {
+			order: presentation?.pageOrder ?? 0,
+			sections: /* @__PURE__ */ new Map(),
+			node: {
+				kind: "page",
+				id,
+				title,
+				sections: []
+			}
+		};
+		pages.set(id, page);
+	}
+	return page;
+}
+function ensureSection(sections, title, presentation) {
+	const id = slugify(title);
+	let section = sections.get(id);
+	if (!section) {
+		section = {
+			order: presentation?.sectionOrder ?? 0,
+			node: {
+				kind: "section",
+				id,
+				title,
+				fields: []
+			}
+		};
+		sections.set(id, section);
+	}
+	return section;
+}
+function projectField(resource, presentation) {
+	return {
+		kind: "field",
+		id: resource.id,
+		title: presentation?.title ?? resource.definition.title ?? labelize(resource.id),
+		description: presentation?.description ?? resource.definition.description,
+		type: resource.definition.type,
+		value: resource.value,
+		source: resource.source,
+		options: resource.definition.options,
+		validation: resource.definition.validation,
+		policy: resource.definition.policy,
+		bindings: resource.definition.bindings
+	};
+}
+function sortGroups(groups) {
+	return [...groups.values()].sort(compareByOrderThenTitle).map((group) => ({
+		...group.node,
+		pages: [...group.pages.values()].sort(compareByOrderThenTitle).map((page) => ({
+			...page.node,
+			sections: [...page.sections.values()].sort(compareByOrderThenTitle).map((section) => ({
+				...section.node,
+				fields: section.node.fields.sort(compareFields)
+			}))
+		}))
+	}));
+}
+function compareByOrderThenTitle(left, right) {
+	return left.order - right.order || left.node.title.localeCompare(right.node.title);
+}
+function compareFields(left, right) {
+	return left.title.localeCompare(right.title);
+}
+function labelize(value) {
+	return (value.split(".").pop() ?? value).replace(/[_-]+/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function slugify(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "general";
+}
+
+//#endregion
+export { projectSettingsShell };
+//# sourceMappingURL=settings-shell.mjs.map

package/dist/auto-surface/projectors/settings-shell.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-shell.mjs","names":[],"sources":["../../../src/auto-surface/projectors/settings-shell.ts"],"sourcesContent":["import type {\n  AutoSurfaceLayer,\n  AutoSurfaceProjectedField,\n  AutoSurfaceProjectedGroup,\n  AutoSurfaceProjectedPage,\n  AutoSurfaceProjectedSection,\n  AutoSurfaceResolvedRegistry,\n  AutoSurfaceResolvedResource,\n  AutoSurfaceSettingsShellPresentation,\n  AutoSurfaceSettingsShellProjection,\n} from \"../types.js\";\n\nexport interface ProjectSettingsShellOptions {\n  scope?: AutoSurfaceLayer | \"all\";\n}\n\ninterface IndexedGroup {\n  order: number;\n  node: AutoSurfaceProjectedGroup;\n  pages: Map<string, IndexedPage>;\n}\n\ninterface IndexedPage {\n  order: number;\n  node: AutoSurfaceProjectedPage;\n  sections: Map<string, IndexedSection>;\n}\n\ninterface IndexedSection {\n  order: number;\n  node: AutoSurfaceProjectedSection;\n}\n\nexport function projectSettingsShell(\n  resolved: AutoSurfaceResolvedRegistry,\n  options: ProjectSettingsShellOptions = {},\n): AutoSurfaceSettingsShellProjection {\n  const scope = options.scope ?? \"all\";\n  const groups = new Map<string, IndexedGroup>();\n\n  for (const resource of Object.values(resolved.resources)) {\n    if (scope !== \"all\" && !resource.availableScopes.includes(scope)) continue;\n    const presentation = resource.definition.presentations?.[\"settings-shell\"];\n    const groupTitle = presentation?.group ?? \"General\";\n    const pageTitle = presentation?.page ?? \"General\";\n    const sectionTitle = presentation?.section ?? \"General\";\n\n    const group = ensureGroup(groups, groupTitle, presentation);\n    const page = ensurePage(group.pages, pageTitle, presentation);\n    const section = ensureSection(page.sections, sectionTitle, presentation);\n    section.node.fields.push(projectField(resource, presentation));\n  }\n\n  return {\n    projector: \"settings-shell\",\n    scope,\n    groups: sortGroups(groups),\n  };\n}\n\nfunction ensureGroup(\n  groups: Map<string, IndexedGroup>,\n  title: string,\n  presentation: AutoSurfaceSettingsShellPresentation | undefined,\n): IndexedGroup {\n  const id = slugify(title);\n  let group = groups.get(id);\n  if (!group) {\n    group = {\n      order: presentation?.groupOrder ?? 0,\n      pages: new Map(),\n      node: { kind: \"group\", id, title, pages: [] },\n    };\n    groups.set(id, group);\n  }\n  return group;\n}\n\nfunction ensurePage(\n  pages: Map<string, IndexedPage>,\n  title: string,\n  presentation: AutoSurfaceSettingsShellPresentation | undefined,\n): IndexedPage {\n  const id = slugify(title);\n  let page = pages.get(id);\n  if (!page) {\n    page = {\n      order: presentation?.pageOrder ?? 0,\n      sections: new Map(),\n      node: { kind: \"page\", id, title, sections: [] },\n    };\n    pages.set(id, page);\n  }\n  return page;\n}\n\nfunction ensureSection(\n  sections: Map<string, IndexedSection>,\n  title: string,\n  presentation: AutoSurfaceSettingsShellPresentation | undefined,\n): IndexedSection {\n  const id = slugify(title);\n  let section = sections.get(id);\n  if (!section) {\n    section = {\n      order: presentation?.sectionOrder ?? 0,\n      node: { kind: \"section\", id, title, fields: [] },\n    };\n    sections.set(id, section);\n  }\n  return section;\n}\n\nfunction projectField(\n  resource: AutoSurfaceResolvedResource,\n  presentation: AutoSurfaceSettingsShellPresentation | undefined,\n): AutoSurfaceProjectedField {\n  return {\n    kind: \"field\",\n    id: resource.id,\n    title: presentation?.title ?? resource.definition.title ?? labelize(resource.id),\n    description: presentation?.description ?? resource.definition.description,\n    type: resource.definition.type,\n    value: resource.value,\n    source: resource.source,\n    options: resource.definition.options,\n    validation: resource.definition.validation,\n    policy: resource.definition.policy,\n    bindings: resource.definition.bindings,\n  };\n}\n\nfunction sortGroups(groups: Map<string, IndexedGroup>): AutoSurfaceProjectedGroup[] {\n  return [...groups.values()].sort(compareByOrderThenTitle).map((group) => ({\n    ...group.node,\n    pages: [...group.pages.values()].sort(compareByOrderThenTitle).map((page) => ({\n      ...page.node,\n      sections: [...page.sections.values()].sort(compareByOrderThenTitle).map((section) => ({\n        ...section.node,\n        fields: section.node.fields.sort(compareFields),\n      })),\n    })),\n  }));\n}\n\nfunction compareByOrderThenTitle(\n  left: { order: number; node: { title: string } },\n  right: { order: number; node: { title: string } },\n): number {\n  return left.order - right.order || left.node.title.localeCompare(right.node.title);\n}\n\nfunction compareFields(left: AutoSurfaceProjectedField, right: AutoSurfaceProjectedField): number {\n  return left.title.localeCompare(right.title);\n}\n\nfunction labelize(value: string): string {\n  const lastSegment = value.split(\".\").pop() ?? value;\n  return lastSegment\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/\\b\\w/g, (char) => char.toUpperCase());\n}\n\nfunction slugify(value: string): string {\n  return (\n    value\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\") || \"general\"\n  );\n}\n"],"mappings":";AAiCA,SAAgB,qBACd,UACA,UAAuC,EAAE,EACL;CACpC,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,yBAAS,IAAI,KAA2B;AAE9C,MAAK,MAAM,YAAY,OAAO,OAAO,SAAS,UAAU,EAAE;AACxD,MAAI,UAAU,SAAS,CAAC,SAAS,gBAAgB,SAAS,MAAM,CAAE;EAClE,MAAM,eAAe,SAAS,WAAW,gBAAgB;EACzD,MAAM,aAAa,cAAc,SAAS;EAC1C,MAAM,YAAY,cAAc,QAAQ;EACxC,MAAM,eAAe,cAAc,WAAW;AAK9C,EADgB,cADH,WADC,YAAY,QAAQ,YAAY,aAAa,CAC7B,OAAO,WAAW,aAAa,CAC1B,UAAU,cAAc,aAAa,CAChE,KAAK,OAAO,KAAK,aAAa,UAAU,aAAa,CAAC;;AAGhE,QAAO;EACL,WAAW;EACX;EACA,QAAQ,WAAW,OAAO;EAC3B;;AAGH,SAAS,YACP,QACA,OACA,cACc;CACd,MAAM,KAAK,QAAQ,MAAM;CACzB,IAAI,QAAQ,OAAO,IAAI,GAAG;AAC1B,KAAI,CAAC,OAAO;AACV,UAAQ;GACN,OAAO,cAAc,cAAc;GACnC,uBAAO,IAAI,KAAK;GAChB,MAAM;IAAE,MAAM;IAAS;IAAI;IAAO,OAAO,EAAE;IAAE;GAC9C;AACD,SAAO,IAAI,IAAI,MAAM;;AAEvB,QAAO;;AAGT,SAAS,WACP,OACA,OACA,cACa;CACb,MAAM,KAAK,QAAQ,MAAM;CACzB,IAAI,OAAO,MAAM,IAAI,GAAG;AACxB,KAAI,CAAC,MAAM;AACT,SAAO;GACL,OAAO,cAAc,aAAa;GAClC,0BAAU,IAAI,KAAK;GACnB,MAAM;IAAE,MAAM;IAAQ;IAAI;IAAO,UAAU,EAAE;IAAE;GAChD;AACD,QAAM,IAAI,IAAI,KAAK;;AAErB,QAAO;;AAGT,SAAS,cACP,UACA,OACA,cACgB;CAChB,MAAM,KAAK,QAAQ,MAAM;CACzB,IAAI,UAAU,SAAS,IAAI,GAAG;AAC9B,KAAI,CAAC,SAAS;AACZ,YAAU;GACR,OAAO,cAAc,gBAAgB;GACrC,MAAM;IAAE,MAAM;IAAW;IAAI;IAAO,QAAQ,EAAE;IAAE;GACjD;AACD,WAAS,IAAI,IAAI,QAAQ;;AAE3B,QAAO;;AAGT,SAAS,aACP,UACA,cAC2B;AAC3B,QAAO;EACL,MAAM;EACN,IAAI,SAAS;EACb,OAAO,cAAc,SAAS,SAAS,WAAW,SAAS,SAAS,SAAS,GAAG;EAChF,aAAa,cAAc,eAAe,SAAS,WAAW;EAC9D,MAAM,SAAS,WAAW;EAC1B,OAAO,SAAS;EAChB,QAAQ,SAAS;EACjB,SAAS,SAAS,WAAW;EAC7B,YAAY,SAAS,WAAW;EAChC,QAAQ,SAAS,WAAW;EAC5B,UAAU,SAAS,WAAW;EAC/B;;AAGH,SAAS,WAAW,QAAgE;AAClF,QAAO,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,KAAK,wBAAwB,CAAC,KAAK,WAAW;EACxE,GAAG,MAAM;EACT,OAAO,CAAC,GAAG,MAAM,MAAM,QAAQ,CAAC,CAAC,KAAK,wBAAwB,CAAC,KAAK,UAAU;GAC5E,GAAG,KAAK;GACR,UAAU,CAAC,GAAG,KAAK,SAAS,QAAQ,CAAC,CAAC,KAAK,wBAAwB,CAAC,KAAK,aAAa;IACpF,GAAG,QAAQ;IACX,QAAQ,QAAQ,KAAK,OAAO,KAAK,cAAc;IAChD,EAAE;GACJ,EAAE;EACJ,EAAE;;AAGL,SAAS,wBACP,MACA,OACQ;AACR,QAAO,KAAK,QAAQ,MAAM,SAAS,KAAK,KAAK,MAAM,cAAc,MAAM,KAAK,MAAM;;AAGpF,SAAS,cAAc,MAAiC,OAA0C;AAChG,QAAO,KAAK,MAAM,cAAc,MAAM,MAAM;;AAG9C,SAAS,SAAS,OAAuB;AAEvC,SADoB,MAAM,MAAM,IAAI,CAAC,KAAK,IAAI,OAE3C,QAAQ,UAAU,IAAI,CACtB,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,UAAU,SAAS,KAAK,aAAa,CAAC;;AAGnD,SAAS,QAAQ,OAAuB;AACtC,QACE,MACG,MAAM,CACN,aAAa,CACb,QAAQ,eAAe,IAAI,CAC3B,QAAQ,YAAY,GAAG,IAAI"}

package/dist/auto-surface/scenario.cjs

@@ -0,0 +1,38 @@
+const require_compiler = require('./compiler.cjs');
+const require_fragments = require('./fragments.cjs');
+const require_layering = require('./layering.cjs');
+
+//#region src/auto-surface/scenario.ts
+async function loadAutoSurfaceRegistry(options) {
+	const fragments = await Promise.all(options.definitions.map((definition) => require_fragments.loadAutoSurfaceFragment(definition.reader, {
+		source: definition.source,
+		owner: definition.owner,
+		root: definition.root
+	})));
+	return {
+		...require_compiler.compileAutoSurfaceRegistry(fragments),
+		fragments
+	};
+}
+async function loadAutoSurfaceValueLayers(options = {}) {
+	const valueLayers = {};
+	await Promise.all((options.values ?? []).map(async (valueSource) => {
+		valueLayers[valueSource.layer] = await require_fragments.loadAutoSurfaceValueLayer(valueSource.reader, { root: valueSource.root });
+	}));
+	return valueLayers;
+}
+async function resolveAutoSurfaceScenario(options) {
+	const [{ fragments, diagnostics, registry }, valueLayers] = await Promise.all([loadAutoSurfaceRegistry({ definitions: options.definitions }), loadAutoSurfaceValueLayers({ values: options.values })]);
+	return {
+		registry,
+		diagnostics,
+		fragments,
+		valueLayers,
+		resolved: require_layering.resolveAutoSurfaceValues(registry, valueLayers)
+	};
+}
+
+//#endregion
+exports.loadAutoSurfaceRegistry = loadAutoSurfaceRegistry;
+exports.loadAutoSurfaceValueLayers = loadAutoSurfaceValueLayers;
+exports.resolveAutoSurfaceScenario = resolveAutoSurfaceScenario;

package/dist/auto-surface/scenario.d.cts

@@ -0,0 +1,31 @@
+import { AutoSurfaceDefinitionOwner, AutoSurfaceLayer, AutoSurfaceLoadedRegistry, AutoSurfaceResolvedScenario, AutoSurfaceValueLayers } from "./types.cjs";
+import { AutoSurfaceFragmentReader, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions } from "./fragments.cjs";
+
+//#region src/auto-surface/scenario.d.ts
+interface AutoSurfaceDefinitionSource {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  reader: AutoSurfaceFragmentReader;
+  root?: LoadAutoSurfaceFragmentOptions["root"];
+}
+interface AutoSurfaceValueLayerSource {
+  layer: AutoSurfaceLayer;
+  reader: AutoSurfaceFragmentReader;
+  root?: LoadAutoSurfaceValueLayerOptions["root"];
+}
+interface LoadAutoSurfaceRegistryOptions {
+  definitions: AutoSurfaceDefinitionSource[];
+}
+interface LoadAutoSurfaceValueLayersOptions {
+  values?: AutoSurfaceValueLayerSource[];
+}
+interface ResolveAutoSurfaceScenarioOptions {
+  definitions: AutoSurfaceDefinitionSource[];
+  values?: AutoSurfaceValueLayerSource[];
+}
+declare function loadAutoSurfaceRegistry(options: LoadAutoSurfaceRegistryOptions): Promise<AutoSurfaceLoadedRegistry>;
+declare function loadAutoSurfaceValueLayers(options?: LoadAutoSurfaceValueLayersOptions): Promise<AutoSurfaceValueLayers>;
+declare function resolveAutoSurfaceScenario(options: ResolveAutoSurfaceScenarioOptions): Promise<AutoSurfaceResolvedScenario>;
+//#endregion
+export { AutoSurfaceDefinitionSource, AutoSurfaceValueLayerSource, LoadAutoSurfaceRegistryOptions, LoadAutoSurfaceValueLayersOptions, ResolveAutoSurfaceScenarioOptions, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario };
+//# sourceMappingURL=scenario.d.cts.map

package/dist/auto-surface/scenario.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.cts","names":[],"sources":["../../src/auto-surface/scenario.ts"],"mappings":";;;;UAiBiB,2BAAA;EACf,MAAA;EACA,KAAA,EAAO,0BAAA;EACP,MAAA,EAAQ,yBAAA;EACR,IAAA,GAAO,8BAAA;AAAA;AAAA,UAGQ,2BAAA;EACf,KAAA,EAAO,gBAAA;EACP,MAAA,EAAQ,yBAAA;EACR,IAAA,GAAO,gCAAA;AAAA;AAAA,UAGQ,8BAAA;EACf,WAAA,EAAa,2BAAA;AAAA;AAAA,UAGE,iCAAA;EACf,MAAA,GAAS,2BAAA;AAAA;AAAA,UAGM,iCAAA;EACf,WAAA,EAAa,2BAAA;EACb,MAAA,GAAS,2BAAA;AAAA;AAAA,iBAGW,uBAAA,CACpB,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,yBAAA;AAAA,iBAiBW,0BAAA,CACpB,OAAA,GAAS,iCAAA,GACR,OAAA,CAAQ,sBAAA;AAAA,iBAcW,0BAAA,CACpB,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,2BAAA"}

package/dist/auto-surface/scenario.d.mts

@@ -0,0 +1,31 @@
+import { AutoSurfaceDefinitionOwner, AutoSurfaceLayer, AutoSurfaceLoadedRegistry, AutoSurfaceResolvedScenario, AutoSurfaceValueLayers } from "./types.mjs";
+import { AutoSurfaceFragmentReader, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions } from "./fragments.mjs";
+
+//#region src/auto-surface/scenario.d.ts
+interface AutoSurfaceDefinitionSource {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  reader: AutoSurfaceFragmentReader;
+  root?: LoadAutoSurfaceFragmentOptions["root"];
+}
+interface AutoSurfaceValueLayerSource {
+  layer: AutoSurfaceLayer;
+  reader: AutoSurfaceFragmentReader;
+  root?: LoadAutoSurfaceValueLayerOptions["root"];
+}
+interface LoadAutoSurfaceRegistryOptions {
+  definitions: AutoSurfaceDefinitionSource[];
+}
+interface LoadAutoSurfaceValueLayersOptions {
+  values?: AutoSurfaceValueLayerSource[];
+}
+interface ResolveAutoSurfaceScenarioOptions {
+  definitions: AutoSurfaceDefinitionSource[];
+  values?: AutoSurfaceValueLayerSource[];
+}
+declare function loadAutoSurfaceRegistry(options: LoadAutoSurfaceRegistryOptions): Promise<AutoSurfaceLoadedRegistry>;
+declare function loadAutoSurfaceValueLayers(options?: LoadAutoSurfaceValueLayersOptions): Promise<AutoSurfaceValueLayers>;
+declare function resolveAutoSurfaceScenario(options: ResolveAutoSurfaceScenarioOptions): Promise<AutoSurfaceResolvedScenario>;
+//#endregion
+export { AutoSurfaceDefinitionSource, AutoSurfaceValueLayerSource, LoadAutoSurfaceRegistryOptions, LoadAutoSurfaceValueLayersOptions, ResolveAutoSurfaceScenarioOptions, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario };
+//# sourceMappingURL=scenario.d.mts.map

package/dist/auto-surface/scenario.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.mts","names":[],"sources":["../../src/auto-surface/scenario.ts"],"mappings":";;;;UAiBiB,2BAAA;EACf,MAAA;EACA,KAAA,EAAO,0BAAA;EACP,MAAA,EAAQ,yBAAA;EACR,IAAA,GAAO,8BAAA;AAAA;AAAA,UAGQ,2BAAA;EACf,KAAA,EAAO,gBAAA;EACP,MAAA,EAAQ,yBAAA;EACR,IAAA,GAAO,gCAAA;AAAA;AAAA,UAGQ,8BAAA;EACf,WAAA,EAAa,2BAAA;AAAA;AAAA,UAGE,iCAAA;EACf,MAAA,GAAS,2BAAA;AAAA;AAAA,UAGM,iCAAA;EACf,WAAA,EAAa,2BAAA;EACb,MAAA,GAAS,2BAAA;AAAA;AAAA,iBAGW,uBAAA,CACpB,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,yBAAA;AAAA,iBAiBW,0BAAA,CACpB,OAAA,GAAS,iCAAA,GACR,OAAA,CAAQ,sBAAA;AAAA,iBAcW,0BAAA,CACpB,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,2BAAA"}

package/dist/auto-surface/scenario.mjs

@@ -0,0 +1,37 @@
+import { compileAutoSurfaceRegistry } from "./compiler.mjs";
+import { loadAutoSurfaceFragment, loadAutoSurfaceValueLayer } from "./fragments.mjs";
+import { resolveAutoSurfaceValues } from "./layering.mjs";
+
+//#region src/auto-surface/scenario.ts
+async function loadAutoSurfaceRegistry(options) {
+	const fragments = await Promise.all(options.definitions.map((definition) => loadAutoSurfaceFragment(definition.reader, {
+		source: definition.source,
+		owner: definition.owner,
+		root: definition.root
+	})));
+	return {
+		...compileAutoSurfaceRegistry(fragments),
+		fragments
+	};
+}
+async function loadAutoSurfaceValueLayers(options = {}) {
+	const valueLayers = {};
+	await Promise.all((options.values ?? []).map(async (valueSource) => {
+		valueLayers[valueSource.layer] = await loadAutoSurfaceValueLayer(valueSource.reader, { root: valueSource.root });
+	}));
+	return valueLayers;
+}
+async function resolveAutoSurfaceScenario(options) {
+	const [{ fragments, diagnostics, registry }, valueLayers] = await Promise.all([loadAutoSurfaceRegistry({ definitions: options.definitions }), loadAutoSurfaceValueLayers({ values: options.values })]);
+	return {
+		registry,
+		diagnostics,
+		fragments,
+		valueLayers,
+		resolved: resolveAutoSurfaceValues(registry, valueLayers)
+	};
+}
+
+//#endregion
+export { loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario };
+//# sourceMappingURL=scenario.mjs.map

package/dist/auto-surface/scenario.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.mjs","names":[],"sources":["../../src/auto-surface/scenario.ts"],"sourcesContent":["import { compileAutoSurfaceRegistry } from \"./compiler.js\";\nimport {\n  type AutoSurfaceFragmentReader,\n  type LoadAutoSurfaceFragmentOptions,\n  type LoadAutoSurfaceValueLayerOptions,\n  loadAutoSurfaceFragment,\n  loadAutoSurfaceValueLayer,\n} from \"./fragments.js\";\nimport { resolveAutoSurfaceValues } from \"./layering.js\";\nimport type {\n  AutoSurfaceDefinitionOwner,\n  AutoSurfaceLayer,\n  AutoSurfaceLoadedRegistry,\n  AutoSurfaceResolvedScenario,\n  AutoSurfaceValueLayers,\n} from \"./types.js\";\n\nexport interface AutoSurfaceDefinitionSource {\n  source: string;\n  owner: AutoSurfaceDefinitionOwner;\n  reader: AutoSurfaceFragmentReader;\n  root?: LoadAutoSurfaceFragmentOptions[\"root\"];\n}\n\nexport interface AutoSurfaceValueLayerSource {\n  layer: AutoSurfaceLayer;\n  reader: AutoSurfaceFragmentReader;\n  root?: LoadAutoSurfaceValueLayerOptions[\"root\"];\n}\n\nexport interface LoadAutoSurfaceRegistryOptions {\n  definitions: AutoSurfaceDefinitionSource[];\n}\n\nexport interface LoadAutoSurfaceValueLayersOptions {\n  values?: AutoSurfaceValueLayerSource[];\n}\n\nexport interface ResolveAutoSurfaceScenarioOptions {\n  definitions: AutoSurfaceDefinitionSource[];\n  values?: AutoSurfaceValueLayerSource[];\n}\n\nexport async function loadAutoSurfaceRegistry(\n  options: LoadAutoSurfaceRegistryOptions,\n): Promise<AutoSurfaceLoadedRegistry> {\n  const fragments = await Promise.all(\n    options.definitions.map((definition) =>\n      loadAutoSurfaceFragment(definition.reader, {\n        source: definition.source,\n        owner: definition.owner,\n        root: definition.root,\n      }),\n    ),\n  );\n  const compile = compileAutoSurfaceRegistry(fragments);\n  return {\n    ...compile,\n    fragments,\n  };\n}\n\nexport async function loadAutoSurfaceValueLayers(\n  options: LoadAutoSurfaceValueLayersOptions = {},\n): Promise<AutoSurfaceValueLayers> {\n  const valueLayers: AutoSurfaceValueLayers = {};\n\n  await Promise.all(\n    (options.values ?? []).map(async (valueSource) => {\n      valueLayers[valueSource.layer] = await loadAutoSurfaceValueLayer(valueSource.reader, {\n        root: valueSource.root,\n      });\n    }),\n  );\n\n  return valueLayers;\n}\n\nexport async function resolveAutoSurfaceScenario(\n  options: ResolveAutoSurfaceScenarioOptions,\n): Promise<AutoSurfaceResolvedScenario> {\n  const [{ fragments, diagnostics, registry }, valueLayers] = await Promise.all([\n    loadAutoSurfaceRegistry({ definitions: options.definitions }),\n    loadAutoSurfaceValueLayers({ values: options.values }),\n  ]);\n\n  return {\n    registry,\n    diagnostics,\n    fragments,\n    valueLayers,\n    resolved: resolveAutoSurfaceValues(registry, valueLayers),\n  };\n}\n"],"mappings":";;;;;AA2CA,eAAsB,wBACpB,SACoC;CACpC,MAAM,YAAY,MAAM,QAAQ,IAC9B,QAAQ,YAAY,KAAK,eACvB,wBAAwB,WAAW,QAAQ;EACzC,QAAQ,WAAW;EACnB,OAAO,WAAW;EAClB,MAAM,WAAW;EAClB,CAAC,CACH,CACF;AAED,QAAO;EACL,GAFc,2BAA2B,UAAU;EAGnD;EACD;;AAGH,eAAsB,2BACpB,UAA6C,EAAE,EACd;CACjC,MAAM,cAAsC,EAAE;AAE9C,OAAM,QAAQ,KACX,QAAQ,UAAU,EAAE,EAAE,IAAI,OAAO,gBAAgB;AAChD,cAAY,YAAY,SAAS,MAAM,0BAA0B,YAAY,QAAQ,EACnF,MAAM,YAAY,MACnB,CAAC;GACF,CACH;AAED,QAAO;;AAGT,eAAsB,2BACpB,SACsC;CACtC,MAAM,CAAC,EAAE,WAAW,aAAa,YAAY,eAAe,MAAM,QAAQ,IAAI,CAC5E,wBAAwB,EAAE,aAAa,QAAQ,aAAa,CAAC,EAC7D,2BAA2B,EAAE,QAAQ,QAAQ,QAAQ,CAAC,CACvD,CAAC;AAEF,QAAO;EACL;EACA;EACA;EACA;EACA,UAAU,yBAAyB,UAAU,YAAY;EAC1D"}

package/dist/auto-surface/types.cjs

@@ -0,0 +1,9 @@
+
+//#region src/auto-surface/types.ts
+function normalizeAutoSurfaceScopes(scopes) {
+	if (!scopes || scopes.length === 0) return ["instance"];
+	return [...new Set(scopes)];
+}
+
+//#endregion
+exports.normalizeAutoSurfaceScopes = normalizeAutoSurfaceScopes;

package/dist/auto-surface/types.d.cts

@@ -0,0 +1,153 @@
+//#region src/auto-surface/types.d.ts
+type AutoSurfaceDefinitionOwner = "system" | "package";
+type AutoSurfaceLayer = "system" | "package" | "instance" | "user";
+type AutoSurfaceProjectorName = "settings-shell";
+type AutoSurfaceValueSource = AutoSurfaceLayer | "default" | "unset";
+type AutoSurfaceValueType = "string" | "number" | "boolean" | "select" | "textarea" | "json";
+interface AutoSurfaceOption {
+  value: string | number | boolean;
+  label: string;
+}
+interface AutoSurfaceValidationRule {
+  required?: boolean;
+  min?: number;
+  max?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+}
+interface AutoSurfacePolicy {
+  readonly?: boolean;
+  secret?: boolean;
+  allowInstanceOverride?: boolean;
+  allowUserOverride?: boolean;
+}
+interface AutoSurfaceBindingMap {
+  system?: string;
+  package?: string;
+  instance?: string;
+  user?: string;
+}
+interface AutoSurfaceSettingsShellPresentation {
+  group?: string;
+  page?: string;
+  section?: string;
+  title?: string;
+  description?: string;
+  order?: number;
+  groupOrder?: number;
+  pageOrder?: number;
+  sectionOrder?: number;
+}
+type AutoSurfacePresentation = AutoSurfaceSettingsShellPresentation | Record<string, unknown>;
+type AutoSurfacePresentations = Record<string, AutoSurfacePresentation | undefined> & {
+  "settings-shell"?: AutoSurfaceSettingsShellPresentation;
+};
+interface AutoSurfaceResourceDefinition {
+  id: string;
+  type: AutoSurfaceValueType;
+  title?: string;
+  description?: string;
+  defaultValue?: unknown;
+  options?: AutoSurfaceOption[];
+  validation?: AutoSurfaceValidationRule;
+  scopes?: AutoSurfaceLayer[];
+  bindings?: AutoSurfaceBindingMap;
+  policy?: AutoSurfacePolicy;
+  presentations?: AutoSurfacePresentations;
+  metadata?: Record<string, unknown>;
+}
+interface AutoSurfaceFragment {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  resources: AutoSurfaceResourceDefinition[];
+}
+interface AutoSurfaceDiagnostic {
+  code: "duplicate_resource" | "protected_resource";
+  resourceId: string;
+  severity: "error" | "warning";
+  message: string;
+  source: string;
+}
+interface AutoSurfaceRegistryEntry {
+  definition: AutoSurfaceResourceDefinition;
+  owner: AutoSurfaceDefinitionOwner;
+  source: string;
+}
+interface AutoSurfaceRegistry {
+  resources: Record<string, AutoSurfaceRegistryEntry>;
+}
+interface AutoSurfaceCompileResult {
+  registry: AutoSurfaceRegistry;
+  diagnostics: AutoSurfaceDiagnostic[];
+}
+interface AutoSurfaceLoadedRegistry extends AutoSurfaceCompileResult {
+  fragments: AutoSurfaceFragment[];
+}
+interface AutoSurfaceValueLayers {
+  system?: Record<string, unknown>;
+  package?: Record<string, unknown>;
+  instance?: Record<string, unknown>;
+  user?: Record<string, unknown>;
+}
+interface AutoSurfaceResolvedResource {
+  id: string;
+  definition: AutoSurfaceResourceDefinition;
+  owner: AutoSurfaceDefinitionOwner;
+  value: unknown;
+  source: AutoSurfaceValueSource;
+  availableScopes: AutoSurfaceLayer[];
+  bindings: AutoSurfaceBindingMap;
+  sourceDefinition: string;
+}
+interface AutoSurfaceResolvedRegistry {
+  resources: Record<string, AutoSurfaceResolvedResource>;
+}
+interface AutoSurfaceResolvedScenario {
+  registry: AutoSurfaceRegistry;
+  diagnostics: AutoSurfaceDiagnostic[];
+  fragments: AutoSurfaceFragment[];
+  valueLayers: AutoSurfaceValueLayers;
+  resolved: AutoSurfaceResolvedRegistry;
+}
+interface AutoSurfaceProjectedField {
+  kind: "field";
+  id: string;
+  title: string;
+  description?: string;
+  type: AutoSurfaceValueType;
+  value: unknown;
+  source: AutoSurfaceValueSource;
+  options?: AutoSurfaceOption[];
+  validation?: AutoSurfaceValidationRule;
+  policy?: AutoSurfacePolicy;
+  bindings?: AutoSurfaceBindingMap;
+}
+interface AutoSurfaceProjectedSection {
+  kind: "section";
+  id: string;
+  title: string;
+  fields: AutoSurfaceProjectedField[];
+}
+interface AutoSurfaceProjectedPage {
+  kind: "page";
+  id: string;
+  title: string;
+  sections: AutoSurfaceProjectedSection[];
+}
+interface AutoSurfaceProjectedGroup {
+  kind: "group";
+  id: string;
+  title: string;
+  pages: AutoSurfaceProjectedPage[];
+}
+interface AutoSurfaceSettingsShellProjection {
+  projector: "settings-shell";
+  scope: AutoSurfaceLayer | "all";
+  groups: AutoSurfaceProjectedGroup[];
+}
+type AutoSurfaceProjection = AutoSurfaceSettingsShellProjection;
+declare function normalizeAutoSurfaceScopes(scopes: AutoSurfaceLayer[] | undefined): AutoSurfaceLayer[];
+//#endregion
+export { AutoSurfaceBindingMap, AutoSurfaceCompileResult, AutoSurfaceDefinitionOwner, AutoSurfaceDiagnostic, AutoSurfaceFragment, AutoSurfaceLayer, AutoSurfaceLoadedRegistry, AutoSurfaceOption, AutoSurfacePolicy, AutoSurfacePresentations, AutoSurfaceProjectedField, AutoSurfaceProjectedGroup, AutoSurfaceProjectedPage, AutoSurfaceProjectedSection, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceRegistry, AutoSurfaceRegistryEntry, AutoSurfaceResolvedRegistry, AutoSurfaceResolvedResource, AutoSurfaceResolvedScenario, AutoSurfaceResourceDefinition, AutoSurfaceSettingsShellPresentation, AutoSurfaceSettingsShellProjection, AutoSurfaceValidationRule, AutoSurfaceValueLayers, AutoSurfaceValueSource, AutoSurfaceValueType, normalizeAutoSurfaceScopes };
+//# sourceMappingURL=types.d.cts.map

package/dist/auto-surface/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/auto-surface/types.ts"],"mappings":"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"}

package/dist/auto-surface/types.d.mts

@@ -0,0 +1,153 @@
+//#region src/auto-surface/types.d.ts
+type AutoSurfaceDefinitionOwner = "system" | "package";
+type AutoSurfaceLayer = "system" | "package" | "instance" | "user";
+type AutoSurfaceProjectorName = "settings-shell";
+type AutoSurfaceValueSource = AutoSurfaceLayer | "default" | "unset";
+type AutoSurfaceValueType = "string" | "number" | "boolean" | "select" | "textarea" | "json";
+interface AutoSurfaceOption {
+  value: string | number | boolean;
+  label: string;
+}
+interface AutoSurfaceValidationRule {
+  required?: boolean;
+  min?: number;
+  max?: number;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+}
+interface AutoSurfacePolicy {
+  readonly?: boolean;
+  secret?: boolean;
+  allowInstanceOverride?: boolean;
+  allowUserOverride?: boolean;
+}
+interface AutoSurfaceBindingMap {
+  system?: string;
+  package?: string;
+  instance?: string;
+  user?: string;
+}
+interface AutoSurfaceSettingsShellPresentation {
+  group?: string;
+  page?: string;
+  section?: string;
+  title?: string;
+  description?: string;
+  order?: number;
+  groupOrder?: number;
+  pageOrder?: number;
+  sectionOrder?: number;
+}
+type AutoSurfacePresentation = AutoSurfaceSettingsShellPresentation | Record<string, unknown>;
+type AutoSurfacePresentations = Record<string, AutoSurfacePresentation | undefined> & {
+  "settings-shell"?: AutoSurfaceSettingsShellPresentation;
+};
+interface AutoSurfaceResourceDefinition {
+  id: string;
+  type: AutoSurfaceValueType;
+  title?: string;
+  description?: string;
+  defaultValue?: unknown;
+  options?: AutoSurfaceOption[];
+  validation?: AutoSurfaceValidationRule;
+  scopes?: AutoSurfaceLayer[];
+  bindings?: AutoSurfaceBindingMap;
+  policy?: AutoSurfacePolicy;
+  presentations?: AutoSurfacePresentations;
+  metadata?: Record<string, unknown>;
+}
+interface AutoSurfaceFragment {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  resources: AutoSurfaceResourceDefinition[];
+}
+interface AutoSurfaceDiagnostic {
+  code: "duplicate_resource" | "protected_resource";
+  resourceId: string;
+  severity: "error" | "warning";
+  message: string;
+  source: string;
+}
+interface AutoSurfaceRegistryEntry {
+  definition: AutoSurfaceResourceDefinition;
+  owner: AutoSurfaceDefinitionOwner;
+  source: string;
+}
+interface AutoSurfaceRegistry {
+  resources: Record<string, AutoSurfaceRegistryEntry>;
+}
+interface AutoSurfaceCompileResult {
+  registry: AutoSurfaceRegistry;
+  diagnostics: AutoSurfaceDiagnostic[];
+}
+interface AutoSurfaceLoadedRegistry extends AutoSurfaceCompileResult {
+  fragments: AutoSurfaceFragment[];
+}
+interface AutoSurfaceValueLayers {
+  system?: Record<string, unknown>;
+  package?: Record<string, unknown>;
+  instance?: Record<string, unknown>;
+  user?: Record<string, unknown>;
+}
+interface AutoSurfaceResolvedResource {
+  id: string;
+  definition: AutoSurfaceResourceDefinition;
+  owner: AutoSurfaceDefinitionOwner;
+  value: unknown;
+  source: AutoSurfaceValueSource;
+  availableScopes: AutoSurfaceLayer[];
+  bindings: AutoSurfaceBindingMap;
+  sourceDefinition: string;
+}
+interface AutoSurfaceResolvedRegistry {
+  resources: Record<string, AutoSurfaceResolvedResource>;
+}
+interface AutoSurfaceResolvedScenario {
+  registry: AutoSurfaceRegistry;
+  diagnostics: AutoSurfaceDiagnostic[];
+  fragments: AutoSurfaceFragment[];
+  valueLayers: AutoSurfaceValueLayers;
+  resolved: AutoSurfaceResolvedRegistry;
+}
+interface AutoSurfaceProjectedField {
+  kind: "field";
+  id: string;
+  title: string;
+  description?: string;
+  type: AutoSurfaceValueType;
+  value: unknown;
+  source: AutoSurfaceValueSource;
+  options?: AutoSurfaceOption[];
+  validation?: AutoSurfaceValidationRule;
+  policy?: AutoSurfacePolicy;
+  bindings?: AutoSurfaceBindingMap;
+}
+interface AutoSurfaceProjectedSection {
+  kind: "section";
+  id: string;
+  title: string;
+  fields: AutoSurfaceProjectedField[];
+}
+interface AutoSurfaceProjectedPage {
+  kind: "page";
+  id: string;
+  title: string;
+  sections: AutoSurfaceProjectedSection[];
+}
+interface AutoSurfaceProjectedGroup {
+  kind: "group";
+  id: string;
+  title: string;
+  pages: AutoSurfaceProjectedPage[];
+}
+interface AutoSurfaceSettingsShellProjection {
+  projector: "settings-shell";
+  scope: AutoSurfaceLayer | "all";
+  groups: AutoSurfaceProjectedGroup[];
+}
+type AutoSurfaceProjection = AutoSurfaceSettingsShellProjection;
+declare function normalizeAutoSurfaceScopes(scopes: AutoSurfaceLayer[] | undefined): AutoSurfaceLayer[];
+//#endregion
+export { AutoSurfaceBindingMap, AutoSurfaceCompileResult, AutoSurfaceDefinitionOwner, AutoSurfaceDiagnostic, AutoSurfaceFragment, AutoSurfaceLayer, AutoSurfaceLoadedRegistry, AutoSurfaceOption, AutoSurfacePolicy, AutoSurfacePresentations, AutoSurfaceProjectedField, AutoSurfaceProjectedGroup, AutoSurfaceProjectedPage, AutoSurfaceProjectedSection, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceRegistry, AutoSurfaceRegistryEntry, AutoSurfaceResolvedRegistry, AutoSurfaceResolvedResource, AutoSurfaceResolvedScenario, AutoSurfaceResourceDefinition, AutoSurfaceSettingsShellPresentation, AutoSurfaceSettingsShellProjection, AutoSurfaceValidationRule, AutoSurfaceValueLayers, AutoSurfaceValueSource, AutoSurfaceValueType, normalizeAutoSurfaceScopes };
+//# sourceMappingURL=types.d.mts.map

package/dist/auto-surface/types.d.mts.map

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

package/dist/auto-surface/types.mjs

@@ -0,0 +1,9 @@
+//#region src/auto-surface/types.ts
+function normalizeAutoSurfaceScopes(scopes) {
+	if (!scopes || scopes.length === 0) return ["instance"];
+	return [...new Set(scopes)];
+}
+
+//#endregion
+export { normalizeAutoSurfaceScopes };
+//# sourceMappingURL=types.mjs.map

package/dist/auto-surface/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/auto-surface/types.ts"],"sourcesContent":["export type AutoSurfaceDefinitionOwner = \"system\" | \"package\";\nexport type AutoSurfaceLayer = \"system\" | \"package\" | \"instance\" | \"user\";\nexport type AutoSurfaceProjectorName = \"settings-shell\";\nexport type AutoSurfaceValueSource = AutoSurfaceLayer | \"default\" | \"unset\";\nexport type AutoSurfaceValueType = \"string\" | \"number\" | \"boolean\" | \"select\" | \"textarea\" | \"json\";\n\nexport interface AutoSurfaceOption {\n  value: string | number | boolean;\n  label: string;\n}\n\nexport interface AutoSurfaceValidationRule {\n  required?: boolean;\n  min?: number;\n  max?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n}\n\nexport interface AutoSurfacePolicy {\n  readonly?: boolean;\n  secret?: boolean;\n  allowInstanceOverride?: boolean;\n  allowUserOverride?: boolean;\n}\n\nexport interface AutoSurfaceBindingMap {\n  system?: string;\n  package?: string;\n  instance?: string;\n  user?: string;\n}\n\nexport interface AutoSurfaceSettingsShellPresentation {\n  group?: string;\n  page?: string;\n  section?: string;\n  title?: string;\n  description?: string;\n  order?: number;\n  groupOrder?: number;\n  pageOrder?: number;\n  sectionOrder?: number;\n}\n\nexport type AutoSurfacePresentation =\n  | AutoSurfaceSettingsShellPresentation\n  | Record<string, unknown>;\n\nexport type AutoSurfacePresentations = Record<string, AutoSurfacePresentation | undefined> & {\n  \"settings-shell\"?: AutoSurfaceSettingsShellPresentation;\n};\n\nexport interface AutoSurfaceResourceDefinition {\n  id: string;\n  type: AutoSurfaceValueType;\n  title?: string;\n  description?: string;\n  defaultValue?: unknown;\n  options?: AutoSurfaceOption[];\n  validation?: AutoSurfaceValidationRule;\n  scopes?: AutoSurfaceLayer[];\n  bindings?: AutoSurfaceBindingMap;\n  policy?: AutoSurfacePolicy;\n  presentations?: AutoSurfacePresentations;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface AutoSurfaceFragment {\n  source: string;\n  owner: AutoSurfaceDefinitionOwner;\n  resources: AutoSurfaceResourceDefinition[];\n}\n\nexport interface AutoSurfaceDiagnostic {\n  code: \"duplicate_resource\" | \"protected_resource\";\n  resourceId: string;\n  severity: \"error\" | \"warning\";\n  message: string;\n  source: string;\n}\n\nexport interface AutoSurfaceRegistryEntry {\n  definition: AutoSurfaceResourceDefinition;\n  owner: AutoSurfaceDefinitionOwner;\n  source: string;\n}\n\nexport interface AutoSurfaceRegistry {\n  resources: Record<string, AutoSurfaceRegistryEntry>;\n}\n\nexport interface AutoSurfaceCompileResult {\n  registry: AutoSurfaceRegistry;\n  diagnostics: AutoSurfaceDiagnostic[];\n}\n\nexport interface AutoSurfaceLoadedRegistry extends AutoSurfaceCompileResult {\n  fragments: AutoSurfaceFragment[];\n}\n\nexport interface AutoSurfaceValueLayers {\n  system?: Record<string, unknown>;\n  package?: Record<string, unknown>;\n  instance?: Record<string, unknown>;\n  user?: Record<string, unknown>;\n}\n\nexport interface AutoSurfaceResolvedResource {\n  id: string;\n  definition: AutoSurfaceResourceDefinition;\n  owner: AutoSurfaceDefinitionOwner;\n  value: unknown;\n  source: AutoSurfaceValueSource;\n  availableScopes: AutoSurfaceLayer[];\n  bindings: AutoSurfaceBindingMap;\n  sourceDefinition: string;\n}\n\nexport interface AutoSurfaceResolvedRegistry {\n  resources: Record<string, AutoSurfaceResolvedResource>;\n}\n\nexport interface AutoSurfaceResolvedScenario {\n  registry: AutoSurfaceRegistry;\n  diagnostics: AutoSurfaceDiagnostic[];\n  fragments: AutoSurfaceFragment[];\n  valueLayers: AutoSurfaceValueLayers;\n  resolved: AutoSurfaceResolvedRegistry;\n}\n\nexport interface AutoSurfaceProjectedField {\n  kind: \"field\";\n  id: string;\n  title: string;\n  description?: string;\n  type: AutoSurfaceValueType;\n  value: unknown;\n  source: AutoSurfaceValueSource;\n  options?: AutoSurfaceOption[];\n  validation?: AutoSurfaceValidationRule;\n  policy?: AutoSurfacePolicy;\n  bindings?: AutoSurfaceBindingMap;\n}\n\nexport interface AutoSurfaceProjectedSection {\n  kind: \"section\";\n  id: string;\n  title: string;\n  fields: AutoSurfaceProjectedField[];\n}\n\nexport interface AutoSurfaceProjectedPage {\n  kind: \"page\";\n  id: string;\n  title: string;\n  sections: AutoSurfaceProjectedSection[];\n}\n\nexport interface AutoSurfaceProjectedGroup {\n  kind: \"group\";\n  id: string;\n  title: string;\n  pages: AutoSurfaceProjectedPage[];\n}\n\nexport interface AutoSurfaceSettingsShellProjection {\n  projector: \"settings-shell\";\n  scope: AutoSurfaceLayer | \"all\";\n  groups: AutoSurfaceProjectedGroup[];\n}\n\nexport type AutoSurfaceProjection = AutoSurfaceSettingsShellProjection;\n\nexport function normalizeAutoSurfaceScopes(\n  scopes: AutoSurfaceLayer[] | undefined,\n): AutoSurfaceLayer[] {\n  if (!scopes || scopes.length === 0) return [\"instance\"];\n  return [...new Set(scopes)];\n}\n"],"mappings":";AA+KA,SAAgB,2BACd,QACoB;AACpB,KAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO,CAAC,WAAW;AACvD,QAAO,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC"}