@formspec/build 0.1.0-alpha.55 → 0.1.0-alpha.57

package/dist/build-alpha.d.ts

@@ -905,11 +905,12 @@ export declare interface FormSpecConfig {
     readonly vendorPrefix?: string;
     /**
      * JSON Schema representation for static enums.
-     * - "enum": flat { "enum": ["a", "b"] }
-     * - "oneOf": { "oneOf": [{ "const": "a" }, ...] }
+     * - "enum": compact `enum` output, plus a display-name extension when labels exist
+     * - "oneOf": per-member `const` output, with `title` only for distinct labels
+     * - "smart-size": uses `enum` unless a distinct display label would be lost
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -928,7 +929,7 @@ declare interface FormSpecPackageOverride {
     /** Override constraint surface for this package. */
     readonly constraints?: ConstraintConfig;
     /** Override enum serialization for this package. */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
@@ -1011,7 +1012,7 @@ export declare interface GenerateJsonSchemaOptions {
      * JSON Schema representation to use for static enums.
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
     /**
@@ -2173,7 +2174,7 @@ export declare interface StaticSchemaGenerationOptions {
      * @defaultValue "enum"
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Metadata resolution policy for static schema generation.
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.

package/dist/build-beta.d.ts

@@ -905,11 +905,12 @@ export declare interface FormSpecConfig {
     readonly vendorPrefix?: string;
     /**
      * JSON Schema representation for static enums.
-     * - "enum": flat { "enum": ["a", "b"] }
-     * - "oneOf": { "oneOf": [{ "const": "a" }, ...] }
+     * - "enum": compact `enum` output, plus a display-name extension when labels exist
+     * - "oneOf": per-member `const` output, with `title` only for distinct labels
+     * - "smart-size": uses `enum` unless a distinct display label would be lost
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -928,7 +929,7 @@ declare interface FormSpecPackageOverride {
     /** Override constraint surface for this package. */
     readonly constraints?: ConstraintConfig;
     /** Override enum serialization for this package. */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
@@ -1011,7 +1012,7 @@ export declare interface GenerateJsonSchemaOptions {
      * JSON Schema representation to use for static enums.
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
     /**
@@ -2173,7 +2174,7 @@ export declare interface StaticSchemaGenerationOptions {
      * @defaultValue "enum"
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Metadata resolution policy for static schema generation.
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.

package/dist/build-internal.d.ts

@@ -905,11 +905,12 @@ export declare interface FormSpecConfig {
     readonly vendorPrefix?: string;
     /**
      * JSON Schema representation for static enums.
-     * - "enum": flat { "enum": ["a", "b"] }
-     * - "oneOf": { "oneOf": [{ "const": "a" }, ...] }
+     * - "enum": compact `enum` output, plus a display-name extension when labels exist
+     * - "oneOf": per-member `const` output, with `title` only for distinct labels
+     * - "smart-size": uses `enum` unless a distinct display label would be lost
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -928,7 +929,7 @@ declare interface FormSpecPackageOverride {
     /** Override constraint surface for this package. */
     readonly constraints?: ConstraintConfig;
     /** Override enum serialization for this package. */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
@@ -1011,7 +1012,7 @@ export declare interface GenerateJsonSchemaOptions {
      * JSON Schema representation to use for static enums.
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
     /**
@@ -2173,7 +2174,7 @@ export declare interface StaticSchemaGenerationOptions {
      * @defaultValue "enum"
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Metadata resolution policy for static schema generation.
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.

package/dist/build.d.ts

@@ -905,11 +905,12 @@ export declare interface FormSpecConfig {
     readonly vendorPrefix?: string;
     /**
      * JSON Schema representation for static enums.
-     * - "enum": flat { "enum": ["a", "b"] }
-     * - "oneOf": { "oneOf": [{ "const": "a" }, ...] }
+     * - "enum": compact `enum` output, plus a display-name extension when labels exist
+     * - "oneOf": per-member `const` output, with `title` only for distinct labels
+     * - "smart-size": uses `enum` unless a distinct display label would be lost
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -928,7 +929,7 @@ declare interface FormSpecPackageOverride {
     /** Override constraint surface for this package. */
     readonly constraints?: ConstraintConfig;
     /** Override enum serialization for this package. */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
@@ -1011,7 +1012,7 @@ export declare interface GenerateJsonSchemaOptions {
      * JSON Schema representation to use for static enums.
      * @defaultValue "enum"
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Metadata resolution policy for chain DSL generation. */
     readonly metadata?: MetadataPolicyInput | undefined;
     /**
@@ -2173,7 +2174,7 @@ export declare interface StaticSchemaGenerationOptions {
      * @defaultValue "enum"
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.
      */
-    readonly enumSerialization?: "enum" | "oneOf";
+    readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /**
      * Metadata resolution policy for static schema generation.
      * @deprecated Provide a `FormSpecConfig` via the `config` option instead.

package/dist/cli.cjs

@@ -1018,20 +1018,29 @@ var init_collision_guards = __esm({
 });
 
 // src/json-schema/ir-generator.ts
+function parseEnumSerialization(value) {
+  switch (value) {
+    case void 0:
+    case "enum":
+      return "enum";
+    case "oneOf":
+      return "oneOf";
+    case "smart-size":
+      return "smart-size";
+    default:
+      throw new Error(
+        `Invalid enumSerialization "${String(value)}". Expected "enum", "oneOf", or "smart-size".`
+      );
+  }
+}
 function makeContext(options) {
   const vendorPrefix = options?.vendorPrefix ?? "x-formspec";
-  const rawEnumSerialization = options?.enumSerialization;
+  const enumSerialization = parseEnumSerialization(options?.enumSerialization);
   if (!vendorPrefix.startsWith("x-")) {
     throw new Error(
       `Invalid vendorPrefix "${vendorPrefix}". Extension JSON Schema keywords must start with "x-".`
     );
   }
-  if (rawEnumSerialization !== void 0 && rawEnumSerialization !== "enum" && rawEnumSerialization !== "oneOf") {
-    throw new Error(
-      `Invalid enumSerialization "${rawEnumSerialization}". Expected "enum" or "oneOf".`
-    );
-  }
-  const enumSerialization = rawEnumSerialization ?? "enum";
   return {
     defs: {},
     typeNameMap: {},
@@ -1239,7 +1248,7 @@ function generatePrimitiveType(type) {
   };
 }
 function generateEnumType(type, ctx) {
-  if (ctx.enumSerialization === "oneOf") {
+  if (ctx.enumSerialization === "oneOf" || ctx.enumSerialization === "smart-size" && shouldSerializeEnumAsOneOf(type)) {
     return {
       oneOf: type.members.map((m) => {
         const stringValue = String(m.value);
@@ -1249,12 +1258,21 @@ function generateEnumType(type, ctx) {
     };
   }
   const schema = { enum: type.members.map((m) => m.value) };
+  if (ctx.enumSerialization === "smart-size") {
+    return schema;
+  }
   const displayNames = buildEnumDisplayNameExtension(type);
   if (displayNames !== void 0) {
     schema[`${ctx.vendorPrefix}-display-names`] = displayNames;
   }
   return schema;
 }
+function shouldSerializeEnumAsOneOf(type) {
+  return type.members.some((member) => {
+    const title = member.displayName ?? String(member.value);
+    return title !== String(member.value);
+  });
+}
 function buildEnumDisplayNameExtension(type) {
   if (!type.members.some((member) => member.displayName !== void 0)) {
     return void 0;
@@ -7194,7 +7212,7 @@ Usage:
 Options:
   -o, --out-dir <dir>   Output directory (default: ./generated)
   -n, --name <name>     Base name for output files (default: derived from input)
-  --enum-serialization <enum|oneOf>
+  --enum-serialization <enum|oneOf|smart-size>
                          Enum JSON Schema representation (default: enum)
   -h, --help            Show this help message
 
@@ -7246,8 +7264,10 @@ function parseArgs(args) {
         console.error("Error: --enum-serialization requires a value");
         return null;
       }
-      if (nextArg !== "enum" && nextArg !== "oneOf") {
-        console.error('Error: --enum-serialization must be "enum" or "oneOf"');
+      if (nextArg !== "enum" && nextArg !== "oneOf" && nextArg !== "smart-size") {
+        console.error(
+          'Error: --enum-serialization must be "enum", "oneOf", or "smart-size"'
+        );
         return null;
       }
       enumSerialization = nextArg;