@builder-builder/builder 0.0.13 → 0.0.14

package/dist/entities/ui/input.js

@@ -0,0 +1,39 @@
+import * as v from 'valibot';
+import { BuilderPathSchema } from '../../paths.js';
+import { paramable } from '../../references.js';
+import { serialisable } from '../../serialisable.js';
+export class BuilderUIInput {
+    type = 'input';
+    path;
+    displayName;
+    kind;
+    metadata;
+    constructor(path, displayName, kind, metadata) {
+        this.path = path;
+        this.displayName = displayName;
+        this.kind = kind;
+        this.metadata = metadata;
+    }
+    display(displayName) {
+        return new BuilderUIInput(this.path, displayName, this.kind, this.metadata);
+    }
+    as(kind) {
+        return new BuilderUIInput(this.path, this.displayName, kind, this.metadata);
+    }
+    meta(metadata) {
+        return new BuilderUIInput(this.path, this.displayName, this.kind, metadata);
+    }
+}
+export function input(path) {
+    return new BuilderUIInput(path);
+}
+export const BuilderUIInputSchema = v.instance(BuilderUIInput);
+export const BuilderUIInputMetadataSchema = v.pipe(v.record(v.string(), paramable(v.unknown())), v.readonly());
+export const BuilderUIInputSerialisedSchema = serialisable(v.object({
+    type: v.literal('input'),
+    path: paramable(BuilderPathSchema),
+    displayName: v.optional(paramable(v.string())),
+    kind: v.optional(paramable(v.string())),
+    metadata: v.optional(paramable(BuilderUIInputMetadataSchema))
+}));
+export const BuilderUIInputsSerialisedSchema = v.pipe(v.array(paramable(BuilderUIInputSerialisedSchema)), v.readonly());

package/dist/entities/ui/page.d.ts

@@ -1,11 +1,11 @@
-import type { BuilderPaths } from '../../paths';
 import type { Paramable } from '../../references';
+import type { BuilderUIInputs } from './input';
 import * as v from 'valibot';
-export declare class BuilderUIPage<const Label extends Paramable<string> = Paramable<string>, const Paths extends Paramable<BuilderPaths> = Paramable<BuilderPaths>> {
+export declare class BuilderUIPage<const Label extends Paramable<string> = Paramable<string>, const Inputs extends Paramable<BuilderUIInputs> = Paramable<BuilderUIInputs>> {
     readonly type: "page";
     readonly label: Label;
-    readonly paths: Paths;
-    constructor(label: Label, paths: Paths);
+    readonly inputs: Inputs;
+    constructor(label: Label, inputs: Inputs);
 }
 export declare const BuilderUIPageSchema: v.InstanceSchema<typeof BuilderUIPage, undefined>;
 export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -25,7 +25,7 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         type: "ref";
         id: string;
     }>]>, v.StringSchema<undefined>], undefined>;
-    readonly paths: v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly inputs: v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"parameter", undefined>;
         readonly id: v.StringSchema<undefined>;
         readonly name: v.StringSchema<undefined>;
@@ -39,7 +39,178 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
     }, undefined>, v.ReadonlyAction<{
         type: "ref";
         id: string;
-    }>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>], undefined>;
+    }>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"parameter", undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "parameter";
+        id: string;
+        name: string;
+    }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ref", undefined>;
+        readonly id: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "ref";
+        id: string;
+    }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"input", undefined>;
+        readonly path: v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"parameter", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>], undefined>;
+        readonly displayName: v.OptionalSchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"parameter", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+        }>]>, v.StringSchema<undefined>], undefined>, undefined>;
+        readonly kind: v.OptionalSchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"parameter", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+        }>]>, v.StringSchema<undefined>], undefined>, undefined>;
+        readonly metadata: v.OptionalSchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"parameter", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+        }>]>, v.SchemaWithPipe<readonly [v.RecordSchema<v.StringSchema<undefined>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"parameter", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+        }>]>, v.UnknownSchema], undefined>, undefined>, v.ReadonlyAction<{
+            [x: string]: unknown;
+        }>]>], undefined>, undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "input";
+        path: readonly (string | number)[] | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }>;
+        displayName?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        kind?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        metadata?: Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | Readonly<{
+            [x: string]: unknown;
+        }> | undefined;
+    }>]>], undefined>, undefined>, v.ReadonlyAction<(Readonly<{
+        type: "parameter";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        type: "ref";
+        id: string;
+    }> | Readonly<{
+        type: "input";
+        path: readonly (string | number)[] | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }>;
+        displayName?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        kind?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        metadata?: Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | Readonly<{
+            [x: string]: unknown;
+        }> | undefined;
+    }>)[]>]>], undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "page";
     label: string | Readonly<{
@@ -50,13 +221,56 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         type: "ref";
         id: string;
     }>;
-    paths: readonly (readonly (string | number)[])[] | Readonly<{
+    inputs: Readonly<{
         type: "parameter";
         id: string;
         name: string;
     }> | Readonly<{
         type: "ref";
         id: string;
-    }>;
+    }> | readonly (Readonly<{
+        type: "parameter";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        type: "ref";
+        id: string;
+    }> | Readonly<{
+        type: "input";
+        path: readonly (string | number)[] | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }>;
+        displayName?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        kind?: string | Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | undefined;
+        metadata?: Readonly<{
+            type: "parameter";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            type: "ref";
+            id: string;
+        }> | Readonly<{
+            [x: string]: unknown;
+        }> | undefined;
+    }>)[];
 }>]>;
 export type BuilderUIPageSerialised = v.InferOutput<typeof BuilderUIPageSerialisedSchema>;

package/dist/entities/ui/page.js

@@ -1,19 +1,19 @@
 import * as v from 'valibot';
-import { BuilderPathsSchema } from '../../paths.js';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
+import { BuilderUIInputsSerialisedSchema } from './input.js';
 export class BuilderUIPage {
     type = 'page';
     label;
-    paths;
-    constructor(label, paths) {
+    inputs;
+    constructor(label, inputs) {
         this.label = label;
-        this.paths = paths;
+        this.inputs = inputs;
     }
 }
 export const BuilderUIPageSchema = v.instance(BuilderUIPage);
 export const BuilderUIPageSerialisedSchema = serialisable(v.object({
     type: v.literal('page'),
     label: paramable(v.string()),
-    paths: paramable(BuilderPathsSchema)
+    inputs: paramable(BuilderUIInputsSerialisedSchema)
 }));

package/dist/entities/ui/ui.d.ts

@@ -3,7 +3,7 @@ import type { BuilderExpectation, BuilderExpectations, BuilderExpectationsSerial
 import type { CollectionNamesOf } from '../collection/index';
 import type { BuilderModel, BuilderModelGeneric, BuilderModelStateOf } from '../model/model';
 import type { BuilderModelStateAsserted } from '../model/expectation';
-import type { BuilderValidPathsOf } from '../when';
+import type { BuilderUIValidInputsOf } from './input';
 import type { BuilderUIItems, BuilderUIItemsSerialised } from './pages';
 import * as v from 'valibot';
 export type BuilderUIs = ReadonlyArray<Paramable<BuilderUI>>;
@@ -16,8 +16,8 @@ export declare class BuilderUI<Model extends BuilderModelGeneric = BuilderModelG
     readonly expectations: BuilderExpectations;
     constructor(uis: BuilderUIs, items: BuilderUIItems, expectations: BuilderExpectations);
     expect<const Exps extends readonly [BuilderExpectation, ...ReadonlyArray<BuilderExpectation>]>(...expectations: Exps): BuilderUI<BuilderModel<BuilderModelStateAsserted<BuilderModelStateOf<Model>, Exps>>>;
-    page(label: Paramable<string>, paths: Paramable<BuilderValidPathsOf<Model>>): BuilderUI<Model>;
-    describe(label: Paramable<string>, paths: Paramable<BuilderValidPathsOf<Model>>): BuilderUI<Model>;
+    page(label: Paramable<string>, inputs: Paramable<BuilderUIValidInputsOf<Model>>): BuilderUI<Model>;
+    describe(label: Paramable<string>, inputs: Paramable<BuilderUIValidInputsOf<Model>>): BuilderUI<Model>;
     pages<const Name extends CollectionNamesOf<BuilderModelStateOf<Model>>>(name: Name, label: Paramable<string>, itemUI: Paramable<BuilderUI<BuilderModelGeneric>>): BuilderUI<Model>;
 }
 export declare const BuilderUISchema: v.InstanceSchema<typeof BuilderUI, undefined>;

package/dist/entities/ui/ui.js

@@ -21,11 +21,14 @@ export class BuilderUI {
             ...expectations
         ]);
     }
-    page(label, paths) {
-        return new BuilderUI(this.uis, [...this.items, new BuilderUIPage(label, paths)], this.expectations);
+    page(label, inputs) {
+        return new BuilderUI(this.uis, [...this.items, new BuilderUIPage(label, inputs)], this.expectations);
     }
-    describe(label, paths) {
-        return new BuilderUI(this.uis, [...this.items, new BuilderUIDescribe(label, paths)], this.expectations);
+    describe(label, inputs) {
+        return new BuilderUI(this.uis, [
+            ...this.items,
+            new BuilderUIDescribe(label, inputs)
+        ], this.expectations);
     }
     pages(name, label, itemUI) {
         const items = check.is(BuilderUISchema, itemUI) ? itemUI.items : itemUI;

package/dist/entities/validated.d.ts

@@ -4,9 +4,9 @@ import type { Prettify } from '../prettify';
 import type { BuilderParameter, BuilderParameterSerialised, BuilderRef, BuilderRefSerialised } from '../references';
 import type { BuilderSerialised } from './builder/index';
 import type { BuilderCollectionConfigSerialised, BuilderCollectionSerialised, BuilderCollectionsSerialised } from './collection/index';
-import type { BuilderComponentSerialised, BuilderComponentsSerialised } from './component/index';
+import type { BuilderComponentDetailsSerialised, BuilderComponentSerialised, BuilderComponentsSerialised } from './component/index';
 import type { BuilderModelSerialised } from './model/index';
-import type { BuilderOptionSerialised, BuilderOptionsSerialised } from './option/index';
+import type { BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValuesSerialised } from './option/index';
 import type { BuilderUIDescribeSerialised, BuilderUIItemsSerialised, BuilderUIPageSerialised, BuilderUISerialised } from './ui/index';
 export type Validated<Input> = Input extends BuilderComponentVariants | BuilderInstance | BuilderModelSerialised | BuilderSerialised | BuilderUISerialised ? Validate<Input> & BuilderValidatedBrand : Validate<Input>;
 type Validate<Input> = Input extends BuilderParameter<string> | BuilderParameterSerialised | BuilderRef | BuilderRefSerialised ? never : Input extends ReadonlyArray<unknown> ? ValidatedTuple<Input> : Input extends object ? {
@@ -24,8 +24,10 @@ export type BuilderInstancesValidated = Prettify<Validated<BuilderInstances>>;
 export type BuilderComponentVariantsValidated = Prettify<Validated<BuilderComponentVariants>>;
 export type BuilderOptionValidated = Prettify<Validated<BuilderOptionSerialised>>;
 export type BuilderOptionsValidated = Prettify<Validated<BuilderOptionsSerialised>>;
+export type BuilderOptionValuesValidated = Prettify<Validated<BuilderOptionValuesSerialised>>;
 export type BuilderComponentValidated = Prettify<Validated<BuilderComponentSerialised>>;
 export type BuilderComponentsValidated = Prettify<Validated<BuilderComponentsSerialised>>;
+export type BuilderComponentDetailsValidated = Prettify<Validated<BuilderComponentDetailsSerialised>>;
 export type BuilderCollectionValidated = Prettify<Validated<BuilderCollectionSerialised>>;
 export type BuilderCollectionsValidated = Prettify<Validated<BuilderCollectionsSerialised>>;
 export type BuilderCollectionConfigValidated = Prettify<Validated<BuilderCollectionConfigSerialised>>;

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 export type { BB, BBOptions } from './bb';
-export type { BuilderBindings, BuilderBindingsSerialised, BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSerialised, BuilderCollections, BuilderCollectionSerialised, BuilderCollectionsSerialised, BuilderCollectionWhen, BuilderCollectionWhenSerialised, BuilderComponent, BuilderComponentDetails, BuilderComponentDetailsSerialised, BuilderComponentField, BuilderComponentFields, BuilderComponentFieldSerialised, BuilderComponentFieldsSerialised, BuilderComponentFieldValueType, BuilderComponents, BuilderComponentSerialised, BuilderComponentsSerialised, BuilderComponentWhen, BuilderComponentWhenSerialised, BuilderDescription, BuilderDescriptionItem, BuilderEntityKind, BuilderEntitySerialised, BuilderExpectation, BuilderExpectationKind, BuilderExpectations, BuilderExpectationSerialised, BuilderExpectationsSerialised, BuilderInstanceOf, BuilderModel, BuilderModels, BuilderModelSerialised, BuilderModelValidated, BuilderOption, BuilderOptions, BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValues, BuilderOptionValuesSerialised, BuilderOptionWhen, BuilderOptionWhenSerialised, BuilderRefEntities, BuilderRefEntity, BuilderSelectType, BuilderSelectTypeLabels, BuilderSelectTypeSerialised, BuilderSelectTypeValues, BuilderSerialised, BuilderToggleType, BuilderToggleTypeSerialised, BuilderToggleValueType, BuilderUI, BuilderUIDescribe, BuilderUIDescribeSerialised, BuilderUIItem, BuilderUIItems, BuilderUIItemsSerialised, BuilderUIPage, BuilderUIPages, BuilderUIPageSerialised, BuilderUIPagesSerialised, BuilderUIs, BuilderUIsSerialised, BuilderUISerialised, BuilderUIValidated, BuilderValidated, BuilderComponentVariantsValidated, BuilderInstanceValidated, BuilderEnableConfig, BuilderMatchConfig, BuilderMatchSelectMap, BuilderUnlessConfig, BuilderWhen, BuilderWhenConfig, BuilderWhenSerialised } from './entities/index';
+export type { BuilderBindings, BuilderBindingsSerialised, BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSerialised, BuilderCollections, BuilderCollectionSerialised, BuilderCollectionsSerialised, BuilderCollectionWhen, BuilderCollectionWhenSerialised, BuilderComponent, BuilderComponentDetails, BuilderComponentDetailsSerialised, BuilderComponentField, BuilderComponentFields, BuilderComponentFieldSerialised, BuilderComponentFieldsSerialised, BuilderComponentFieldValueType, BuilderComponents, BuilderComponentSerialised, BuilderComponentsSerialised, BuilderComponentWhen, BuilderComponentWhenSerialised, BuilderDescription, BuilderDescriptionItem, BuilderEntityKind, BuilderEntitySerialised, BuilderExpectation, BuilderExpectationKind, BuilderExpectations, BuilderExpectationSerialised, BuilderExpectationsSerialised, BuilderInstanceOf, BuilderModel, BuilderModels, BuilderModelSerialised, BuilderModelValidated, BuilderOption, BuilderOptions, BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValues, BuilderOptionValuesSerialised, BuilderOptionWhen, BuilderOptionWhenSerialised, BuilderRefEntities, BuilderRefEntity, BuilderSelectType, BuilderSelectTypeLabels, BuilderSelectTypeSerialised, BuilderSelectTypeValues, BuilderSerialised, BuilderToggleType, BuilderToggleTypeSerialised, BuilderToggleValueType, BuilderUI, BuilderUIDescribe, BuilderUIDescribeSerialised, BuilderUIInput, BuilderUIInputMetadata, BuilderUIInputMetadataSerialised, BuilderUIInputs, BuilderUIInputsSerialised, BuilderUIInputSerialised, BuilderUIItem, BuilderUIItems, BuilderUIItemsSerialised, BuilderUIPage, BuilderUIPages, BuilderUIPageSerialised, BuilderUIPagesSerialised, BuilderUIs, BuilderUIsSerialised, BuilderUISerialised, BuilderUIValidated, BuilderValidated, BuilderComponentVariantsValidated, BuilderInstanceValidated, BuilderEnableConfig, BuilderMatchConfig, BuilderMatchSelectMap, BuilderUnlessConfig, BuilderWhen, BuilderWhenConfig, BuilderWhenSerialised } from './entities/index';
 export type { BuilderEnvironment } from './environment';
 export type { BuilderError, BuilderErrorBase, BuilderErrorLocation, BuilderErrors } from './exception';
-export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingReference, BuilderErrorMissingVariant, BuilderErrorUnboundParameter, BuilderErrorUnexpectedComponent, BuilderErrorUnexpectedDetail, BuilderErrorUnmetExpectation, BuilderErrorUnvalidated, BuilderInstanceValidationResult, BuilderModelValidationResult, BuilderOrder, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate, BuilderUIValidationResult, BuilderValidationResult, BuilderVariantsValidationOptions } from './mappers/index';
+export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingReference, BuilderErrorMissingVariant, BuilderErrorUnboundParameter, BuilderErrorUnexpectedComponent, BuilderErrorUnexpectedDetail, BuilderErrorUnmetExpectation, BuilderErrorUnvalidated, BuilderInstanceValidationResult, BuilderModelValidationResult, BuilderOrder, BuilderRenderMetadata, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate, BuilderUIValidationResult, BuilderValidationResult, BuilderVariantsValidationOptions } from './mappers/index';
 export type { BuilderComponentVariants, BuilderInstance, BuilderInstanceInput, BuilderInstances, BuilderVariant, BuilderVariants } from './instance';
 export type { BuilderPath, BuilderPaths } from './paths';
 export type { BuilderPrimitive, BuilderPrimitives } from './primitive';
 export type { BuilderParameter, BuilderParameterSerialised, BuilderRef, Paramable, ParamableSerialised } from './references';
 export { bb } from './bb.js';
-export { Builder, builder, detailBoolean, detailNumber, detailString, model, parameter, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
+export { Builder, builder, detailBoolean, detailNumber, detailString, input, model, parameter, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
 export { BuilderException } from './exception.js';
 export { ordinal } from './mappers/index.js';
 import { collectionConfig, collectionExpectation, componentDetails, componentExpectation, optionExpectation, uis } from './entities/index.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { bb } from './bb.js';
-export { Builder, builder, detailBoolean, detailNumber, detailString, model, parameter, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
+export { Builder, builder, detailBoolean, detailNumber, detailString, input, model, parameter, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
 export { BuilderException } from './exception.js';
 export { ordinal } from './mappers/index.js';
 import { collectionConfig, collectionExpectation, collectionWhen, componentDetails, componentExpectation, componentWhen, optionExpectation, optionWhen, uis } from './entities/index.js';

package/dist/mappers/index.d.ts

@@ -1,9 +1,10 @@
 export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingReference, BuilderErrorMissingVariant, BuilderErrorUnboundParameter, BuilderErrorUnexpectedComponent, BuilderErrorUnexpectedDetail, BuilderErrorUnmetExpectation, BuilderErrorUnvalidated, BuilderInstanceValidationResult, BuilderModelValidationResult, BuilderUIValidationResult, BuilderValidationResult, BuilderVariantsValidationOptions } from '../validate/index';
 export type { BuilderOrder } from './order';
-export type { BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate } from './render/index';
+export type { BuilderRenderMetadata, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate } from './render/index';
 export { assertValidated, validateBuilder, validateInstance, validateModel, validateUI, validateVariants } from '../validate/index.js';
+export type { BuilderOptionGraph } from './variants/index.js';
 export { createInstance } from './instance.js';
-export { createVariants } from './variants/index.js';
+export { createVariants, optionGraph, variantsFor } from './variants/index.js';
 export { order } from './order.js';
 export { ordinal, render } from './render/index.js';
 export { resolveCollection, resolveComponent, resolveOption } from './resolve.js';

package/dist/mappers/index.js

@@ -1,6 +1,6 @@
 export { assertValidated, validateBuilder, validateInstance, validateModel, validateUI, validateVariants } from '../validate/index.js';
 export { createInstance } from './instance.js';
-export { createVariants } from './variants/index.js';
+export { createVariants, optionGraph, variantsFor } from './variants/index.js';
 export { order } from './order.js';
 export { ordinal, render } from './render/index.js';
 export { resolveCollection, resolveComponent, resolveOption } from './resolve.js';

package/dist/mappers/render/index.d.ts

@@ -1,4 +1,4 @@
-export type { BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderUpdate } from './pages';
+export type { BuilderRenderMetadata, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderUpdate } from './pages';
 export type { BuilderRenderResult } from './render';
 export { render } from './render.js';
 export { ordinal } from './ordinal.js';

package/dist/mappers/render/pages.d.ts

@@ -1,12 +1,20 @@
 import type { BuilderOptionValuesSerialised } from '../../entities/index';
 import type { BuilderPrimitive } from '../../primitive';
 import type { BuilderInstance } from '../../instance';
+import * as v from 'valibot';
 export type BuilderRenderUpdate = (model: BuilderInstance, primitive: BuilderPrimitive) => BuilderInstance;
+export declare const BuilderRenderMetadataSchema: v.SchemaWithPipe<readonly [v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, v.ReadonlyAction<{
+    [x: string]: unknown;
+}>]>;
+export type BuilderRenderMetadata = v.InferOutput<typeof BuilderRenderMetadataSchema>;
 export type BuilderRenderOption = Readonly<{
     name: string;
     value: BuilderPrimitive;
     update: BuilderRenderUpdate;
     option: BuilderOptionValuesSerialised;
+    displayName?: string;
+    kind?: string;
+    metadata?: BuilderRenderMetadata;
 }>;
 export type BuilderRenderOptions = ReadonlyArray<BuilderRenderOption>;
 export type BuilderRenderPage = Readonly<{

package/dist/mappers/render/pages.js

@@ -1 +1,2 @@
-export {};
+import * as v from 'valibot';
+export const BuilderRenderMetadataSchema = v.pipe(v.record(v.string(), v.unknown()), v.readonly());

package/dist/mappers/render/render.js

@@ -1,3 +1,4 @@
+import { BuilderRenderMetadataSchema } from './pages.js';
 import * as v from 'valibot';
 import { check } from '../../check.js';
 import { BuilderInstancesSchema } from '../../instance.js';
@@ -37,7 +38,8 @@ export function render(builder, instance, refs = []) {
         });
     }
     function emitPage(page, model, collectionPath, labelContext, currentInstance) {
-        const options = page.paths.flatMap((path) => {
+        const options = page.inputs.flatMap((input) => {
+            const { path } = input;
             const found = resolvePath(model, currentInstance, path, refs);
             if (found == null) {
                 return [];
@@ -49,7 +51,10 @@ export function render(builder, instance, refs = []) {
                     name: found.name,
                     option: found.payload,
                     value: found.value,
-                    update: (updateInstance, updateValue) => createInstance(builder, setPath(updateInstance, fullPath, updateValue), refs)
+                    update: (updateInstance, updateValue) => createInstance(builder, setPath(updateInstance, fullPath, updateValue), refs),
+                    displayName: input.displayName && composeString(input.displayName, 'displayName'),
+                    kind: input.kind && composeString(input.kind, 'kind'),
+                    metadata: input.metadata && composeMetadata(input.metadata)
                 }
             ];
         });
@@ -60,7 +65,8 @@ export function render(builder, instance, refs = []) {
     }
     function emitDescribe(describe, model, labelContext, currentInstance) {
         const composedLabel = composeLabel(describe.label, labelContext);
-        const values = describe.paths.flatMap((path) => {
+        const values = describe.inputs.flatMap((input) => {
+            const { path } = input;
             const found = resolvePath(model, currentInstance, path, refs);
             if (found?.value == null) {
                 return [];
@@ -84,6 +90,16 @@ export function render(builder, instance, refs = []) {
         }
         return `${labelContext.join(', ')}, ${resolved}`;
     }
+    function composeString(value, fieldLabel) {
+        const resolved = resolveRef(value, refs);
+        check.assert(v.string(), resolved, `Input ${fieldLabel} did not resolve to a string! ❌`);
+        return resolved;
+    }
+    function composeMetadata(value) {
+        const resolved = resolveRef(value, refs);
+        check.assert(BuilderRenderMetadataSchema, resolved, 'Input metadata did not resolve to an object! ❌');
+        return Object.fromEntries(Object.entries(resolved).map(([key, entry]) => [key, resolveRef(entry, refs)]));
+    }
     function findCollection(model, instance, collectionName) {
         const entry = model.collections.find((candidate) => candidate.name === collectionName);
         return entry == null ? null : resolveCollection(entry, model, instance, refs);

package/dist/mappers/resolve.d.ts

@@ -1,13 +1,13 @@
-import type { BuilderCollectionConfigValidated, BuilderCollectionValidated, BuilderComponentDetailsSerialised, BuilderComponentValidated, BuilderModelValidated, BuilderOptionValidated, BuilderOptionValuesSerialised, BuilderRefEntities } from '../entities/index';
+import type { BuilderCollectionConfigValidated, BuilderCollectionValidated, BuilderComponentDetailsValidated, BuilderComponentValidated, BuilderModelValidated, BuilderOptionValidated, BuilderOptionValuesValidated, BuilderRefEntities } from '../entities/index';
 import type { BuilderInstance } from '../instance';
 import type { BuilderPath } from '../paths';
-export declare function resolveOption(option: BuilderOptionValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderOptionValuesSerialised | null;
-export declare function resolveComponent(component: BuilderComponentValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderComponentDetailsSerialised | null;
+export declare function resolveOption(option: BuilderOptionValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderOptionValuesValidated | null;
+export declare function resolveComponent(component: BuilderComponentValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderComponentDetailsValidated | null;
 export declare function resolveCollection(collection: BuilderCollectionValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderCollectionConfigValidated | null;
 export declare function resolveRef(value: unknown, refs: BuilderRefEntities): unknown;
 export type ResolvedPath = {
     readonly name: string;
-    readonly payload: BuilderOptionValuesSerialised;
+    readonly payload: BuilderOptionValuesValidated;
     readonly value: unknown;
 };
 export declare function resolvePath(model: BuilderModelValidated, instance: unknown, path: BuilderPath, refs?: BuilderRefEntities): ResolvedPath | null;

package/dist/mappers/variants/index.d.ts

@@ -1 +1,2 @@
-export { createVariants } from './variants.js';
+export { BuilderOptionGraph } from './option-graph.js';
+export { createVariants, optionGraph, variantsFor } from './variants.js';

package/dist/mappers/variants/index.js

@@ -1 +1,2 @@
-export { createVariants } from './variants.js';
+export { BuilderOptionGraph } from './option-graph.js';
+export { createVariants, optionGraph, variantsFor } from './variants.js';

package/dist/mappers/variants/variants.d.ts

@@ -1,3 +1,6 @@
-import type { BuilderModelValidated, BuilderValidated } from '../../entities/index';
-import type { BuilderComponentVariants } from '../../instance';
+import type { BuilderCollectionValidated, BuilderComponentValidated, BuilderModelValidated, BuilderValidated } from '../../entities/index';
+import type { BuilderComponentVariants, BuilderInstances } from '../../instance';
+import { BuilderOptionGraph } from './option-graph.js';
 export declare function createVariants(entity: BuilderValidated | BuilderModelValidated): BuilderComponentVariants;
+export declare function optionGraph(model: BuilderModelValidated): BuilderOptionGraph;
+export declare function variantsFor(entity: BuilderComponentValidated | BuilderCollectionValidated, options: BuilderOptionGraph): BuilderInstances;

package/dist/mappers/variants/variants.js

@@ -24,10 +24,10 @@ function buildVariants(model) {
         ]))
     };
 }
-function optionGraph(model) {
+export function optionGraph(model) {
     return model.options.reduce((graph, option) => graph.add(option, model), new BuilderOptionGraph());
 }
-function variantsFor(entity, options) {
+export function variantsFor(entity, options) {
     const keys = new Set(dependencyKeys(entity.payload, entity.paths));
     const graphPaths = Array.from(keys)
         .map((key) => options.get(key))

package/dist/validate/brand.d.ts

@@ -1,14 +1,7 @@
-import type { BuilderErrorLocation } from '../exception';
 declare const VALIDATED: unique symbol;
 export type BuilderValidatedBrand = {
     readonly [VALIDATED]: true;
 };
-export declare function builderErrorUnvalidated(value: unknown, location?: BuilderErrorLocation): {
-    value: unknown;
-    kind: "unvalidated";
-    location: BuilderErrorLocation;
-};
-export type BuilderErrorUnvalidated = ReturnType<typeof builderErrorUnvalidated>;
 export declare function validate<Input extends object>(value: Input): Input & BuilderValidatedBrand;
 export declare function assertValidated<Input>(value: Input): asserts value is Input & BuilderValidatedBrand;
 export {};

package/dist/validate/brand.js

@@ -1,8 +1,6 @@
-import { builderError, BuilderException } from '../exception.js';
+import { BuilderException } from '../exception.js';
+import { BuilderValidateErrors } from './errors.js';
 const VALIDATED = Symbol('builder.validated');
-export function builderErrorUnvalidated(value, location = []) {
-    return { ...builderError('unvalidated', location), value };
-}
 export function validate(value) {
     // Descriptor flags chosen for Svelte 5 `$state` proxy compatibility — `$state`
     // rejects any property that isn't writable, configurable, and enumerable.
@@ -18,6 +16,8 @@ export function validate(value) {
 }
 export function assertValidated(value) {
     if (typeof value !== 'object' || value === null || !(VALIDATED in value)) {
-        throw new BuilderException([builderErrorUnvalidated(value)]);
+        const errors = new BuilderValidateErrors();
+        errors.unvalidated(value);
+        throw new BuilderException(errors.errors);
     }
 }