@formspec/build 0.1.0-alpha.26 → 0.1.0-alpha.28

package/dist/build-alpha.d.ts

@@ -27,9 +27,7 @@ import { AnyField } from '@formspec/core';
 import { ArrayField } from '@formspec/core';
 import { BooleanField } from '@formspec/core';
 import { BuiltinConstraintBroadeningRegistration } from '@formspec/core';
-import { BuiltinConstraintName } from '@formspec/core';
 import { Conditional } from '@formspec/core';
-import { ConstraintSemanticRole } from '@formspec/core';
 import { ConstraintTagRegistration } from '@formspec/core';
 import { CustomAnnotationRegistration } from '@formspec/core';
 import { CustomConstraintRegistration } from '@formspec/core';
@@ -38,10 +36,7 @@ import { DynamicEnumField } from '@formspec/core';
 import { DynamicSchemaField } from '@formspec/core';
 import { EnumOption } from '@formspec/core';
 import { EnumOptionValue } from '@formspec/core';
-import { ExtensionApplicableType } from '@formspec/core';
 import { ExtensionDefinition } from '@formspec/core';
-import { ExtensionPayloadValue } from '@formspec/core';
-import { ExtensionTypeKind } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
@@ -49,7 +44,8 @@ import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
 import { StaticEnumField } from '@formspec/core';
 import { TextField } from '@formspec/core';
-import { VocabularyKeywordRegistration } from '@formspec/core';
+import * as ts from 'typescript';
+import { z } from 'zod';
 
 export { AnyField }
 
@@ -142,8 +138,6 @@ export declare interface BuildResult {
 
 export { BuiltinConstraintBroadeningRegistration }
 
-export { BuiltinConstraintName }
-
 /**
  * A Categorization element (tab-based layout).
  *
@@ -186,8 +180,6 @@ export declare interface Category {
 
 export { Conditional }
 
-export { ConstraintSemanticRole }
-
 export { ConstraintTagRegistration }
 
 /**
@@ -242,16 +234,12 @@ export { EnumOptionValue }
 /**
  * JSON Schema with FormSpec extension properties for arbitrary `x-formspec-*` keys.
  *
- * @beta
+ * @public
  */
 export declare type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
 
-export { ExtensionApplicableType }
-
 export { ExtensionDefinition }
 
-export { ExtensionPayloadValue }
-
 /**
  * A registry of extensions that provides lookup by fully-qualified ID.
  *
@@ -311,8 +299,6 @@ export declare interface ExtensionRegistry {
     findAnnotation(annotationId: string): CustomAnnotationRegistration | undefined;
 }
 
-export { ExtensionTypeKind }
-
 export { FormElement }
 
 export { FormSpec }
@@ -320,7 +306,7 @@ export { FormSpec }
 /**
  * Extension properties for custom FormSpec constraint tags.
  *
- * @beta
+ * @public
  */
 export declare type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
 
@@ -439,6 +425,34 @@ export declare function generateSchemas(options: GenerateSchemasOptions): Genera
  */
 export declare function generateSchemasFromClass(options: GenerateFromClassOptions): GenerateFromClassResult;
 
+/**
+ * Generates JSON Schema and UI Schema from a named type within an existing
+ * TypeScript program supplied by the caller.
+ *
+ * This low-level entry point lets downstream tooling reuse a host-owned
+ * `Program` for both FormSpec extraction and other TypeScript analysis.
+ *
+ * @param options - Host program, file path, type name, and optional schema generation options
+ * @returns Generated JSON Schema and UI Schema
+ *
+ * @public
+ */
+export declare function generateSchemasFromProgram(options: GenerateSchemasFromProgramOptions): GenerateFromClassResult;
+
+/**
+ * Options for generating schemas from a named type inside an existing TypeScript program.
+ *
+ * @public
+ */
+export declare interface GenerateSchemasFromProgramOptions extends StaticSchemaGenerationOptions {
+    /** Existing TypeScript program supplied by the caller. */
+    readonly program: ts.Program;
+    /** Path to the TypeScript source file */
+    readonly filePath: string;
+    /** Name of the exported class, interface, or type alias to analyze */
+    readonly typeName: string;
+}
+
 /**
  * Options for generating schemas from a named type (class, interface, or type alias).
  *
@@ -613,7 +627,7 @@ export declare interface JsonSchema2020 {
 /**
  * A JSON Schema definition (legacy subset used by Zod validator and types.ts).
  *
- * @beta
+ * @public
  */
 export declare interface JSONSchema7 {
     /** Declared JSON Schema dialect URI for the document root. */
@@ -695,6 +709,13 @@ export declare interface JSONSchema7 {
     "x-formspec-schemaSource"?: string;
 }
 
+/**
+ * Zod schema for the legacy JSON Schema 7 subset used by `@formspec/build`.
+ *
+ * @public
+ */
+export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
+
 /**
  * JSON Schema type definitions.
  *
@@ -703,7 +724,7 @@ export declare interface JSONSchema7 {
 /**
  * JSON Schema primitive types.
  *
- * @beta
+ * @public
  */
 export declare type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 
@@ -873,6 +894,13 @@ export declare interface UISchemaElementBase {
  */
 export declare type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category" | "Label";
 
+/**
+ * Zod schema for the root UI Schema (layout types only).
+ *
+ * @public
+ */
+export declare const uiSchemaSchema: z.ZodType<UISchema>;
+
 /**
  * A vertical layout element.
  *
@@ -891,8 +919,6 @@ export declare interface VerticalLayout {
     readonly [k: string]: unknown;
 }
 
-export { VocabularyKeywordRegistration }
-
 /**
  * Builds and writes both JSON Schema and UI Schema files to disk.
  *

package/dist/build-beta.d.ts

@@ -27,9 +27,7 @@ import { AnyField } from '@formspec/core';
 import { ArrayField } from '@formspec/core';
 import { BooleanField } from '@formspec/core';
 import { BuiltinConstraintBroadeningRegistration } from '@formspec/core';
-import { BuiltinConstraintName } from '@formspec/core';
 import { Conditional } from '@formspec/core';
-import { ConstraintSemanticRole } from '@formspec/core';
 import { ConstraintTagRegistration } from '@formspec/core';
 import { CustomAnnotationRegistration } from '@formspec/core';
 import { CustomConstraintRegistration } from '@formspec/core';
@@ -38,10 +36,7 @@ import { DynamicEnumField } from '@formspec/core';
 import { DynamicSchemaField } from '@formspec/core';
 import { EnumOption } from '@formspec/core';
 import { EnumOptionValue } from '@formspec/core';
-import { ExtensionApplicableType } from '@formspec/core';
 import { ExtensionDefinition } from '@formspec/core';
-import { ExtensionPayloadValue } from '@formspec/core';
-import { ExtensionTypeKind } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
@@ -49,7 +44,8 @@ import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
 import { StaticEnumField } from '@formspec/core';
 import { TextField } from '@formspec/core';
-import { VocabularyKeywordRegistration } from '@formspec/core';
+import * as ts from 'typescript';
+import { z } from 'zod';
 
 export { AnyField }
 
@@ -142,8 +138,6 @@ export declare interface BuildResult {
 
 export { BuiltinConstraintBroadeningRegistration }
 
-export { BuiltinConstraintName }
-
 /**
  * A Categorization element (tab-based layout).
  *
@@ -186,8 +180,6 @@ export declare interface Category {
 
 export { Conditional }
 
-export { ConstraintSemanticRole }
-
 export { ConstraintTagRegistration }
 
 /**
@@ -242,16 +234,12 @@ export { EnumOptionValue }
 /**
  * JSON Schema with FormSpec extension properties for arbitrary `x-formspec-*` keys.
  *
- * @beta
+ * @public
  */
 export declare type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
 
-export { ExtensionApplicableType }
-
 export { ExtensionDefinition }
 
-export { ExtensionPayloadValue }
-
 /**
  * A registry of extensions that provides lookup by fully-qualified ID.
  *
@@ -311,8 +299,6 @@ export declare interface ExtensionRegistry {
     findAnnotation(annotationId: string): CustomAnnotationRegistration | undefined;
 }
 
-export { ExtensionTypeKind }
-
 export { FormElement }
 
 export { FormSpec }
@@ -320,7 +306,7 @@ export { FormSpec }
 /**
  * Extension properties for custom FormSpec constraint tags.
  *
- * @beta
+ * @public
  */
 export declare type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
 
@@ -439,6 +425,34 @@ export declare function generateSchemas(options: GenerateSchemasOptions): Genera
  */
 export declare function generateSchemasFromClass(options: GenerateFromClassOptions): GenerateFromClassResult;
 
+/**
+ * Generates JSON Schema and UI Schema from a named type within an existing
+ * TypeScript program supplied by the caller.
+ *
+ * This low-level entry point lets downstream tooling reuse a host-owned
+ * `Program` for both FormSpec extraction and other TypeScript analysis.
+ *
+ * @param options - Host program, file path, type name, and optional schema generation options
+ * @returns Generated JSON Schema and UI Schema
+ *
+ * @public
+ */
+export declare function generateSchemasFromProgram(options: GenerateSchemasFromProgramOptions): GenerateFromClassResult;
+
+/**
+ * Options for generating schemas from a named type inside an existing TypeScript program.
+ *
+ * @public
+ */
+export declare interface GenerateSchemasFromProgramOptions extends StaticSchemaGenerationOptions {
+    /** Existing TypeScript program supplied by the caller. */
+    readonly program: ts.Program;
+    /** Path to the TypeScript source file */
+    readonly filePath: string;
+    /** Name of the exported class, interface, or type alias to analyze */
+    readonly typeName: string;
+}
+
 /**
  * Options for generating schemas from a named type (class, interface, or type alias).
  *
@@ -613,7 +627,7 @@ export declare interface JsonSchema2020 {
 /**
  * A JSON Schema definition (legacy subset used by Zod validator and types.ts).
  *
- * @beta
+ * @public
  */
 export declare interface JSONSchema7 {
     /** Declared JSON Schema dialect URI for the document root. */
@@ -695,6 +709,13 @@ export declare interface JSONSchema7 {
     "x-formspec-schemaSource"?: string;
 }
 
+/**
+ * Zod schema for the legacy JSON Schema 7 subset used by `@formspec/build`.
+ *
+ * @public
+ */
+export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
+
 /**
  * JSON Schema type definitions.
  *
@@ -703,7 +724,7 @@ export declare interface JSONSchema7 {
 /**
  * JSON Schema primitive types.
  *
- * @beta
+ * @public
  */
 export declare type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 
@@ -873,6 +894,13 @@ export declare interface UISchemaElementBase {
  */
 export declare type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category" | "Label";
 
+/**
+ * Zod schema for the root UI Schema (layout types only).
+ *
+ * @public
+ */
+export declare const uiSchemaSchema: z.ZodType<UISchema>;
+
 /**
  * A vertical layout element.
  *
@@ -891,8 +919,6 @@ export declare interface VerticalLayout {
     readonly [k: string]: unknown;
 }
 
-export { VocabularyKeywordRegistration }
-
 /**
  * Builds and writes both JSON Schema and UI Schema files to disk.
  *

package/dist/build-internal.d.ts

@@ -27,9 +27,7 @@ import { AnyField } from '@formspec/core';
 import { ArrayField } from '@formspec/core';
 import { BooleanField } from '@formspec/core';
 import { BuiltinConstraintBroadeningRegistration } from '@formspec/core';
-import { BuiltinConstraintName } from '@formspec/core';
 import { Conditional } from '@formspec/core';
-import { ConstraintSemanticRole } from '@formspec/core';
 import { ConstraintTagRegistration } from '@formspec/core';
 import { CustomAnnotationRegistration } from '@formspec/core';
 import { CustomConstraintRegistration } from '@formspec/core';
@@ -38,10 +36,7 @@ import { DynamicEnumField } from '@formspec/core';
 import { DynamicSchemaField } from '@formspec/core';
 import { EnumOption } from '@formspec/core';
 import { EnumOptionValue } from '@formspec/core';
-import { ExtensionApplicableType } from '@formspec/core';
 import { ExtensionDefinition } from '@formspec/core';
-import { ExtensionPayloadValue } from '@formspec/core';
-import { ExtensionTypeKind } from '@formspec/core';
 import { FormElement } from '@formspec/core';
 import { FormSpec } from '@formspec/core';
 import { Group } from '@formspec/core';
@@ -49,7 +44,8 @@ import { NumberField } from '@formspec/core';
 import { ObjectField } from '@formspec/core';
 import { StaticEnumField } from '@formspec/core';
 import { TextField } from '@formspec/core';
-import { VocabularyKeywordRegistration } from '@formspec/core';
+import * as ts from 'typescript';
+import { z } from 'zod';
 
 export { AnyField }
 
@@ -142,8 +138,6 @@ export declare interface BuildResult {
 
 export { BuiltinConstraintBroadeningRegistration }
 
-export { BuiltinConstraintName }
-
 /**
  * A Categorization element (tab-based layout).
  *
@@ -186,8 +180,6 @@ export declare interface Category {
 
 export { Conditional }
 
-export { ConstraintSemanticRole }
-
 export { ConstraintTagRegistration }
 
 /**
@@ -242,16 +234,12 @@ export { EnumOptionValue }
 /**
  * JSON Schema with FormSpec extension properties for arbitrary `x-formspec-*` keys.
  *
- * @beta
+ * @public
  */
 export declare type ExtendedJSONSchema7 = JSONSchema7 & FormSpecSchemaExtensions;
 
-export { ExtensionApplicableType }
-
 export { ExtensionDefinition }
 
-export { ExtensionPayloadValue }
-
 /**
  * A registry of extensions that provides lookup by fully-qualified ID.
  *
@@ -311,8 +299,6 @@ export declare interface ExtensionRegistry {
     findAnnotation(annotationId: string): CustomAnnotationRegistration | undefined;
 }
 
-export { ExtensionTypeKind }
-
 export { FormElement }
 
 export { FormSpec }
@@ -320,7 +306,7 @@ export { FormSpec }
 /**
  * Extension properties for custom FormSpec constraint tags.
  *
- * @beta
+ * @public
  */
 export declare type FormSpecSchemaExtensions = Record<`x-formspec-${string}`, unknown>;
 
@@ -439,6 +425,34 @@ export declare function generateSchemas(options: GenerateSchemasOptions): Genera
  */
 export declare function generateSchemasFromClass(options: GenerateFromClassOptions): GenerateFromClassResult;
 
+/**
+ * Generates JSON Schema and UI Schema from a named type within an existing
+ * TypeScript program supplied by the caller.
+ *
+ * This low-level entry point lets downstream tooling reuse a host-owned
+ * `Program` for both FormSpec extraction and other TypeScript analysis.
+ *
+ * @param options - Host program, file path, type name, and optional schema generation options
+ * @returns Generated JSON Schema and UI Schema
+ *
+ * @public
+ */
+export declare function generateSchemasFromProgram(options: GenerateSchemasFromProgramOptions): GenerateFromClassResult;
+
+/**
+ * Options for generating schemas from a named type inside an existing TypeScript program.
+ *
+ * @public
+ */
+export declare interface GenerateSchemasFromProgramOptions extends StaticSchemaGenerationOptions {
+    /** Existing TypeScript program supplied by the caller. */
+    readonly program: ts.Program;
+    /** Path to the TypeScript source file */
+    readonly filePath: string;
+    /** Name of the exported class, interface, or type alias to analyze */
+    readonly typeName: string;
+}
+
 /**
  * Options for generating schemas from a named type (class, interface, or type alias).
  *
@@ -613,7 +627,7 @@ export declare interface JsonSchema2020 {
 /**
  * A JSON Schema definition (legacy subset used by Zod validator and types.ts).
  *
- * @beta
+ * @public
  */
 export declare interface JSONSchema7 {
     /** Declared JSON Schema dialect URI for the document root. */
@@ -695,6 +709,13 @@ export declare interface JSONSchema7 {
     "x-formspec-schemaSource"?: string;
 }
 
+/**
+ * Zod schema for the legacy JSON Schema 7 subset used by `@formspec/build`.
+ *
+ * @public
+ */
+export declare const jsonSchema7Schema: z.ZodType<JSONSchema7>;
+
 /**
  * JSON Schema type definitions.
  *
@@ -703,7 +724,7 @@ export declare interface JSONSchema7 {
 /**
  * JSON Schema primitive types.
  *
- * @beta
+ * @public
  */
 export declare type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
 
@@ -873,6 +894,13 @@ export declare interface UISchemaElementBase {
  */
 export declare type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category" | "Label";
 
+/**
+ * Zod schema for the root UI Schema (layout types only).
+ *
+ * @public
+ */
+export declare const uiSchemaSchema: z.ZodType<UISchema>;
+
 /**
  * A vertical layout element.
  *
@@ -891,8 +919,6 @@ export declare interface VerticalLayout {
     readonly [k: string]: unknown;
 }
 
-export { VocabularyKeywordRegistration }
-
 /**
  * Builds and writes both JSON Schema and UI Schema files to disk.
  *