@aigne/aos 0.2.0-beta

package/dist/scaffold/surface-dsl.cjs

@@ -0,0 +1,182 @@
+const require_dsl_shared = require('../dsl-shared.cjs');
+const require_dsl_error = require('./dsl-error.cjs');
+
+//#region src/scaffold/surface-dsl.ts
+const STRING = "\"((?:[^\"\\\\]|\\\\.)*)\"";
+function compileSurfaceDsl(source) {
+	const declaration = require_dsl_shared.parseDeclaration(source, {
+		kind: "surface",
+		allowQuotedTitle: true,
+		expected: "Expected surface id \"Title\" {",
+		fieldKeywords: [
+			"title",
+			"kind",
+			"module",
+			"projector",
+			"definition-root",
+			"value-root",
+			"scope",
+			"order",
+			"metadata"
+		],
+		nestedFieldKeywords: ["metadata"],
+		wildcardNestedFieldKeywords: ["metadata"],
+		error: parseSharedError
+	});
+	if (!declaration.title) throw parseError(declaration.idToken.line, "Expected surface id \"Title\" {", declaration.idToken.column);
+	const surface = {
+		id: declaration.id,
+		title: declaration.title,
+		kind: "auto-surface"
+	};
+	for (const field of declaration.fields) {
+		if (field.name.value === "title") {
+			surface.title = parseStringField(field, "Expected title \"<text>\"");
+			continue;
+		}
+		if (field.name.value === "kind") {
+			surface.kind = parseIdentifierField(field, "kind");
+			continue;
+		}
+		if (field.name.value === "module") {
+			surface.module = parseIdentifierField(field, "module");
+			continue;
+		}
+		if (field.name.value === "projector") {
+			surface.projector = parseIdentifierField(field, "projector");
+			continue;
+		}
+		if (field.name.value === "definition-root") {
+			surface.definitionRoot = parseStringField(field, "Expected definition-root \"<path>\"");
+			continue;
+		}
+		if (field.name.value === "value-root") {
+			const layer = field.values[0];
+			const root = field.values[1];
+			if (field.values.length !== 2 || layer?.type !== "word" || ![
+				"system",
+				"package",
+				"instance",
+				"user"
+			].includes(layer.value) || root?.type !== "string") throw parseError(field.name.line, "Expected value-root system|package|instance|user \"<path>\"", field.name.column);
+			surface.valueRoots ??= {};
+			surface.valueRoots[layer.value] = require_dsl_shared.parseDslStringToken(root, parseSharedError);
+			continue;
+		}
+		if (field.name.value === "scope") {
+			surface.scope = parseIdentifierField(field, "scope");
+			continue;
+		}
+		if (field.name.value === "order") {
+			surface.order = parseNumberField(field, "order");
+			continue;
+		}
+		if (field.name.value === "metadata") applyMetadataField(surface, field);
+	}
+	return surface;
+}
+function formatSurfaceDsl(source) {
+	const surface = compileSurfaceDsl(source);
+	const lines = [`surface ${surface.id} ${quote(surface.title ?? surface.id)} {`];
+	lines.push(`  kind ${surface.kind}`);
+	if (surface.module) lines.push(`  module ${surface.module}`);
+	if (surface.projector) lines.push(`  projector ${surface.projector}`);
+	if (surface.definitionRoot) lines.push(`  definition-root ${quote(surface.definitionRoot)}`);
+	for (const layer of [
+		"system",
+		"package",
+		"instance",
+		"user"
+	]) {
+		const root = surface.valueRoots?.[layer];
+		if (root) lines.push(`  value-root ${layer} ${quote(root)}`);
+	}
+	if (surface.scope) lines.push(`  scope ${surface.scope}`);
+	if (surface.order !== void 0) lines.push(`  order ${surface.order}`);
+	pushMetadataLines(lines, surface.metadata);
+	lines.push("}");
+	return `${lines.join("\n")}\n`;
+}
+function pushMetadataLines(lines, metadata) {
+	const entries = Object.entries(metadata ?? {});
+	if (entries.length === 0) return;
+	if (entries.length === 1) {
+		const [key, value] = entries[0];
+		lines.push(`  metadata ${key} ${formatMetadataValue(value)}`);
+		return;
+	}
+	lines.push("  metadata {");
+	for (const [key, value] of entries) lines.push(`    ${key} ${formatMetadataValue(value)}`);
+	lines.push("  }");
+}
+function applyMetadataField(surface, field) {
+	surface.metadata ??= {};
+	if (field.children) {
+		if (field.values.length > 0) throw parseError(field.name.line, "Expected metadata { ... }", field.name.column);
+		for (const child of field.children) surface.metadata[child.name.value] = parseMetadataValue(joinDslValues(child.values), child.name.line);
+		return;
+	}
+	const key = field.values[0];
+	if (key?.type !== "word" || field.values.length < 2) throw parseError(field.name.line, "Expected metadata <key> <value>", field.name.column);
+	surface.metadata[key.value] = parseMetadataValue(joinDslValues(field.values.slice(1)), field.name.line);
+}
+function parseMetadataValue(input, lineNumber) {
+	const string = input.match(/* @__PURE__ */ new RegExp(`^${STRING}$`));
+	if (string) return unescapeString(string[1] ?? "");
+	if (input === "true") return true;
+	if (input === "false") return false;
+	if (/^-?\d+(?:\.\d+)?$/.test(input)) return Number(input);
+	if (input.startsWith("[")) try {
+		return JSON.parse(input);
+	} catch (err) {
+		throw parseError(lineNumber, `Invalid metadata array: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	throw parseError(lineNumber, `Unsupported metadata value: ${input}`);
+}
+function parseSharedError(message, line, column = 1) {
+	return parseError(line, message, column);
+}
+function parseIdentifierField(field, name) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "word" || !/^[A-Za-z0-9_-]+$/.test(value.value)) throw parseError(value?.line ?? field.name.line, `Expected ${name} <identifier>`, value?.column ?? field.name.column);
+	return value.value;
+}
+function parseNumberField(field, name) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "word" || !/^\d+$/.test(value.value)) throw parseError(value?.line ?? field.name.line, `Expected ${name} <number>`, value?.column ?? field.name.column);
+	return Number(value.value);
+}
+function parseStringField(field, message) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "string") throw parseError(value?.line ?? field.name.line, message, value?.column ?? field.name.column);
+	return require_dsl_shared.parseDslStringToken(value, parseSharedError);
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function formatMetadataValue(value) {
+	if (typeof value === "string") return quote(value);
+	if (typeof value === "boolean" || typeof value === "number") return String(value);
+	return formatInlineJson(value);
+}
+function unescapeString(value) {
+	return value.replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+}
+function quote(value) {
+	return JSON.stringify(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatInlineJson(value) {
+	if (Array.isArray(value)) return `[${value.map(formatInlineJson).join(", ")}]`;
+	if (isRecord(value)) return `{${Object.entries(value).map(([key, entry]) => `${quote(key)}: ${formatInlineJson(entry)}`).join(", ")}}`;
+	return JSON.stringify(value);
+}
+function parseError(line, message, column = 1) {
+	return require_dsl_error.scaffoldDslParseError("surface", line, message, column);
+}
+
+//#endregion
+exports.compileSurfaceDsl = compileSurfaceDsl;
+exports.formatSurfaceDsl = formatSurfaceDsl;

package/dist/scaffold/surface-dsl.d.cts

@@ -0,0 +1,8 @@
+import { ScaffoldSurfaceDefinition } from "./types.cjs";
+
+//#region src/scaffold/surface-dsl.d.ts
+declare function compileSurfaceDsl(source: string): ScaffoldSurfaceDefinition;
+declare function formatSurfaceDsl(source: string): string;
+//#endregion
+export { compileSurfaceDsl, formatSurfaceDsl };
+//# sourceMappingURL=surface-dsl.d.cts.map

package/dist/scaffold/surface-dsl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-dsl.d.cts","names":[],"sources":["../../src/scaffold/surface-dsl.ts"],"mappings":";;;iBAYgB,iBAAA,CAAkB,MAAA,WAAiB,yBAAA;AAAA,iBAiGnC,gBAAA,CAAiB,MAAA"}

package/dist/scaffold/surface-dsl.d.mts

@@ -0,0 +1,8 @@
+import { ScaffoldSurfaceDefinition } from "./types.mjs";
+
+//#region src/scaffold/surface-dsl.d.ts
+declare function compileSurfaceDsl(source: string): ScaffoldSurfaceDefinition;
+declare function formatSurfaceDsl(source: string): string;
+//#endregion
+export { compileSurfaceDsl, formatSurfaceDsl };
+//# sourceMappingURL=surface-dsl.d.mts.map

package/dist/scaffold/surface-dsl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-dsl.d.mts","names":[],"sources":["../../src/scaffold/surface-dsl.ts"],"mappings":";;;iBAYgB,iBAAA,CAAkB,MAAA,WAAiB,yBAAA;AAAA,iBAiGnC,gBAAA,CAAiB,MAAA"}

package/dist/scaffold/surface-dsl.mjs

@@ -0,0 +1,182 @@
+import { parseDeclaration, parseDslStringToken } from "../dsl-shared.mjs";
+import { scaffoldDslParseError } from "./dsl-error.mjs";
+
+//#region src/scaffold/surface-dsl.ts
+const STRING = "\"((?:[^\"\\\\]|\\\\.)*)\"";
+function compileSurfaceDsl(source) {
+	const declaration = parseDeclaration(source, {
+		kind: "surface",
+		allowQuotedTitle: true,
+		expected: "Expected surface id \"Title\" {",
+		fieldKeywords: [
+			"title",
+			"kind",
+			"module",
+			"projector",
+			"definition-root",
+			"value-root",
+			"scope",
+			"order",
+			"metadata"
+		],
+		nestedFieldKeywords: ["metadata"],
+		wildcardNestedFieldKeywords: ["metadata"],
+		error: parseSharedError
+	});
+	if (!declaration.title) throw parseError(declaration.idToken.line, "Expected surface id \"Title\" {", declaration.idToken.column);
+	const surface = {
+		id: declaration.id,
+		title: declaration.title,
+		kind: "auto-surface"
+	};
+	for (const field of declaration.fields) {
+		if (field.name.value === "title") {
+			surface.title = parseStringField(field, "Expected title \"<text>\"");
+			continue;
+		}
+		if (field.name.value === "kind") {
+			surface.kind = parseIdentifierField(field, "kind");
+			continue;
+		}
+		if (field.name.value === "module") {
+			surface.module = parseIdentifierField(field, "module");
+			continue;
+		}
+		if (field.name.value === "projector") {
+			surface.projector = parseIdentifierField(field, "projector");
+			continue;
+		}
+		if (field.name.value === "definition-root") {
+			surface.definitionRoot = parseStringField(field, "Expected definition-root \"<path>\"");
+			continue;
+		}
+		if (field.name.value === "value-root") {
+			const layer = field.values[0];
+			const root = field.values[1];
+			if (field.values.length !== 2 || layer?.type !== "word" || ![
+				"system",
+				"package",
+				"instance",
+				"user"
+			].includes(layer.value) || root?.type !== "string") throw parseError(field.name.line, "Expected value-root system|package|instance|user \"<path>\"", field.name.column);
+			surface.valueRoots ??= {};
+			surface.valueRoots[layer.value] = parseDslStringToken(root, parseSharedError);
+			continue;
+		}
+		if (field.name.value === "scope") {
+			surface.scope = parseIdentifierField(field, "scope");
+			continue;
+		}
+		if (field.name.value === "order") {
+			surface.order = parseNumberField(field, "order");
+			continue;
+		}
+		if (field.name.value === "metadata") applyMetadataField(surface, field);
+	}
+	return surface;
+}
+function formatSurfaceDsl(source) {
+	const surface = compileSurfaceDsl(source);
+	const lines = [`surface ${surface.id} ${quote(surface.title ?? surface.id)} {`];
+	lines.push(`  kind ${surface.kind}`);
+	if (surface.module) lines.push(`  module ${surface.module}`);
+	if (surface.projector) lines.push(`  projector ${surface.projector}`);
+	if (surface.definitionRoot) lines.push(`  definition-root ${quote(surface.definitionRoot)}`);
+	for (const layer of [
+		"system",
+		"package",
+		"instance",
+		"user"
+	]) {
+		const root = surface.valueRoots?.[layer];
+		if (root) lines.push(`  value-root ${layer} ${quote(root)}`);
+	}
+	if (surface.scope) lines.push(`  scope ${surface.scope}`);
+	if (surface.order !== void 0) lines.push(`  order ${surface.order}`);
+	pushMetadataLines(lines, surface.metadata);
+	lines.push("}");
+	return `${lines.join("\n")}\n`;
+}
+function pushMetadataLines(lines, metadata) {
+	const entries = Object.entries(metadata ?? {});
+	if (entries.length === 0) return;
+	if (entries.length === 1) {
+		const [key, value] = entries[0];
+		lines.push(`  metadata ${key} ${formatMetadataValue(value)}`);
+		return;
+	}
+	lines.push("  metadata {");
+	for (const [key, value] of entries) lines.push(`    ${key} ${formatMetadataValue(value)}`);
+	lines.push("  }");
+}
+function applyMetadataField(surface, field) {
+	surface.metadata ??= {};
+	if (field.children) {
+		if (field.values.length > 0) throw parseError(field.name.line, "Expected metadata { ... }", field.name.column);
+		for (const child of field.children) surface.metadata[child.name.value] = parseMetadataValue(joinDslValues(child.values), child.name.line);
+		return;
+	}
+	const key = field.values[0];
+	if (key?.type !== "word" || field.values.length < 2) throw parseError(field.name.line, "Expected metadata <key> <value>", field.name.column);
+	surface.metadata[key.value] = parseMetadataValue(joinDslValues(field.values.slice(1)), field.name.line);
+}
+function parseMetadataValue(input, lineNumber) {
+	const string = input.match(/* @__PURE__ */ new RegExp(`^${STRING}$`));
+	if (string) return unescapeString(string[1] ?? "");
+	if (input === "true") return true;
+	if (input === "false") return false;
+	if (/^-?\d+(?:\.\d+)?$/.test(input)) return Number(input);
+	if (input.startsWith("[")) try {
+		return JSON.parse(input);
+	} catch (err) {
+		throw parseError(lineNumber, `Invalid metadata array: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	throw parseError(lineNumber, `Unsupported metadata value: ${input}`);
+}
+function parseSharedError(message, line, column = 1) {
+	return parseError(line, message, column);
+}
+function parseIdentifierField(field, name) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "word" || !/^[A-Za-z0-9_-]+$/.test(value.value)) throw parseError(value?.line ?? field.name.line, `Expected ${name} <identifier>`, value?.column ?? field.name.column);
+	return value.value;
+}
+function parseNumberField(field, name) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "word" || !/^\d+$/.test(value.value)) throw parseError(value?.line ?? field.name.line, `Expected ${name} <number>`, value?.column ?? field.name.column);
+	return Number(value.value);
+}
+function parseStringField(field, message) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "string") throw parseError(value?.line ?? field.name.line, message, value?.column ?? field.name.column);
+	return parseDslStringToken(value, parseSharedError);
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function formatMetadataValue(value) {
+	if (typeof value === "string") return quote(value);
+	if (typeof value === "boolean" || typeof value === "number") return String(value);
+	return formatInlineJson(value);
+}
+function unescapeString(value) {
+	return value.replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+}
+function quote(value) {
+	return JSON.stringify(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatInlineJson(value) {
+	if (Array.isArray(value)) return `[${value.map(formatInlineJson).join(", ")}]`;
+	if (isRecord(value)) return `{${Object.entries(value).map(([key, entry]) => `${quote(key)}: ${formatInlineJson(entry)}`).join(", ")}}`;
+	return JSON.stringify(value);
+}
+function parseError(line, message, column = 1) {
+	return scaffoldDslParseError("surface", line, message, column);
+}
+
+//#endregion
+export { compileSurfaceDsl, formatSurfaceDsl };
+//# sourceMappingURL=surface-dsl.mjs.map

package/dist/scaffold/surface-dsl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-dsl.mjs","names":[],"sources":["../../src/scaffold/surface-dsl.ts"],"sourcesContent":["import type { AutoSurfaceLayer } from \"../auto-surface/index.js\";\nimport {\n  type DslField,\n  type DslToken,\n  parseDeclaration,\n  parseDslStringToken,\n} from \"../dsl-shared.js\";\nimport { scaffoldDslParseError } from \"./dsl-error.js\";\nimport type { ScaffoldSurfaceDefinition } from \"./types.js\";\n\nconst STRING = '\"((?:[^\"\\\\\\\\]|\\\\\\\\.)*)\"';\n\nexport function compileSurfaceDsl(source: string): ScaffoldSurfaceDefinition {\n  const declaration = parseDeclaration(source, {\n    kind: \"surface\",\n    allowQuotedTitle: true,\n    expected: 'Expected surface id \"Title\" {',\n    fieldKeywords: [\n      \"title\",\n      \"kind\",\n      \"module\",\n      \"projector\",\n      \"definition-root\",\n      \"value-root\",\n      \"scope\",\n      \"order\",\n      \"metadata\",\n    ],\n    nestedFieldKeywords: [\"metadata\"],\n    wildcardNestedFieldKeywords: [\"metadata\"],\n    error: parseSharedError,\n  });\n\n  if (!declaration.title) {\n    throw parseError(\n      declaration.idToken.line,\n      'Expected surface id \"Title\" {',\n      declaration.idToken.column,\n    );\n  }\n\n  const surface: ScaffoldSurfaceDefinition = {\n    id: declaration.id,\n    title: declaration.title,\n    kind: \"auto-surface\",\n  };\n\n  for (const field of declaration.fields) {\n    if (field.name.value === \"title\") {\n      surface.title = parseStringField(field, 'Expected title \"<text>\"');\n      continue;\n    }\n    if (field.name.value === \"kind\") {\n      surface.kind = parseIdentifierField(field, \"kind\");\n      continue;\n    }\n    if (field.name.value === \"module\") {\n      surface.module = parseIdentifierField(field, \"module\");\n      continue;\n    }\n    if (field.name.value === \"projector\") {\n      surface.projector = parseIdentifierField(\n        field,\n        \"projector\",\n      ) as ScaffoldSurfaceDefinition[\"projector\"];\n      continue;\n    }\n    if (field.name.value === \"definition-root\") {\n      surface.definitionRoot = parseStringField(field, 'Expected definition-root \"<path>\"');\n      continue;\n    }\n    if (field.name.value === \"value-root\") {\n      const layer = field.values[0];\n      const root = field.values[1];\n      if (\n        field.values.length !== 2 ||\n        layer?.type !== \"word\" ||\n        ![\"system\", \"package\", \"instance\", \"user\"].includes(layer.value) ||\n        root?.type !== \"string\"\n      ) {\n        throw parseError(\n          field.name.line,\n          'Expected value-root system|package|instance|user \"<path>\"',\n          field.name.column,\n        );\n      }\n      surface.valueRoots ??= {};\n      surface.valueRoots[layer.value as AutoSurfaceLayer] = parseDslStringToken(\n        root,\n        parseSharedError,\n      );\n      continue;\n    }\n    if (field.name.value === \"scope\") {\n      surface.scope = parseIdentifierField(field, \"scope\") as ScaffoldSurfaceDefinition[\"scope\"];\n      continue;\n    }\n    if (field.name.value === \"order\") {\n      surface.order = parseNumberField(field, \"order\");\n      continue;\n    }\n    if (field.name.value === \"metadata\") {\n      applyMetadataField(surface, field);\n    }\n  }\n\n  return surface;\n}\n\nexport function formatSurfaceDsl(source: string): string {\n  const surface = compileSurfaceDsl(source);\n  const lines = [`surface ${surface.id} ${quote(surface.title ?? surface.id)} {`];\n  lines.push(`  kind ${surface.kind}`);\n  if (surface.module) lines.push(`  module ${surface.module}`);\n  if (surface.projector) lines.push(`  projector ${surface.projector}`);\n  if (surface.definitionRoot) lines.push(`  definition-root ${quote(surface.definitionRoot)}`);\n  for (const layer of [\"system\", \"package\", \"instance\", \"user\"] as const) {\n    const root = surface.valueRoots?.[layer];\n    if (root) lines.push(`  value-root ${layer} ${quote(root)}`);\n  }\n  if (surface.scope) lines.push(`  scope ${surface.scope}`);\n  if (surface.order !== undefined) lines.push(`  order ${surface.order}`);\n  pushMetadataLines(lines, surface.metadata);\n  lines.push(\"}\");\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction pushMetadataLines(lines: string[], metadata: Record<string, unknown> | undefined): void {\n  const entries = Object.entries(metadata ?? {});\n  if (entries.length === 0) return;\n  if (entries.length === 1) {\n    const [key, value] = entries[0]!;\n    lines.push(`  metadata ${key} ${formatMetadataValue(value)}`);\n    return;\n  }\n  lines.push(\"  metadata {\");\n  for (const [key, value] of entries) {\n    lines.push(`    ${key} ${formatMetadataValue(value)}`);\n  }\n  lines.push(\"  }\");\n}\n\nfunction applyMetadataField(surface: ScaffoldSurfaceDefinition, field: DslField): void {\n  surface.metadata ??= {};\n  if (field.children) {\n    if (field.values.length > 0) {\n      throw parseError(field.name.line, \"Expected metadata { ... }\", field.name.column);\n    }\n    for (const child of field.children) {\n      surface.metadata[child.name.value] = parseMetadataValue(\n        joinDslValues(child.values),\n        child.name.line,\n      );\n    }\n    return;\n  }\n\n  const key = field.values[0];\n  if (key?.type !== \"word\" || field.values.length < 2) {\n    throw parseError(field.name.line, \"Expected metadata <key> <value>\", field.name.column);\n  }\n  surface.metadata[key.value] = parseMetadataValue(\n    joinDslValues(field.values.slice(1)),\n    field.name.line,\n  );\n}\n\nfunction parseMetadataValue(input: string, lineNumber: number): unknown {\n  const string = input.match(new RegExp(`^${STRING}$`));\n  if (string) return unescapeString(string[1] ?? \"\");\n  if (input === \"true\") return true;\n  if (input === \"false\") return false;\n  if (/^-?\\d+(?:\\.\\d+)?$/.test(input)) return Number(input);\n  if (input.startsWith(\"[\")) {\n    try {\n      return JSON.parse(input);\n    } catch (err) {\n      throw parseError(\n        lineNumber,\n        `Invalid metadata array: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n  throw parseError(lineNumber, `Unsupported metadata value: ${input}`);\n}\n\nfunction parseSharedError(message: string, line: number, column = 1): Error {\n  return parseError(line, message, column);\n}\n\nfunction parseIdentifierField(field: DslField, name: string): string {\n  const value = field.values[0];\n  if (\n    field.values.length !== 1 ||\n    value?.type !== \"word\" ||\n    !/^[A-Za-z0-9_-]+$/.test(value.value)\n  ) {\n    throw parseError(\n      value?.line ?? field.name.line,\n      `Expected ${name} <identifier>`,\n      value?.column ?? field.name.column,\n    );\n  }\n  return value.value;\n}\n\nfunction parseNumberField(field: DslField, name: string): number {\n  const value = field.values[0];\n  if (field.values.length !== 1 || value?.type !== \"word\" || !/^\\d+$/.test(value.value)) {\n    throw parseError(\n      value?.line ?? field.name.line,\n      `Expected ${name} <number>`,\n      value?.column ?? field.name.column,\n    );\n  }\n  return Number(value.value);\n}\n\nfunction parseStringField(field: DslField, message: string): string {\n  const value = field.values[0];\n  if (field.values.length !== 1 || value?.type !== \"string\") {\n    throw parseError(value?.line ?? field.name.line, message, value?.column ?? field.name.column);\n  }\n  return parseDslStringToken(value, parseSharedError);\n}\n\nfunction joinDslValues(tokens: DslToken[]): string {\n  return tokens.map((token) => token.value).join(\" \");\n}\n\nfunction formatMetadataValue(value: unknown): string {\n  if (typeof value === \"string\") return quote(value);\n  if (typeof value === \"boolean\" || typeof value === \"number\") return String(value);\n  return formatInlineJson(value);\n}\n\nfunction unescapeString(value: string): string {\n  return value.replace(/\\\\\"/g, '\"').replace(/\\\\\\\\/g, \"\\\\\");\n}\n\nfunction quote(value: string): string {\n  return JSON.stringify(value);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction formatInlineJson(value: unknown): string {\n  if (Array.isArray(value)) return `[${value.map(formatInlineJson).join(\", \")}]`;\n  if (isRecord(value)) {\n    return `{${Object.entries(value)\n      .map(([key, entry]) => `${quote(key)}: ${formatInlineJson(entry)}`)\n      .join(\", \")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nfunction parseError(line: number, message: string, column = 1): Error {\n  return scaffoldDslParseError(\"surface\", line, message, column);\n}\n"],"mappings":"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"}

package/dist/scaffold/surfaces.cjs

@@ -0,0 +1,84 @@
+const require_fragments = require('../auto-surface/fragments.cjs');
+const require_projection = require('../auto-surface/projection.cjs');
+const require_scenario = require('../auto-surface/scenario.cjs');
+
+//#region src/scaffold/surfaces.ts
+async function resolveScaffoldSurfaces(scaffold, options) {
+	const diagnostics = [];
+	const surfaces = {};
+	for (const definition of scaffold.definition.surfaces) {
+		if (definition.kind !== "auto-surface") {
+			diagnostics.push({
+				code: "unsupported_surface_kind",
+				severity: "warning",
+				surfaceId: definition.id,
+				message: `Surface "${definition.id}" uses unsupported kind "${definition.kind}"`
+			});
+			continue;
+		}
+		try {
+			const resolved = await resolveAutoSurfaceScaffoldSurface(definition, options);
+			surfaces[definition.id] = resolved;
+		} catch (error) {
+			diagnostics.push({
+				code: "surface_resolve_error",
+				severity: "error",
+				surfaceId: definition.id,
+				message: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	return {
+		surfaces,
+		diagnostics
+	};
+}
+async function resolveScaffoldSurface(scaffold, surfaceId, options) {
+	const surface = scaffold.surfacesById[surfaceId];
+	if (!surface) return void 0;
+	if (surface.kind !== "auto-surface") return void 0;
+	return resolveAutoSurfaceScaffoldSurface(surface, options);
+}
+async function resolveAutoSurfaceScaffoldSurface(surface, options) {
+	const scenario = await buildAutoSurfaceScenario(surface, options);
+	return {
+		kind: "auto-surface",
+		definition: surface,
+		scenario,
+		projection: require_projection.projectAutoSurface(scenario.resolved, {
+			projector: surface.projector ?? options.autoSurface?.defaultProjector ?? "settings-shell",
+			scope: surface.scope ?? options.autoSurface?.defaultScope
+		})
+	};
+}
+async function buildAutoSurfaceScenario(surface, options) {
+	const definitions = [];
+	if (options.autoSurface?.systemDefinitionRoot) definitions.push({
+		source: options.autoSurface.systemDefinitionSource ?? "arc://system",
+		owner: "system",
+		reader: options.afs,
+		root: options.autoSurface.systemDefinitionRoot
+	});
+	definitions.push({
+		source: options.autoSurface?.packageDefinitionSource ?? "blocklet://package",
+		owner: "package",
+		reader: options.afs,
+		root: surface.definitionRoot ?? options.autoSurface?.packageDefinitionRoot ?? require_fragments.DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT
+	});
+	const valueRoots = {
+		...options.autoSurface?.valueRoots ?? {},
+		...surface.valueRoots ?? {}
+	};
+	return require_scenario.resolveAutoSurfaceScenario({
+		definitions,
+		values: Object.entries(valueRoots).filter(([, root]) => typeof root === "string" && root.length > 0).map(([layer, root]) => ({
+			layer,
+			reader: options.afs,
+			root
+		}))
+	});
+}
+
+//#endregion
+exports.resolveScaffoldSurface = resolveScaffoldSurface;
+exports.resolveScaffoldSurfaces = resolveScaffoldSurfaces;

package/dist/scaffold/surfaces.d.cts

@@ -0,0 +1,23 @@
+import { AutoSurfaceLayer, AutoSurfaceProjectorName } from "../auto-surface/types.cjs";
+import { ResolvedScaffoldDefinition, ResolvedScaffoldSurface, ResolvedScaffoldSurfaces } from "./types.cjs";
+import { ScaffoldAfsReader } from "./afs.cjs";
+
+//#region src/scaffold/surfaces.d.ts
+interface ResolveScaffoldAutoSurfaceOptions {
+  systemDefinitionRoot?: string;
+  systemDefinitionSource?: string;
+  packageDefinitionRoot?: string;
+  packageDefinitionSource?: string;
+  valueRoots?: Partial<Record<AutoSurfaceLayer, string>>;
+  defaultProjector?: AutoSurfaceProjectorName;
+  defaultScope?: AutoSurfaceLayer | "all";
+}
+interface ResolveScaffoldSurfacesOptions {
+  afs: ScaffoldAfsReader;
+  autoSurface?: ResolveScaffoldAutoSurfaceOptions;
+}
+declare function resolveScaffoldSurfaces(scaffold: ResolvedScaffoldDefinition, options: ResolveScaffoldSurfacesOptions): Promise<ResolvedScaffoldSurfaces>;
+declare function resolveScaffoldSurface(scaffold: ResolvedScaffoldDefinition, surfaceId: string, options: ResolveScaffoldSurfacesOptions): Promise<ResolvedScaffoldSurface | undefined>;
+//#endregion
+export { ResolveScaffoldAutoSurfaceOptions, ResolveScaffoldSurfacesOptions, resolveScaffoldSurface, resolveScaffoldSurfaces };
+//# sourceMappingURL=surfaces.d.cts.map

package/dist/scaffold/surfaces.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.cts","names":[],"sources":["../../src/scaffold/surfaces.ts"],"mappings":";;;;;UAkBiB,iCAAA;EACf,oBAAA;EACA,sBAAA;EACA,qBAAA;EACA,uBAAA;EACA,UAAA,GAAa,OAAA,CAAQ,MAAA,CAAO,gBAAA;EAC5B,gBAAA,GAAmB,wBAAA;EACnB,YAAA,GAAe,gBAAA;AAAA;AAAA,UAGA,8BAAA;EACf,GAAA,EAAK,iBAAA;EACL,WAAA,GAAc,iCAAA;AAAA;AAAA,iBAGM,uBAAA,CACpB,QAAA,EAAU,0BAAA,EACV,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,wBAAA;AAAA,iBA+BW,sBAAA,CACpB,QAAA,EAAU,0BAAA,EACV,SAAA,UACA,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,uBAAA"}

package/dist/scaffold/surfaces.d.mts

@@ -0,0 +1,24 @@
+import { AutoSurfaceLayer, AutoSurfaceProjectorName } from "../auto-surface/types.mjs";
+import "../auto-surface/index.mjs";
+import { ResolvedScaffoldDefinition, ResolvedScaffoldSurface, ResolvedScaffoldSurfaces } from "./types.mjs";
+import { ScaffoldAfsReader } from "./afs.mjs";
+
+//#region src/scaffold/surfaces.d.ts
+interface ResolveScaffoldAutoSurfaceOptions {
+  systemDefinitionRoot?: string;
+  systemDefinitionSource?: string;
+  packageDefinitionRoot?: string;
+  packageDefinitionSource?: string;
+  valueRoots?: Partial<Record<AutoSurfaceLayer, string>>;
+  defaultProjector?: AutoSurfaceProjectorName;
+  defaultScope?: AutoSurfaceLayer | "all";
+}
+interface ResolveScaffoldSurfacesOptions {
+  afs: ScaffoldAfsReader;
+  autoSurface?: ResolveScaffoldAutoSurfaceOptions;
+}
+declare function resolveScaffoldSurfaces(scaffold: ResolvedScaffoldDefinition, options: ResolveScaffoldSurfacesOptions): Promise<ResolvedScaffoldSurfaces>;
+declare function resolveScaffoldSurface(scaffold: ResolvedScaffoldDefinition, surfaceId: string, options: ResolveScaffoldSurfacesOptions): Promise<ResolvedScaffoldSurface | undefined>;
+//#endregion
+export { ResolveScaffoldAutoSurfaceOptions, ResolveScaffoldSurfacesOptions, resolveScaffoldSurface, resolveScaffoldSurfaces };
+//# sourceMappingURL=surfaces.d.mts.map

package/dist/scaffold/surfaces.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.mts","names":[],"sources":["../../src/scaffold/surfaces.ts"],"mappings":";;;;;;UAkBiB,iCAAA;EACf,oBAAA;EACA,sBAAA;EACA,qBAAA;EACA,uBAAA;EACA,UAAA,GAAa,OAAA,CAAQ,MAAA,CAAO,gBAAA;EAC5B,gBAAA,GAAmB,wBAAA;EACnB,YAAA,GAAe,gBAAA;AAAA;AAAA,UAGA,8BAAA;EACf,GAAA,EAAK,iBAAA;EACL,WAAA,GAAc,iCAAA;AAAA;AAAA,iBAGM,uBAAA,CACpB,QAAA,EAAU,0BAAA,EACV,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,wBAAA;AAAA,iBA+BW,sBAAA,CACpB,QAAA,EAAU,0BAAA,EACV,SAAA,UACA,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,uBAAA"}

package/dist/scaffold/surfaces.mjs

@@ -0,0 +1,84 @@
+import { DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT } from "../auto-surface/fragments.mjs";
+import { projectAutoSurface } from "../auto-surface/projection.mjs";
+import { resolveAutoSurfaceScenario } from "../auto-surface/scenario.mjs";
+
+//#region src/scaffold/surfaces.ts
+async function resolveScaffoldSurfaces(scaffold, options) {
+	const diagnostics = [];
+	const surfaces = {};
+	for (const definition of scaffold.definition.surfaces) {
+		if (definition.kind !== "auto-surface") {
+			diagnostics.push({
+				code: "unsupported_surface_kind",
+				severity: "warning",
+				surfaceId: definition.id,
+				message: `Surface "${definition.id}" uses unsupported kind "${definition.kind}"`
+			});
+			continue;
+		}
+		try {
+			const resolved = await resolveAutoSurfaceScaffoldSurface(definition, options);
+			surfaces[definition.id] = resolved;
+		} catch (error) {
+			diagnostics.push({
+				code: "surface_resolve_error",
+				severity: "error",
+				surfaceId: definition.id,
+				message: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	return {
+		surfaces,
+		diagnostics
+	};
+}
+async function resolveScaffoldSurface(scaffold, surfaceId, options) {
+	const surface = scaffold.surfacesById[surfaceId];
+	if (!surface) return void 0;
+	if (surface.kind !== "auto-surface") return void 0;
+	return resolveAutoSurfaceScaffoldSurface(surface, options);
+}
+async function resolveAutoSurfaceScaffoldSurface(surface, options) {
+	const scenario = await buildAutoSurfaceScenario(surface, options);
+	return {
+		kind: "auto-surface",
+		definition: surface,
+		scenario,
+		projection: projectAutoSurface(scenario.resolved, {
+			projector: surface.projector ?? options.autoSurface?.defaultProjector ?? "settings-shell",
+			scope: surface.scope ?? options.autoSurface?.defaultScope
+		})
+	};
+}
+async function buildAutoSurfaceScenario(surface, options) {
+	const definitions = [];
+	if (options.autoSurface?.systemDefinitionRoot) definitions.push({
+		source: options.autoSurface.systemDefinitionSource ?? "arc://system",
+		owner: "system",
+		reader: options.afs,
+		root: options.autoSurface.systemDefinitionRoot
+	});
+	definitions.push({
+		source: options.autoSurface?.packageDefinitionSource ?? "blocklet://package",
+		owner: "package",
+		reader: options.afs,
+		root: surface.definitionRoot ?? options.autoSurface?.packageDefinitionRoot ?? DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT
+	});
+	const valueRoots = {
+		...options.autoSurface?.valueRoots ?? {},
+		...surface.valueRoots ?? {}
+	};
+	return resolveAutoSurfaceScenario({
+		definitions,
+		values: Object.entries(valueRoots).filter(([, root]) => typeof root === "string" && root.length > 0).map(([layer, root]) => ({
+			layer,
+			reader: options.afs,
+			root
+		}))
+	});
+}
+
+//#endregion
+export { resolveScaffoldSurface, resolveScaffoldSurfaces };
+//# sourceMappingURL=surfaces.mjs.map

package/dist/scaffold/surfaces.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.mjs","names":[],"sources":["../../src/scaffold/surfaces.ts"],"sourcesContent":["import {\n  type AutoSurfaceLayer,\n  type AutoSurfaceProjectorName,\n  type AutoSurfaceResolvedScenario,\n  DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT,\n  projectAutoSurface,\n  resolveAutoSurfaceScenario,\n} from \"../auto-surface/index.js\";\nimport type { ScaffoldAfsReader } from \"./afs.js\";\nimport type {\n  ResolvedScaffoldAutoSurface,\n  ResolvedScaffoldDefinition,\n  ResolvedScaffoldSurface,\n  ResolvedScaffoldSurfaces,\n  ScaffoldSurfaceDefinition,\n  ScaffoldSurfaceRuntimeDiagnostic,\n} from \"./types.js\";\n\nexport interface ResolveScaffoldAutoSurfaceOptions {\n  systemDefinitionRoot?: string;\n  systemDefinitionSource?: string;\n  packageDefinitionRoot?: string;\n  packageDefinitionSource?: string;\n  valueRoots?: Partial<Record<AutoSurfaceLayer, string>>;\n  defaultProjector?: AutoSurfaceProjectorName;\n  defaultScope?: AutoSurfaceLayer | \"all\";\n}\n\nexport interface ResolveScaffoldSurfacesOptions {\n  afs: ScaffoldAfsReader;\n  autoSurface?: ResolveScaffoldAutoSurfaceOptions;\n}\n\nexport async function resolveScaffoldSurfaces(\n  scaffold: ResolvedScaffoldDefinition,\n  options: ResolveScaffoldSurfacesOptions,\n): Promise<ResolvedScaffoldSurfaces> {\n  const diagnostics: ScaffoldSurfaceRuntimeDiagnostic[] = [];\n  const surfaces: Record<string, ResolvedScaffoldSurface> = {};\n\n  for (const definition of scaffold.definition.surfaces) {\n    if (definition.kind !== \"auto-surface\") {\n      diagnostics.push({\n        code: \"unsupported_surface_kind\",\n        severity: \"warning\",\n        surfaceId: definition.id,\n        message: `Surface \"${definition.id}\" uses unsupported kind \"${definition.kind}\"`,\n      });\n      continue;\n    }\n\n    try {\n      const resolved = await resolveAutoSurfaceScaffoldSurface(definition, options);\n      surfaces[definition.id] = resolved;\n    } catch (error) {\n      diagnostics.push({\n        code: \"surface_resolve_error\",\n        severity: \"error\",\n        surfaceId: definition.id,\n        message: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  return { surfaces, diagnostics };\n}\n\nexport async function resolveScaffoldSurface(\n  scaffold: ResolvedScaffoldDefinition,\n  surfaceId: string,\n  options: ResolveScaffoldSurfacesOptions,\n): Promise<ResolvedScaffoldSurface | undefined> {\n  const surface = scaffold.surfacesById[surfaceId];\n  if (!surface) return undefined;\n  if (surface.kind !== \"auto-surface\") return undefined;\n  return resolveAutoSurfaceScaffoldSurface(surface, options);\n}\n\nasync function resolveAutoSurfaceScaffoldSurface(\n  surface: ScaffoldSurfaceDefinition,\n  options: ResolveScaffoldSurfacesOptions,\n): Promise<ResolvedScaffoldAutoSurface> {\n  const scenario = await buildAutoSurfaceScenario(surface, options);\n  return {\n    kind: \"auto-surface\",\n    definition: surface,\n    scenario,\n    projection: projectAutoSurface(scenario.resolved, {\n      projector: surface.projector ?? options.autoSurface?.defaultProjector ?? \"settings-shell\",\n      scope: surface.scope ?? options.autoSurface?.defaultScope,\n    }),\n  };\n}\n\nasync function buildAutoSurfaceScenario(\n  surface: ScaffoldSurfaceDefinition,\n  options: ResolveScaffoldSurfacesOptions,\n): Promise<AutoSurfaceResolvedScenario> {\n  const definitions = [];\n  if (options.autoSurface?.systemDefinitionRoot) {\n    definitions.push({\n      source: options.autoSurface.systemDefinitionSource ?? \"arc://system\",\n      owner: \"system\" as const,\n      reader: options.afs,\n      root: options.autoSurface.systemDefinitionRoot,\n    });\n  }\n  definitions.push({\n    source: options.autoSurface?.packageDefinitionSource ?? \"blocklet://package\",\n    owner: \"package\" as const,\n    reader: options.afs,\n    root:\n      surface.definitionRoot ??\n      options.autoSurface?.packageDefinitionRoot ??\n      DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT,\n  });\n\n  const valueRoots = {\n    ...(options.autoSurface?.valueRoots ?? {}),\n    ...(surface.valueRoots ?? {}),\n  };\n  const values = Object.entries(valueRoots)\n    .filter(([, root]) => typeof root === \"string\" && root.length > 0)\n    .map(([layer, root]) => ({\n      layer: layer as AutoSurfaceLayer,\n      reader: options.afs,\n      root,\n    }));\n\n  return resolveAutoSurfaceScenario({\n    definitions,\n    values,\n  });\n}\n"],"mappings":";;;;;AAiCA,eAAsB,wBACpB,UACA,SACmC;CACnC,MAAM,cAAkD,EAAE;CAC1D,MAAM,WAAoD,EAAE;AAE5D,MAAK,MAAM,cAAc,SAAS,WAAW,UAAU;AACrD,MAAI,WAAW,SAAS,gBAAgB;AACtC,eAAY,KAAK;IACf,MAAM;IACN,UAAU;IACV,WAAW,WAAW;IACtB,SAAS,YAAY,WAAW,GAAG,2BAA2B,WAAW,KAAK;IAC/E,CAAC;AACF;;AAGF,MAAI;GACF,MAAM,WAAW,MAAM,kCAAkC,YAAY,QAAQ;AAC7E,YAAS,WAAW,MAAM;WACnB,OAAO;AACd,eAAY,KAAK;IACf,MAAM;IACN,UAAU;IACV,WAAW,WAAW;IACtB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAChE,CAAC;;;AAIN,QAAO;EAAE;EAAU;EAAa;;AAGlC,eAAsB,uBACpB,UACA,WACA,SAC8C;CAC9C,MAAM,UAAU,SAAS,aAAa;AACtC,KAAI,CAAC,QAAS,QAAO;AACrB,KAAI,QAAQ,SAAS,eAAgB,QAAO;AAC5C,QAAO,kCAAkC,SAAS,QAAQ;;AAG5D,eAAe,kCACb,SACA,SACsC;CACtC,MAAM,WAAW,MAAM,yBAAyB,SAAS,QAAQ;AACjE,QAAO;EACL,MAAM;EACN,YAAY;EACZ;EACA,YAAY,mBAAmB,SAAS,UAAU;GAChD,WAAW,QAAQ,aAAa,QAAQ,aAAa,oBAAoB;GACzE,OAAO,QAAQ,SAAS,QAAQ,aAAa;GAC9C,CAAC;EACH;;AAGH,eAAe,yBACb,SACA,SACsC;CACtC,MAAM,cAAc,EAAE;AACtB,KAAI,QAAQ,aAAa,qBACvB,aAAY,KAAK;EACf,QAAQ,QAAQ,YAAY,0BAA0B;EACtD,OAAO;EACP,QAAQ,QAAQ;EAChB,MAAM,QAAQ,YAAY;EAC3B,CAAC;AAEJ,aAAY,KAAK;EACf,QAAQ,QAAQ,aAAa,2BAA2B;EACxD,OAAO;EACP,QAAQ,QAAQ;EAChB,MACE,QAAQ,kBACR,QAAQ,aAAa,yBACrB;EACH,CAAC;CAEF,MAAM,aAAa;EACjB,GAAI,QAAQ,aAAa,cAAc,EAAE;EACzC,GAAI,QAAQ,cAAc,EAAE;EAC7B;AASD,QAAO,2BAA2B;EAChC;EACA,QAVa,OAAO,QAAQ,WAAW,CACtC,QAAQ,GAAG,UAAU,OAAO,SAAS,YAAY,KAAK,SAAS,EAAE,CACjE,KAAK,CAAC,OAAO,WAAW;GAChB;GACP,QAAQ,QAAQ;GAChB;GACD,EAAE;EAKJ,CAAC"}