@aigne/aos 0.2.0-beta

package/dist/auto-surface/definition-dsl.mjs

@@ -0,0 +1,332 @@
+import { parseDeclaration, parseDslStringToken } from "../dsl-shared.mjs";
+
+//#region src/auto-surface/definition-dsl.ts
+var AutoSurfaceDefinitionDslCompileError = class extends Error {
+	constructor(message, line, column = 1) {
+		super(`${line}:${column} ${message}`);
+		this.line = line;
+		this.column = column;
+		this.name = "AutoSurfaceDefinitionDslCompileError";
+	}
+};
+const VALUE_TYPES = new Set([
+	"string",
+	"number",
+	"boolean",
+	"select",
+	"textarea",
+	"json"
+]);
+const LAYERS = new Set([
+	"system",
+	"package",
+	"instance",
+	"user"
+]);
+const LAYER_ORDER = [
+	"system",
+	"package",
+	"instance",
+	"user"
+];
+function compileAutoSurfaceDefinitionDsl(source) {
+	const declaration = parseDeclaration(source, {
+		kind: "surface-definitions",
+		allowQuotedTitle: true,
+		expected: "Expected surface-definitions <id> \"Title\" {",
+		fieldKeywords: [
+			"order",
+			"description",
+			"page",
+			"section",
+			"field",
+			"default",
+			"scopes",
+			"binding",
+			"resource-id",
+			"options",
+			"validation",
+			"policy",
+			"presentations",
+			"metadata"
+		],
+		nestedFieldKeywords: [
+			"page",
+			"section",
+			"field"
+		],
+		error: parseSharedError
+	});
+	if (!declaration.title) throw new AutoSurfaceDefinitionDslCompileError("Expected surface-definitions <id> \"Title\" {", declaration.idToken.line, declaration.idToken.column);
+	const group = {
+		id: declaration.id,
+		title: declaration.title,
+		pages: []
+	};
+	for (const field of declaration.fields) {
+		if (parseSharedMetaField(group, field)) continue;
+		if (field.name.value !== "page") throw unsupportedField("surface-definitions", field);
+		group.pages.push(parsePageField(field));
+	}
+	return {
+		group,
+		files: buildDefinitionFiles(group)
+	};
+}
+function formatAutoSurfaceDefinitionDsl(source) {
+	const compiled = compileAutoSurfaceDefinitionDsl(source);
+	const lines = [];
+	emitGroup(lines, compiled.group, 0);
+	return `${lines.join("\n")}\n`;
+}
+function parsePageField(field) {
+	const head = parseIdTitleField(field, "Expected page <id> \"Title\" {");
+	const page = {
+		id: head.id,
+		title: head.title,
+		sections: [],
+		fields: []
+	};
+	for (const child of field.children ?? []) {
+		if (parseSharedMetaField(page, child)) continue;
+		if (child.name.value === "section") {
+			page.sections.push(parseSectionField(child));
+			continue;
+		}
+		if (child.name.value === "field") {
+			page.fields.push(parseResourceField(child));
+			continue;
+		}
+		throw unsupportedField("page", child);
+	}
+	return page;
+}
+function parseSectionField(field) {
+	const head = parseIdTitleField(field, "Expected section <id> \"Title\" {");
+	const section = {
+		id: head.id,
+		title: head.title,
+		fields: []
+	};
+	for (const child of field.children ?? []) {
+		if (parseSharedMetaField(section, child)) continue;
+		if (child.name.value === "field") {
+			section.fields.push(parseResourceField(child));
+			continue;
+		}
+		throw unsupportedField("section", child);
+	}
+	return section;
+}
+function parseResourceField(field) {
+	const id = field.values[0];
+	const typeToken = field.values[1];
+	const title = field.values[2];
+	if (field.values.length !== 3 || id?.type !== "word" || typeToken?.type !== "word" || title?.type !== "string") throw new AutoSurfaceDefinitionDslCompileError("Expected field <id> <type> \"Title\" {", field.name.line, field.name.column);
+	const type = typeToken.value;
+	if (!VALUE_TYPES.has(type)) throw new AutoSurfaceDefinitionDslCompileError(`Unsupported field type: ${type}`, typeToken.line, typeToken.column);
+	const resource = {
+		id: id.value,
+		type,
+		title: parseDslStringToken(title, parseSharedError)
+	};
+	for (const child of field.children ?? []) {
+		if (parseSharedMetaField(resource, child)) continue;
+		parseFieldAttributeField(resource, child);
+	}
+	return resource;
+}
+function parseSharedMetaField(node, field) {
+	if (field.name.value === "order") {
+		if ("type" in node) return false;
+		node.order = parseNumberField(field, "order");
+		return true;
+	}
+	if (field.name.value === "description") {
+		const value = parseJsonValueFromTokens(field.values, field.name.line, field.name.column);
+		if (typeof value !== "string") throw new AutoSurfaceDefinitionDslCompileError("description must be a string", field.name.line, field.name.column);
+		node.description = value;
+		return true;
+	}
+	return false;
+}
+function parseFieldAttributeField(field, attribute) {
+	if (attribute.name.value === "default") {
+		field.defaultValue = parseJsonValueFromTokens(attribute.values, attribute.name.line, attribute.name.column);
+		return;
+	}
+	if (attribute.name.value === "scopes") {
+		const scopes = parseJsonValueFromTokens(attribute.values, attribute.name.line, attribute.name.column);
+		if (!Array.isArray(scopes) || !scopes.every((scope) => typeof scope === "string" && LAYERS.has(scope))) throw new AutoSurfaceDefinitionDslCompileError("scopes must be an array of \"system\", \"package\", \"instance\", or \"user\"", attribute.name.line, attribute.name.column);
+		field.scopes = scopes;
+		return;
+	}
+	if (attribute.name.value === "binding") {
+		const layerToken = attribute.values[0];
+		if (layerToken?.type !== "word" || attribute.values.length < 2) throw new AutoSurfaceDefinitionDslCompileError("Expected binding <layer> \"<path>\"", attribute.name.line, attribute.name.column);
+		const layer = layerToken.value;
+		if (!LAYERS.has(layer)) throw new AutoSurfaceDefinitionDslCompileError(`Unsupported binding layer: ${layer}`, layerToken.line, layerToken.column);
+		const value = parseJsonValueFromTokens(attribute.values.slice(1), attribute.name.line, layerToken.column);
+		if (typeof value !== "string") throw new AutoSurfaceDefinitionDslCompileError("binding value must be a string", attribute.name.line, attribute.name.column);
+		field.bindings = {
+			...field.bindings ?? {},
+			[layer]: value
+		};
+		return;
+	}
+	if (attribute.name.value === "resource-id") {
+		const value = parseJsonValueFromTokens(attribute.values, attribute.name.line, attribute.name.column);
+		if (typeof value !== "string") throw new AutoSurfaceDefinitionDslCompileError("resource-id must be a string", attribute.name.line, attribute.name.column);
+		field.explicitId = value;
+		return;
+	}
+	if ([
+		"options",
+		"validation",
+		"policy",
+		"presentations",
+		"metadata"
+	].includes(attribute.name.value)) {
+		const key = attribute.name.value;
+		const value = parseJsonValueFromTokens(attribute.values, attribute.name.line, attribute.name.column);
+		if (key === "options") {
+			if (!Array.isArray(value)) throw new AutoSurfaceDefinitionDslCompileError("options must be an array", attribute.name.line, attribute.name.column);
+			field.options = value;
+		} else if (key === "validation") field.validation = assertRecordValue(value, key, attribute.name.line, attribute.name.column);
+		else if (key === "policy") field.policy = assertRecordValue(value, key, attribute.name.line, attribute.name.column);
+		else if (key === "presentations") field.presentations = assertRecordValue(value, key, attribute.name.line, attribute.name.column);
+		else if (key === "metadata") field.metadata = assertRecordValue(value, key, attribute.name.line, attribute.name.column);
+		return;
+	}
+	throw new AutoSurfaceDefinitionDslCompileError(`Unsupported field attribute line: ${attribute.name.value}`, attribute.name.line, attribute.name.column);
+}
+function parseIdTitleField(field, message) {
+	const id = field.values[0];
+	const title = field.values[1];
+	if (field.values.length !== 2 || id?.type !== "word" || title?.type !== "string") throw new AutoSurfaceDefinitionDslCompileError(message, field.name.line, field.name.column);
+	return {
+		id: id.value,
+		title: parseDslStringToken(title, parseSharedError)
+	};
+}
+function parseNumberField(field, name) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "word" || !/^-?\d+(?:\.\d+)?$/.test(value.value)) throw new AutoSurfaceDefinitionDslCompileError(`Expected ${name} <number>`, value?.line ?? field.name.line, value?.column ?? field.name.column);
+	return Number(value.value);
+}
+function parseJsonValueFromTokens(tokens, line, column) {
+	return parseJsonValue(joinDslValues(tokens), line, tokens[0]?.column ?? column);
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function unsupportedField(context, field) {
+	return new AutoSurfaceDefinitionDslCompileError(`Unsupported ${context} DSL statement: ${field.name.value}`, field.name.line, field.name.column);
+}
+function parseSharedError(message, line, column = 1) {
+	return new AutoSurfaceDefinitionDslCompileError(message, line, column);
+}
+function buildDefinitionFiles(group) {
+	const files = {};
+	const addFile = (path, content) => {
+		if (Object.hasOwn(files, path)) throw new AutoSurfaceDefinitionDslCompileError(`Duplicate generated path: ${path}`, 1);
+		files[path] = content;
+	};
+	addFile(`${group.id}/group.json`, directoryMetaToJson(group));
+	for (const page of group.pages) {
+		addFile(`${group.id}/${page.id}/page.json`, directoryMetaToJson(page));
+		for (const field of page.fields) addFile(`${group.id}/${page.id}/${field.id}.field.json`, fieldToJson(field));
+		for (const section of page.sections) {
+			addFile(`${group.id}/${page.id}/${section.id}/section.json`, directoryMetaToJson(section));
+			for (const field of section.fields) addFile(`${group.id}/${page.id}/${section.id}/${field.id}.field.json`, fieldToJson(field));
+		}
+	}
+	return files;
+}
+function directoryMetaToJson(meta) {
+	return {
+		title: meta.title,
+		...meta.description !== void 0 ? { description: meta.description } : {},
+		...meta.order !== void 0 ? { order: meta.order } : {}
+	};
+}
+function fieldToJson(field) {
+	return {
+		...field.explicitId !== void 0 ? { id: field.explicitId } : {},
+		type: field.type,
+		title: field.title,
+		...field.description !== void 0 ? { description: field.description } : {},
+		...field.defaultValue !== void 0 ? { defaultValue: field.defaultValue } : {},
+		...field.options !== void 0 ? { options: field.options } : {},
+		...field.validation !== void 0 ? { validation: field.validation } : {},
+		...field.scopes !== void 0 ? { scopes: field.scopes } : {},
+		...field.bindings !== void 0 ? { bindings: field.bindings } : {},
+		...field.policy !== void 0 ? { policy: field.policy } : {},
+		...field.presentations !== void 0 ? { presentations: field.presentations } : {},
+		...field.metadata !== void 0 ? { metadata: field.metadata } : {}
+	};
+}
+function emitGroup(lines, group, indent) {
+	lines.push(`${space(indent)}surface-definitions ${group.id} ${quote(group.title)} {`);
+	emitMetaLines(lines, group, indent + 2);
+	for (const page of group.pages) emitPage(lines, page, indent + 2);
+	lines.push(`${space(indent)}}`);
+}
+function emitPage(lines, page, indent) {
+	lines.push(`${space(indent)}page ${page.id} ${quote(page.title)} {`);
+	emitMetaLines(lines, page, indent + 2);
+	for (const field of page.fields) emitField(lines, field, indent + 2);
+	for (const section of page.sections) emitSection(lines, section, indent + 2);
+	lines.push(`${space(indent)}}`);
+}
+function emitSection(lines, section, indent) {
+	lines.push(`${space(indent)}section ${section.id} ${quote(section.title)} {`);
+	emitMetaLines(lines, section, indent + 2);
+	for (const field of section.fields) emitField(lines, field, indent + 2);
+	lines.push(`${space(indent)}}`);
+}
+function emitField(lines, field, indent) {
+	lines.push(`${space(indent)}field ${field.id} ${field.type} ${quote(field.title)} {`);
+	emitMetaLines(lines, field, indent + 2);
+	if (field.defaultValue !== void 0) lines.push(`${space(indent + 2)}default ${formatJson(field.defaultValue)}`);
+	if (field.scopes !== void 0) lines.push(`${space(indent + 2)}scopes ${formatJson(field.scopes)}`);
+	for (const layer of LAYER_ORDER) {
+		const value = field.bindings?.[layer];
+		if (value !== void 0) lines.push(`${space(indent + 2)}binding ${layer} ${quote(value)}`);
+	}
+	if (field.options !== void 0) lines.push(`${space(indent + 2)}options ${formatJson(field.options)}`);
+	if (field.validation !== void 0) lines.push(`${space(indent + 2)}validation ${formatJson(field.validation)}`);
+	if (field.policy !== void 0) lines.push(`${space(indent + 2)}policy ${formatJson(field.policy)}`);
+	if (field.presentations !== void 0) lines.push(`${space(indent + 2)}presentations ${formatJson(field.presentations)}`);
+	if (field.metadata !== void 0) lines.push(`${space(indent + 2)}metadata ${formatJson(field.metadata)}`);
+	if (field.explicitId !== void 0) lines.push(`${space(indent + 2)}resource-id ${quote(field.explicitId)}`);
+	lines.push(`${space(indent)}}`);
+}
+function emitMetaLines(lines, node, indent) {
+	if (node.description !== void 0) lines.push(`${space(indent)}description ${quote(node.description)}`);
+	if (!("type" in node) && node.order !== void 0) lines.push(`${space(indent)}order ${node.order}`);
+}
+function parseJsonValue(source, line, column) {
+	try {
+		return JSON.parse(source);
+	} catch (error) {
+		throw new AutoSurfaceDefinitionDslCompileError(`Invalid JSON value: ${error instanceof Error ? error.message : String(error)}`, line, column);
+	}
+}
+function assertRecordValue(value, name, line, column) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new AutoSurfaceDefinitionDslCompileError(`${name} must be an object`, line, column);
+	return value;
+}
+function quote(value) {
+	return JSON.stringify(value);
+}
+function formatJson(value) {
+	return JSON.stringify(value);
+}
+function space(count) {
+	return " ".repeat(count);
+}
+
+//#endregion
+export { AutoSurfaceDefinitionDslCompileError, compileAutoSurfaceDefinitionDsl, formatAutoSurfaceDefinitionDsl };
+//# sourceMappingURL=definition-dsl.mjs.map

package/dist/auto-surface/definition-dsl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-dsl.mjs","names":[],"sources":["../../src/auto-surface/definition-dsl.ts"],"sourcesContent":["import {\n  type DslField,\n  type DslToken,\n  parseDeclaration,\n  parseDslStringToken,\n} from \"../dsl-shared.js\";\nimport type {\n  AutoSurfaceLayer,\n  AutoSurfacePolicy,\n  AutoSurfacePresentations,\n  AutoSurfaceResourceDefinition,\n  AutoSurfaceValidationRule,\n  AutoSurfaceValueType,\n} from \"./types.js\";\n\nexport interface AutoSurfaceDefinitionDslCompileResult {\n  group: AutoSurfaceDefinitionDslGroup;\n  files: Record<string, unknown>;\n}\n\nexport interface AutoSurfaceDefinitionDslGroup extends AutoSurfaceDirectoryMeta {\n  id: string;\n  pages: AutoSurfaceDefinitionDslPage[];\n}\n\nexport interface AutoSurfaceDefinitionDslPage extends AutoSurfaceDirectoryMeta {\n  id: string;\n  sections: AutoSurfaceDefinitionDslSection[];\n  fields: AutoSurfaceDefinitionDslField[];\n}\n\nexport interface AutoSurfaceDefinitionDslSection extends AutoSurfaceDirectoryMeta {\n  id: string;\n  fields: AutoSurfaceDefinitionDslField[];\n}\n\nexport interface AutoSurfaceDefinitionDslField\n  extends Omit<AutoSurfaceResourceDefinition, \"id\" | \"title\" | \"type\"> {\n  id: string;\n  type: AutoSurfaceValueType;\n  title: string;\n  explicitId?: string;\n}\n\nexport class AutoSurfaceDefinitionDslCompileError extends Error {\n  constructor(\n    message: string,\n    readonly line: number,\n    readonly column = 1,\n  ) {\n    super(`${line}:${column} ${message}`);\n    this.name = \"AutoSurfaceDefinitionDslCompileError\";\n  }\n}\n\ninterface AutoSurfaceDirectoryMeta {\n  title: string;\n  description?: string;\n  order?: number;\n}\n\nconst VALUE_TYPES = new Set<AutoSurfaceValueType>([\n  \"string\",\n  \"number\",\n  \"boolean\",\n  \"select\",\n  \"textarea\",\n  \"json\",\n]);\n\nconst LAYERS = new Set<AutoSurfaceLayer>([\"system\", \"package\", \"instance\", \"user\"]);\nconst LAYER_ORDER: AutoSurfaceLayer[] = [\"system\", \"package\", \"instance\", \"user\"];\n\nexport function compileAutoSurfaceDefinitionDsl(\n  source: string,\n): AutoSurfaceDefinitionDslCompileResult {\n  const declaration = parseDeclaration(source, {\n    kind: \"surface-definitions\",\n    allowQuotedTitle: true,\n    expected: 'Expected surface-definitions <id> \"Title\" {',\n    fieldKeywords: [\n      \"order\",\n      \"description\",\n      \"page\",\n      \"section\",\n      \"field\",\n      \"default\",\n      \"scopes\",\n      \"binding\",\n      \"resource-id\",\n      \"options\",\n      \"validation\",\n      \"policy\",\n      \"presentations\",\n      \"metadata\",\n    ],\n    nestedFieldKeywords: [\"page\", \"section\", \"field\"],\n    error: parseSharedError,\n  });\n\n  if (!declaration.title) {\n    throw new AutoSurfaceDefinitionDslCompileError(\n      'Expected surface-definitions <id> \"Title\" {',\n      declaration.idToken.line,\n      declaration.idToken.column,\n    );\n  }\n\n  const group: AutoSurfaceDefinitionDslGroup = {\n    id: declaration.id,\n    title: declaration.title,\n    pages: [],\n  };\n\n  for (const field of declaration.fields) {\n    if (parseSharedMetaField(group, field)) continue;\n    if (field.name.value !== \"page\") throw unsupportedField(\"surface-definitions\", field);\n    group.pages.push(parsePageField(field));\n  }\n\n  return { group, files: buildDefinitionFiles(group) };\n}\n\nexport function formatAutoSurfaceDefinitionDsl(source: string): string {\n  const compiled = compileAutoSurfaceDefinitionDsl(source);\n  const lines: string[] = [];\n  emitGroup(lines, compiled.group, 0);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction parsePageField(field: DslField): AutoSurfaceDefinitionDslPage {\n  const head = parseIdTitleField(field, 'Expected page <id> \"Title\" {');\n  const page: AutoSurfaceDefinitionDslPage = {\n    id: head.id,\n    title: head.title,\n    sections: [],\n    fields: [],\n  };\n  for (const child of field.children ?? []) {\n    if (parseSharedMetaField(page, child)) continue;\n    if (child.name.value === \"section\") {\n      page.sections.push(parseSectionField(child));\n      continue;\n    }\n    if (child.name.value === \"field\") {\n      page.fields.push(parseResourceField(child));\n      continue;\n    }\n    throw unsupportedField(\"page\", child);\n  }\n  return page;\n}\n\nfunction parseSectionField(field: DslField): AutoSurfaceDefinitionDslSection {\n  const head = parseIdTitleField(field, 'Expected section <id> \"Title\" {');\n  const section: AutoSurfaceDefinitionDslSection = {\n    id: head.id,\n    title: head.title,\n    fields: [],\n  };\n  for (const child of field.children ?? []) {\n    if (parseSharedMetaField(section, child)) continue;\n    if (child.name.value === \"field\") {\n      section.fields.push(parseResourceField(child));\n      continue;\n    }\n    throw unsupportedField(\"section\", child);\n  }\n  return section;\n}\n\nfunction parseResourceField(field: DslField): AutoSurfaceDefinitionDslField {\n  const id = field.values[0];\n  const typeToken = field.values[1];\n  const title = field.values[2];\n  if (\n    field.values.length !== 3 ||\n    id?.type !== \"word\" ||\n    typeToken?.type !== \"word\" ||\n    title?.type !== \"string\"\n  ) {\n    throw new AutoSurfaceDefinitionDslCompileError(\n      'Expected field <id> <type> \"Title\" {',\n      field.name.line,\n      field.name.column,\n    );\n  }\n  const type = typeToken.value as AutoSurfaceValueType;\n  if (!VALUE_TYPES.has(type)) {\n    throw new AutoSurfaceDefinitionDslCompileError(\n      `Unsupported field type: ${type}`,\n      typeToken.line,\n      typeToken.column,\n    );\n  }\n  const resource: AutoSurfaceDefinitionDslField = {\n    id: id.value,\n    type,\n    title: parseDslStringToken(title, parseSharedError),\n  };\n  for (const child of field.children ?? []) {\n    if (parseSharedMetaField(resource, child)) continue;\n    parseFieldAttributeField(resource, child);\n  }\n  return resource;\n}\n\nfunction parseSharedMetaField(\n  node: AutoSurfaceDirectoryMeta | AutoSurfaceDefinitionDslField,\n  field: DslField,\n): boolean {\n  if (field.name.value === \"order\") {\n    if (\"type\" in node) return false;\n    const order = parseNumberField(field, \"order\");\n    node.order = order;\n    return true;\n  }\n\n  if (field.name.value === \"description\") {\n    const value = parseJsonValueFromTokens(field.values, field.name.line, field.name.column);\n    if (typeof value !== \"string\") {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        \"description must be a string\",\n        field.name.line,\n        field.name.column,\n      );\n    }\n    node.description = value;\n    return true;\n  }\n\n  return false;\n}\n\nfunction parseFieldAttributeField(field: AutoSurfaceDefinitionDslField, attribute: DslField): void {\n  if (attribute.name.value === \"default\") {\n    field.defaultValue = parseJsonValueFromTokens(\n      attribute.values,\n      attribute.name.line,\n      attribute.name.column,\n    );\n    return;\n  }\n\n  if (attribute.name.value === \"scopes\") {\n    const scopes = parseJsonValueFromTokens(\n      attribute.values,\n      attribute.name.line,\n      attribute.name.column,\n    );\n    if (\n      !Array.isArray(scopes) ||\n      !scopes.every((scope) => typeof scope === \"string\" && LAYERS.has(scope as AutoSurfaceLayer))\n    ) {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        'scopes must be an array of \"system\", \"package\", \"instance\", or \"user\"',\n        attribute.name.line,\n        attribute.name.column,\n      );\n    }\n    field.scopes = scopes as AutoSurfaceLayer[];\n    return;\n  }\n\n  if (attribute.name.value === \"binding\") {\n    const layerToken = attribute.values[0];\n    if (layerToken?.type !== \"word\" || attribute.values.length < 2) {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        'Expected binding <layer> \"<path>\"',\n        attribute.name.line,\n        attribute.name.column,\n      );\n    }\n    const layer = layerToken.value as AutoSurfaceLayer;\n    if (!LAYERS.has(layer)) {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        `Unsupported binding layer: ${layer}`,\n        layerToken.line,\n        layerToken.column,\n      );\n    }\n    const value = parseJsonValueFromTokens(\n      attribute.values.slice(1),\n      attribute.name.line,\n      layerToken.column,\n    );\n    if (typeof value !== \"string\") {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        \"binding value must be a string\",\n        attribute.name.line,\n        attribute.name.column,\n      );\n    }\n    field.bindings = { ...(field.bindings ?? {}), [layer]: value };\n    return;\n  }\n\n  if (attribute.name.value === \"resource-id\") {\n    const value = parseJsonValueFromTokens(\n      attribute.values,\n      attribute.name.line,\n      attribute.name.column,\n    );\n    if (typeof value !== \"string\") {\n      throw new AutoSurfaceDefinitionDslCompileError(\n        \"resource-id must be a string\",\n        attribute.name.line,\n        attribute.name.column,\n      );\n    }\n    field.explicitId = value;\n    return;\n  }\n\n  if (\n    [\"options\", \"validation\", \"policy\", \"presentations\", \"metadata\"].includes(attribute.name.value)\n  ) {\n    const key = attribute.name.value;\n    const value = parseJsonValueFromTokens(\n      attribute.values,\n      attribute.name.line,\n      attribute.name.column,\n    );\n    if (key === \"options\") {\n      if (!Array.isArray(value)) {\n        throw new AutoSurfaceDefinitionDslCompileError(\n          \"options must be an array\",\n          attribute.name.line,\n          attribute.name.column,\n        );\n      }\n      field.options = value as AutoSurfaceDefinitionDslField[\"options\"];\n    } else if (key === \"validation\") {\n      field.validation = assertRecordValue(\n        value,\n        key,\n        attribute.name.line,\n        attribute.name.column,\n      ) as AutoSurfaceValidationRule;\n    } else if (key === \"policy\") {\n      field.policy = assertRecordValue(\n        value,\n        key,\n        attribute.name.line,\n        attribute.name.column,\n      ) as AutoSurfacePolicy;\n    } else if (key === \"presentations\") {\n      field.presentations = assertRecordValue(\n        value,\n        key,\n        attribute.name.line,\n        attribute.name.column,\n      ) as AutoSurfacePresentations;\n    } else if (key === \"metadata\") {\n      field.metadata = assertRecordValue(value, key, attribute.name.line, attribute.name.column);\n    }\n    return;\n  }\n\n  throw new AutoSurfaceDefinitionDslCompileError(\n    `Unsupported field attribute line: ${attribute.name.value}`,\n    attribute.name.line,\n    attribute.name.column,\n  );\n}\n\nfunction parseIdTitleField(field: DslField, message: string): { id: string; title: string } {\n  const id = field.values[0];\n  const title = field.values[1];\n  if (field.values.length !== 2 || id?.type !== \"word\" || title?.type !== \"string\") {\n    throw new AutoSurfaceDefinitionDslCompileError(message, field.name.line, field.name.column);\n  }\n  return {\n    id: id.value,\n    title: parseDslStringToken(title, parseSharedError),\n  };\n}\n\nfunction parseNumberField(field: DslField, name: string): number {\n  const value = field.values[0];\n  if (\n    field.values.length !== 1 ||\n    value?.type !== \"word\" ||\n    !/^-?\\d+(?:\\.\\d+)?$/.test(value.value)\n  ) {\n    throw new AutoSurfaceDefinitionDslCompileError(\n      `Expected ${name} <number>`,\n      value?.line ?? field.name.line,\n      value?.column ?? field.name.column,\n    );\n  }\n  return Number(value.value);\n}\n\nfunction parseJsonValueFromTokens(tokens: DslToken[], line: number, column: number): unknown {\n  return parseJsonValue(joinDslValues(tokens), line, tokens[0]?.column ?? column);\n}\n\nfunction joinDslValues(tokens: DslToken[]): string {\n  return tokens.map((token) => token.value).join(\" \");\n}\n\nfunction unsupportedField(context: string, field: DslField): AutoSurfaceDefinitionDslCompileError {\n  return new AutoSurfaceDefinitionDslCompileError(\n    `Unsupported ${context} DSL statement: ${field.name.value}`,\n    field.name.line,\n    field.name.column,\n  );\n}\n\nfunction parseSharedError(\n  message: string,\n  line: number,\n  column = 1,\n): AutoSurfaceDefinitionDslCompileError {\n  return new AutoSurfaceDefinitionDslCompileError(message, line, column);\n}\n\nfunction buildDefinitionFiles(group: AutoSurfaceDefinitionDslGroup): Record<string, unknown> {\n  const files: Record<string, unknown> = {};\n  const addFile = (path: string, content: unknown): void => {\n    if (Object.hasOwn(files, path)) {\n      throw new AutoSurfaceDefinitionDslCompileError(`Duplicate generated path: ${path}`, 1);\n    }\n    files[path] = content;\n  };\n\n  addFile(`${group.id}/group.json`, directoryMetaToJson(group));\n  for (const page of group.pages) {\n    addFile(`${group.id}/${page.id}/page.json`, directoryMetaToJson(page));\n    for (const field of page.fields) {\n      addFile(`${group.id}/${page.id}/${field.id}.field.json`, fieldToJson(field));\n    }\n    for (const section of page.sections) {\n      addFile(`${group.id}/${page.id}/${section.id}/section.json`, directoryMetaToJson(section));\n      for (const field of section.fields) {\n        addFile(`${group.id}/${page.id}/${section.id}/${field.id}.field.json`, fieldToJson(field));\n      }\n    }\n  }\n  return files;\n}\n\nfunction directoryMetaToJson(meta: AutoSurfaceDirectoryMeta): Record<string, unknown> {\n  return {\n    title: meta.title,\n    ...(meta.description !== undefined ? { description: meta.description } : {}),\n    ...(meta.order !== undefined ? { order: meta.order } : {}),\n  };\n}\n\nfunction fieldToJson(field: AutoSurfaceDefinitionDslField): Record<string, unknown> {\n  return {\n    ...(field.explicitId !== undefined ? { id: field.explicitId } : {}),\n    type: field.type,\n    title: field.title,\n    ...(field.description !== undefined ? { description: field.description } : {}),\n    ...(field.defaultValue !== undefined ? { defaultValue: field.defaultValue } : {}),\n    ...(field.options !== undefined ? { options: field.options } : {}),\n    ...(field.validation !== undefined ? { validation: field.validation } : {}),\n    ...(field.scopes !== undefined ? { scopes: field.scopes } : {}),\n    ...(field.bindings !== undefined ? { bindings: field.bindings } : {}),\n    ...(field.policy !== undefined ? { policy: field.policy } : {}),\n    ...(field.presentations !== undefined ? { presentations: field.presentations } : {}),\n    ...(field.metadata !== undefined ? { metadata: field.metadata } : {}),\n  };\n}\n\nfunction emitGroup(lines: string[], group: AutoSurfaceDefinitionDslGroup, indent: number): void {\n  lines.push(`${space(indent)}surface-definitions ${group.id} ${quote(group.title)} {`);\n  emitMetaLines(lines, group, indent + 2);\n  for (const page of group.pages) emitPage(lines, page, indent + 2);\n  lines.push(`${space(indent)}}`);\n}\n\nfunction emitPage(lines: string[], page: AutoSurfaceDefinitionDslPage, indent: number): void {\n  lines.push(`${space(indent)}page ${page.id} ${quote(page.title)} {`);\n  emitMetaLines(lines, page, indent + 2);\n  for (const field of page.fields) emitField(lines, field, indent + 2);\n  for (const section of page.sections) emitSection(lines, section, indent + 2);\n  lines.push(`${space(indent)}}`);\n}\n\nfunction emitSection(\n  lines: string[],\n  section: AutoSurfaceDefinitionDslSection,\n  indent: number,\n): void {\n  lines.push(`${space(indent)}section ${section.id} ${quote(section.title)} {`);\n  emitMetaLines(lines, section, indent + 2);\n  for (const field of section.fields) emitField(lines, field, indent + 2);\n  lines.push(`${space(indent)}}`);\n}\n\nfunction emitField(lines: string[], field: AutoSurfaceDefinitionDslField, indent: number): void {\n  lines.push(`${space(indent)}field ${field.id} ${field.type} ${quote(field.title)} {`);\n  emitMetaLines(lines, field, indent + 2);\n  if (field.defaultValue !== undefined) {\n    lines.push(`${space(indent + 2)}default ${formatJson(field.defaultValue)}`);\n  }\n  if (field.scopes !== undefined)\n    lines.push(`${space(indent + 2)}scopes ${formatJson(field.scopes)}`);\n  for (const layer of LAYER_ORDER) {\n    const value = field.bindings?.[layer];\n    if (value !== undefined) lines.push(`${space(indent + 2)}binding ${layer} ${quote(value)}`);\n  }\n  if (field.options !== undefined)\n    lines.push(`${space(indent + 2)}options ${formatJson(field.options)}`);\n  if (field.validation !== undefined) {\n    lines.push(`${space(indent + 2)}validation ${formatJson(field.validation)}`);\n  }\n  if (field.policy !== undefined)\n    lines.push(`${space(indent + 2)}policy ${formatJson(field.policy)}`);\n  if (field.presentations !== undefined) {\n    lines.push(`${space(indent + 2)}presentations ${formatJson(field.presentations)}`);\n  }\n  if (field.metadata !== undefined)\n    lines.push(`${space(indent + 2)}metadata ${formatJson(field.metadata)}`);\n  if (field.explicitId !== undefined) {\n    lines.push(`${space(indent + 2)}resource-id ${quote(field.explicitId)}`);\n  }\n  lines.push(`${space(indent)}}`);\n}\n\nfunction emitMetaLines(\n  lines: string[],\n  node: AutoSurfaceDirectoryMeta | AutoSurfaceDefinitionDslField,\n  indent: number,\n): void {\n  if (node.description !== undefined)\n    lines.push(`${space(indent)}description ${quote(node.description)}`);\n  if (!(\"type\" in node) && node.order !== undefined)\n    lines.push(`${space(indent)}order ${node.order}`);\n}\n\nfunction parseJsonValue(source: string, line: number, column: number): unknown {\n  try {\n    return JSON.parse(source);\n  } catch (error) {\n    throw new AutoSurfaceDefinitionDslCompileError(\n      `Invalid JSON value: ${error instanceof Error ? error.message : String(error)}`,\n      line,\n      column,\n    );\n  }\n}\n\nfunction assertRecordValue(\n  value: unknown,\n  name: string,\n  line: number,\n  column: number,\n): Record<string, unknown> {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new AutoSurfaceDefinitionDslCompileError(`${name} must be an object`, line, column);\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction quote(value: string): string {\n  return JSON.stringify(value);\n}\n\nfunction formatJson(value: unknown): string {\n  return JSON.stringify(value);\n}\n\nfunction space(count: number): string {\n  return \" \".repeat(count);\n}\n"],"mappings":"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"}

package/dist/auto-surface/fragments.cjs

@@ -0,0 +1,177 @@
+let ufo = require("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 || (0, ufo.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
+exports.DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT = DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT;
+exports.DEFAULT_AUTO_SURFACE_VALUES_ROOT = DEFAULT_AUTO_SURFACE_VALUES_ROOT;
+exports.loadAutoSurfaceFragment = loadAutoSurfaceFragment;
+exports.loadAutoSurfaceValueLayer = loadAutoSurfaceValueLayer;

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

@@ -0,0 +1,23 @@
+import { AutoSurfaceDefinitionOwner, AutoSurfaceFragment } from "./types.cjs";
+import { AFSListResult, AFSReadResult } from "@aigne/afs";
+
+//#region src/auto-surface/fragments.d.ts
+declare const DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT = "/.surface/definitions";
+declare const DEFAULT_AUTO_SURFACE_VALUES_ROOT = "/.surface/overrides";
+interface AutoSurfaceFragmentReader {
+  list(path: string): Promise<AFSListResult>;
+  read(path: string): Promise<AFSReadResult>;
+}
+interface LoadAutoSurfaceFragmentOptions {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  root?: string;
+}
+interface LoadAutoSurfaceValueLayerOptions {
+  root?: string;
+}
+declare function loadAutoSurfaceFragment(reader: AutoSurfaceFragmentReader, options: LoadAutoSurfaceFragmentOptions): Promise<AutoSurfaceFragment>;
+declare function loadAutoSurfaceValueLayer(reader: AutoSurfaceFragmentReader, options?: LoadAutoSurfaceValueLayerOptions): Promise<Record<string, unknown>>;
+//#endregion
+export { AutoSurfaceFragmentReader, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer };
+//# sourceMappingURL=fragments.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.cts","names":[],"sources":["../../src/auto-surface/fragments.ts"],"mappings":";;;;cAUa,qCAAA;AAAA,cACA,gCAAA;AAAA,UAEI,yBAAA;EACf,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;EAC5B,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;AAAA;AAAA,UAGb,8BAAA;EACf,MAAA;EACA,KAAA,EAAO,0BAAA;EACP,IAAA;AAAA;AAAA,UAGe,gCAAA;EACf,IAAA;AAAA;AAAA,iBAmBoB,uBAAA,CACpB,MAAA,EAAQ,yBAAA,EACR,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,mBAAA;AAAA,iBAgBW,yBAAA,CACpB,MAAA,EAAQ,yBAAA,EACR,OAAA,GAAS,gCAAA,GACR,OAAA,CAAQ,MAAA"}

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

@@ -0,0 +1,23 @@
+import { AutoSurfaceDefinitionOwner, AutoSurfaceFragment } from "./types.mjs";
+import { AFSListResult, AFSReadResult } from "@aigne/afs";
+
+//#region src/auto-surface/fragments.d.ts
+declare const DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT = "/.surface/definitions";
+declare const DEFAULT_AUTO_SURFACE_VALUES_ROOT = "/.surface/overrides";
+interface AutoSurfaceFragmentReader {
+  list(path: string): Promise<AFSListResult>;
+  read(path: string): Promise<AFSReadResult>;
+}
+interface LoadAutoSurfaceFragmentOptions {
+  source: string;
+  owner: AutoSurfaceDefinitionOwner;
+  root?: string;
+}
+interface LoadAutoSurfaceValueLayerOptions {
+  root?: string;
+}
+declare function loadAutoSurfaceFragment(reader: AutoSurfaceFragmentReader, options: LoadAutoSurfaceFragmentOptions): Promise<AutoSurfaceFragment>;
+declare function loadAutoSurfaceValueLayer(reader: AutoSurfaceFragmentReader, options?: LoadAutoSurfaceValueLayerOptions): Promise<Record<string, unknown>>;
+//#endregion
+export { AutoSurfaceFragmentReader, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer };
+//# sourceMappingURL=fragments.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.mts","names":[],"sources":["../../src/auto-surface/fragments.ts"],"mappings":";;;;cAUa,qCAAA;AAAA,cACA,gCAAA;AAAA,UAEI,yBAAA;EACf,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;EAC5B,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;AAAA;AAAA,UAGb,8BAAA;EACf,MAAA;EACA,KAAA,EAAO,0BAAA;EACP,IAAA;AAAA;AAAA,UAGe,gCAAA;EACf,IAAA;AAAA;AAAA,iBAmBoB,uBAAA,CACpB,MAAA,EAAQ,yBAAA,EACR,OAAA,EAAS,8BAAA,GACR,OAAA,CAAQ,mBAAA;AAAA,iBAgBW,yBAAA,CACpB,MAAA,EAAQ,yBAAA,EACR,OAAA,GAAS,gCAAA,GACR,OAAA,CAAQ,MAAA"}