@warlock.js/core 5.30.0 → 5.31.0

package/esm/cli/commands/generate/utils/endpoint-schema.mjs

@@ -0,0 +1,137 @@
+//#region ../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The non-null JSON types a node allows, and whether `null` is one of them. */
+function typesOf(node) {
+	const variants = node.anyOf ?? node.oneOf;
+	if (variants) {
+		const all = variants.map(typesOf);
+		return {
+			types: all.flatMap((entry) => entry.types),
+			nullable: all.some((entry) => entry.nullable)
+		};
+	}
+	const raw = node.type === void 0 ? [] : Array.isArray(node.type) ? node.type : [node.type];
+	return {
+		types: raw.filter((type) => type !== "null"),
+		nullable: raw.includes("null")
+	};
+}
+function primaryNode(node) {
+	const variants = node.anyOf ?? node.oneOf;
+	if (!variants) return node;
+	return variants.find((variant) => !typesOf(variant).types.every((type) => type === "null")) ?? node;
+}
+/** A file upload: JSON cannot carry it, so it has no sample and no cast. */
+function isFileNode(node) {
+	return node.format === "binary" || node.contentEncoding === "binary" || node.contentMediaType !== void 0;
+}
+const CASTS = {
+	string: "string",
+	integer: "int",
+	number: "number",
+	boolean: "boolean",
+	array: "array",
+	object: "object"
+};
+/** `"string"` or `"number"` when every enum value has that type. */
+function enumValuesType(node) {
+	if (!node.enum || node.enum.length === 0) return void 0;
+	if (node.enum.every((value) => typeof value === "string")) return "string";
+	if (node.enum.every((value) => typeof value === "number")) return "number";
+}
+/** The resource cast for a field, with `?` when the value may be null or absent. */
+function castForNode(node, required) {
+	const primary = primaryNode(node);
+	if (isFileNode(primary)) return void 0;
+	const { types, nullable } = typesOf(node);
+	const enumType = enumValuesType(primary);
+	const only = types.length === 1 ? types[0] : void 0;
+	const base = enumType ?? (only === void 0 ? void 0 : CASTS[only]);
+	if (base === void 0) return void 0;
+	if (base === "string" && (primary.format === "date-time" || primary.format === "date")) return nullable || !required ? "date?" : "date";
+	return nullable || !required ? `${base}?` : base;
+}
+/**
+* A deterministic value that satisfies `node`, or `undefined` when JSON cannot
+* express one. `seed` keeps values readable and stable between runs.
+*/
+function sampleForNode(node, seed) {
+	const primary = primaryNode(node);
+	if (isFileNode(primary)) return void 0;
+	if (primary.const !== void 0) return primary.const;
+	if (primary.enum && primary.enum.length > 0) return primary.enum[0];
+	const { types } = typesOf(node);
+	switch (types[0]) {
+		case "string": return sampleString(primary, seed);
+		case "integer": return sampleNumber(primary, true);
+		case "number": return sampleNumber(primary, false);
+		case "boolean": return true;
+		case "array": {
+			const count = primary.minItems ?? 0;
+			const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : void 0;
+			if (count > 0 && item === void 0) return void 0;
+			return Array.from({ length: count }, () => item);
+		}
+		case "object": return sampleObject(primary, seed);
+		default: return;
+	}
+}
+function sampleNumber(node, integer) {
+	const lower = node.minimum ?? (node.exclusiveMinimum !== void 0 ? node.exclusiveMinimum + 1 : 1);
+	let value = integer ? Math.ceil(lower) : lower;
+	if (node.maximum !== void 0 && value > node.maximum) value = node.maximum;
+	return value;
+}
+function sampleString(node, seed) {
+	switch (node.format) {
+		case "email": return `${seed.replace(/[^a-z0-9]/gi, "").toLowerCase() || "user"}@example.test`;
+		case "uri":
+		case "url": return `https://example.test/${seed}`;
+		case "uuid": return "00000000-0000-4000-8000-000000000001";
+		case "date-time": return "2026-01-01T00:00:00.000Z";
+		case "date": return "2026-01-01";
+		default: break;
+	}
+	const minLength = node.minLength ?? 1;
+	let value = `${seed} sample`;
+	while (value.length < minLength) value += " sample";
+	return node.maxLength !== void 0 ? value.slice(0, Math.max(node.maxLength, minLength)) : value;
+}
+function sampleObject(node, seed) {
+	const required = new Set(node.required ?? []);
+	const result = {};
+	for (const [key, child] of Object.entries(node.properties ?? {})) {
+		const value = sampleForNode(child, key);
+		if (value === void 0) {
+			if (required.has(key)) return void 0;
+			continue;
+		}
+		result[key] = value;
+	}
+	return result;
+}
+/** Read the top-level fields of a request schema's JSON Schema. */
+function readEndpointFields(jsonSchema) {
+	if (!isRecord(jsonSchema)) return [];
+	const node = jsonSchema;
+	const required = new Set(node.required ?? []);
+	return Object.entries(node.properties ?? {}).map(([name, child]) => {
+		const isRequired = required.has(name);
+		const cast = castForNode(child, isRequired);
+		const sample = sampleForNode(child, name);
+		const field = {
+			name,
+			required: isRequired,
+			comparable: sample !== void 0 && cast !== void 0 && !cast.startsWith("date") && !cast.startsWith("object")
+		};
+		if (cast !== void 0) field.cast = cast;
+		if (sample !== void 0) field.sample = sample;
+		return field;
+	});
+}
+
+//#endregion
+export { readEndpointFields };
+//# sourceMappingURL=endpoint-schema.mjs.map

package/esm/cli/commands/generate/utils/endpoint-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-schema.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts"],"sourcesContent":["/**\n * What the endpoint generator needs to know about a request schema, read\n * from the JSON Schema seal produces (`validator.toJsonSchema()`).\n *\n * Kept free of seal imports: it works on the plain JSON Schema object, so it\n * is unit-testable and survives seal's internals changing.\n */\n\n/** The JSON Schema subset this module reads. */\nexport type JsonSchemaNode = {\n  type?: string | string[];\n  format?: string;\n  enum?: unknown[];\n  const?: unknown;\n  minimum?: number;\n  exclusiveMinimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  minItems?: number;\n  items?: JsonSchemaNode;\n  properties?: Record<string, JsonSchemaNode>;\n  required?: string[];\n  anyOf?: JsonSchemaNode[];\n  oneOf?: JsonSchemaNode[];\n  contentMediaType?: string;\n  contentEncoding?: string;\n};\n\n/** One top-level field of the request schema. */\nexport type EndpointField = {\n  name: string;\n  required: boolean;\n  /** The resource cast for this field, or `undefined` when it has no plain JSON shape (a file). */\n  cast?: string;\n  /** A deterministic valid value, or `undefined` when JSON cannot carry one (a file). */\n  sample?: unknown;\n  /**\n   * Whether the response echoes the sample unchanged, so a generated test can\n   * compare it. Dates are parsed and re-cast, so they are not comparable.\n   */\n  comparable: boolean;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The non-null JSON types a node allows, and whether `null` is one of them. */\nfunction typesOf(node: JsonSchemaNode): { types: string[]; nullable: boolean } {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (variants) {\n    const all = variants.map(typesOf);\n\n    return {\n      types: all.flatMap((entry) => entry.types),\n      nullable: all.some((entry) => entry.nullable),\n    };\n  }\n\n  const raw = node.type === undefined ? [] : Array.isArray(node.type) ? node.type : [node.type];\n\n  return { types: raw.filter((type) => type !== \"null\"), nullable: raw.includes(\"null\") };\n}\n\nfunction primaryNode(node: JsonSchemaNode): JsonSchemaNode {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (!variants) return node;\n\n  return (\n    variants.find((variant) => !typesOf(variant).types.every((type) => type === \"null\")) ?? node\n  );\n}\n\n/** A file upload: JSON cannot carry it, so it has no sample and no cast. */\nfunction isFileNode(node: JsonSchemaNode): boolean {\n  return (\n    node.format === \"binary\" ||\n    node.contentEncoding === \"binary\" ||\n    node.contentMediaType !== undefined\n  );\n}\n\nconst CASTS: Record<string, string> = {\n  string: \"string\",\n  integer: \"int\",\n  number: \"number\",\n  boolean: \"boolean\",\n  array: \"array\",\n  object: \"object\",\n};\n\n/** `\"string\"` or `\"number\"` when every enum value has that type. */\nfunction enumValuesType(node: JsonSchemaNode): string | undefined {\n  if (!node.enum || node.enum.length === 0) return undefined;\n  if (node.enum.every((value) => typeof value === \"string\")) return \"string\";\n  if (node.enum.every((value) => typeof value === \"number\")) return \"number\";\n\n  return undefined;\n}\n\n/** The resource cast for a field, with `?` when the value may be null or absent. */\nexport function castForNode(node: JsonSchemaNode, required: boolean): string | undefined {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n\n  const { types, nullable } = typesOf(node);\n  const enumType = enumValuesType(primary);\n  const only = types.length === 1 ? types[0] : undefined;\n  const base = enumType ?? (only === undefined ? undefined : CASTS[only]);\n\n  if (base === undefined) return undefined;\n\n  if (base === \"string\" && (primary.format === \"date-time\" || primary.format === \"date\")) {\n    return nullable || !required ? \"date?\" : \"date\";\n  }\n\n  return nullable || !required ? `${base}?` : base;\n}\n\n/**\n * A deterministic value that satisfies `node`, or `undefined` when JSON cannot\n * express one. `seed` keeps values readable and stable between runs.\n */\nexport function sampleForNode(node: JsonSchemaNode, seed: string): unknown {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n  if (primary.const !== undefined) return primary.const;\n  if (primary.enum && primary.enum.length > 0) return primary.enum[0];\n\n  const { types } = typesOf(node);\n  const type = types[0];\n\n  switch (type) {\n    case \"string\":\n      return sampleString(primary, seed);\n    case \"integer\":\n      return sampleNumber(primary, true);\n    case \"number\":\n      return sampleNumber(primary, false);\n    case \"boolean\":\n      return true;\n    case \"array\": {\n      const count = primary.minItems ?? 0;\n      const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : undefined;\n\n      if (count > 0 && item === undefined) return undefined;\n\n      return Array.from({ length: count }, () => item);\n    }\n    case \"object\":\n      return sampleObject(primary, seed);\n    default:\n      return undefined;\n  }\n}\n\nfunction sampleNumber(node: JsonSchemaNode, integer: boolean): number {\n  const lower =\n    node.minimum ?? (node.exclusiveMinimum !== undefined ? node.exclusiveMinimum + 1 : 1);\n  let value = integer ? Math.ceil(lower) : lower;\n\n  if (node.maximum !== undefined && value > node.maximum) value = node.maximum;\n\n  return value;\n}\n\nfunction sampleString(node: JsonSchemaNode, seed: string): string {\n  switch (node.format) {\n    case \"email\":\n      return `${seed.replace(/[^a-z0-9]/gi, \"\").toLowerCase() || \"user\"}@example.test`;\n    case \"uri\":\n    case \"url\":\n      return `https://example.test/${seed}`;\n    case \"uuid\":\n      return \"00000000-0000-4000-8000-000000000001\";\n    case \"date-time\":\n      return \"2026-01-01T00:00:00.000Z\";\n    case \"date\":\n      return \"2026-01-01\";\n    default:\n      break;\n  }\n\n  const minLength = node.minLength ?? 1;\n  let value = `${seed} sample`;\n\n  while (value.length < minLength) value += \" sample\";\n\n  return node.maxLength !== undefined ? value.slice(0, Math.max(node.maxLength, minLength)) : value;\n}\n\nfunction sampleObject(node: JsonSchemaNode, seed: string): Record<string, unknown> | undefined {\n  const required = new Set(node.required ?? []);\n  const result: Record<string, unknown> = {};\n\n  for (const [key, child] of Object.entries(node.properties ?? {})) {\n    const value = sampleForNode(child, key);\n\n    if (value === undefined) {\n      if (required.has(key)) return undefined;\n      continue;\n    }\n\n    result[key] = value;\n  }\n\n  void seed;\n\n  return result;\n}\n\n/** Read the top-level fields of a request schema's JSON Schema. */\nexport function readEndpointFields(jsonSchema: unknown): EndpointField[] {\n  if (!isRecord(jsonSchema)) return [];\n\n  const node = jsonSchema as JsonSchemaNode;\n  const required = new Set(node.required ?? []);\n\n  return Object.entries(node.properties ?? {}).map(([name, child]) => {\n    const isRequired = required.has(name);\n    const cast = castForNode(child, isRequired);\n    const sample = sampleForNode(child, name);\n    const field: EndpointField = {\n      name,\n      required: isRequired,\n      comparable:\n        sample !== undefined &&\n        cast !== undefined &&\n        !cast.startsWith(\"date\") &&\n        !cast.startsWith(\"object\"),\n    };\n\n    if (cast !== undefined) field.cast = cast;\n    if (sample !== undefined) field.sample = sample;\n\n    return field;\n  });\n}\n"],"mappings":"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"}

package/esm/cli/commands/generate/utils/name-parser.mjs

@@ -10,7 +10,7 @@ import pluralize from "pluralize-esm";
 */
 function parseModulePath(input) {
 	const parts = input.split("/");
-	if (parts.length === 1) return { name: parts[0] };
+	if (parts.length === 1) return { name: input };
 	return {
 		module: parts[0],
 		name: parts.slice(1).join("/")

package/esm/cli/commands/generate/utils/name-parser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"name-parser.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/name-parser.ts"],"sourcesContent":["import { toCamelCase, toKebabCase, toSnakeCase, toStudlyCase } from \"@mongez/reinforcements\";\nimport pluralize from \"pluralize-esm\";\nimport type { ParsedName } from \"../types\";\n\n/**\n * Parse module path from input\n * Examples:\n * - \"users/create-user\" → { module: \"users\", name: \"create-user\" }\n * - \"create-user\" → { module: undefined, name: \"create-user\" }\n */\nexport function parseModulePath(input: string): { module?: string; name: string } {\n  const parts = input.split(\"/\");\n\n  if (parts.length === 1) {\n    return { name: parts[0] };\n  }\n\n  return {\n    module: parts[0],\n    name: parts.slice(1).join(\"/\"),\n  };\n}\n\n/**\n * Parse name into all case variants\n */\n// Returns the Name class, which is what it has always constructed. Annotating it as\n// ParsedName understated the result: Name carries `plural` and `singular` getters that\n// the CRUD stubs need, and a protected member that makes it nominal in practice — so\n// four generators could not pass this value to a stub expecting a Name, even though\n// that is exactly what they had. Name still satisfies ParsedName for callers that only\n// want the cased strings.\nexport function parseName(input: string): Name {\n  return new Name(input);\n}\n\n/**\n * Get plural name\n */\nexport function pluralName(name: string) {\n  return new Name(pluralize(name));\n}\n\n/**\n * Get singular name\n */\nexport function singularName(name: string) {\n  return new Name(pluralize.singular(name));\n}\n\nexport class Name {\n  protected parsedData: {\n    kebab: string;\n    camel: string;\n    snake: string;\n    studly: string;\n  };\n\n  public constructor(public readonly raw: string) {\n    this.parsedData = {\n      kebab: toKebabCase(raw),\n      camel: toCamelCase(raw),\n      snake: toSnakeCase(raw),\n      studly: toStudlyCase(raw),\n    };\n  }\n\n  public get plural() {\n    return new Name(pluralize(this.raw));\n  }\n\n  public get singular() {\n    return new Name(pluralize.singular(this.raw));\n  }\n\n  public get pascal(): string {\n    return this.parsedData.studly;\n  }\n\n  public get camel(): string {\n    return this.parsedData.camel;\n  }\n\n  public get kebab(): string {\n    return this.parsedData.kebab;\n  }\n\n  public get snake(): string {\n    return this.parsedData.snake;\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,gBAAgB,OAAkD;CAChF,MAAM,QAAQ,MAAM,MAAM,GAAG;CAE7B,IAAI,MAAM,WAAW,GACnB,OAAO,EAAE,MAAM,MAAM,GAAG;CAG1B,OAAO;EACL,QAAQ,MAAM;EACd,MAAM,MAAM,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;CAC/B;AACF;;;;AAWA,SAAgB,UAAU,OAAqB;CAC7C,OAAO,IAAI,KAAK,KAAK;AACvB;;;;AAKA,SAAgB,WAAW,MAAc;CACvC,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC;AACjC;;;;AAKA,SAAgB,aAAa,MAAc;CACzC,OAAO,IAAI,KAAK,UAAU,SAAS,IAAI,CAAC;AAC1C;AAEA,IAAa,OAAb,MAAa,KAAK;CAQhB,AAAO,YAAY,AAAgB,KAAa;EAAb;EACjC,KAAK,aAAa;GAChB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,QAAQ,aAAa,GAAG;EAC1B;CACF;CAEA,IAAW,SAAS;EAClB,OAAO,IAAI,KAAK,UAAU,KAAK,GAAG,CAAC;CACrC;CAEA,IAAW,WAAW;EACpB,OAAO,IAAI,KAAK,UAAU,SAAS,KAAK,GAAG,CAAC;CAC9C;CAEA,IAAW,SAAiB;EAC1B,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;AACF"}
+{"version":3,"file":"name-parser.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/name-parser.ts"],"sourcesContent":["import { toCamelCase, toKebabCase, toSnakeCase, toStudlyCase } from \"@mongez/reinforcements\";\nimport pluralize from \"pluralize-esm\";\n\n/**\n * Parse module path from input\n * Examples:\n * - \"users/create-user\" → { module: \"users\", name: \"create-user\" }\n * - \"create-user\" → { module: undefined, name: \"create-user\" }\n */\nexport function parseModulePath(input: string): { module?: string; name: string } {\n  const parts = input.split(\"/\");\n\n  if (parts.length === 1) {\n    return { name: input };\n  }\n\n  return {\n    module: parts[0],\n    name: parts.slice(1).join(\"/\"),\n  };\n}\n\n/**\n * Parse name into all case variants\n */\n// Returns the Name class, which is what it has always constructed. Annotating it as\n// ParsedName understated the result: Name carries `plural` and `singular` getters that\n// the CRUD stubs need, and a protected member that makes it nominal in practice — so\n// four generators could not pass this value to a stub expecting a Name, even though\n// that is exactly what they had. Name still satisfies ParsedName for callers that only\n// want the cased strings.\nexport function parseName(input: string): Name {\n  return new Name(input);\n}\n\n/**\n * Get plural name\n */\nexport function pluralName(name: string) {\n  return new Name(pluralize(name));\n}\n\n/**\n * Get singular name\n */\nexport function singularName(name: string) {\n  return new Name(pluralize.singular(name));\n}\n\nexport class Name {\n  protected parsedData: {\n    kebab: string;\n    camel: string;\n    snake: string;\n    studly: string;\n  };\n\n  public constructor(public readonly raw: string) {\n    this.parsedData = {\n      kebab: toKebabCase(raw),\n      camel: toCamelCase(raw),\n      snake: toSnakeCase(raw),\n      studly: toStudlyCase(raw),\n    };\n  }\n\n  public get plural() {\n    return new Name(pluralize(this.raw));\n  }\n\n  public get singular() {\n    return new Name(pluralize.singular(this.raw));\n  }\n\n  public get pascal(): string {\n    return this.parsedData.studly;\n  }\n\n  public get camel(): string {\n    return this.parsedData.camel;\n  }\n\n  public get kebab(): string {\n    return this.parsedData.kebab;\n  }\n\n  public get snake(): string {\n    return this.parsedData.snake;\n  }\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,gBAAgB,OAAkD;CAChF,MAAM,QAAQ,MAAM,MAAM,GAAG;CAE7B,IAAI,MAAM,WAAW,GACnB,OAAO,EAAE,MAAM,MAAM;CAGvB,OAAO;EACL,QAAQ,MAAM;EACd,MAAM,MAAM,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;CAC/B;AACF;;;;AAWA,SAAgB,UAAU,OAAqB;CAC7C,OAAO,IAAI,KAAK,KAAK;AACvB;;;;AAKA,SAAgB,WAAW,MAAc;CACvC,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC;AACjC;;;;AAKA,SAAgB,aAAa,MAAc;CACzC,OAAO,IAAI,KAAK,UAAU,SAAS,IAAI,CAAC;AAC1C;AAEA,IAAa,OAAb,MAAa,KAAK;CAQhB,AAAO,YAAY,AAAgB,KAAa;EAAb;EACjC,KAAK,aAAa;GAChB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,QAAQ,aAAa,GAAG;EAC1B;CACF;CAEA,IAAW,SAAS;EAClB,OAAO,IAAI,KAAK,UAAU,KAAK,GAAG,CAAC;CACrC;CAEA,IAAW,WAAW;EACpB,OAAO,IAAI,KAAK,UAAU,SAAS,KAAK,GAAG,CAAC;CAC9C;CAEA,IAAW,SAAiB;EAC1B,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;AACF"}

package/esm/cli/commands/generate/utils/prompt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/prompt.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * Prompt user for confirmation\n */\nexport async function confirm(message: string, defaultValue = false): Promise<boolean> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const defaultText = defaultValue ? \"Y/n\" : \"y/N\";\n    rl.question(`${message} (${defaultText}): `, (answer) => {\n      rl.close();\n\n      if (!answer.trim()) {\n        resolve(defaultValue);\n        return;\n      }\n\n      const normalized = answer.toLowerCase().trim();\n      resolve(normalized === \"y\" || normalized === \"yes\");\n    });\n  });\n}\n\n/**\n * Prompt user for text input\n */\nexport async function input(message: string, defaultValue?: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const prompt = defaultValue ? `${message} (${defaultValue}): ` : `${message}: `;\n\n    rl.question(prompt, (answer) => {\n      rl.close();\n      resolve(answer.trim() || defaultValue || \"\");\n    });\n  });\n}\n\n/**\n * Prompt user to select from choices\n */\nexport async function select(message: string, choices: string[]): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    console.log(message);\n    choices.forEach((choice, index) => {\n      console.log(`  ${index + 1}. ${choice}`);\n    });\n\n    rl.question(\"Select (1-\" + choices.length + \"): \", (answer) => {\n      rl.close();\n\n      const index = parseInt(answer.trim(), 10) - 1;\n\n      if (index >= 0 && index < choices.length) {\n        resolve(choices[index]);\n      } else {\n        resolve(choices[0]);\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;AAKA,eAAsB,QAAQ,SAAiB,eAAe,OAAyB;CACrF,MAAM,KAAK,SAAS,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;CAClB,CAAC;CAED,OAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,cAAc,eAAe,QAAQ;EAC3C,GAAG,SAAS,GAAG,QAAQ,IAAI,YAAY,OAAO,WAAW;GACvD,GAAG,MAAM;GAET,IAAI,CAAC,OAAO,KAAK,GAAG;IAClB,QAAQ,YAAY;IACpB;GACF;GAEA,MAAM,aAAa,OAAO,YAAY,CAAC,CAAC,KAAK;GAC7C,QAAQ,eAAe,OAAO,eAAe,KAAK;EACpD,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/prompt.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * Prompt user for confirmation\n */\nexport async function confirm(message: string, defaultValue = false): Promise<boolean> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const defaultText = defaultValue ? \"Y/n\" : \"y/N\";\n    rl.question(`${message} (${defaultText}): `, (answer) => {\n      rl.close();\n\n      if (!answer.trim()) {\n        resolve(defaultValue);\n        return;\n      }\n\n      const normalized = answer.toLowerCase().trim();\n      resolve(normalized === \"y\" || normalized === \"yes\");\n    });\n  });\n}\n\n/**\n * Prompt user for text input\n */\nexport async function input(message: string, defaultValue?: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const prompt = defaultValue ? `${message} (${defaultValue}): ` : `${message}: `;\n\n    rl.question(prompt, (answer) => {\n      rl.close();\n      resolve(answer.trim() || defaultValue || \"\");\n    });\n  });\n}\n\n/**\n * Prompt user to select from choices\n */\nexport async function select(message: string, choices: string[]): Promise<string> {\n  if (choices.length === 0) throw new RangeError(\"Selection requires at least one choice.\");\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    console.log(message);\n    choices.forEach((choice, index) => {\n      console.log(`  ${index + 1}. ${choice}`);\n    });\n\n    rl.question(\"Select (1-\" + choices.length + \"): \", (answer) => {\n      rl.close();\n\n      const index = parseInt(answer.trim(), 10) - 1;\n\n      if (index >= 0 && index < choices.length) {\n        resolve(choices[index]!);\n      } else {\n        resolve(choices[0]!);\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;AAKA,eAAsB,QAAQ,SAAiB,eAAe,OAAyB;CACrF,MAAM,KAAK,SAAS,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;CAClB,CAAC;CAED,OAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,cAAc,eAAe,QAAQ;EAC3C,GAAG,SAAS,GAAG,QAAQ,IAAI,YAAY,OAAO,WAAW;GACvD,GAAG,MAAM;GAET,IAAI,CAAC,OAAO,KAAK,GAAG;IAClB,QAAQ,YAAY;IACpB;GACF;GAEA,MAAM,aAAa,OAAO,YAAY,CAAC,CAAC,KAAK;GAC7C,QAAQ,eAAe,OAAO,eAAe,KAAK;EACpD,CAAC;CACH,CAAC;AACH"}

package/esm/cli/commands/generate/utils/writer.mjs

@@ -1,21 +1,23 @@
-import path from "node:path";
+import { isGenerationDryRun, pendingGeneratedContent, recordGeneratedFile, recordSkippedFile, setPendingGeneratedContent, toReportPath } from "../../../../generations/generation-run.mjs";
+import { existsSync, readFileSync } from "node:fs";
 import { colors } from "@mongez/copper";
 import { ensureDirectoryAsync, putFileAsync } from "@warlock.js/fs";
-import { existsSync, readFileSync } from "node:fs";
 
 //#region ../../packages/core/src/cli/commands/generate/utils/writer.ts
 /**
 * Dry-run state for the `generate.*` command family.
 *
 * When enabled (via `--dry-run`), every generator write becomes a no-op
-* that instead reports the file it *would* have created — letting a
-* developer preview a scaffold (especially `generate.module --crud`,
-* which writes ~25 files) before anything touches disk.
+* that instead reports the file it *would* have created, overwritten or
+* skipped — letting a developer preview a scaffold (especially
+* `generate.module`, which writes ~25 files) before anything touches disk.
 *
 * The flag is process-wide module state: the CLI runs one command per
 * process, and a top-level generator (e.g. `generateModule`) sets it
 * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)
 * inherit it without threading a parameter through every signature.
+* A generation run started by `runGenerationCommand` (`--json`) is honoured
+* too, and records every file for the report.
 */
 let dryRun = false;
 /**
@@ -45,40 +47,63 @@ function reportSkippedFiles() {
 	for (const file of skippedFiles) console.log(`  ${colors.gray(file)}`);
 	skippedFiles.length = 0;
 }
+function isDryRun() {
+	return dryRun || isGenerationDryRun();
+}
 /** Render an absolute path relative to the cwd for tidy logs. */
 function relativePath(target) {
-	return path.relative(process.cwd(), target) || target;
+	return toReportPath(target);
+}
+/** The content at `target`: what this dry run already "wrote", else the disk. */
+function existingContent(target) {
+	const pending = pendingGeneratedContent(target);
+	if (pending !== void 0) return pending;
+	return existsSync(target) ? readFileSync(target, "utf8") : void 0;
 }
 /**
 * Write a generated file — or, in dry-run, report what *would* be
 * written. Owns the per-file log so call sites stay a single line.
 *
+* A file that already holds exactly the generated content is left alone.
+* With `setSkipExisting(true)` an existing file that differs is skipped and
+* listed; otherwise it is overwritten (generators refuse to reach this point
+* for an existing file unless `--force` was given).
+*
 * @example
 * await putFileAsync(controllerPath, controllerContent);
 * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts
 * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts
 */
 async function putFileAsync$1(target, content) {
-	if (dryRun) {
-		console.log(`${colors.cyan("○")} would create ${colors.gray(relativePath(target))}`);
+	const current = existingContent(target);
+	if (current !== void 0 && current === content) {
+		recordGeneratedFile(target, "unchanged");
+		return;
+	}
+	if (current !== void 0 && skipExisting) {
+		skippedFiles.push(relativePath(target));
+		recordSkippedFile(target, "exists and differs from the generated output");
 		return;
 	}
-	if (skipExisting && existsSync(target)) {
-		if (readFileSync(target, "utf8") !== content) skippedFiles.push(relativePath(target));
+	const type = current === void 0 ? "create" : "overwrite";
+	recordGeneratedFile(target, type);
+	if (isDryRun()) {
+		setPendingGeneratedContent(target, content);
+		console.log(`${colors.cyan("○")} would ${type} ${colors.gray(relativePath(target))}`);
 		return;
 	}
 	await putFileAsync(target, content);
-	console.log(`${colors.green("✓")} created ${colors.gray(relativePath(target))}`);
+	console.log(`${colors.green("✓")} ${type === "create" ? "created" : "overwrote"} ${colors.gray(relativePath(target))}`);
 }
 /**
 * Ensure a directory exists. Silent no-op in dry-run so a preview never
 * leaves empty folders behind.
 */
 async function ensureDirectoryAsync$1(target) {
-	if (dryRun) return;
+	if (isDryRun()) return;
 	await ensureDirectoryAsync(target);
 }
 
 //#endregion
-export { ensureDirectoryAsync$1 as ensureDirectoryAsync, putFileAsync$1 as putFileAsync, reportSkippedFiles, setDryRun, setSkipExisting };
+export { ensureDirectoryAsync$1 as ensureDirectoryAsync, isDryRun, putFileAsync$1 as putFileAsync, reportSkippedFiles, setDryRun, setSkipExisting };
 //# sourceMappingURL=writer.mjs.map

package/esm/cli/commands/generate/utils/writer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writer.mjs","names":["putFileAsync","fsPutFileAsync","ensureDirectoryAsync","fsEnsureDirectoryAsync"],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/writer.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  ensureDirectoryAsync as fsEnsureDirectoryAsync,\n  putFileAsync as fsPutFileAsync,\n} from \"@warlock.js/fs\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Dry-run state for the `generate.*` command family.\n *\n * When enabled (via `--dry-run`), every generator write becomes a no-op\n * that instead reports the file it *would* have created — letting a\n * developer preview a scaffold (especially `generate.module --crud`,\n * which writes ~25 files) before anything touches disk.\n *\n * The flag is process-wide module state: the CLI runs one command per\n * process, and a top-level generator (e.g. `generateModule`) sets it\n * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)\n * inherit it without threading a parameter through every signature.\n */\nlet dryRun = false;\n\n/**\n * Toggle dry-run mode. Call once at the start of a generator action,\n * e.g. `setDryRun(Boolean(data.options.dryRun))`.\n */\nexport function setDryRun(value: boolean): void {\n  dryRun = value;\n\n  if (value) {\n    console.log(\n      colors.yellowBright(\"\\n○ Dry run — previewing planned files. Nothing will be written.\\n\"),\n    );\n  }\n}\n\n/**\n * When true, a file that already exists and differs from the generated\n * content is left untouched (and reported) instead of overwritten.\n * Model/module generators enable it unless `--force --overwrite` is given.\n */\nlet skipExisting = false;\nconst skippedFiles: string[] = [];\n\nexport function setSkipExisting(value: boolean): void {\n  skipExisting = value;\n  skippedFiles.length = 0;\n}\n\n/** Print the files skipped because they exist and differ. No-op when none. */\nexport function reportSkippedFiles(): void {\n  if (skippedFiles.length === 0) return;\n\n  console.log(\n    colors.yellow(\n      `\n! Skipped ${skippedFiles.length} existing file(s) that differ from the generated output (pass --force --overwrite to replace them):`,\n    ),\n  );\n\n  for (const file of skippedFiles) {\n    console.log(`  ${colors.gray(file)}`);\n  }\n\n  skippedFiles.length = 0;\n}\n\nexport function isDryRun(): boolean {\n  return dryRun;\n}\n\n/** Render an absolute path relative to the cwd for tidy logs. */\nfunction relativePath(target: string): string {\n  return path.relative(process.cwd(), target) || target;\n}\n\n/**\n * Write a generated file — or, in dry-run, report what *would* be\n * written. Owns the per-file log so call sites stay a single line.\n *\n * @example\n * await putFileAsync(controllerPath, controllerContent);\n * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts\n * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts\n */\nexport async function putFileAsync(target: string, content: string): Promise<void> {\n  if (dryRun) {\n    console.log(`${colors.cyan(\"○\")} would create ${colors.gray(relativePath(target))}`);\n    return;\n  }\n\n  if (skipExisting && existsSync(target)) {\n    if (readFileSync(target, \"utf8\") !== content) {\n      skippedFiles.push(relativePath(target));\n    }\n\n    return;\n  }\n\n  await fsPutFileAsync(target, content);\n  console.log(`${colors.green(\"✓\")} created ${colors.gray(relativePath(target))}`);\n}\n\n/**\n * Ensure a directory exists. Silent no-op in dry-run so a preview never\n * leaves empty folders behind.\n */\nexport async function ensureDirectoryAsync(target: string): Promise<void> {\n  if (dryRun) return;\n\n  await fsEnsureDirectoryAsync(target);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,IAAI,SAAS;;;;;AAMb,SAAgB,UAAU,OAAsB;CAC9C,SAAS;CAET,IAAI,OACF,QAAQ,IACN,OAAO,aAAa,oEAAoE,CAC1F;AAEJ;;;;;;AAOA,IAAI,eAAe;AACnB,MAAM,eAAyB,CAAC;AAEhC,SAAgB,gBAAgB,OAAsB;CACpD,eAAe;CACf,aAAa,SAAS;AACxB;;AAGA,SAAgB,qBAA2B;CACzC,IAAI,aAAa,WAAW,GAAG;CAE/B,QAAQ,IACN,OAAO,OACL;YACM,aAAa,OAAO,oGAC5B,CACF;CAEA,KAAK,MAAM,QAAQ,cACjB,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI,GAAG;CAGtC,aAAa,SAAS;AACxB;;AAOA,SAAS,aAAa,QAAwB;CAC5C,OAAO,KAAK,SAAS,QAAQ,IAAI,GAAG,MAAM,KAAK;AACjD;;;;;;;;;;AAWA,eAAsBA,eAAa,QAAgB,SAAgC;CACjF,IAAI,QAAQ;EACV,QAAQ,IAAI,GAAG,OAAO,KAAK,GAAG,EAAE,gBAAgB,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;EACnF;CACF;CAEA,IAAI,gBAAgB,WAAW,MAAM,GAAG;EACtC,IAAI,aAAa,QAAQ,MAAM,MAAM,SACnC,aAAa,KAAK,aAAa,MAAM,CAAC;EAGxC;CACF;CAEA,MAAMC,aAAe,QAAQ,OAAO;CACpC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,WAAW,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;AACjF;;;;;AAMA,eAAsBC,uBAAqB,QAA+B;CACxE,IAAI,QAAQ;CAEZ,MAAMC,qBAAuB,MAAM;AACrC"}
+{"version":3,"file":"writer.mjs","names":["putFileAsync","fsPutFileAsync","ensureDirectoryAsync","fsEnsureDirectoryAsync"],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/writer.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  ensureDirectoryAsync as fsEnsureDirectoryAsync,\n  putFileAsync as fsPutFileAsync,\n} from \"@warlock.js/fs\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport {\n  isGenerationDryRun,\n  pendingGeneratedContent,\n  recordGeneratedFile,\n  recordSkippedFile,\n  setPendingGeneratedContent,\n  toReportPath,\n} from \"../../../../generations/generation-run\";\n\n/**\n * Dry-run state for the `generate.*` command family.\n *\n * When enabled (via `--dry-run`), every generator write becomes a no-op\n * that instead reports the file it *would* have created, overwritten or\n * skipped — letting a developer preview a scaffold (especially\n * `generate.module`, which writes ~25 files) before anything touches disk.\n *\n * The flag is process-wide module state: the CLI runs one command per\n * process, and a top-level generator (e.g. `generateModule`) sets it\n * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)\n * inherit it without threading a parameter through every signature.\n * A generation run started by `runGenerationCommand` (`--json`) is honoured\n * too, and records every file for the report.\n */\nlet dryRun = false;\n\n/**\n * Toggle dry-run mode. Call once at the start of a generator action,\n * e.g. `setDryRun(Boolean(data.options.dryRun))`.\n */\nexport function setDryRun(value: boolean): void {\n  dryRun = value;\n\n  if (value) {\n    console.log(\n      colors.yellowBright(\"\\n○ Dry run — previewing planned files. Nothing will be written.\\n\"),\n    );\n  }\n}\n\n/**\n * When true, a file that already exists and differs from the generated\n * content is left untouched (and reported) instead of overwritten.\n * Model/module generators enable it unless `--force --overwrite` is given.\n */\nlet skipExisting = false;\nconst skippedFiles: string[] = [];\n\nexport function setSkipExisting(value: boolean): void {\n  skipExisting = value;\n  skippedFiles.length = 0;\n}\n\n/** Print the files skipped because they exist and differ. No-op when none. */\nexport function reportSkippedFiles(): void {\n  if (skippedFiles.length === 0) return;\n\n  console.log(\n    colors.yellow(\n      `\n! Skipped ${skippedFiles.length} existing file(s) that differ from the generated output (pass --force --overwrite to replace them):`,\n    ),\n  );\n\n  for (const file of skippedFiles) {\n    console.log(`  ${colors.gray(file)}`);\n  }\n\n  skippedFiles.length = 0;\n}\n\nexport function isDryRun(): boolean {\n  return dryRun || isGenerationDryRun();\n}\n\n/** Render an absolute path relative to the cwd for tidy logs. */\nfunction relativePath(target: string): string {\n  return toReportPath(target);\n}\n\n/** The content at `target`: what this dry run already \"wrote\", else the disk. */\nfunction existingContent(target: string): string | undefined {\n  const pending = pendingGeneratedContent(target);\n\n  if (pending !== undefined) return pending;\n\n  return existsSync(target) ? readFileSync(target, \"utf8\") : undefined;\n}\n\n/**\n * Write a generated file — or, in dry-run, report what *would* be\n * written. Owns the per-file log so call sites stay a single line.\n *\n * A file that already holds exactly the generated content is left alone.\n * With `setSkipExisting(true)` an existing file that differs is skipped and\n * listed; otherwise it is overwritten (generators refuse to reach this point\n * for an existing file unless `--force` was given).\n *\n * @example\n * await putFileAsync(controllerPath, controllerContent);\n * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts\n * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts\n */\nexport async function putFileAsync(target: string, content: string): Promise<void> {\n  const current = existingContent(target);\n\n  if (current !== undefined && current === content) {\n    recordGeneratedFile(target, \"unchanged\");\n    return;\n  }\n\n  if (current !== undefined && skipExisting) {\n    skippedFiles.push(relativePath(target));\n    recordSkippedFile(target, \"exists and differs from the generated output\");\n    return;\n  }\n\n  const type = current === undefined ? \"create\" : \"overwrite\";\n\n  recordGeneratedFile(target, type);\n\n  if (isDryRun()) {\n    setPendingGeneratedContent(target, content);\n    console.log(`${colors.cyan(\"○\")} would ${type} ${colors.gray(relativePath(target))}`);\n    return;\n  }\n\n  await fsPutFileAsync(target, content);\n  console.log(\n    `${colors.green(\"✓\")} ${type === \"create\" ? \"created\" : \"overwrote\"} ${colors.gray(relativePath(target))}`,\n  );\n}\n\n/**\n * Ensure a directory exists. Silent no-op in dry-run so a preview never\n * leaves empty folders behind.\n */\nexport async function ensureDirectoryAsync(target: string): Promise<void> {\n  if (isDryRun()) return;\n\n  await fsEnsureDirectoryAsync(target);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA8BA,IAAI,SAAS;;;;;AAMb,SAAgB,UAAU,OAAsB;CAC9C,SAAS;CAET,IAAI,OACF,QAAQ,IACN,OAAO,aAAa,oEAAoE,CAC1F;AAEJ;;;;;;AAOA,IAAI,eAAe;AACnB,MAAM,eAAyB,CAAC;AAEhC,SAAgB,gBAAgB,OAAsB;CACpD,eAAe;CACf,aAAa,SAAS;AACxB;;AAGA,SAAgB,qBAA2B;CACzC,IAAI,aAAa,WAAW,GAAG;CAE/B,QAAQ,IACN,OAAO,OACL;YACM,aAAa,OAAO,oGAC5B,CACF;CAEA,KAAK,MAAM,QAAQ,cACjB,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI,GAAG;CAGtC,aAAa,SAAS;AACxB;AAEA,SAAgB,WAAoB;CAClC,OAAO,UAAU,mBAAmB;AACtC;;AAGA,SAAS,aAAa,QAAwB;CAC5C,OAAO,aAAa,MAAM;AAC5B;;AAGA,SAAS,gBAAgB,QAAoC;CAC3D,MAAM,UAAU,wBAAwB,MAAM;CAE9C,IAAI,YAAY,QAAW,OAAO;CAElC,OAAO,WAAW,MAAM,IAAI,aAAa,QAAQ,MAAM,IAAI;AAC7D;;;;;;;;;;;;;;;AAgBA,eAAsBA,eAAa,QAAgB,SAAgC;CACjF,MAAM,UAAU,gBAAgB,MAAM;CAEtC,IAAI,YAAY,UAAa,YAAY,SAAS;EAChD,oBAAoB,QAAQ,WAAW;EACvC;CACF;CAEA,IAAI,YAAY,UAAa,cAAc;EACzC,aAAa,KAAK,aAAa,MAAM,CAAC;EACtC,kBAAkB,QAAQ,8CAA8C;EACxE;CACF;CAEA,MAAM,OAAO,YAAY,SAAY,WAAW;CAEhD,oBAAoB,QAAQ,IAAI;CAEhC,IAAI,SAAS,GAAG;EACd,2BAA2B,QAAQ,OAAO;EAC1C,QAAQ,IAAI,GAAG,OAAO,KAAK,GAAG,EAAE,SAAS,KAAK,GAAG,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;EACpF;CACF;CAEA,MAAMC,aAAe,QAAQ,OAAO;CACpC,QAAQ,IACN,GAAG,OAAO,MAAM,GAAG,EAAE,GAAG,SAAS,WAAW,YAAY,YAAY,GAAG,OAAO,KAAK,aAAa,MAAM,CAAC,GACzG;AACF;;;;;AAMA,eAAsBC,uBAAqB,QAA+B;CACxE,IAAI,SAAS,GAAG;CAEhB,MAAMC,qBAAuB,MAAM;AACrC"}

package/esm/cli/commands/inspect/inspect-command.action.mjs

@@ -0,0 +1,72 @@
+import { bootForInspect, inspectOptionsFromBoot } from "../../../tooling/inspect/boot-for-inspect.mjs";
+import { inspectApp, parseInspectSections } from "../../../tooling/inspect/inspect-app.mjs";
+import { withConsoleOnStderr } from "../routes/with-console-on-stderr.mjs";
+import { colors } from "@mongez/copper";
+
+//#region ../../packages/core/src/cli/commands/inspect/inspect-command.action.ts
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* The human summary `warlock inspect` prints without `--json`: one count per
+* section, the routes as `METHOD path  [auth] name`, and the warnings.
+* Returned as lines so it is testable.
+*/
+function formatInspectSummary(report) {
+	const lines = [`${report.app.name ?? "app"}${report.app.version ? `@${report.app.version}` : ""} (${report.app.runtimeStrategy}, Node ${report.app.node})`, ""];
+	const counts = [
+		["routes", report.routes?.length],
+		["models", report.models?.length],
+		["resources", report.resources?.length],
+		["config keys", report.config?.length],
+		["events", report.events?.length],
+		["pages", report.pages?.length],
+		["jobs", report.jobs?.length],
+		["schedules", report.schedules?.length],
+		["packages", report.packages?.length]
+	];
+	for (const [label, count] of counts) if (count !== void 0) lines.push(`  ${label.padEnd(12)} ${count}`);
+	if (report.routes && report.routes.length > 0) {
+		lines.push("", "Routes:");
+		for (const route of report.routes) {
+			const guard = route.auth.required ? " [auth]" : "";
+			const name = route.name ? `  ${route.name}` : "";
+			lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);
+		}
+	}
+	if (report.warnings.length > 0) {
+		lines.push("", `${report.warnings.length} warning(s):`);
+		for (const warning of report.warnings) lines.push(`  - ${warning.code ? `${warning.code} ` : ""}${warning.message}`);
+	}
+	lines.push("", "Run `warlock inspect --json` for the full report.");
+	return lines;
+}
+/**
+* Action behind `warlock inspect`.
+*
+* Boots the app read-only (the `warlock doctor` boot pass: connectors booted,
+* none started, no connection, no port), then describes it with
+* `inspectApp()`. With `--json`, stdout carries exactly the report and the
+* boot's progress lines go to stderr.
+*
+* @param data Parsed CLI args: `options.json`, `options.section`.
+*/
+async function inspectCommandAction({ options }) {
+	const sections = parseInspectSections(stringOption(options.section));
+	const json = options.json === true;
+	const report = await inspectApp({
+		...inspectOptionsFromBoot(json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect()),
+		sections
+	});
+	if (json) {
+		console.log(JSON.stringify(report, null, 2));
+		return;
+	}
+	const [heading, ...rest] = formatInspectSummary(report);
+	console.log(colors.bold(heading ?? ""));
+	for (const line of rest) console.log(line);
+}
+
+//#endregion
+export { inspectCommandAction };
+//# sourceMappingURL=inspect-command.action.mjs.map

package/esm/cli/commands/inspect/inspect-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/inspect/inspect-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, parseInspectSections } from \"../../../tooling/inspect/inspect-app\";\nimport type { InspectReport } from \"../../../tooling/inspect/inspect-report.types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The human summary `warlock inspect` prints without `--json`: one count per\n * section, the routes as `METHOD path  [auth] name`, and the warnings.\n * Returned as lines so it is testable.\n */\nexport function formatInspectSummary(report: InspectReport): string[] {\n  const lines: string[] = [\n    `${report.app.name ?? \"app\"}${report.app.version ? `@${report.app.version}` : \"\"} (${report.app.runtimeStrategy}, Node ${report.app.node})`,\n    \"\",\n  ];\n\n  const counts: [string, number | undefined][] = [\n    [\"routes\", report.routes?.length],\n    [\"models\", report.models?.length],\n    [\"resources\", report.resources?.length],\n    [\"config keys\", report.config?.length],\n    [\"events\", report.events?.length],\n    [\"pages\", report.pages?.length],\n    [\"jobs\", report.jobs?.length],\n    [\"schedules\", report.schedules?.length],\n    [\"packages\", report.packages?.length],\n  ];\n\n  for (const [label, count] of counts) {\n    if (count !== undefined) lines.push(`  ${label.padEnd(12)} ${count}`);\n  }\n\n  if (report.routes && report.routes.length > 0) {\n    lines.push(\"\", \"Routes:\");\n\n    for (const route of report.routes) {\n      const guard = route.auth.required ? \" [auth]\" : \"\";\n      const name = route.name ? `  ${route.name}` : \"\";\n\n      lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);\n    }\n  }\n\n  if (report.warnings.length > 0) {\n    lines.push(\"\", `${report.warnings.length} warning(s):`);\n\n    for (const warning of report.warnings) {\n      lines.push(`  - ${warning.code ? `${warning.code} ` : \"\"}${warning.message}`);\n    }\n  }\n\n  lines.push(\"\", \"Run `warlock inspect --json` for the full report.\");\n\n  return lines;\n}\n\n/**\n * Action behind `warlock inspect`.\n *\n * Boots the app read-only (the `warlock doctor` boot pass: connectors booted,\n * none started, no connection, no port), then describes it with\n * `inspectApp()`. With `--json`, stdout carries exactly the report and the\n * boot's progress lines go to stderr.\n *\n * @param data Parsed CLI args: `options.json`, `options.section`.\n */\nexport async function inspectCommandAction({ options }: CommandActionData): Promise<void> {\n  // Parsed first, so a typo fails before the app boots.\n  const sections = parseInspectSections(stringOption(options.section));\n  const json = options.json === true;\n  const boot = json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect();\n  const report = await inspectApp({ ...inspectOptionsFromBoot(boot), sections });\n\n  if (json) {\n    console.log(JSON.stringify(report, null, 2));\n    return;\n  }\n\n  const [heading, ...rest] = formatInspectSummary(report);\n\n  console.log(colors.bold(heading ?? \"\"));\n\n  for (const line of rest) {\n    console.log(line);\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,qBAAqB,QAAiC;CACpE,MAAM,QAAkB,CACtB,GAAG,OAAO,IAAI,QAAQ,QAAQ,OAAO,IAAI,UAAU,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,OAAO,IAAI,gBAAgB,SAAS,OAAO,IAAI,KAAK,IACzI,EACF;CAEA,MAAM,SAAyC;EAC7C,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,eAAe,OAAO,QAAQ,MAAM;EACrC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,SAAS,OAAO,OAAO,MAAM;EAC9B,CAAC,QAAQ,OAAO,MAAM,MAAM;EAC5B,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,YAAY,OAAO,UAAU,MAAM;CACtC;CAEA,KAAK,MAAM,CAAC,OAAO,UAAU,QAC3B,IAAI,UAAU,QAAW,MAAM,KAAK,KAAK,MAAM,OAAO,EAAE,EAAE,GAAG,OAAO;CAGtE,IAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;EAC7C,MAAM,KAAK,IAAI,SAAS;EAExB,KAAK,MAAM,SAAS,OAAO,QAAQ;GACjC,MAAM,QAAQ,MAAM,KAAK,WAAW,YAAY;GAChD,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM,SAAS;GAE9C,MAAM,KAAK,KAAK,MAAM,OAAO,OAAO,CAAC,EAAE,GAAG,MAAM,OAAO,QAAQ,MAAM;EACvE;CACF;CAEA,IAAI,OAAO,SAAS,SAAS,GAAG;EAC9B,MAAM,KAAK,IAAI,GAAG,OAAO,SAAS,OAAO,aAAa;EAEtD,KAAK,MAAM,WAAW,OAAO,UAC3B,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,KAAK,KAAK,QAAQ,SAAS;CAEhF;CAEA,MAAM,KAAK,IAAI,mDAAmD;CAElE,OAAO;AACT;;;;;;;;;;;AAYA,eAAsB,qBAAqB,EAAE,WAA6C;CAExF,MAAM,WAAW,qBAAqB,aAAa,QAAQ,OAAO,CAAC;CACnE,MAAM,OAAO,QAAQ,SAAS;CAE9B,MAAM,SAAS,MAAM,WAAW;EAAE,GAAG,uBADxB,OAAO,MAAM,0BAA0B,eAAe,CAAC,IAAI,MAAM,eAAe,CAC7B;EAAG;CAAS,CAAC;CAE7E,IAAI,MAAM;EACR,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EAC3C;CACF;CAEA,MAAM,CAAC,SAAS,GAAG,QAAQ,qBAAqB,MAAM;CAEtD,QAAQ,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;CAEtC,KAAK,MAAM,QAAQ,MACjB,QAAQ,IAAI,IAAI;AAEpB"}

package/esm/cli/commands/inspect.command.mjs

@@ -0,0 +1,39 @@
+import { command } from "../../commands/cli-command.mjs";
+import { inspectCommandAction } from "./inspect/inspect-command.action.mjs";
+
+//#region ../../packages/core/src/cli/commands/inspect.command.ts
+/**
+* `warlock inspect` — print the app's facts from its booted registries:
+* routes (middleware, guard, rate limit, logging, request/response schemas),
+* models, resources, config keys, event listeners, pages, queue jobs,
+* scheduled tasks and installed `@warlock.js/*` versions. `--json` prints the
+* versioned report (`schemaVersion: 1`); `--section` limits it.
+*
+* Boots like `warlock doctor`: connectors boot (routes register) but none
+* starts, so no database, cache or socket connection opens and no port binds.
+* `runtimeStrategy: "development"` for the same reason doctor declares it.
+*/
+const inspectCommand = command({
+	name: "inspect",
+	description: "Print the app's routes, models, resources, config keys, events, pages, jobs, schedules and package versions (read-only); --json for the versioned report",
+	action: inspectCommandAction,
+	preload: {
+		runtimeStrategy: "development",
+		config: true,
+		env: true,
+		bootstrap: true
+	},
+	options: [{
+		text: "--json, -j",
+		description: "Print the report as JSON (schemaVersion 1)",
+		type: "boolean"
+	}, {
+		text: "--section, -s",
+		description: "Comma-separated sections: routes, models, resources, config, events, pages, jobs, schedules, packages",
+		type: "string"
+	}]
+});
+
+//#endregion
+export { inspectCommand };
+//# sourceMappingURL=inspect.command.mjs.map

package/esm/cli/commands/inspect.command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.command.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/cli/commands/inspect.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\nimport { inspectCommandAction } from \"./inspect/inspect-command.action\";\n\n/**\n * `warlock inspect` — print the app's facts from its booted registries:\n * routes (middleware, guard, rate limit, logging, request/response schemas),\n * models, resources, config keys, event listeners, pages, queue jobs,\n * scheduled tasks and installed `@warlock.js/*` versions. `--json` prints the\n * versioned report (`schemaVersion: 1`); `--section` limits it.\n *\n * Boots like `warlock doctor`: connectors boot (routes register) but none\n * starts, so no database, cache or socket connection opens and no port binds.\n * `runtimeStrategy: \"development\"` for the same reason doctor declares it.\n */\nexport const inspectCommand = command({\n  name: \"inspect\",\n  description:\n    \"Print the app's routes, models, resources, config keys, events, pages, jobs, schedules and package versions (read-only); --json for the versioned report\",\n  action: inspectCommandAction,\n  preload: {\n    runtimeStrategy: \"development\",\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--json, -j\",\n      description: \"Print the report as JSON (schemaVersion 1)\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--section, -s\",\n      description:\n        \"Comma-separated sections: routes, models, resources, config, events, pages, jobs, schedules, packages\",\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,iBAAiB,QAAQ;CACpC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,SAAS,CACP;EACE,MAAM;EACN,aAAa;EACb,MAAM;CACR,GACA;EACE,MAAM;EACN,aACE;EACF,MAAM;CACR,CACF;AACF,CAAC"}

package/esm/cli/commands/mcp/mcp-command.action.mjs

@@ -0,0 +1,103 @@
+import { getWarlockVersion } from "../../../utils/framework-vesion.mjs";
+import { featuresMap } from "../../../generations/features/index.mjs";
+import { bootForInspect, inspectOptionsFromBoot } from "../../../tooling/inspect/boot-for-inspect.mjs";
+import { inspectApp } from "../../../tooling/inspect/inspect-app.mjs";
+import { flushAndExit } from "../../flush-and-exit.mjs";
+import { createMcpContext } from "../../../tooling/mcp/create-mcp-context.mjs";
+import { resolveMcpTransport, startWarlockMcpServer } from "../../../tooling/mcp/start-mcp-server.mjs";
+
+//#region ../../packages/core/src/cli/commands/mcp/mcp-command.action.ts
+function stringOption(value) {
+	if (typeof value === "number") return String(value);
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* The transport `warlock mcp` options describe: stdio by default, HTTP with
+* `--http` (and `--host`, `--port`, `--path`, `--token` / `WARLOCK_MCP_TOKEN`).
+* Throws on a port that is not a number.
+*/
+function mcpTransportFromOptions(options, env = process.env) {
+	if (!(options.http === true || stringOption(options.host) !== void 0 || options.port !== void 0)) return { type: "stdio" };
+	const portText = stringOption(options.port);
+	const port = portText === void 0 ? 0 : Number(portText);
+	if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(`--port must be a number from 0 to 65535, got ${JSON.stringify(portText)}.`);
+	return {
+		type: "http",
+		host: stringOption(options.host) ?? "127.0.0.1",
+		port,
+		path: stringOption(options.path) ?? "/mcp",
+		token: stringOption(options.token) ?? stringOption(env.WARLOCK_MCP_TOKEN)
+	};
+}
+/**
+* Send `console.log` / `console.info` / `console.debug` to stderr for the rest
+* of the process: over stdio, stdout carries only JSON-RPC, so a stray log
+* line from the app (or the framework's logger) would corrupt the stream.
+*/
+function routeConsoleToStderr() {
+	const { log, info, debug } = console;
+	const toStderr = (...args) => console.error(...args);
+	console.log = toStderr;
+	console.info = toStderr;
+	console.debug = toStderr;
+	return () => {
+		console.log = log;
+		console.info = info;
+		console.debug = debug;
+	};
+}
+/** The read-only boot, run once on the first tool call that needs the app. */
+function lazyInspectOptions() {
+	let boot;
+	return () => {
+		boot ??= bootForInspect().then(inspectOptionsFromBoot);
+		return boot;
+	};
+}
+/**
+* Action behind `warlock mcp`.
+*
+* Serves the app's tools over MCP. The app is booted the `warlock inspect`
+* way — connectors booted, none started, no connection, no port — on the
+* first call that needs it, so the server answers `initialize` at once.
+* Runs until stdin closes (stdio) or SIGINT/SIGTERM.
+*/
+async function mcpCommandAction({ options }) {
+	const transport = mcpTransportFromOptions(options);
+	resolveMcpTransport(transport);
+	if (transport.type === "stdio") routeConsoleToStderr();
+	const allowWrites = options.allowWrites === true;
+	const inspectOptions = lazyInspectOptions();
+	const server = await startWarlockMcpServer({
+		context: createMcpContext({
+			allowWrites,
+			inspect: async (sections) => inspectApp({
+				...await inspectOptions(),
+				sections
+			}),
+			...process.argv[1] ? { cliEntry: process.argv[1] } : {},
+			devtools: {
+				...stringOption(options.url) ? { url: stringOption(options.url) } : {},
+				...stringOption(options.devtoolsPath) ? { devtoolsPath: stringOption(options.devtoolsPath) } : {}
+			},
+			features: Object.keys(featuresMap)
+		}),
+		transport,
+		version: await getWarlockVersion()
+	});
+	console.error(`warlock mcp: ${server.tools.length} tools on ${server.url ?? "stdio"} (${allowWrites ? "writes allowed" : "read-only"})`);
+	let closing = false;
+	const stop = async () => {
+		if (closing) return;
+		closing = true;
+		await server.close();
+		await flushAndExit(0);
+	};
+	process.once("SIGINT", () => void stop());
+	process.once("SIGTERM", () => void stop());
+	if (transport.type === "stdio") process.stdin.once("end", () => void stop());
+}
+
+//#endregion
+export { mcpCommandAction, routeConsoleToStderr };
+//# sourceMappingURL=mcp-command.action.mjs.map

package/esm/cli/commands/mcp/mcp-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/mcp/mcp-command.action.ts"],"sourcesContent":["import type { CommandActionData } from \"../../../commands/types\";\nimport { featuresMap } from \"../../../generations/features\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, type InspectOptions } from \"../../../tooling/inspect/inspect-app\";\nimport { createMcpContext } from \"../../../tooling/mcp/create-mcp-context\";\nimport {\n  resolveMcpTransport,\n  startWarlockMcpServer,\n  type WarlockMcpTransport,\n} from \"../../../tooling/mcp/start-mcp-server\";\nimport { getWarlockVersion } from \"../../../utils/framework-vesion\";\nimport { flushAndExit } from \"../../flush-and-exit\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  if (typeof value === \"number\") return String(value);\n\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The transport `warlock mcp` options describe: stdio by default, HTTP with\n * `--http` (and `--host`, `--port`, `--path`, `--token` / `WARLOCK_MCP_TOKEN`).\n * Throws on a port that is not a number.\n */\nexport function mcpTransportFromOptions(\n  options: CommandActionData[\"options\"],\n  env: NodeJS.ProcessEnv = process.env,\n): WarlockMcpTransport {\n  const http =\n    options.http === true || stringOption(options.host) !== undefined || options.port !== undefined;\n\n  if (!http) return { type: \"stdio\" };\n\n  const portText = stringOption(options.port);\n  const port = portText === undefined ? 0 : Number(portText);\n\n  if (!Number.isInteger(port) || port < 0 || port > 65_535) {\n    throw new Error(`--port must be a number from 0 to 65535, got ${JSON.stringify(portText)}.`);\n  }\n\n  return {\n    type: \"http\",\n    host: stringOption(options.host) ?? \"127.0.0.1\",\n    port,\n    path: stringOption(options.path) ?? \"/mcp\",\n    token: stringOption(options.token) ?? stringOption(env.WARLOCK_MCP_TOKEN),\n  };\n}\n\n/**\n * Send `console.log` / `console.info` / `console.debug` to stderr for the rest\n * of the process: over stdio, stdout carries only JSON-RPC, so a stray log\n * line from the app (or the framework's logger) would corrupt the stream.\n */\nexport function routeConsoleToStderr(): () => void {\n  const { log, info, debug } = console;\n  const toStderr = (...args: unknown[]) => console.error(...args);\n\n  console.log = toStderr;\n  console.info = toStderr;\n  console.debug = toStderr;\n\n  return () => {\n    console.log = log;\n    console.info = info;\n    console.debug = debug;\n  };\n}\n\n/** The read-only boot, run once on the first tool call that needs the app. */\nfunction lazyInspectOptions(): () => Promise<InspectOptions> {\n  let boot: Promise<InspectOptions> | undefined;\n\n  return () => {\n    boot ??= bootForInspect().then(inspectOptionsFromBoot);\n\n    return boot;\n  };\n}\n\n/**\n * Action behind `warlock mcp`.\n *\n * Serves the app's tools over MCP. The app is booted the `warlock inspect`\n * way — connectors booted, none started, no connection, no port — on the\n * first call that needs it, so the server answers `initialize` at once.\n * Runs until stdin closes (stdio) or SIGINT/SIGTERM.\n */\nexport async function mcpCommandAction({ options }: CommandActionData): Promise<void> {\n  const transport = mcpTransportFromOptions(options);\n\n  // Refuse an unsafe bind before anything boots.\n  resolveMcpTransport(transport);\n\n  if (transport.type === \"stdio\") routeConsoleToStderr();\n\n  const allowWrites = options.allowWrites === true;\n  const inspectOptions = lazyInspectOptions();\n  const context = createMcpContext({\n    allowWrites,\n    inspect: async (sections) => inspectApp({ ...(await inspectOptions()), sections }),\n    ...(process.argv[1] ? { cliEntry: process.argv[1] } : {}),\n    devtools: {\n      ...(stringOption(options.url) ? { url: stringOption(options.url) } : {}),\n      ...(stringOption(options.devtoolsPath)\n        ? { devtoolsPath: stringOption(options.devtoolsPath) }\n        : {}),\n    },\n    features: Object.keys(featuresMap),\n  });\n\n  const server = await startWarlockMcpServer({\n    context,\n    transport,\n    version: await getWarlockVersion(),\n  });\n\n  console.error(\n    `warlock mcp: ${server.tools.length} tools on ${server.url ?? \"stdio\"} (${allowWrites ? \"writes allowed\" : \"read-only\"})`,\n  );\n\n  let closing = false;\n\n  const stop = async () => {\n    if (closing) return;\n    closing = true;\n    await server.close();\n    await flushAndExit(0);\n  };\n\n  process.once(\"SIGINT\", () => void stop());\n  process.once(\"SIGTERM\", () => void stop());\n\n  if (transport.type === \"stdio\") {\n    process.stdin.once(\"end\", () => void stop());\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAS,aAAa,OAAkE;CACtF,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,KAAK;CAElD,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,wBACd,SACA,MAAyB,QAAQ,KACZ;CAIrB,IAAI,EAFF,QAAQ,SAAS,QAAQ,aAAa,QAAQ,IAAI,MAAM,UAAa,QAAQ,SAAS,SAE7E,OAAO,EAAE,MAAM,QAAQ;CAElC,MAAM,WAAW,aAAa,QAAQ,IAAI;CAC1C,MAAM,OAAO,aAAa,SAAY,IAAI,OAAO,QAAQ;CAEzD,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO,OAChD,MAAM,IAAI,MAAM,gDAAgD,KAAK,UAAU,QAAQ,EAAE,EAAE;CAG7F,OAAO;EACL,MAAM;EACN,MAAM,aAAa,QAAQ,IAAI,KAAK;EACpC;EACA,MAAM,aAAa,QAAQ,IAAI,KAAK;EACpC,OAAO,aAAa,QAAQ,KAAK,KAAK,aAAa,IAAI,iBAAiB;CAC1E;AACF;;;;;;AAOA,SAAgB,uBAAmC;CACjD,MAAM,EAAE,KAAK,MAAM,UAAU;CAC7B,MAAM,YAAY,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;CAE9D,QAAQ,MAAM;CACd,QAAQ,OAAO;CACf,QAAQ,QAAQ;CAEhB,aAAa;EACX,QAAQ,MAAM;EACd,QAAQ,OAAO;EACf,QAAQ,QAAQ;CAClB;AACF;;AAGA,SAAS,qBAAoD;CAC3D,IAAI;CAEJ,aAAa;EACX,SAAS,eAAe,CAAC,CAAC,KAAK,sBAAsB;EAErD,OAAO;CACT;AACF;;;;;;;;;AAUA,eAAsB,iBAAiB,EAAE,WAA6C;CACpF,MAAM,YAAY,wBAAwB,OAAO;CAGjD,oBAAoB,SAAS;CAE7B,IAAI,UAAU,SAAS,SAAS,qBAAqB;CAErD,MAAM,cAAc,QAAQ,gBAAgB;CAC5C,MAAM,iBAAiB,mBAAmB;CAc1C,MAAM,SAAS,MAAM,sBAAsB;EACzC,SAdc,iBAAiB;GAC/B;GACA,SAAS,OAAO,aAAa,WAAW;IAAE,GAAI,MAAM,eAAe;IAAI;GAAS,CAAC;GACjF,GAAI,QAAQ,KAAK,KAAK,EAAE,UAAU,QAAQ,KAAK,GAAG,IAAI,CAAC;GACvD,UAAU;IACR,GAAI,aAAa,QAAQ,GAAG,IAAI,EAAE,KAAK,aAAa,QAAQ,GAAG,EAAE,IAAI,CAAC;IACtE,GAAI,aAAa,QAAQ,YAAY,IACjC,EAAE,cAAc,aAAa,QAAQ,YAAY,EAAE,IACnD,CAAC;GACP;GACA,UAAU,OAAO,KAAK,WAAW;EACnC,CAGQ;EACN;EACA,SAAS,MAAM,kBAAkB;CACnC,CAAC;CAED,QAAQ,MACN,gBAAgB,OAAO,MAAM,OAAO,YAAY,OAAO,OAAO,QAAQ,IAAI,cAAc,mBAAmB,YAAY,EACzH;CAEA,IAAI,UAAU;CAEd,MAAM,OAAO,YAAY;EACvB,IAAI,SAAS;EACb,UAAU;EACV,MAAM,OAAO,MAAM;EACnB,MAAM,aAAa,CAAC;CACtB;CAEA,QAAQ,KAAK,gBAAgB,KAAK,KAAK,CAAC;CACxC,QAAQ,KAAK,iBAAiB,KAAK,KAAK,CAAC;CAEzC,IAAI,UAAU,SAAS,SACrB,QAAQ,MAAM,KAAK,aAAa,KAAK,KAAK,CAAC;AAE/C"}