@formspec/build 0.1.0-alpha.15 → 0.1.0-alpha.17

package/dist/build.d.ts

@@ -23,6 +23,8 @@
  * @packageDocumentation
  */
 
+import type { BuiltinConstraintBroadeningRegistration } from '@formspec/core';
+import type { ConstraintTagRegistration } from '@formspec/core';
 import type { CustomAnnotationRegistration } from '@formspec/core';
 import type { CustomConstraintRegistration } from '@formspec/core';
 import type { CustomTypeRegistration } from '@formspec/core';
@@ -30,6 +32,7 @@ import type { ExtensionDefinition } from '@formspec/core';
 import type { FormElement } from '@formspec/core';
 import type { FormIR } from '@formspec/core';
 import type { FormSpec } from '@formspec/core';
+import type { JsonValue } from '@formspec/core';
 import { z } from 'zod';
 
 /**
@@ -69,6 +72,32 @@ export declare function buildFormSchemas<E extends readonly FormElement[]>(form:
  */
 export declare type BuildFormSchemasOptions = GenerateJsonSchemaOptions;
 
+/**
+ * Builds JSON Schema and UI Schema from a TSDoc-derived model with ChainDSL
+ * field overlays.
+ *
+ * Overlays are matched by field name. The static model wins for structure,
+ * ordering, and constraints; ChainDSL overlays may contribute dynamic runtime
+ * field metadata such as dynamic enum or dynamic schema keywords, and may fill
+ * in missing annotations.
+ */
+export declare function buildMixedAuthoringSchemas(options: BuildMixedAuthoringSchemasOptions): MixedAuthoringSchemas;
+
+/**
+ * Options for generating mixed-authoring schemas.
+ *
+ * The `typeName` can resolve to a class, interface, or object type alias, just
+ * like `generateSchemas()`.
+ */
+export declare interface BuildMixedAuthoringSchemasOptions extends GenerateJsonSchemaFromIROptions {
+    /** Path to the TypeScript source file. */
+    readonly filePath: string;
+    /** Name of the class, interface, or type alias to analyze. */
+    readonly typeName: string;
+    /** ChainDSL overlays to apply to the static model. Groups and conditionals are flattened by field name. */
+    readonly overlays: FormSpec<readonly FormElement[]>;
+}
+
 /**
  * Result of building form schemas.
  */
@@ -250,6 +279,16 @@ export declare interface ExtensionRegistry {
      * @returns The registration if found, otherwise `undefined`.
      */
     findType(typeId: string): CustomTypeRegistration | undefined;
+    /**
+     * Look up a custom type registration by a TypeScript-facing type name.
+     *
+     * This is used during TSDoc/class analysis to resolve extension-defined
+     * custom types from source-level declarations.
+     */
+    findTypeByName(typeName: string): {
+        readonly extensionId: string;
+        readonly registration: CustomTypeRegistration;
+    } | undefined;
     /**
      * Look up a custom constraint registration by its fully-qualified constraint ID.
      *
@@ -257,6 +296,20 @@ export declare interface ExtensionRegistry {
      * @returns The registration if found, otherwise `undefined`.
      */
     findConstraint(constraintId: string): CustomConstraintRegistration | undefined;
+    /**
+     * Look up a TSDoc custom constraint-tag registration by tag name.
+     */
+    findConstraintTag(tagName: string): {
+        readonly extensionId: string;
+        readonly registration: ConstraintTagRegistration;
+    } | undefined;
+    /**
+     * Look up built-in tag broadening for a given custom type ID.
+     */
+    findBuiltinConstraintBroadening(typeId: string, tagName: string): {
+        readonly extensionId: string;
+        readonly registration: BuiltinConstraintBroadeningRegistration;
+    } | undefined;
     /**
      * Look up a custom annotation registration by its fully-qualified annotation ID.
      *
@@ -272,7 +325,7 @@ export declare type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, un
 /**
  * Options for generating schemas from a decorated class.
  */
-export declare interface GenerateFromClassOptions {
+export declare interface GenerateFromClassOptions extends GenerateJsonSchemaFromIROptions {
     /** Path to the TypeScript source file */
     filePath: string;
     /** Class name to analyze */
@@ -431,7 +484,7 @@ export declare function generateSchemasFromClass(options: GenerateFromClassOptio
 /**
  * Options for generating schemas from a named type (class, interface, or type alias).
  */
-export declare interface GenerateSchemasOptions {
+export declare interface GenerateSchemasOptions extends GenerateJsonSchemaFromIROptions {
     /** Path to the TypeScript source file */
     filePath: string;
     /** Name of the exported class, interface, or type alias to analyze */
@@ -538,7 +591,7 @@ export declare interface JsonSchema2020 {
     items?: JsonSchema2020;
     additionalProperties?: boolean | JsonSchema2020;
     enum?: readonly (string | number)[];
-    const?: string | number | boolean | null;
+    const?: JsonValue;
     allOf?: readonly JsonSchema2020[];
     oneOf?: readonly JsonSchema2020[];
     anyOf?: readonly JsonSchema2020[];
@@ -553,6 +606,7 @@ export declare interface JsonSchema2020 {
     maxItems?: number;
     pattern?: string;
     uniqueItems?: boolean;
+    format?: string;
     title?: string;
     description?: string;
     default?: unknown;
@@ -726,6 +780,16 @@ export declare const labelElementSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.ZodTypeAny, "passthrough">>;
 
+/**
+ * Result of generating schemas from a mixed-authoring composition.
+ */
+export declare interface MixedAuthoringSchemas {
+    /** JSON Schema 2020-12 for validation. */
+    readonly jsonSchema: JsonSchema2020;
+    /** JSON Forms UI Schema for rendering. */
+    readonly uiSchema: UISchema;
+}
+
 /**
  * Rule for conditional element visibility/enablement.
  */

package/dist/canonicalize/tsdoc-canonicalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc-canonicalizer.d.ts","sourceRoot":"","sources":["../../src/canonicalize/tsdoc-canonicalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,+BAA+B,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAmBzF"}
+{"version":3,"file":"tsdoc-canonicalizer.d.ts","sourceRoot":"","sources":["../../src/canonicalize/tsdoc-canonicalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,+BAA+B,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAqBzF"}