@aigne/aos 0.2.0-beta

package/dist/auto-surface/fragments.mjs

@@ -0,0 +1,175 @@
+import { joinURL } from "ufo";
+
+//#region src/auto-surface/fragments.ts
+const DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT = "/.surface/definitions";
+const DEFAULT_AUTO_SURFACE_VALUES_ROOT = "/.surface/overrides";
+async function loadAutoSurfaceFragment(reader, options) {
+	const root = options.root ?? DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT;
+	const resources = [];
+	if (!await hasDirectory(reader, root)) return {
+		source: options.source,
+		owner: options.owner,
+		resources
+	};
+	await walkDefinitionDirectory(reader, root, [], {}, resources);
+	return {
+		source: options.source,
+		owner: options.owner,
+		resources
+	};
+}
+async function loadAutoSurfaceValueLayer(reader, options = {}) {
+	const root = options.root ?? DEFAULT_AUTO_SURFACE_VALUES_ROOT;
+	const values = {};
+	if (!await hasDirectory(reader, root)) return values;
+	await walkValueDirectory(reader, root, [], values);
+	return values;
+}
+async function walkDefinitionDirectory(reader, currentPath, relativeSegments, inheritedContext, resources) {
+	const entries = await listVisible(reader, currentPath);
+	const dirs = entries.filter(isDirectoryEntry);
+	const files = entries.filter((entry) => !isDirectoryEntry(entry));
+	const context = deriveDefinitionContext(relativeSegments, inheritedContext, await readDirectoryMeta(reader, files, currentPath));
+	for (const file of files) {
+		if (!file.id.endsWith(".field.json")) continue;
+		const field = await readJSON(reader, entryPath(currentPath, file));
+		const resourceId = typeof field.id === "string" && field.id.trim().length > 0 ? field.id : buildResourceId(relativeSegments, stripSuffix(file.id, ".field.json"));
+		resources.push({
+			...field,
+			id: resourceId,
+			presentations: mergePresentations(field.presentations, inferSettingsShellPresentation(relativeSegments, context))
+		});
+	}
+	for (const dir of dirs) await walkDefinitionDirectory(reader, entryPath(currentPath, dir), [...relativeSegments, dir.id], context, resources);
+}
+async function walkValueDirectory(reader, currentPath, relativeSegments, values) {
+	const entries = await listVisible(reader, currentPath);
+	const dirs = entries.filter(isDirectoryEntry);
+	const files = entries.filter((entry) => !isDirectoryEntry(entry));
+	for (const file of files) {
+		if (!file.id.endsWith(".value.json")) continue;
+		const parsed = await readJSON(reader, entryPath(currentPath, file), { allowScalar: true });
+		const valueId = resolveValueId(parsed, relativeSegments, file.id);
+		values[valueId] = resolveValue(parsed);
+	}
+	for (const dir of dirs) await walkValueDirectory(reader, entryPath(currentPath, dir), [...relativeSegments, dir.id], values);
+}
+async function readDirectoryMeta(reader, files, currentPath) {
+	const result = {};
+	for (const file of files) {
+		if (![
+			"group.json",
+			"page.json",
+			"section.json"
+		].includes(file.id)) continue;
+		const path = entryPath(currentPath, file);
+		result[file.id] = await readJSON(reader, path);
+	}
+	return result;
+}
+function deriveDefinitionContext(relativeSegments, inheritedContext, localMeta) {
+	const context = { ...inheritedContext };
+	if (relativeSegments.length >= 1) {
+		const groupId = relativeSegments[0];
+		context.group = {
+			title: localMeta["group.json"]?.title ?? inheritedContext.group?.title ?? labelize(groupId),
+			description: localMeta["group.json"]?.description ?? inheritedContext.group?.description,
+			order: localMeta["group.json"]?.order ?? inheritedContext.group?.order
+		};
+	}
+	if (relativeSegments.length >= 2) {
+		const pageId = relativeSegments[1];
+		context.page = {
+			title: localMeta["page.json"]?.title ?? inheritedContext.page?.title ?? labelize(pageId),
+			description: localMeta["page.json"]?.description ?? inheritedContext.page?.description,
+			order: localMeta["page.json"]?.order ?? inheritedContext.page?.order
+		};
+	}
+	if (relativeSegments.length >= 3) {
+		const sectionId = relativeSegments.slice(2).join("/");
+		context.section = {
+			title: localMeta["section.json"]?.title ?? inheritedContext.section?.title ?? labelize(relativeSegments[relativeSegments.length - 1]),
+			description: localMeta["section.json"]?.description ?? inheritedContext.section?.description,
+			order: localMeta["section.json"]?.order ?? inheritedContext.section?.order
+		};
+		if (!context.section.title) context.section.title = labelize(sectionId);
+	}
+	return context;
+}
+function inferSettingsShellPresentation(relativeSegments, context) {
+	return {
+		group: context.group?.title ?? labelize(relativeSegments[0] ?? "general"),
+		page: context.page?.title ?? "General",
+		section: context.section?.title ?? "General",
+		...context.group?.order !== void 0 ? { groupOrder: context.group.order } : {},
+		...context.page?.order !== void 0 ? { pageOrder: context.page.order } : {},
+		...context.section?.order !== void 0 ? { sectionOrder: context.section.order } : {}
+	};
+}
+function mergePresentations(existing, inferred) {
+	return {
+		...existing ?? {},
+		"settings-shell": {
+			...inferred,
+			...existing?.["settings-shell"] ?? {}
+		}
+	};
+}
+function buildResourceId(relativeSegments, basename) {
+	return [...relativeSegments, basename].filter(Boolean).join(".");
+}
+function resolveValueId(parsed, relativeSegments, fileName) {
+	if (isPlainObject(parsed) && typeof parsed.id === "string" && parsed.id.trim().length > 0) return parsed.id;
+	return buildResourceId(relativeSegments, stripSuffix(fileName, ".value.json"));
+}
+function resolveValue(parsed) {
+	if (isPlainObject(parsed) && Object.hasOwn(parsed, "value")) return parsed.value;
+	return parsed;
+}
+async function hasDirectory(reader, path) {
+	try {
+		const entries = await reader.list(path);
+		return Array.isArray(entries.data);
+	} catch {
+		return false;
+	}
+}
+async function listVisible(reader, path) {
+	return ((await reader.list(path)).data ?? []).filter((entry) => entry?.id && !entry.id.startsWith("."));
+}
+async function readJSON(reader, path, options = {}) {
+	const content = extractContent(await reader.read(path));
+	if (typeof content === "string") try {
+		return JSON.parse(content);
+	} catch (error) {
+		throw new Error(`Invalid JSON in "${path}": ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (content && typeof content === "object") return content;
+	if (options.allowScalar) return content;
+	throw new Error(`Expected JSON object in "${path}"`);
+}
+function extractContent(result) {
+	const data = result.data;
+	if (data && typeof data === "object" && "content" in data) return data.content;
+	return data;
+}
+function isDirectoryEntry(entry) {
+	const meta = entry.meta ?? {};
+	return meta.kind === "fs:directory" || meta.kind === "directory" || Array.isArray(meta.kinds) && meta.kinds.includes("fs:directory") || typeof meta.childrenCount === "number";
+}
+function entryPath(parentPath, entry) {
+	return entry.path || joinURL(parentPath, entry.id);
+}
+function stripSuffix(value, suffix) {
+	return value.endsWith(suffix) ? value.slice(0, -suffix.length) : value;
+}
+function labelize(value) {
+	return value.replace(/[_-]+/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function isPlainObject(value) {
+	return Object.prototype.toString.call(value) === "[object Object]";
+}
+
+//#endregion
+export { DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer };
+//# sourceMappingURL=fragments.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.mjs","names":[],"sources":["../../src/auto-surface/fragments.ts"],"sourcesContent":["import type { AFSEntry, AFSListResult, AFSReadResult } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\nimport type {\n  AutoSurfaceDefinitionOwner,\n  AutoSurfaceFragment,\n  AutoSurfacePresentations,\n  AutoSurfaceResourceDefinition,\n  AutoSurfaceSettingsShellPresentation,\n} from \"./types.js\";\n\nexport const DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT = \"/.surface/definitions\";\nexport const DEFAULT_AUTO_SURFACE_VALUES_ROOT = \"/.surface/overrides\";\n\nexport interface AutoSurfaceFragmentReader {\n  list(path: string): Promise<AFSListResult>;\n  read(path: string): Promise<AFSReadResult>;\n}\n\nexport interface LoadAutoSurfaceFragmentOptions {\n  source: string;\n  owner: AutoSurfaceDefinitionOwner;\n  root?: string;\n}\n\nexport interface LoadAutoSurfaceValueLayerOptions {\n  root?: string;\n}\n\ninterface AutoSurfaceDirectoryMeta {\n  title?: string;\n  description?: string;\n  order?: number;\n}\n\ninterface AutoSurfaceFieldFile extends Omit<AutoSurfaceResourceDefinition, \"id\"> {\n  id?: string;\n}\n\ninterface DefinitionContext {\n  group?: AutoSurfaceDirectoryMeta;\n  page?: AutoSurfaceDirectoryMeta;\n  section?: AutoSurfaceDirectoryMeta;\n}\n\nexport async function loadAutoSurfaceFragment(\n  reader: AutoSurfaceFragmentReader,\n  options: LoadAutoSurfaceFragmentOptions,\n): Promise<AutoSurfaceFragment> {\n  const root = options.root ?? DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT;\n  const resources: AutoSurfaceResourceDefinition[] = [];\n\n  if (!(await hasDirectory(reader, root))) {\n    return { source: options.source, owner: options.owner, resources };\n  }\n\n  await walkDefinitionDirectory(reader, root, [], {}, resources);\n  return {\n    source: options.source,\n    owner: options.owner,\n    resources,\n  };\n}\n\nexport async function loadAutoSurfaceValueLayer(\n  reader: AutoSurfaceFragmentReader,\n  options: LoadAutoSurfaceValueLayerOptions = {},\n): Promise<Record<string, unknown>> {\n  const root = options.root ?? DEFAULT_AUTO_SURFACE_VALUES_ROOT;\n  const values: Record<string, unknown> = {};\n\n  if (!(await hasDirectory(reader, root))) return values;\n\n  await walkValueDirectory(reader, root, [], values);\n  return values;\n}\n\nasync function walkDefinitionDirectory(\n  reader: AutoSurfaceFragmentReader,\n  currentPath: string,\n  relativeSegments: string[],\n  inheritedContext: DefinitionContext,\n  resources: AutoSurfaceResourceDefinition[],\n): Promise<void> {\n  const entries = await listVisible(reader, currentPath);\n  const dirs = entries.filter(isDirectoryEntry);\n  const files = entries.filter((entry) => !isDirectoryEntry(entry));\n  const localMeta = await readDirectoryMeta(reader, files, currentPath);\n  const context = deriveDefinitionContext(relativeSegments, inheritedContext, localMeta);\n\n  for (const file of files) {\n    if (!file.id.endsWith(\".field.json\")) continue;\n    const path = entryPath(currentPath, file);\n    const parsed = await readJSON(reader, path);\n    const field = parsed as AutoSurfaceFieldFile;\n    const resourceId =\n      typeof field.id === \"string\" && field.id.trim().length > 0\n        ? field.id\n        : buildResourceId(relativeSegments, stripSuffix(file.id, \".field.json\"));\n    resources.push({\n      ...field,\n      id: resourceId,\n      presentations: mergePresentations(\n        field.presentations,\n        inferSettingsShellPresentation(relativeSegments, context),\n      ),\n    });\n  }\n\n  for (const dir of dirs) {\n    await walkDefinitionDirectory(\n      reader,\n      entryPath(currentPath, dir),\n      [...relativeSegments, dir.id],\n      context,\n      resources,\n    );\n  }\n}\n\nasync function walkValueDirectory(\n  reader: AutoSurfaceFragmentReader,\n  currentPath: string,\n  relativeSegments: string[],\n  values: Record<string, unknown>,\n): Promise<void> {\n  const entries = await listVisible(reader, currentPath);\n  const dirs = entries.filter(isDirectoryEntry);\n  const files = entries.filter((entry) => !isDirectoryEntry(entry));\n\n  for (const file of files) {\n    if (!file.id.endsWith(\".value.json\")) continue;\n    const path = entryPath(currentPath, file);\n    const parsed = await readJSON(reader, path, { allowScalar: true });\n    const valueId = resolveValueId(parsed, relativeSegments, file.id);\n    values[valueId] = resolveValue(parsed);\n  }\n\n  for (const dir of dirs) {\n    await walkValueDirectory(\n      reader,\n      entryPath(currentPath, dir),\n      [...relativeSegments, dir.id],\n      values,\n    );\n  }\n}\n\nasync function readDirectoryMeta(\n  reader: AutoSurfaceFragmentReader,\n  files: AFSEntry[],\n  currentPath: string,\n): Promise<Record<string, AutoSurfaceDirectoryMeta>> {\n  const result: Record<string, AutoSurfaceDirectoryMeta> = {};\n\n  for (const file of files) {\n    if (![\"group.json\", \"page.json\", \"section.json\"].includes(file.id)) continue;\n    const path = entryPath(currentPath, file);\n    result[file.id] = (await readJSON(reader, path)) as AutoSurfaceDirectoryMeta;\n  }\n\n  return result;\n}\n\nfunction deriveDefinitionContext(\n  relativeSegments: string[],\n  inheritedContext: DefinitionContext,\n  localMeta: Record<string, AutoSurfaceDirectoryMeta>,\n): DefinitionContext {\n  const context: DefinitionContext = { ...inheritedContext };\n\n  if (relativeSegments.length >= 1) {\n    const groupId = relativeSegments[0]!;\n    context.group = {\n      title: localMeta[\"group.json\"]?.title ?? inheritedContext.group?.title ?? labelize(groupId),\n      description: localMeta[\"group.json\"]?.description ?? inheritedContext.group?.description,\n      order: localMeta[\"group.json\"]?.order ?? inheritedContext.group?.order,\n    };\n  }\n\n  if (relativeSegments.length >= 2) {\n    const pageId = relativeSegments[1]!;\n    context.page = {\n      title: localMeta[\"page.json\"]?.title ?? inheritedContext.page?.title ?? labelize(pageId),\n      description: localMeta[\"page.json\"]?.description ?? inheritedContext.page?.description,\n      order: localMeta[\"page.json\"]?.order ?? inheritedContext.page?.order,\n    };\n  }\n\n  if (relativeSegments.length >= 3) {\n    const sectionId = relativeSegments.slice(2).join(\"/\");\n    context.section = {\n      title:\n        localMeta[\"section.json\"]?.title ??\n        inheritedContext.section?.title ??\n        labelize(relativeSegments[relativeSegments.length - 1]!),\n      description: localMeta[\"section.json\"]?.description ?? inheritedContext.section?.description,\n      order: localMeta[\"section.json\"]?.order ?? inheritedContext.section?.order,\n    };\n    if (!context.section.title) context.section.title = labelize(sectionId);\n  }\n\n  return context;\n}\n\nfunction inferSettingsShellPresentation(\n  relativeSegments: string[],\n  context: DefinitionContext,\n): AutoSurfaceSettingsShellPresentation {\n  return {\n    group: context.group?.title ?? labelize(relativeSegments[0] ?? \"general\"),\n    page: context.page?.title ?? \"General\",\n    section: context.section?.title ?? \"General\",\n    ...(context.group?.order !== undefined ? { groupOrder: context.group.order } : {}),\n    ...(context.page?.order !== undefined ? { pageOrder: context.page.order } : {}),\n    ...(context.section?.order !== undefined ? { sectionOrder: context.section.order } : {}),\n  };\n}\n\nfunction mergePresentations(\n  existing: AutoSurfacePresentations | undefined,\n  inferred: AutoSurfaceSettingsShellPresentation,\n): AutoSurfacePresentations {\n  return {\n    ...(existing ?? {}),\n    \"settings-shell\": {\n      ...inferred,\n      ...(existing?.[\"settings-shell\"] ?? {}),\n    },\n  };\n}\n\nfunction buildResourceId(relativeSegments: string[], basename: string): string {\n  return [...relativeSegments, basename].filter(Boolean).join(\".\");\n}\n\nfunction resolveValueId(parsed: unknown, relativeSegments: string[], fileName: string): string {\n  if (isPlainObject(parsed) && typeof parsed.id === \"string\" && parsed.id.trim().length > 0) {\n    return parsed.id;\n  }\n  return buildResourceId(relativeSegments, stripSuffix(fileName, \".value.json\"));\n}\n\nfunction resolveValue(parsed: unknown): unknown {\n  if (isPlainObject(parsed) && Object.hasOwn(parsed, \"value\")) {\n    return parsed.value;\n  }\n  return parsed;\n}\n\nasync function hasDirectory(reader: AutoSurfaceFragmentReader, path: string): Promise<boolean> {\n  try {\n    const entries = await reader.list(path);\n    return Array.isArray(entries.data);\n  } catch {\n    return false;\n  }\n}\n\nasync function listVisible(reader: AutoSurfaceFragmentReader, path: string): Promise<AFSEntry[]> {\n  const result = await reader.list(path);\n  return (result.data ?? []).filter((entry) => entry?.id && !entry.id.startsWith(\".\"));\n}\n\nasync function readJSON(\n  reader: AutoSurfaceFragmentReader,\n  path: string,\n  options: { allowScalar?: boolean } = {},\n): Promise<unknown> {\n  const result = await reader.read(path);\n  const content = extractContent(result);\n  if (typeof content === \"string\") {\n    try {\n      return JSON.parse(content);\n    } catch (error) {\n      throw new Error(\n        `Invalid JSON in \"${path}\": ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n  if (content && typeof content === \"object\") return content;\n  if (options.allowScalar) return content;\n  throw new Error(`Expected JSON object in \"${path}\"`);\n}\n\nfunction extractContent(result: AFSReadResult): unknown {\n  const data = result.data;\n  if (data && typeof data === \"object\" && \"content\" in data) {\n    return (data as { content?: unknown }).content;\n  }\n  return data;\n}\n\nfunction isDirectoryEntry(entry: AFSEntry): boolean {\n  const meta = entry.meta ?? {};\n  return (\n    meta.kind === \"fs:directory\" ||\n    meta.kind === \"directory\" ||\n    (Array.isArray(meta.kinds) && meta.kinds.includes(\"fs:directory\")) ||\n    typeof meta.childrenCount === \"number\"\n  );\n}\n\nfunction entryPath(parentPath: string, entry: AFSEntry): string {\n  return entry.path || joinURL(parentPath, entry.id);\n}\n\nfunction stripSuffix(value: string, suffix: string): string {\n  return value.endsWith(suffix) ? value.slice(0, -suffix.length) : value;\n}\n\nfunction labelize(value: string): string {\n  return value\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/\\b\\w/g, (char) => char.toUpperCase());\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return Object.prototype.toString.call(value) === \"[object Object]\";\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+import { 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 } from "./types.mjs";
+import { compileAutoSurfaceRegistry } from "./compiler.mjs";
+import { AutoSurfaceDefinitionDslCompileError, AutoSurfaceDefinitionDslCompileResult, AutoSurfaceDefinitionDslField, AutoSurfaceDefinitionDslGroup, AutoSurfaceDefinitionDslPage, AutoSurfaceDefinitionDslSection, compileAutoSurfaceDefinitionDsl, formatAutoSurfaceDefinitionDsl } from "./definition-dsl.mjs";
+import { AutoSurfaceFragmentReader, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer } from "./fragments.mjs";
+import { resolveAutoSurfaceValues } from "./layering.mjs";
+import { ProjectAutoSurfaceOptions, projectAutoSurface } from "./projection.mjs";
+import { ProjectSettingsShellOptions, projectSettingsShell } from "./projectors/settings-shell.mjs";
+import { AutoSurfaceDefinitionSource, AutoSurfaceValueLayerSource, LoadAutoSurfaceRegistryOptions, LoadAutoSurfaceValueLayersOptions, ResolveAutoSurfaceScenarioOptions, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario } from "./scenario.mjs";
+import { AutoSurfaceValueDslCompileError, AutoSurfaceValueDslCompileResult, AutoSurfaceValueDslEntry, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl } from "./value-dsl.mjs";

package/dist/auto-surface/layering.cjs

@@ -0,0 +1,43 @@
+
+//#region src/auto-surface/layering.ts
+const LAYER_ORDER = [
+	"system",
+	"package",
+	"instance",
+	"user"
+];
+function resolveAutoSurfaceValues(registry, layers) {
+	const resources = {};
+	for (const [resourceId, entry] of Object.entries(registry.resources)) {
+		const scopes = entry.definition.scopes ?? ["instance"];
+		let value = entry.definition.defaultValue;
+		let source = entry.definition.defaultValue === void 0 ? "unset" : "default";
+		for (const layer of LAYER_ORDER) {
+			if (!scopes.includes(layer)) continue;
+			if (!canApplyLayer(layer, entry.definition.policy)) continue;
+			const candidate = layers[layer]?.[resourceId];
+			if (candidate === void 0) continue;
+			value = candidate;
+			source = layer;
+		}
+		resources[resourceId] = {
+			id: resourceId,
+			definition: entry.definition,
+			owner: entry.owner,
+			value,
+			source,
+			availableScopes: scopes,
+			bindings: entry.definition.bindings ?? {},
+			sourceDefinition: entry.source
+		};
+	}
+	return { resources };
+}
+function canApplyLayer(layer, policy) {
+	if (layer === "instance" && policy?.allowInstanceOverride === false) return false;
+	if (layer === "user" && policy?.allowUserOverride === false) return false;
+	return true;
+}
+
+//#endregion
+exports.resolveAutoSurfaceValues = resolveAutoSurfaceValues;

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

@@ -0,0 +1,7 @@
+import { AutoSurfaceRegistry, AutoSurfaceResolvedRegistry, AutoSurfaceValueLayers } from "./types.cjs";
+
+//#region src/auto-surface/layering.d.ts
+declare function resolveAutoSurfaceValues(registry: AutoSurfaceRegistry, layers: AutoSurfaceValueLayers): AutoSurfaceResolvedRegistry;
+//#endregion
+export { resolveAutoSurfaceValues };
+//# sourceMappingURL=layering.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layering.d.cts","names":[],"sources":["../../src/auto-surface/layering.ts"],"mappings":";;;iBAWgB,wBAAA,CACd,QAAA,EAAU,mBAAA,EACV,MAAA,EAAQ,sBAAA,GACP,2BAAA"}

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

@@ -0,0 +1,7 @@
+import { AutoSurfaceRegistry, AutoSurfaceResolvedRegistry, AutoSurfaceValueLayers } from "./types.mjs";
+
+//#region src/auto-surface/layering.d.ts
+declare function resolveAutoSurfaceValues(registry: AutoSurfaceRegistry, layers: AutoSurfaceValueLayers): AutoSurfaceResolvedRegistry;
+//#endregion
+export { resolveAutoSurfaceValues };
+//# sourceMappingURL=layering.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layering.d.mts","names":[],"sources":["../../src/auto-surface/layering.ts"],"mappings":";;;iBAWgB,wBAAA,CACd,QAAA,EAAU,mBAAA,EACV,MAAA,EAAQ,sBAAA,GACP,2BAAA"}

package/dist/auto-surface/layering.mjs

@@ -0,0 +1,43 @@
+//#region src/auto-surface/layering.ts
+const LAYER_ORDER = [
+	"system",
+	"package",
+	"instance",
+	"user"
+];
+function resolveAutoSurfaceValues(registry, layers) {
+	const resources = {};
+	for (const [resourceId, entry] of Object.entries(registry.resources)) {
+		const scopes = entry.definition.scopes ?? ["instance"];
+		let value = entry.definition.defaultValue;
+		let source = entry.definition.defaultValue === void 0 ? "unset" : "default";
+		for (const layer of LAYER_ORDER) {
+			if (!scopes.includes(layer)) continue;
+			if (!canApplyLayer(layer, entry.definition.policy)) continue;
+			const candidate = layers[layer]?.[resourceId];
+			if (candidate === void 0) continue;
+			value = candidate;
+			source = layer;
+		}
+		resources[resourceId] = {
+			id: resourceId,
+			definition: entry.definition,
+			owner: entry.owner,
+			value,
+			source,
+			availableScopes: scopes,
+			bindings: entry.definition.bindings ?? {},
+			sourceDefinition: entry.source
+		};
+	}
+	return { resources };
+}
+function canApplyLayer(layer, policy) {
+	if (layer === "instance" && policy?.allowInstanceOverride === false) return false;
+	if (layer === "user" && policy?.allowUserOverride === false) return false;
+	return true;
+}
+
+//#endregion
+export { resolveAutoSurfaceValues };
+//# sourceMappingURL=layering.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layering.mjs","names":[],"sources":["../../src/auto-surface/layering.ts"],"sourcesContent":["import type {\n  AutoSurfaceLayer,\n  AutoSurfaceRegistry,\n  AutoSurfaceResolvedRegistry,\n  AutoSurfaceResolvedResource,\n  AutoSurfaceValueLayers,\n  AutoSurfaceValueSource,\n} from \"./types.js\";\n\nconst LAYER_ORDER: AutoSurfaceLayer[] = [\"system\", \"package\", \"instance\", \"user\"];\n\nexport function resolveAutoSurfaceValues(\n  registry: AutoSurfaceRegistry,\n  layers: AutoSurfaceValueLayers,\n): AutoSurfaceResolvedRegistry {\n  const resources: Record<string, AutoSurfaceResolvedResource> = {};\n\n  for (const [resourceId, entry] of Object.entries(registry.resources)) {\n    const scopes = entry.definition.scopes ?? [\"instance\"];\n    let value = entry.definition.defaultValue;\n    let source: AutoSurfaceValueSource =\n      entry.definition.defaultValue === undefined ? \"unset\" : \"default\";\n\n    for (const layer of LAYER_ORDER) {\n      if (!scopes.includes(layer)) continue;\n      if (!canApplyLayer(layer, entry.definition.policy)) continue;\n      const candidate = layers[layer]?.[resourceId];\n      if (candidate === undefined) continue;\n      value = candidate;\n      source = layer;\n    }\n\n    resources[resourceId] = {\n      id: resourceId,\n      definition: entry.definition,\n      owner: entry.owner,\n      value,\n      source,\n      availableScopes: scopes,\n      bindings: entry.definition.bindings ?? {},\n      sourceDefinition: entry.source,\n    };\n  }\n\n  return { resources };\n}\n\nfunction canApplyLayer(\n  layer: AutoSurfaceLayer,\n  policy: AutoSurfaceResolvedResource[\"definition\"][\"policy\"] | undefined,\n): boolean {\n  if (layer === \"instance\" && policy?.allowInstanceOverride === false) return false;\n  if (layer === \"user\" && policy?.allowUserOverride === false) return false;\n  return true;\n}\n"],"mappings":";AASA,MAAM,cAAkC;CAAC;CAAU;CAAW;CAAY;CAAO;AAEjF,SAAgB,yBACd,UACA,QAC6B;CAC7B,MAAM,YAAyD,EAAE;AAEjE,MAAK,MAAM,CAAC,YAAY,UAAU,OAAO,QAAQ,SAAS,UAAU,EAAE;EACpE,MAAM,SAAS,MAAM,WAAW,UAAU,CAAC,WAAW;EACtD,IAAI,QAAQ,MAAM,WAAW;EAC7B,IAAI,SACF,MAAM,WAAW,iBAAiB,SAAY,UAAU;AAE1D,OAAK,MAAM,SAAS,aAAa;AAC/B,OAAI,CAAC,OAAO,SAAS,MAAM,CAAE;AAC7B,OAAI,CAAC,cAAc,OAAO,MAAM,WAAW,OAAO,CAAE;GACpD,MAAM,YAAY,OAAO,SAAS;AAClC,OAAI,cAAc,OAAW;AAC7B,WAAQ;AACR,YAAS;;AAGX,YAAU,cAAc;GACtB,IAAI;GACJ,YAAY,MAAM;GAClB,OAAO,MAAM;GACb;GACA;GACA,iBAAiB;GACjB,UAAU,MAAM,WAAW,YAAY,EAAE;GACzC,kBAAkB,MAAM;GACzB;;AAGH,QAAO,EAAE,WAAW;;AAGtB,SAAS,cACP,OACA,QACS;AACT,KAAI,UAAU,cAAc,QAAQ,0BAA0B,MAAO,QAAO;AAC5E,KAAI,UAAU,UAAU,QAAQ,sBAAsB,MAAO,QAAO;AACpE,QAAO"}

package/dist/auto-surface/projection.cjs

@@ -0,0 +1,11 @@
+const require_settings_shell = require('./projectors/settings-shell.cjs');
+
+//#region src/auto-surface/projection.ts
+function projectAutoSurface(resolved, options = {}) {
+	switch (options.projector ?? "settings-shell") {
+		case "settings-shell": return require_settings_shell.projectSettingsShell(resolved, { scope: options.scope });
+	}
+}
+
+//#endregion
+exports.projectAutoSurface = projectAutoSurface;

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

@@ -0,0 +1,11 @@
+import { AutoSurfaceLayer, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceResolvedRegistry } from "./types.cjs";
+
+//#region src/auto-surface/projection.d.ts
+interface ProjectAutoSurfaceOptions {
+  projector?: AutoSurfaceProjectorName;
+  scope?: AutoSurfaceLayer | "all";
+}
+declare function projectAutoSurface(resolved: AutoSurfaceResolvedRegistry, options?: ProjectAutoSurfaceOptions): AutoSurfaceProjection;
+//#endregion
+export { ProjectAutoSurfaceOptions, projectAutoSurface };
+//# sourceMappingURL=projection.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.cts","names":[],"sources":["../../src/auto-surface/projection.ts"],"mappings":";;;UAQiB,yBAAA;EACf,SAAA,GAAY,wBAAA;EACZ,KAAA,GAAQ,gBAAA;AAAA;AAAA,iBAGM,kBAAA,CACd,QAAA,EAAU,2BAAA,EACV,OAAA,GAAS,yBAAA,GACR,qBAAA"}

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

@@ -0,0 +1,11 @@
+import { AutoSurfaceLayer, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceResolvedRegistry } from "./types.mjs";
+
+//#region src/auto-surface/projection.d.ts
+interface ProjectAutoSurfaceOptions {
+  projector?: AutoSurfaceProjectorName;
+  scope?: AutoSurfaceLayer | "all";
+}
+declare function projectAutoSurface(resolved: AutoSurfaceResolvedRegistry, options?: ProjectAutoSurfaceOptions): AutoSurfaceProjection;
+//#endregion
+export { ProjectAutoSurfaceOptions, projectAutoSurface };
+//# sourceMappingURL=projection.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.mts","names":[],"sources":["../../src/auto-surface/projection.ts"],"mappings":";;;UAQiB,yBAAA;EACf,SAAA,GAAY,wBAAA;EACZ,KAAA,GAAQ,gBAAA;AAAA;AAAA,iBAGM,kBAAA,CACd,QAAA,EAAU,2BAAA,EACV,OAAA,GAAS,yBAAA,GACR,qBAAA"}

package/dist/auto-surface/projection.mjs

@@ -0,0 +1,12 @@
+import { projectSettingsShell } from "./projectors/settings-shell.mjs";
+
+//#region src/auto-surface/projection.ts
+function projectAutoSurface(resolved, options = {}) {
+	switch (options.projector ?? "settings-shell") {
+		case "settings-shell": return projectSettingsShell(resolved, { scope: options.scope });
+	}
+}
+
+//#endregion
+export { projectAutoSurface };
+//# sourceMappingURL=projection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.mjs","names":[],"sources":["../../src/auto-surface/projection.ts"],"sourcesContent":["import { projectSettingsShell } from \"./projectors/settings-shell.js\";\nimport type {\n  AutoSurfaceLayer,\n  AutoSurfaceProjection,\n  AutoSurfaceProjectorName,\n  AutoSurfaceResolvedRegistry,\n} from \"./types.js\";\n\nexport interface ProjectAutoSurfaceOptions {\n  projector?: AutoSurfaceProjectorName;\n  scope?: AutoSurfaceLayer | \"all\";\n}\n\nexport function projectAutoSurface(\n  resolved: AutoSurfaceResolvedRegistry,\n  options: ProjectAutoSurfaceOptions = {},\n): AutoSurfaceProjection {\n  const projector = options.projector ?? \"settings-shell\";\n\n  switch (projector) {\n    case \"settings-shell\":\n      return projectSettingsShell(resolved, { scope: options.scope });\n  }\n}\n"],"mappings":";;;AAaA,SAAgB,mBACd,UACA,UAAqC,EAAE,EAChB;AAGvB,SAFkB,QAAQ,aAAa,kBAEvC;EACE,KAAK,iBACH,QAAO,qBAAqB,UAAU,EAAE,OAAO,QAAQ,OAAO,CAAC"}

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

@@ -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
+exports.projectSettingsShell = projectSettingsShell;

package/dist/auto-surface/projectors/settings-shell.d.cts

@@ -0,0 +1,10 @@
+import { AutoSurfaceLayer, AutoSurfaceResolvedRegistry, AutoSurfaceSettingsShellProjection } from "../types.cjs";
+
+//#region src/auto-surface/projectors/settings-shell.d.ts
+interface ProjectSettingsShellOptions {
+  scope?: AutoSurfaceLayer | "all";
+}
+declare function projectSettingsShell(resolved: AutoSurfaceResolvedRegistry, options?: ProjectSettingsShellOptions): AutoSurfaceSettingsShellProjection;
+//#endregion
+export { ProjectSettingsShellOptions, projectSettingsShell };
+//# sourceMappingURL=settings-shell.d.cts.map

package/dist/auto-surface/projectors/settings-shell.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-shell.d.cts","names":[],"sources":["../../../src/auto-surface/projectors/settings-shell.ts"],"mappings":";;;UAYiB,2BAAA;EACf,KAAA,GAAQ,gBAAA;AAAA;AAAA,iBAoBM,oBAAA,CACd,QAAA,EAAU,2BAAA,EACV,OAAA,GAAS,2BAAA,GACR,kCAAA"}

package/dist/auto-surface/projectors/settings-shell.d.mts

@@ -0,0 +1,10 @@
+import { AutoSurfaceLayer, AutoSurfaceResolvedRegistry, AutoSurfaceSettingsShellProjection } from "../types.mjs";
+
+//#region src/auto-surface/projectors/settings-shell.d.ts
+interface ProjectSettingsShellOptions {
+  scope?: AutoSurfaceLayer | "all";
+}
+declare function projectSettingsShell(resolved: AutoSurfaceResolvedRegistry, options?: ProjectSettingsShellOptions): AutoSurfaceSettingsShellProjection;
+//#endregion
+export { ProjectSettingsShellOptions, projectSettingsShell };
+//# sourceMappingURL=settings-shell.d.mts.map

package/dist/auto-surface/projectors/settings-shell.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-shell.d.mts","names":[],"sources":["../../../src/auto-surface/projectors/settings-shell.ts"],"mappings":";;;UAYiB,2BAAA;EACf,KAAA,GAAQ,gBAAA;AAAA;AAAA,iBAoBM,oBAAA,CACd,QAAA,EAAU,2BAAA,EACV,OAAA,GAAS,2BAAA,GACR,kCAAA"}