@aigne/afs 1.11.0-beta → 1.11.0-beta.10

package/dist/meta/validation.mjs

@@ -0,0 +1,77 @@
+import { minimatch } from "minimatch";
+
+//#region src/meta/validation.ts
+/**
+* Validation utilities for AFS Meta System.
+*
+* Provides:
+* - Node constraint validation (required/optional nodes, glob patterns)
+* - Validation result types
+*/
+/**
+* Validate a list of node names against NodesConstraints.
+*
+* @param basePath - Base path for error reporting (e.g., "/project")
+* @param nodeNames - List of node names in the directory
+* @param constraints - NodesConstraints to validate against
+* @returns ValidationResult with valid flag and any errors
+*/
+function validateNodes(basePath, nodeNames, constraints) {
+	const errors = [];
+	if (!constraints) return {
+		valid: true,
+		errors: []
+	};
+	const matchedNodes = /* @__PURE__ */ new Set();
+	if (constraints.required) for (const constraint of constraints.required) {
+		const pattern = constraint.path;
+		let found = false;
+		for (const nodeName of nodeNames) if (matchesPattern(nodeName, pattern)) {
+			found = true;
+			matchedNodes.add(nodeName);
+			break;
+		}
+		if (!found) errors.push({
+			path: `${basePath}/${pattern}`,
+			message: `Required node "${pattern}" not found in ${basePath}`,
+			code: "REQUIRED_NODE_MISSING"
+		});
+	}
+	if (constraints.optional) for (const constraint of constraints.optional) {
+		const pattern = constraint.path;
+		for (const nodeName of nodeNames) if (matchesPattern(nodeName, pattern)) matchedNodes.add(nodeName);
+	}
+	if (constraints.allowOther === false) {
+		for (const nodeName of nodeNames) if (!matchedNodes.has(nodeName)) errors.push({
+			path: `${basePath}/${nodeName}`,
+			message: `Unexpected node "${nodeName}" in ${basePath} (allowOther is false)`,
+			code: "UNEXPECTED_NODE"
+		});
+	}
+	return {
+		valid: errors.length === 0,
+		errors
+	};
+}
+/**
+* Check if a node name matches a pattern (supports glob).
+*/
+function matchesPattern(nodeName, pattern) {
+	if (nodeName === pattern) return true;
+	if (pattern.includes("*")) return minimatch(nodeName, pattern, { dot: true });
+	return false;
+}
+/**
+* Combine multiple ValidationResults into one.
+*/
+function combineValidationResults(...results) {
+	const allErrors = results.flatMap((r) => r.errors);
+	return {
+		valid: allErrors.length === 0,
+		errors: allErrors
+	};
+}
+
+//#endregion
+export { combineValidationResults, validateNodes };
+//# sourceMappingURL=validation.mjs.map

package/dist/meta/validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../src/meta/validation.ts"],"sourcesContent":["/**\n * Validation utilities for AFS Meta System.\n *\n * Provides:\n * - Node constraint validation (required/optional nodes, glob patterns)\n * - Validation result types\n */\n\nimport { minimatch } from \"minimatch\";\nimport type { NodesConstraints, ValidationError, ValidationResult } from \"./type.js\";\n\n/**\n * Validate a list of node names against NodesConstraints.\n *\n * @param basePath - Base path for error reporting (e.g., \"/project\")\n * @param nodeNames - List of node names in the directory\n * @param constraints - NodesConstraints to validate against\n * @returns ValidationResult with valid flag and any errors\n */\nexport function validateNodes(\n  basePath: string,\n  nodeNames: string[],\n  constraints: NodesConstraints | undefined,\n): ValidationResult {\n  const errors: ValidationError[] = [];\n\n  // No constraints means everything is valid\n  if (!constraints) {\n    return { valid: true, errors: [] };\n  }\n\n  const matchedNodes = new Set<string>();\n\n  // Check required nodes\n  if (constraints.required) {\n    for (const constraint of constraints.required) {\n      const pattern = constraint.path;\n      let found = false;\n\n      // Check if any node matches the pattern (could be glob)\n      for (const nodeName of nodeNames) {\n        if (matchesPattern(nodeName, pattern)) {\n          found = true;\n          matchedNodes.add(nodeName);\n          break;\n        }\n      }\n\n      if (!found) {\n        errors.push({\n          path: `${basePath}/${pattern}`,\n          message: `Required node \"${pattern}\" not found in ${basePath}`,\n          code: \"REQUIRED_NODE_MISSING\",\n        });\n      }\n    }\n  }\n\n  // Track optional nodes that match\n  if (constraints.optional) {\n    for (const constraint of constraints.optional) {\n      const pattern = constraint.path;\n      for (const nodeName of nodeNames) {\n        if (matchesPattern(nodeName, pattern)) {\n          matchedNodes.add(nodeName);\n        }\n      }\n    }\n  }\n\n  // Check for unexpected nodes if allowOther is false\n  if (constraints.allowOther === false) {\n    for (const nodeName of nodeNames) {\n      if (!matchedNodes.has(nodeName)) {\n        errors.push({\n          path: `${basePath}/${nodeName}`,\n          message: `Unexpected node \"${nodeName}\" in ${basePath} (allowOther is false)`,\n          code: \"UNEXPECTED_NODE\",\n        });\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Check if a node name matches a pattern (supports glob).\n */\nfunction matchesPattern(nodeName: string, pattern: string): boolean {\n  // Exact match\n  if (nodeName === pattern) {\n    return true;\n  }\n\n  // Glob match\n  if (pattern.includes(\"*\")) {\n    return minimatch(nodeName, pattern, { dot: true });\n  }\n\n  return false;\n}\n\n/**\n * Combine multiple ValidationResults into one.\n */\nexport function combineValidationResults(...results: ValidationResult[]): ValidationResult {\n  const allErrors = results.flatMap((r) => r.errors);\n  return {\n    valid: allErrors.length === 0,\n    errors: allErrors,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cACd,UACA,WACA,aACkB;CAClB,MAAM,SAA4B,EAAE;AAGpC,KAAI,CAAC,YACH,QAAO;EAAE,OAAO;EAAM,QAAQ,EAAE;EAAE;CAGpC,MAAM,+BAAe,IAAI,KAAa;AAGtC,KAAI,YAAY,SACd,MAAK,MAAM,cAAc,YAAY,UAAU;EAC7C,MAAM,UAAU,WAAW;EAC3B,IAAI,QAAQ;AAGZ,OAAK,MAAM,YAAY,UACrB,KAAI,eAAe,UAAU,QAAQ,EAAE;AACrC,WAAQ;AACR,gBAAa,IAAI,SAAS;AAC1B;;AAIJ,MAAI,CAAC,MACH,QAAO,KAAK;GACV,MAAM,GAAG,SAAS,GAAG;GACrB,SAAS,kBAAkB,QAAQ,iBAAiB;GACpD,MAAM;GACP,CAAC;;AAMR,KAAI,YAAY,SACd,MAAK,MAAM,cAAc,YAAY,UAAU;EAC7C,MAAM,UAAU,WAAW;AAC3B,OAAK,MAAM,YAAY,UACrB,KAAI,eAAe,UAAU,QAAQ,CACnC,cAAa,IAAI,SAAS;;AAOlC,KAAI,YAAY,eAAe,OAC7B;OAAK,MAAM,YAAY,UACrB,KAAI,CAAC,aAAa,IAAI,SAAS,CAC7B,QAAO,KAAK;GACV,MAAM,GAAG,SAAS,GAAG;GACrB,SAAS,oBAAoB,SAAS,OAAO,SAAS;GACtD,MAAM;GACP,CAAC;;AAKR,QAAO;EACL,OAAO,OAAO,WAAW;EACzB;EACD;;;;;AAMH,SAAS,eAAe,UAAkB,SAA0B;AAElE,KAAI,aAAa,QACf,QAAO;AAIT,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,UAAU,UAAU,SAAS,EAAE,KAAK,MAAM,CAAC;AAGpD,QAAO;;;;;AAMT,SAAgB,yBAAyB,GAAG,SAA+C;CACzF,MAAM,YAAY,QAAQ,SAAS,MAAM,EAAE,OAAO;AAClD,QAAO;EACL,OAAO,UAAU,WAAW;EAC5B,QAAQ;EACT"}

package/dist/meta/well-known-kinds.cjs

@@ -0,0 +1,228 @@
+
+//#region src/meta/well-known-kinds.ts
+/**
+* Common meta properties that can apply to any node.
+* Providers can extend their kinds with these properties.
+*/
+const commonMetaSchema = {
+	type: "object",
+	properties: {
+		icon: {
+			type: "string",
+			description: "Display icon for this node"
+		},
+		label: {
+			type: "string",
+			description: "Human-readable display name"
+		},
+		color: {
+			type: "string",
+			description: "Display color for this node"
+		},
+		tags: {
+			type: "array",
+			items: { type: "string" },
+			description: "Tags for categorization and filtering"
+		},
+		description: {
+			type: "string",
+			description: "Description of this node"
+		}
+	}
+};
+/**
+* Base node kind - the root of all kinds.
+* All AFS nodes are just "nodes" - there's no file/directory distinction at the kind level.
+* Whether a node has children is determined by childrenCount at runtime.
+*/
+const afsNode = {
+	name: "afs:node",
+	description: "Base kind for all AFS nodes",
+	meta: {
+		type: "object",
+		properties: {
+			...commonMetaSchema.properties,
+			childrenCount: {
+				type: "integer",
+				minimum: 0,
+				description: "Number of children (undefined=unknown, 0=none currently, >0=has children)"
+			},
+			mimeType: {
+				type: "string",
+				description: "MIME type (e.g., text/plain, application/json)"
+			},
+			expanded: {
+				type: "boolean",
+				description: "Whether to show expanded by default in UI"
+			},
+			sortOrder: {
+				type: "string",
+				enum: [
+					"name",
+					"date",
+					"size",
+					"type",
+					"custom"
+				],
+				description: "How to sort children in listings"
+			}
+		}
+	}
+};
+/**
+* Document kind (text, markdown, etc.).
+*/
+const afsDocument = {
+	name: "afs:document",
+	extends: "afs:node",
+	description: "Document (text, markdown, rich text)",
+	meta: {
+		type: "object",
+		properties: {
+			title: {
+				type: "string",
+				description: "Document title"
+			},
+			author: {
+				type: "string",
+				description: "Author of the document"
+			},
+			format: {
+				type: "string",
+				enum: [
+					"text",
+					"markdown",
+					"html",
+					"rst",
+					"asciidoc"
+				],
+				description: "Document format"
+			}
+		}
+	}
+};
+/**
+* Image kind.
+*/
+const afsImage = {
+	name: "afs:image",
+	extends: "afs:node",
+	description: "Image (png, jpg, gif, etc.)",
+	meta: {
+		type: "object",
+		properties: {
+			width: {
+				type: "integer",
+				minimum: 0,
+				description: "Image width in pixels"
+			},
+			height: {
+				type: "integer",
+				minimum: 0,
+				description: "Image height in pixels"
+			},
+			format: {
+				type: "string",
+				enum: [
+					"png",
+					"jpg",
+					"jpeg",
+					"gif",
+					"webp",
+					"svg",
+					"ico",
+					"bmp"
+				],
+				description: "Image format"
+			},
+			alt: {
+				type: "string",
+				description: "Alternative text for accessibility"
+			}
+		}
+	}
+};
+/**
+* Executable or script kind.
+*/
+const afsExecutable = {
+	name: "afs:executable",
+	extends: "afs:node",
+	description: "Executable or script",
+	meta: {
+		type: "object",
+		properties: {
+			runtime: {
+				type: "string",
+				description: "Runtime environment (e.g., node, python, bash)"
+			},
+			command: {
+				type: "string",
+				description: "Command to execute"
+			},
+			inputSchema: {
+				type: "object",
+				description: "JSON Schema describing expected input parameters"
+			},
+			outputSchema: {
+				type: "object",
+				description: "JSON Schema describing expected output format"
+			}
+		}
+	}
+};
+/**
+* Link/symlink kind.
+*/
+const afsLink = {
+	name: "afs:link",
+	extends: "afs:node",
+	description: "Symbolic link or reference to another node",
+	meta: {
+		type: "object",
+		properties: { target: {
+			type: "string",
+			description: "Path to the target node"
+		} }
+	}
+};
+/**
+* All well-known kinds as an array.
+* Note: No separate file/directory kinds - all are nodes.
+* Whether a node has children is determined by childrenCount at runtime.
+*/
+const WELL_KNOWN_KINDS = [
+	afsNode,
+	afsDocument,
+	afsImage,
+	afsExecutable,
+	afsLink
+];
+/**
+* Well-known kinds as a map for quick lookup.
+*/
+const WELL_KNOWN_KINDS_MAP = new Map(WELL_KNOWN_KINDS.map((k) => [k.name, k]));
+/**
+* Get a well-known kind by name.
+*/
+function getWellKnownKind(name) {
+	return WELL_KNOWN_KINDS_MAP.get(name);
+}
+/**
+* Check if a kind name is a well-known kind.
+*/
+function isWellKnownKind(name) {
+	return WELL_KNOWN_KINDS_MAP.has(name);
+}
+
+//#endregion
+exports.WELL_KNOWN_KINDS = WELL_KNOWN_KINDS;
+exports.WELL_KNOWN_KINDS_MAP = WELL_KNOWN_KINDS_MAP;
+exports.afsDocument = afsDocument;
+exports.afsExecutable = afsExecutable;
+exports.afsImage = afsImage;
+exports.afsLink = afsLink;
+exports.afsNode = afsNode;
+exports.commonMetaSchema = commonMetaSchema;
+exports.getWellKnownKind = getWellKnownKind;
+exports.isWellKnownKind = isWellKnownKind;

package/dist/meta/well-known-kinds.d.cts

@@ -0,0 +1,52 @@
+import { JSONSchema7 } from "../node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.cjs";
+import { KindSchema } from "./type.cjs";
+
+//#region src/meta/well-known-kinds.d.ts
+/**
+ * Common meta properties that can apply to any node.
+ * Providers can extend their kinds with these properties.
+ */
+declare const commonMetaSchema: JSONSchema7;
+/**
+ * Base node kind - the root of all kinds.
+ * All AFS nodes are just "nodes" - there's no file/directory distinction at the kind level.
+ * Whether a node has children is determined by childrenCount at runtime.
+ */
+declare const afsNode: KindSchema;
+/**
+ * Document kind (text, markdown, etc.).
+ */
+declare const afsDocument: KindSchema;
+/**
+ * Image kind.
+ */
+declare const afsImage: KindSchema;
+/**
+ * Executable or script kind.
+ */
+declare const afsExecutable: KindSchema;
+/**
+ * Link/symlink kind.
+ */
+declare const afsLink: KindSchema;
+/**
+ * All well-known kinds as an array.
+ * Note: No separate file/directory kinds - all are nodes.
+ * Whether a node has children is determined by childrenCount at runtime.
+ */
+declare const WELL_KNOWN_KINDS: KindSchema[];
+/**
+ * Well-known kinds as a map for quick lookup.
+ */
+declare const WELL_KNOWN_KINDS_MAP: Map<string, KindSchema>;
+/**
+ * Get a well-known kind by name.
+ */
+declare function getWellKnownKind(name: string): KindSchema | undefined;
+/**
+ * Check if a kind name is a well-known kind.
+ */
+declare function isWellKnownKind(name: string): boolean;
+//#endregion
+export { WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, afsDocument, afsExecutable, afsImage, afsLink, afsNode, commonMetaSchema, getWellKnownKind, isWellKnownKind };
+//# sourceMappingURL=well-known-kinds.d.cts.map

package/dist/meta/well-known-kinds.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-kinds.d.cts","names":[],"sources":["../../src/meta/well-known-kinds.ts"],"mappings":";;;;;;;;cAoBa,gBAAA,EAAkB,WAAA;;;;;AAmH/B;cA1Ea,OAAA,EAAS,UAAA;;;;cA4CT,WAAA,EAAa,UAAA;;;;cA8Bb,QAAA,EAAU,UAAA;AAuEvB;;;AAAA,cAlCa,aAAA,EAAe,UAAA;;AA2D5B;;cAzBa,OAAA,EAAS,UAAA;;;AAoCtB;;;cAXa,gBAAA,EAAkB,UAAA;;AAkB/B;;cAPa,oBAAA,EAAsB,GAAA,SAAY,UAAA;;;AAc/C;iBAPgB,gBAAA,CAAiB,IAAA,WAAe,UAAA;;;;iBAOhC,eAAA,CAAgB,IAAA"}

package/dist/meta/well-known-kinds.d.mts

@@ -0,0 +1,52 @@
+import { JSONSchema7 } from "../node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.mjs";
+import { KindSchema } from "./type.mjs";
+
+//#region src/meta/well-known-kinds.d.ts
+/**
+ * Common meta properties that can apply to any node.
+ * Providers can extend their kinds with these properties.
+ */
+declare const commonMetaSchema: JSONSchema7;
+/**
+ * Base node kind - the root of all kinds.
+ * All AFS nodes are just "nodes" - there's no file/directory distinction at the kind level.
+ * Whether a node has children is determined by childrenCount at runtime.
+ */
+declare const afsNode: KindSchema;
+/**
+ * Document kind (text, markdown, etc.).
+ */
+declare const afsDocument: KindSchema;
+/**
+ * Image kind.
+ */
+declare const afsImage: KindSchema;
+/**
+ * Executable or script kind.
+ */
+declare const afsExecutable: KindSchema;
+/**
+ * Link/symlink kind.
+ */
+declare const afsLink: KindSchema;
+/**
+ * All well-known kinds as an array.
+ * Note: No separate file/directory kinds - all are nodes.
+ * Whether a node has children is determined by childrenCount at runtime.
+ */
+declare const WELL_KNOWN_KINDS: KindSchema[];
+/**
+ * Well-known kinds as a map for quick lookup.
+ */
+declare const WELL_KNOWN_KINDS_MAP: Map<string, KindSchema>;
+/**
+ * Get a well-known kind by name.
+ */
+declare function getWellKnownKind(name: string): KindSchema | undefined;
+/**
+ * Check if a kind name is a well-known kind.
+ */
+declare function isWellKnownKind(name: string): boolean;
+//#endregion
+export { WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, afsDocument, afsExecutable, afsImage, afsLink, afsNode, commonMetaSchema, getWellKnownKind, isWellKnownKind };
+//# sourceMappingURL=well-known-kinds.d.mts.map

package/dist/meta/well-known-kinds.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-kinds.d.mts","names":[],"sources":["../../src/meta/well-known-kinds.ts"],"mappings":";;;;;;;;cAoBa,gBAAA,EAAkB,WAAA;;;;;AAmH/B;cA1Ea,OAAA,EAAS,UAAA;;;;cA4CT,WAAA,EAAa,UAAA;;;;cA8Bb,QAAA,EAAU,UAAA;AAuEvB;;;AAAA,cAlCa,aAAA,EAAe,UAAA;;AA2D5B;;cAzBa,OAAA,EAAS,UAAA;;;AAoCtB;;;cAXa,gBAAA,EAAkB,UAAA;;AAkB/B;;cAPa,oBAAA,EAAsB,GAAA,SAAY,UAAA;;;AAc/C;iBAPgB,gBAAA,CAAiB,IAAA,WAAe,UAAA;;;;iBAOhC,eAAA,CAAgB,IAAA"}

package/dist/meta/well-known-kinds.mjs

@@ -0,0 +1,219 @@
+//#region src/meta/well-known-kinds.ts
+/**
+* Common meta properties that can apply to any node.
+* Providers can extend their kinds with these properties.
+*/
+const commonMetaSchema = {
+	type: "object",
+	properties: {
+		icon: {
+			type: "string",
+			description: "Display icon for this node"
+		},
+		label: {
+			type: "string",
+			description: "Human-readable display name"
+		},
+		color: {
+			type: "string",
+			description: "Display color for this node"
+		},
+		tags: {
+			type: "array",
+			items: { type: "string" },
+			description: "Tags for categorization and filtering"
+		},
+		description: {
+			type: "string",
+			description: "Description of this node"
+		}
+	}
+};
+/**
+* Base node kind - the root of all kinds.
+* All AFS nodes are just "nodes" - there's no file/directory distinction at the kind level.
+* Whether a node has children is determined by childrenCount at runtime.
+*/
+const afsNode = {
+	name: "afs:node",
+	description: "Base kind for all AFS nodes",
+	meta: {
+		type: "object",
+		properties: {
+			...commonMetaSchema.properties,
+			childrenCount: {
+				type: "integer",
+				minimum: 0,
+				description: "Number of children (undefined=unknown, 0=none currently, >0=has children)"
+			},
+			mimeType: {
+				type: "string",
+				description: "MIME type (e.g., text/plain, application/json)"
+			},
+			expanded: {
+				type: "boolean",
+				description: "Whether to show expanded by default in UI"
+			},
+			sortOrder: {
+				type: "string",
+				enum: [
+					"name",
+					"date",
+					"size",
+					"type",
+					"custom"
+				],
+				description: "How to sort children in listings"
+			}
+		}
+	}
+};
+/**
+* Document kind (text, markdown, etc.).
+*/
+const afsDocument = {
+	name: "afs:document",
+	extends: "afs:node",
+	description: "Document (text, markdown, rich text)",
+	meta: {
+		type: "object",
+		properties: {
+			title: {
+				type: "string",
+				description: "Document title"
+			},
+			author: {
+				type: "string",
+				description: "Author of the document"
+			},
+			format: {
+				type: "string",
+				enum: [
+					"text",
+					"markdown",
+					"html",
+					"rst",
+					"asciidoc"
+				],
+				description: "Document format"
+			}
+		}
+	}
+};
+/**
+* Image kind.
+*/
+const afsImage = {
+	name: "afs:image",
+	extends: "afs:node",
+	description: "Image (png, jpg, gif, etc.)",
+	meta: {
+		type: "object",
+		properties: {
+			width: {
+				type: "integer",
+				minimum: 0,
+				description: "Image width in pixels"
+			},
+			height: {
+				type: "integer",
+				minimum: 0,
+				description: "Image height in pixels"
+			},
+			format: {
+				type: "string",
+				enum: [
+					"png",
+					"jpg",
+					"jpeg",
+					"gif",
+					"webp",
+					"svg",
+					"ico",
+					"bmp"
+				],
+				description: "Image format"
+			},
+			alt: {
+				type: "string",
+				description: "Alternative text for accessibility"
+			}
+		}
+	}
+};
+/**
+* Executable or script kind.
+*/
+const afsExecutable = {
+	name: "afs:executable",
+	extends: "afs:node",
+	description: "Executable or script",
+	meta: {
+		type: "object",
+		properties: {
+			runtime: {
+				type: "string",
+				description: "Runtime environment (e.g., node, python, bash)"
+			},
+			command: {
+				type: "string",
+				description: "Command to execute"
+			},
+			inputSchema: {
+				type: "object",
+				description: "JSON Schema describing expected input parameters"
+			},
+			outputSchema: {
+				type: "object",
+				description: "JSON Schema describing expected output format"
+			}
+		}
+	}
+};
+/**
+* Link/symlink kind.
+*/
+const afsLink = {
+	name: "afs:link",
+	extends: "afs:node",
+	description: "Symbolic link or reference to another node",
+	meta: {
+		type: "object",
+		properties: { target: {
+			type: "string",
+			description: "Path to the target node"
+		} }
+	}
+};
+/**
+* All well-known kinds as an array.
+* Note: No separate file/directory kinds - all are nodes.
+* Whether a node has children is determined by childrenCount at runtime.
+*/
+const WELL_KNOWN_KINDS = [
+	afsNode,
+	afsDocument,
+	afsImage,
+	afsExecutable,
+	afsLink
+];
+/**
+* Well-known kinds as a map for quick lookup.
+*/
+const WELL_KNOWN_KINDS_MAP = new Map(WELL_KNOWN_KINDS.map((k) => [k.name, k]));
+/**
+* Get a well-known kind by name.
+*/
+function getWellKnownKind(name) {
+	return WELL_KNOWN_KINDS_MAP.get(name);
+}
+/**
+* Check if a kind name is a well-known kind.
+*/
+function isWellKnownKind(name) {
+	return WELL_KNOWN_KINDS_MAP.has(name);
+}
+
+//#endregion
+export { WELL_KNOWN_KINDS, WELL_KNOWN_KINDS_MAP, afsDocument, afsExecutable, afsImage, afsLink, afsNode, commonMetaSchema, getWellKnownKind, isWellKnownKind };
+//# sourceMappingURL=well-known-kinds.mjs.map

package/dist/meta/well-known-kinds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-kinds.mjs","names":[],"sources":["../../src/meta/well-known-kinds.ts"],"sourcesContent":["/**\n * Well-known Kind definitions for @aigne/afs core package.\n *\n * These are common types that all providers can use or extend.\n *\n * Naming convention:\n * - Well-known: \"afs:*\" (defined here)\n * - Provider-specific: \"{provider}:{kind}\" (e.g., \"chamber:project\")\n */\n\nimport type { JSONSchema7, KindSchema } from \"./type.js\";\n\n// =============================================================================\n// Common JSON Schema definitions (reusable across kinds)\n// =============================================================================\n\n/**\n * Common meta properties that can apply to any node.\n * Providers can extend their kinds with these properties.\n */\nexport const commonMetaSchema: JSONSchema7 = {\n  type: \"object\",\n  properties: {\n    /** Display icon (path, URL, or icon identifier like \"folder\", \"file-text\") */\n    icon: {\n      type: \"string\",\n      description: \"Display icon for this node\",\n    },\n    /** Display label (alternative to file/directory name) */\n    label: {\n      type: \"string\",\n      description: \"Human-readable display name\",\n    },\n    /** Color for UI display (hex, rgb, or named color) */\n    color: {\n      type: \"string\",\n      description: \"Display color for this node\",\n    },\n    /** Tags for categorization */\n    tags: {\n      type: \"array\",\n      items: { type: \"string\" },\n      description: \"Tags for categorization and filtering\",\n    },\n    /** Human-readable description */\n    description: {\n      type: \"string\",\n      description: \"Description of this node\",\n    },\n  },\n};\n\n// =============================================================================\n// Well-known Kind Schemas\n// =============================================================================\n\n/**\n * Base node kind - the root of all kinds.\n * All AFS nodes are just \"nodes\" - there's no file/directory distinction at the kind level.\n * Whether a node has children is determined by childrenCount at runtime.\n */\nexport const afsNode: KindSchema = {\n  name: \"afs:node\",\n  description: \"Base kind for all AFS nodes\",\n  meta: {\n    type: \"object\",\n    properties: {\n      ...commonMetaSchema.properties,\n      /**\n       * Number of children this node has.\n       * - undefined: unknown (not yet loaded)\n       * - 0: no children currently (but may have children in the future)\n       * - >0: has children\n       *\n       * Note: This is a runtime value. There is no file/directory distinction -\n       * all nodes can potentially have children.\n       */\n      childrenCount: {\n        type: \"integer\",\n        minimum: 0,\n        description: \"Number of children (undefined=unknown, 0=none currently, >0=has children)\",\n      },\n      /** MIME type (for content nodes) */\n      mimeType: {\n        type: \"string\",\n        description: \"MIME type (e.g., text/plain, application/json)\",\n      },\n      /** Whether this node should be shown expanded by default in UI */\n      expanded: {\n        type: \"boolean\",\n        description: \"Whether to show expanded by default in UI\",\n      },\n      /** Sort order for children */\n      sortOrder: {\n        type: \"string\",\n        enum: [\"name\", \"date\", \"size\", \"type\", \"custom\"],\n        description: \"How to sort children in listings\",\n      },\n    },\n  },\n};\n\n/**\n * Document kind (text, markdown, etc.).\n */\nexport const afsDocument: KindSchema = {\n  name: \"afs:document\",\n  extends: \"afs:node\",\n  description: \"Document (text, markdown, rich text)\",\n  meta: {\n    type: \"object\",\n    properties: {\n      /** Document title */\n      title: {\n        type: \"string\",\n        description: \"Document title\",\n      },\n      /** Author name */\n      author: {\n        type: \"string\",\n        description: \"Author of the document\",\n      },\n      /** Document format */\n      format: {\n        type: \"string\",\n        enum: [\"text\", \"markdown\", \"html\", \"rst\", \"asciidoc\"],\n        description: \"Document format\",\n      },\n    },\n  },\n};\n\n/**\n * Image kind.\n */\nexport const afsImage: KindSchema = {\n  name: \"afs:image\",\n  extends: \"afs:node\",\n  description: \"Image (png, jpg, gif, etc.)\",\n  meta: {\n    type: \"object\",\n    properties: {\n      /** Image width in pixels */\n      width: {\n        type: \"integer\",\n        minimum: 0,\n        description: \"Image width in pixels\",\n      },\n      /** Image height in pixels */\n      height: {\n        type: \"integer\",\n        minimum: 0,\n        description: \"Image height in pixels\",\n      },\n      /** Image format */\n      format: {\n        type: \"string\",\n        enum: [\"png\", \"jpg\", \"jpeg\", \"gif\", \"webp\", \"svg\", \"ico\", \"bmp\"],\n        description: \"Image format\",\n      },\n      /** Alternative text for accessibility */\n      alt: {\n        type: \"string\",\n        description: \"Alternative text for accessibility\",\n      },\n    },\n  },\n};\n\n/**\n * Executable or script kind.\n */\nexport const afsExecutable: KindSchema = {\n  name: \"afs:executable\",\n  extends: \"afs:node\",\n  description: \"Executable or script\",\n  meta: {\n    type: \"object\",\n    properties: {\n      /** Runtime environment */\n      runtime: {\n        type: \"string\",\n        description: \"Runtime environment (e.g., node, python, bash)\",\n      },\n      /** Entry command or script */\n      command: {\n        type: \"string\",\n        description: \"Command to execute\",\n      },\n      /** Input schema (JSON Schema format) */\n      inputSchema: {\n        type: \"object\",\n        description: \"JSON Schema describing expected input parameters\",\n      },\n      /** Output schema (JSON Schema format) */\n      outputSchema: {\n        type: \"object\",\n        description: \"JSON Schema describing expected output format\",\n      },\n    },\n  },\n};\n\n/**\n * Link/symlink kind.\n */\nexport const afsLink: KindSchema = {\n  name: \"afs:link\",\n  extends: \"afs:node\",\n  description: \"Symbolic link or reference to another node\",\n  meta: {\n    type: \"object\",\n    properties: {\n      /** Target path */\n      target: {\n        type: \"string\",\n        description: \"Path to the target node\",\n      },\n    },\n  },\n};\n\n// =============================================================================\n// Registry\n// =============================================================================\n\n/**\n * All well-known kinds as an array.\n * Note: No separate file/directory kinds - all are nodes.\n * Whether a node has children is determined by childrenCount at runtime.\n */\nexport const WELL_KNOWN_KINDS: KindSchema[] = [\n  afsNode,\n  afsDocument,\n  afsImage,\n  afsExecutable,\n  afsLink,\n];\n\n/**\n * Well-known kinds as a map for quick lookup.\n */\nexport const WELL_KNOWN_KINDS_MAP: Map<string, KindSchema> = new Map(\n  WELL_KNOWN_KINDS.map((k) => [k.name, k]),\n);\n\n/**\n * Get a well-known kind by name.\n */\nexport function getWellKnownKind(name: string): KindSchema | undefined {\n  return WELL_KNOWN_KINDS_MAP.get(name);\n}\n\n/**\n * Check if a kind name is a well-known kind.\n */\nexport function isWellKnownKind(name: string): boolean {\n  return WELL_KNOWN_KINDS_MAP.has(name);\n}\n"],"mappings":";;;;;AAoBA,MAAa,mBAAgC;CAC3C,MAAM;CACN,YAAY;EAEV,MAAM;GACJ,MAAM;GACN,aAAa;GACd;EAED,OAAO;GACL,MAAM;GACN,aAAa;GACd;EAED,OAAO;GACL,MAAM;GACN,aAAa;GACd;EAED,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,UAAU;GACzB,aAAa;GACd;EAED,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACF;CACF;;;;;;AAWD,MAAa,UAAsB;CACjC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,MAAM;EACN,YAAY;GACV,GAAG,iBAAiB;GAUpB,eAAe;IACb,MAAM;IACN,SAAS;IACT,aAAa;IACd;GAED,UAAU;IACR,MAAM;IACN,aAAa;IACd;GAED,UAAU;IACR,MAAM;IACN,aAAa;IACd;GAED,WAAW;IACT,MAAM;IACN,MAAM;KAAC;KAAQ;KAAQ;KAAQ;KAAQ;KAAS;IAChD,aAAa;IACd;GACF;EACF;CACF;;;;AAKD,MAAa,cAA0B;CACrC,MAAM;CACN,SAAS;CACT,aAAa;CACb,MAAM;EACJ,MAAM;EACN,YAAY;GAEV,OAAO;IACL,MAAM;IACN,aAAa;IACd;GAED,QAAQ;IACN,MAAM;IACN,aAAa;IACd;GAED,QAAQ;IACN,MAAM;IACN,MAAM;KAAC;KAAQ;KAAY;KAAQ;KAAO;KAAW;IACrD,aAAa;IACd;GACF;EACF;CACF;;;;AAKD,MAAa,WAAuB;CAClC,MAAM;CACN,SAAS;CACT,aAAa;CACb,MAAM;EACJ,MAAM;EACN,YAAY;GAEV,OAAO;IACL,MAAM;IACN,SAAS;IACT,aAAa;IACd;GAED,QAAQ;IACN,MAAM;IACN,SAAS;IACT,aAAa;IACd;GAED,QAAQ;IACN,MAAM;IACN,MAAM;KAAC;KAAO;KAAO;KAAQ;KAAO;KAAQ;KAAO;KAAO;KAAM;IAChE,aAAa;IACd;GAED,KAAK;IACH,MAAM;IACN,aAAa;IACd;GACF;EACF;CACF;;;;AAKD,MAAa,gBAA4B;CACvC,MAAM;CACN,SAAS;CACT,aAAa;CACb,MAAM;EACJ,MAAM;EACN,YAAY;GAEV,SAAS;IACP,MAAM;IACN,aAAa;IACd;GAED,SAAS;IACP,MAAM;IACN,aAAa;IACd;GAED,aAAa;IACX,MAAM;IACN,aAAa;IACd;GAED,cAAc;IACZ,MAAM;IACN,aAAa;IACd;GACF;EACF;CACF;;;;AAKD,MAAa,UAAsB;CACjC,MAAM;CACN,SAAS;CACT,aAAa;CACb,MAAM;EACJ,MAAM;EACN,YAAY,EAEV,QAAQ;GACN,MAAM;GACN,aAAa;GACd,EACF;EACF;CACF;;;;;;AAWD,MAAa,mBAAiC;CAC5C;CACA;CACA;CACA;CACA;CACD;;;;AAKD,MAAa,uBAAgD,IAAI,IAC/D,iBAAiB,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CACzC;;;;AAKD,SAAgB,iBAAiB,MAAsC;AACrE,QAAO,qBAAqB,IAAI,KAAK;;;;;AAMvC,SAAgB,gBAAgB,MAAuB;AACrD,QAAO,qBAAqB,IAAI,KAAK"}