@formspec/build 0.1.0-alpha.52 → 0.1.0-alpha.53

package/dist/build-alpha.d.ts

@@ -40,6 +40,7 @@ import { ExtensionDefinition } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
+import type { LoggerLike } from '@formspec/core';
 import type { MetadataPolicyInput } from '@formspec/core';
 import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
@@ -95,6 +96,11 @@ export declare function buildFormSchemas<E extends readonly FormElement[]>(form:
  * @public
  */
 export declare interface BuildFormSchemasOptions extends GenerateJsonSchemaOptions, GenerateUiSchemaOptions {
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1008,6 +1014,11 @@ export declare interface GenerateJsonSchemaOptions {
     readonly enumSerialization?: "enum" | "oneOf";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1390,6 +1401,11 @@ export declare function generateUiSchema<E extends readonly FormElement[]>(form:
 export declare interface GenerateUiSchemaOptions {
     /** Metadata resolution policy for chain DSL UI generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 export { Group }
@@ -2391,6 +2407,11 @@ export declare interface WriteSchemasOptions extends GenerateJsonSchemaOptions {
     readonly name?: string;
     /** Number of spaces for JSON indentation. Defaults to 2 */
     readonly indent?: number;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**

package/dist/build-beta.d.ts

@@ -40,6 +40,7 @@ import { ExtensionDefinition } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
+import type { LoggerLike } from '@formspec/core';
 import type { MetadataPolicyInput } from '@formspec/core';
 import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
@@ -95,6 +96,11 @@ export declare function buildFormSchemas<E extends readonly FormElement[]>(form:
  * @public
  */
 export declare interface BuildFormSchemasOptions extends GenerateJsonSchemaOptions, GenerateUiSchemaOptions {
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1008,6 +1014,11 @@ export declare interface GenerateJsonSchemaOptions {
     readonly enumSerialization?: "enum" | "oneOf";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1390,6 +1401,11 @@ export declare function generateUiSchema<E extends readonly FormElement[]>(form:
 export declare interface GenerateUiSchemaOptions {
     /** Metadata resolution policy for chain DSL UI generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 export { Group }
@@ -2391,6 +2407,11 @@ export declare interface WriteSchemasOptions extends GenerateJsonSchemaOptions {
     readonly name?: string;
     /** Number of spaces for JSON indentation. Defaults to 2 */
     readonly indent?: number;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**

package/dist/build-internal.d.ts

@@ -40,6 +40,7 @@ import { ExtensionDefinition } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
+import type { LoggerLike } from '@formspec/core';
 import type { MetadataPolicyInput } from '@formspec/core';
 import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
@@ -95,6 +96,11 @@ export declare function buildFormSchemas<E extends readonly FormElement[]>(form:
  * @public
  */
 export declare interface BuildFormSchemasOptions extends GenerateJsonSchemaOptions, GenerateUiSchemaOptions {
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1008,6 +1014,11 @@ export declare interface GenerateJsonSchemaOptions {
     readonly enumSerialization?: "enum" | "oneOf";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1390,6 +1401,11 @@ export declare function generateUiSchema<E extends readonly FormElement[]>(form:
 export declare interface GenerateUiSchemaOptions {
     /** Metadata resolution policy for chain DSL UI generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 export { Group }
@@ -2391,6 +2407,11 @@ export declare interface WriteSchemasOptions extends GenerateJsonSchemaOptions {
     readonly name?: string;
     /** Number of spaces for JSON indentation. Defaults to 2 */
     readonly indent?: number;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**

package/dist/build.d.ts

@@ -40,6 +40,7 @@ import { ExtensionDefinition } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
+import type { LoggerLike } from '@formspec/core';
 import type { MetadataPolicyInput } from '@formspec/core';
 import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
@@ -95,6 +96,11 @@ export declare function buildFormSchemas<E extends readonly FormElement[]>(form:
  * @public
  */
 export declare interface BuildFormSchemasOptions extends GenerateJsonSchemaOptions, GenerateUiSchemaOptions {
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1008,6 +1014,11 @@ export declare interface GenerateJsonSchemaOptions {
     readonly enumSerialization?: "enum" | "oneOf";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**
@@ -1390,6 +1401,11 @@ export declare function generateUiSchema<E extends readonly FormElement[]>(form:
 export declare interface GenerateUiSchemaOptions {
     /** Metadata resolution policy for chain DSL UI generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 export { Group }
@@ -2391,6 +2407,11 @@ export declare interface WriteSchemasOptions extends GenerateJsonSchemaOptions {
     readonly name?: string;
     /** Number of spaces for JSON indentation. Defaults to 2 */
     readonly indent?: number;
+    /**
+     * Optional logger for diagnostic output. Defaults to a no-op logger so
+     * existing callers produce no output.
+     */
+    readonly logger?: LoggerLike | undefined;
 }
 
 /**

package/dist/cli/logger.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pino-based logger factory for the @formspec/build CLI.
+ *
+ * Reads `process.env.DEBUG` to determine which namespaces are enabled using
+ * the shared matcher in `@formspec/core` — same semantics as the `debug` npm
+ * package (comma-separated patterns, `*` wildcard, `-` prefix for negation,
+ * negations always win).
+ */
+import type { LoggerLike } from "@formspec/core";
+/**
+ * Creates a logger for the given namespace.
+ *
+ * When the namespace is enabled by `DEBUG`, writes structured JSON to stderr
+ * (with pino-pretty formatting when stderr is a TTY). Otherwise returns the
+ * silent `noopLogger` from `@formspec/core`.
+ *
+ * pino and pino-pretty are loaded lazily via `require()` so that the CLI
+ * pays no load-time cost when logging is disabled, and so the dependencies
+ * can be declared as `optionalDependencies` of `@formspec/build`.
+ */
+export declare function createLogger(namespace: string): LoggerLike;
+//# sourceMappingURL=logger.d.ts.map

package/dist/cli/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/cli/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAwB1D"}

package/dist/cli.cjs

@@ -1742,19 +1742,25 @@ var init_ir_generator = __esm({
 
 // src/json-schema/generator.ts
 function generateJsonSchema(form, options) {
+  const logger = (options?.logger ?? import_core2.noopLogger).child({ stage: "ir" });
   const metadata = options?.metadata;
   const vendorPrefix = options?.vendorPrefix;
   const enumSerialization = options?.enumSerialization;
+  logger.debug("canonicalizing chain DSL to IR");
   const ir = canonicalizeChainDSL(form, metadata !== void 0 ? { metadata } : void 0);
+  const schemaLogger = (options?.logger ?? import_core2.noopLogger).child({ stage: "schema" });
+  schemaLogger.debug("generating JSON Schema from IR");
   const internalOptions = vendorPrefix === void 0 && enumSerialization === void 0 ? void 0 : {
     ...vendorPrefix !== void 0 && { vendorPrefix },
     ...enumSerialization !== void 0 && { enumSerialization }
   };
   return generateJsonSchemaFromIR(ir, internalOptions);
 }
+var import_core2;
 var init_generator = __esm({
   "src/json-schema/generator.ts"() {
     "use strict";
+    import_core2 = require("@formspec/core");
     init_canonicalize();
     init_ir_generator();
   }
@@ -2034,15 +2040,21 @@ var init_ir_generator2 = __esm({
 
 // src/ui-schema/generator.ts
 function generateUiSchema(form, options) {
+  const logger = (options?.logger ?? import_core3.noopLogger).child({ stage: "ir" });
+  logger.debug("canonicalizing chain DSL to IR for UI Schema generation");
   const ir = canonicalizeChainDSL(
     form,
     options?.metadata !== void 0 ? { metadata: options.metadata } : void 0
   );
+  const schemaLogger = (options?.logger ?? import_core3.noopLogger).child({ stage: "schema" });
+  schemaLogger.debug("generating UI Schema from IR");
   return generateUiSchemaFromIR(ir);
 }
+var import_core3;
 var init_generator2 = __esm({
   "src/ui-schema/generator.ts"() {
     "use strict";
+    import_core3 = require("@formspec/core");
     init_canonicalize();
     init_ir_generator2();
   }
@@ -2490,39 +2502,85 @@ function isNonReferenceIdentifier(node) {
   }
   return false;
 }
-function statementReferencesImportedName(statement, importedNames) {
+function astReferencesImportedName(root, importedNames) {
   if (importedNames.size === 0) {
     return false;
   }
-  let referencesImportedName = false;
+  let found = false;
   const visit = (node) => {
-    if (referencesImportedName) {
-      return;
-    }
+    if (found) return;
     if (ts4.isIdentifier(node) && importedNames.has(node.text) && !isNonReferenceIdentifier(node)) {
-      referencesImportedName = true;
+      found = true;
       return;
     }
     ts4.forEachChild(node, visit);
   };
-  visit(statement);
-  return referencesImportedName;
+  visit(root);
+  return found;
+}
+function getObjectMembers(statement) {
+  if (ts4.isInterfaceDeclaration(statement)) {
+    return statement.members;
+  }
+  if (ts4.isTypeLiteralNode(statement.type)) {
+    return statement.type.members;
+  }
+  return void 0;
+}
+function rewriteImportedMemberTypes(statement, sourceFile, importedNames) {
+  const members = getObjectMembers(statement);
+  if (members === void 0) {
+    return null;
+  }
+  const replacements = [];
+  for (const member of members) {
+    if (!ts4.isPropertySignature(member)) {
+      if (astReferencesImportedName(member, importedNames)) {
+        return null;
+      }
+      continue;
+    }
+    const typeAnnotation = member.type;
+    if (typeAnnotation === void 0) continue;
+    if (astReferencesImportedName(typeAnnotation, importedNames)) {
+      replacements.push({
+        start: typeAnnotation.getStart(sourceFile),
+        end: typeAnnotation.getEnd()
+      });
+    }
+  }
+  if (replacements.length === 0) {
+    return statement.getText(sourceFile);
+  }
+  const stmtStart = statement.getStart(sourceFile);
+  let result = statement.getText(sourceFile);
+  for (const { start, end } of [...replacements].reverse()) {
+    result = result.slice(0, start - stmtStart) + "unknown" + result.slice(end - stmtStart);
+  }
+  return result;
 }
 function buildSupportingDeclarations(sourceFile, extensionTypeNames) {
   const importedNames = collectImportedNames(sourceFile);
   const importedNamesToSkip = new Set(
     [...importedNames].filter((name) => !extensionTypeNames.has(name))
   );
-  return sourceFile.statements.filter((statement) => {
-    if (ts4.isImportDeclaration(statement)) return false;
-    if (ts4.isImportEqualsDeclaration(statement)) return false;
-    if (ts4.isExportDeclaration(statement) && statement.moduleSpecifier !== void 0)
-      return false;
-    if (statementReferencesImportedName(statement, importedNamesToSkip)) {
-      return false;
+  const result = [];
+  for (const statement of sourceFile.statements) {
+    if (ts4.isImportDeclaration(statement)) continue;
+    if (ts4.isImportEqualsDeclaration(statement)) continue;
+    if (ts4.isExportDeclaration(statement) && statement.moduleSpecifier !== void 0) continue;
+    if (!astReferencesImportedName(statement, importedNamesToSkip)) {
+      result.push(statement.getText(sourceFile));
+      continue;
     }
-    return true;
-  }).map((statement) => statement.getText(sourceFile));
+    if (ts4.isInterfaceDeclaration(statement) || ts4.isTypeAliasDeclaration(statement)) {
+      const rewritten = rewriteImportedMemberTypes(statement, sourceFile, importedNamesToSkip);
+      if (rewritten !== null) {
+        result.push(rewritten);
+      }
+    }
+  }
+  return result;
 }
 function pushUniqueCompilerDiagnostics(target, additions) {
   for (const diagnostic of additions) {
@@ -6933,6 +6991,8 @@ __export(index_exports, {
   writeSchemas: () => writeSchemas
 });
 function buildFormSchemas(form, options) {
+  const logger = options?.logger ?? import_core4.noopLogger;
+  logger.debug("buildFormSchemas: starting schema generation");
   return {
     jsonSchema: generateJsonSchema(form, options),
     uiSchema: generateUiSchema(form, options)
@@ -6945,12 +7005,15 @@ function writeSchemas(form, options) {
     indent = 2,
     vendorPrefix,
     enumSerialization,
-    metadata
+    metadata,
+    logger: rawLogger
   } = options;
-  const buildOptions = vendorPrefix === void 0 && enumSerialization === void 0 && metadata === void 0 ? void 0 : {
+  const logger = (rawLogger ?? import_core4.noopLogger).child({ stage: "write" });
+  const buildOptions = vendorPrefix === void 0 && enumSerialization === void 0 && metadata === void 0 ? { logger: rawLogger } : {
     ...vendorPrefix !== void 0 && { vendorPrefix },
     ...enumSerialization !== void 0 && { enumSerialization },
-    ...metadata !== void 0 && { metadata }
+    ...metadata !== void 0 && { metadata },
+    logger: rawLogger
   };
   const { jsonSchema, uiSchema: uiSchema2 } = buildFormSchemas(form, buildOptions);
   if (!fs.existsSync(outDir)) {
@@ -6958,14 +7021,17 @@ function writeSchemas(form, options) {
   }
   const jsonSchemaPath = path3.join(outDir, `${name}-schema.json`);
   const uiSchemaPath = path3.join(outDir, `${name}-uischema.json`);
+  logger.debug("writing JSON Schema", { path: jsonSchemaPath });
   fs.writeFileSync(jsonSchemaPath, JSON.stringify(jsonSchema, null, indent));
+  logger.debug("writing UI Schema", { path: uiSchemaPath });
   fs.writeFileSync(uiSchemaPath, JSON.stringify(uiSchema2, null, indent));
   return { jsonSchemaPath, uiSchemaPath };
 }
-var fs, path3;
+var import_core4, fs, path3;
 var init_index = __esm({
   "src/index.ts"() {
     "use strict";
+    import_core4 = require("@formspec/core");
     init_generator();
     init_generator2();
     init_ir_generator();
@@ -6989,6 +7055,34 @@ var init_index = __esm({
 // src/cli.ts
 var path4 = __toESM(require("path"), 1);
 var import_node_url = require("url");
+
+// src/cli/logger.ts
+var import_node_module = require("module");
+var import_core = require("@formspec/core");
+var import_meta = {};
+var require2 = (0, import_node_module.createRequire)(import_meta.url);
+function createLogger(namespace) {
+  const debugEnv = process.env["DEBUG"] ?? "";
+  if (!(0, import_core.isNamespaceEnabled)(debugEnv, namespace)) {
+    return import_core.noopLogger;
+  }
+  const pinoModule = require2("pino");
+  const pino = typeof pinoModule === "function" ? pinoModule : pinoModule.default;
+  const isTTY = process.stderr.isTTY;
+  if (isTTY) {
+    const pinoPretty = require2("pino-pretty");
+    const prettyTransport = pinoPretty.default ?? pinoPretty;
+    const stream = prettyTransport({ destination: 2, colorize: true, sync: true });
+    return pino({ name: namespace, level: "debug" }, stream);
+  }
+  return pino(
+    { name: namespace, level: "debug" },
+    pino.destination({ dest: 2, sync: true })
+  );
+}
+
+// src/cli.ts
+var log = createLogger("formspec:build");
 function printHelp() {
   console.log(`
 FormSpec Build CLI - Generate JSON Schema and UI Schema
@@ -7078,6 +7172,7 @@ function parseArgs(args) {
   if (!name) {
     name = path4.basename(inputFile, path4.extname(inputFile));
   }
+  log.debug("Arguments parsed", { inputFile, outDir, name, enumSerialization });
   return { inputFile, outDir, name, enumSerialization };
 }
 async function main() {
@@ -7088,11 +7183,14 @@ async function main() {
   }
   const { inputFile, outDir, name, enumSerialization } = options;
   const absoluteInput = path4.resolve(process.cwd(), inputFile);
+  log.debug("Resolved input file", { absoluteInput });
   try {
     const fileUrl = (0, import_node_url.pathToFileURL)(absoluteInput).href;
+    log.debug("Loading form module", { fileUrl });
     const module2 = await import(fileUrl);
     const form = module2["default"] ?? module2["form"];
     if (!form || typeof form !== "object" || !("elements" in form)) {
+      log.error("Input file does not export a valid FormSpec", { fileUrl });
       console.error("Error: Input file must export a FormSpec as default export or as 'form'");
       console.error("Example:");
       console.error('  export default formspec(field.text("name"));');
@@ -7100,18 +7198,22 @@ async function main() {
       console.error('  export const form = formspec(field.text("name"));');
       process.exit(1);
     }
+    log.debug("Form module loaded, generating schemas");
     const { writeSchemas: writeSchemas2 } = await Promise.resolve().then(() => (init_index(), index_exports));
     const { jsonSchemaPath, uiSchemaPath } = writeSchemas2(
       form,
       { outDir, name, enumSerialization }
     );
+    log.debug("Schemas written", { jsonSchemaPath, uiSchemaPath });
     console.log("Generated:");
     console.log(`  ${jsonSchemaPath}`);
     console.log(`  ${uiSchemaPath}`);
   } catch (error) {
     if (error instanceof Error) {
+      log.child({ err: error.message }).error("Schema generation failed");
       console.error(`Error: ${error.message}`);
     } else {
+      log.error("Schema generation failed with unknown error");
       console.error("Error:", error);
     }
     process.exit(1);