@stripe/extensibility-jsonschema-tools 1.0.0 → 1.0.1

package/dist/extensibility-jsonschema-tools-alpha.d.ts

@@ -5,6 +5,30 @@ import { setSchemaExtension } from '@formspec/build/browser';
 import * as ts from 'typescript';
 import { uiSchemaSchema } from '@formspec/build/browser';
 
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy$1 = "local-wins" | "never";
+
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy = "local-wins" | "never";
+
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy_2 = "local-wins" | "never";
+
 /**
  * Registration for mapping a built-in TSDoc tag onto a custom constraint when
  * it is used on a particular custom type.
@@ -117,24 +141,6 @@ export declare interface Category {
 
 /* Excluded from this release type: _ConfigUiSchema */
 
-/**
- * Complete constraint configuration for a FormSpec project.
- *
- * @public
- */
-declare interface ConstraintConfig {
-    /** Field type constraints */
-    fieldTypes?: FieldTypeConstraints;
-    /** Layout and structure constraints */
-    layout?: LayoutConstraints;
-    /** UI Schema feature constraints */
-    uiSchema?: UISchemaConstraints;
-    /** Field configuration option constraints */
-    fieldOptions?: FieldOptionConstraints;
-    /** Control options constraints */
-    controlOptions?: ControlOptionConstraints;
-}
-
 /**
  * Semantic metadata for ordered custom constraints that should participate in
  * the generic contradiction/broadening logic.
@@ -270,7 +276,7 @@ export declare interface ControlElement {
 }
 
 /**
- * Control options constraints - control which JSONForms Control.options are allowed.
+ * Control options constraints - control which JSON Forms Control.options are allowed.
  * These are renderer-specific options that may not be universally supported.
  *
  * @public
@@ -301,6 +307,19 @@ declare interface ControlOptionConstraints {
 export declare interface CustomAnnotationRegistration {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -319,6 +338,19 @@ export declare interface CustomAnnotationRegistration {
 declare interface CustomAnnotationRegistration_2 {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy$1;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation$1;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -337,6 +369,19 @@ declare interface CustomAnnotationRegistration_2 {
 declare interface CustomAnnotationRegistration_3 {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy_2;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation_2;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -344,6 +389,81 @@ declare interface CustomAnnotationRegistration_3 {
     readonly toJsonSchema?: (value: ExtensionPayloadValue_2, vendorPrefix: string) => Record<string, unknown>;
 }
 
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation$1 {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation_2 {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
 /**
  * Registration for a custom constraint that maps to JSON Schema keywords.
  *
@@ -740,6 +860,24 @@ export declare interface DiscriminatorResolutionOptions {
     readonly apiNamePrefix?: string | undefined;
 }
 
+/**
+ * Complete DSL policy for a FormSpec project.
+ *
+ * @public
+ */
+declare interface DSLPolicy {
+    /** Field type constraints */
+    fieldTypes?: FieldTypeConstraints;
+    /** Layout and structure constraints */
+    layout?: LayoutConstraints;
+    /** UI schema feature constraints */
+    uiSchema?: UISchemaConstraints;
+    /** Field configuration option constraints */
+    fieldOptions?: FieldOptionConstraints;
+    /** Control options constraints */
+    controlOptions?: ControlOptionConstraints;
+}
+
 /**
  * Enum-member display names remain unset unless authored explicitly.
  *
@@ -1334,8 +1472,7 @@ declare interface FieldTypeConstraints {
 /* Excluded from this release type: _fixupDecimalPathConstraints */
 
 /**
- * Top-level FormSpec configuration file structure.
- * The .formspec.yml file uses this structure.
+ * Top-level FormSpec configuration structure.
  *
  * @public
  */
@@ -1345,9 +1482,11 @@ export declare interface FormSpecConfig {
      * annotations, and vocabulary keywords.
      */
     readonly extensions?: readonly ExtensionDefinition_3[];
-    /** Constraint surface configuration — controls which field types,
-     * layouts, UI features, and field/control options are allowed. */
-    readonly constraints?: ConstraintConfig;
+    /**
+     * DSL-policy surface configuration controlling which field types,
+     * layouts, UI features, and field/control options are allowed.
+     */
+    readonly constraints?: DSLPolicy;
     /**
      * Metadata inference and naming policy. Controls how apiName,
      * displayName, and plural forms are derived when not authored.
@@ -1367,6 +1506,11 @@ export declare interface FormSpecConfig {
      * @defaultValue "enum"
      */
     readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
+    /**
+     * JSON Schema serialization settings for vocabulary and dialect emission.
+     * PR-1 stores and resolves this block; PR-2 consumes it.
+     */
+    readonly serialization?: FormSpecSerializationConfig;
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -1382,14 +1526,31 @@ export declare interface FormSpecConfig {
  * @public
  */
 declare interface FormSpecPackageOverride {
-    /** Override constraint surface for this package. */
-    readonly constraints?: ConstraintConfig;
+    /** Override DSL policy for this package. */
+    readonly constraints?: DSLPolicy;
     /** Override enum serialization for this package. */
     readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
 
+/**
+ * Forward-looking JSON Schema serialization settings.
+ *
+ * These values are currently carried through configuration for future
+ * vocabulary and dialect emission.
+ *
+ * @public
+ */
+declare interface FormSpecSerializationConfig {
+    /** Base URL used to construct default FormSpec vocabulary URLs. */
+    readonly vocabularyBaseUrl?: string;
+    /** Per-vocabulary URL overrides keyed by vocabulary identifier. */
+    readonly vocabularyUrls?: Readonly<Record<string, string>>;
+    /** Explicit FormSpec dialect URL override. */
+    readonly dialectUrl?: string;
+}
+
 /**
  * Options for generating schemas from a decorated class.
  *
@@ -1560,6 +1721,8 @@ export declare interface JsonSchema2020 {
     description?: string;
     /** Default value suggested for the schema node. */
     default?: unknown;
+    /** Documentation example values (from one or more `@example` tags). */
+    examples?: unknown[];
     /** Whether the schema node is deprecated. */
     deprecated?: boolean;
     /** Additional vendor-prefixed extension keywords. */
@@ -1601,7 +1764,7 @@ declare interface LayoutConstraints {
 }
 
 /**
- * JSONForms layout type constraints.
+ * JSON Forms layout type constraints.
  *
  * @public
  */
@@ -2385,7 +2548,7 @@ export declare interface RuleConditionSchema {
 }
 
 /**
- * JSONForms rule constraints.
+ * JSON Forms rule constraints.
  *
  * @public
  */
@@ -2412,7 +2575,7 @@ declare interface RuleConstraints {
 export declare type RuleEffect = "DISABLE" | "ENABLE" | "HIDE" | "SHOW";
 
 /**
- * JSONForms rule effect constraints.
+ * JSON Forms rule effect constraints.
  *
  * @public
  */
@@ -2442,7 +2605,7 @@ export declare interface SchemaBasedCondition {
 export { setSchemaExtension }
 
 /**
- * Severity level for constraint violations.
+ * Severity level for DSL-policy violations.
  * - "error": Violation fails validation
  * - "warn": Violation emits warning but passes
  * - "off": Feature is allowed (no violation)
@@ -2521,7 +2684,7 @@ export declare interface StaticSchemaGenerationOptions {
 export declare type UISchema = Categorization | GroupLayout | HorizontalLayout | VerticalLayout;
 
 /**
- * UI Schema feature constraints - control JSONForms-specific features.
+ * UI schema feature constraints - control JSON Forms-specific features.
  *
  * @public
  */

package/dist/extensibility-jsonschema-tools-beta.d.ts

@@ -5,6 +5,30 @@ import { setSchemaExtension } from '@formspec/build/browser';
 import * as ts from 'typescript';
 import { uiSchemaSchema } from '@formspec/build/browser';
 
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy$1 = "local-wins" | "never";
+
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy = "local-wins" | "never";
+
+/**
+ * Controls whether a type-level annotation can flow from a base declaration to
+ * a derived declaration during semantic analysis.
+ *
+ * @public
+ */
+declare type AnnotationInheritancePolicy_2 = "local-wins" | "never";
+
 /**
  * Registration for mapping a built-in TSDoc tag onto a custom constraint when
  * it is used on a particular custom type.
@@ -117,24 +141,6 @@ export declare interface Category {
 
 /* Excluded from this release type: _ConfigUiSchema */
 
-/**
- * Complete constraint configuration for a FormSpec project.
- *
- * @public
- */
-declare interface ConstraintConfig {
-    /** Field type constraints */
-    fieldTypes?: FieldTypeConstraints;
-    /** Layout and structure constraints */
-    layout?: LayoutConstraints;
-    /** UI Schema feature constraints */
-    uiSchema?: UISchemaConstraints;
-    /** Field configuration option constraints */
-    fieldOptions?: FieldOptionConstraints;
-    /** Control options constraints */
-    controlOptions?: ControlOptionConstraints;
-}
-
 /**
  * Semantic metadata for ordered custom constraints that should participate in
  * the generic contradiction/broadening logic.
@@ -270,7 +276,7 @@ export declare interface ControlElement {
 }
 
 /**
- * Control options constraints - control which JSONForms Control.options are allowed.
+ * Control options constraints - control which JSON Forms Control.options are allowed.
  * These are renderer-specific options that may not be universally supported.
  *
  * @public
@@ -301,6 +307,19 @@ declare interface ControlOptionConstraints {
 export declare interface CustomAnnotationRegistration {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -319,6 +338,19 @@ export declare interface CustomAnnotationRegistration {
 declare interface CustomAnnotationRegistration_2 {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy$1;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation$1;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -337,6 +369,19 @@ declare interface CustomAnnotationRegistration_2 {
 declare interface CustomAnnotationRegistration_3 {
     /** The annotation name, unique within the extension. */
     readonly annotationName: string;
+    /**
+     * Optional type-level inheritance behavior for semantic consumers.
+     *
+     * `"local-wins"` means a derived declaration inherits this annotation from
+     * its base declaration only when the derived declaration does not provide the
+     * same extension annotation identity locally. Omitted registrations behave as
+     * `"never"`.
+     */
+    readonly inheritFromBase?: AnnotationInheritancePolicy_2;
+    /**
+     * Optional editor documentation for the annotation's TSDoc authoring tag.
+     */
+    readonly tagDocumentation?: CustomAnnotationTagDocumentation_2;
     /**
      * Optionally converts the annotation value into JSON Schema keywords.
      * If omitted, the annotation has no JSON Schema representation (UI-only).
@@ -344,6 +389,81 @@ declare interface CustomAnnotationRegistration_3 {
     readonly toJsonSchema?: (value: ExtensionPayloadValue_2, vendorPrefix: string) => Record<string, unknown>;
 }
 
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation$1 {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
+/**
+ * Documentation text for an extension annotation's TSDoc authoring tag.
+ *
+ * These strings are consumed by editor integrations for completion details and
+ * hover text. They do not affect annotation parsing, inheritance, or schema
+ * emission.
+ *
+ * @public
+ */
+declare interface CustomAnnotationTagDocumentation_2 {
+    /** Completion detail shown beside the annotation tag. */
+    readonly completionDetail?: string;
+    /**
+     * Label for the payload portion of the annotation tag signature.
+     *
+     * The payload remains the full authored text after the tag name, so this can
+     * describe single-argument or multi-argument annotation syntaxes.
+     */
+    readonly payloadLabel?: string;
+    /** Short hover summary shown for the annotation tag. */
+    readonly hoverSummary?: string;
+    /** Full markdown hover body for the annotation tag. */
+    readonly hoverMarkdown?: string;
+}
+
 /**
  * Registration for a custom constraint that maps to JSON Schema keywords.
  *
@@ -740,6 +860,24 @@ export declare interface DiscriminatorResolutionOptions {
     readonly apiNamePrefix?: string | undefined;
 }
 
+/**
+ * Complete DSL policy for a FormSpec project.
+ *
+ * @public
+ */
+declare interface DSLPolicy {
+    /** Field type constraints */
+    fieldTypes?: FieldTypeConstraints;
+    /** Layout and structure constraints */
+    layout?: LayoutConstraints;
+    /** UI schema feature constraints */
+    uiSchema?: UISchemaConstraints;
+    /** Field configuration option constraints */
+    fieldOptions?: FieldOptionConstraints;
+    /** Control options constraints */
+    controlOptions?: ControlOptionConstraints;
+}
+
 /**
  * Enum-member display names remain unset unless authored explicitly.
  *
@@ -1334,8 +1472,7 @@ declare interface FieldTypeConstraints {
 /* Excluded from this release type: _fixupDecimalPathConstraints */
 
 /**
- * Top-level FormSpec configuration file structure.
- * The .formspec.yml file uses this structure.
+ * Top-level FormSpec configuration structure.
  *
  * @public
  */
@@ -1345,9 +1482,11 @@ export declare interface FormSpecConfig {
      * annotations, and vocabulary keywords.
      */
     readonly extensions?: readonly ExtensionDefinition_3[];
-    /** Constraint surface configuration — controls which field types,
-     * layouts, UI features, and field/control options are allowed. */
-    readonly constraints?: ConstraintConfig;
+    /**
+     * DSL-policy surface configuration controlling which field types,
+     * layouts, UI features, and field/control options are allowed.
+     */
+    readonly constraints?: DSLPolicy;
     /**
      * Metadata inference and naming policy. Controls how apiName,
      * displayName, and plural forms are derived when not authored.
@@ -1367,6 +1506,11 @@ export declare interface FormSpecConfig {
      * @defaultValue "enum"
      */
     readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
+    /**
+     * JSON Schema serialization settings for vocabulary and dialect emission.
+     * PR-1 stores and resolves this block; PR-2 consumes it.
+     */
+    readonly serialization?: FormSpecSerializationConfig;
     /**
      * Per-package configuration overrides for monorepos.
      * Keys are glob patterns matched against file paths relative to
@@ -1382,14 +1526,31 @@ export declare interface FormSpecConfig {
  * @public
  */
 declare interface FormSpecPackageOverride {
-    /** Override constraint surface for this package. */
-    readonly constraints?: ConstraintConfig;
+    /** Override DSL policy for this package. */
+    readonly constraints?: DSLPolicy;
     /** Override enum serialization for this package. */
     readonly enumSerialization?: "enum" | "oneOf" | "smart-size";
     /** Override metadata policy for this package. */
     readonly metadata?: MetadataPolicyInput_2;
 }
 
+/**
+ * Forward-looking JSON Schema serialization settings.
+ *
+ * These values are currently carried through configuration for future
+ * vocabulary and dialect emission.
+ *
+ * @public
+ */
+declare interface FormSpecSerializationConfig {
+    /** Base URL used to construct default FormSpec vocabulary URLs. */
+    readonly vocabularyBaseUrl?: string;
+    /** Per-vocabulary URL overrides keyed by vocabulary identifier. */
+    readonly vocabularyUrls?: Readonly<Record<string, string>>;
+    /** Explicit FormSpec dialect URL override. */
+    readonly dialectUrl?: string;
+}
+
 /**
  * Options for generating schemas from a decorated class.
  *
@@ -1560,6 +1721,8 @@ export declare interface JsonSchema2020 {
     description?: string;
     /** Default value suggested for the schema node. */
     default?: unknown;
+    /** Documentation example values (from one or more `@example` tags). */
+    examples?: unknown[];
     /** Whether the schema node is deprecated. */
     deprecated?: boolean;
     /** Additional vendor-prefixed extension keywords. */
@@ -1601,7 +1764,7 @@ declare interface LayoutConstraints {
 }
 
 /**
- * JSONForms layout type constraints.
+ * JSON Forms layout type constraints.
  *
  * @public
  */
@@ -2385,7 +2548,7 @@ export declare interface RuleConditionSchema {
 }
 
 /**
- * JSONForms rule constraints.
+ * JSON Forms rule constraints.
  *
  * @public
  */
@@ -2412,7 +2575,7 @@ declare interface RuleConstraints {
 export declare type RuleEffect = "DISABLE" | "ENABLE" | "HIDE" | "SHOW";
 
 /**
- * JSONForms rule effect constraints.
+ * JSON Forms rule effect constraints.
  *
  * @public
  */
@@ -2442,7 +2605,7 @@ export declare interface SchemaBasedCondition {
 export { setSchemaExtension }
 
 /**
- * Severity level for constraint violations.
+ * Severity level for DSL-policy violations.
  * - "error": Violation fails validation
  * - "warn": Violation emits warning but passes
  * - "off": Feature is allowed (no violation)
@@ -2521,7 +2684,7 @@ export declare interface StaticSchemaGenerationOptions {
 export declare type UISchema = Categorization | GroupLayout | HorizontalLayout | VerticalLayout;
 
 /**
- * UI Schema feature constraints - control JSONForms-specific features.
+ * UI schema feature constraints - control JSON Forms-specific features.
  *
  * @public
  */