@builder-builder/builder 0.0.12 → 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,32 +4,34 @@ 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 ? Prettify<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 ? Prettify<{
+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 ? {
     readonly [Key in keyof Input]: Validated<Input[Key]>;
-}> : Input;
+} : Input;
 type ValidatedTuple<Input extends ReadonlyArray<unknown>> = Input extends readonly [
     infer Head,
     ...infer Rest extends ReadonlyArray<unknown>
 ] ? [Validated<Head>] extends [never] ? ValidatedTuple<Rest> : readonly [Validated<Head>, ...ValidatedTuple<Rest>] : Input extends readonly [] ? readonly [] : ReadonlyArray<Validated<Input[number]>>;
-export type BuilderValidated = Validated<BuilderSerialised>;
-export type BuilderModelValidated = Validated<BuilderModelSerialised>;
-export type BuilderUIValidated = Validated<BuilderUISerialised>;
-export type BuilderInstanceValidated = Validated<BuilderInstance>;
-export type BuilderInstancesValidated = Validated<BuilderInstances>;
-export type BuilderComponentVariantsValidated = Validated<BuilderComponentVariants>;
-export type BuilderOptionValidated = Validated<BuilderOptionSerialised>;
-export type BuilderOptionsValidated = Validated<BuilderOptionsSerialised>;
-export type BuilderComponentValidated = Validated<BuilderComponentSerialised>;
-export type BuilderComponentsValidated = Validated<BuilderComponentsSerialised>;
-export type BuilderCollectionValidated = Validated<BuilderCollectionSerialised>;
-export type BuilderCollectionsValidated = Validated<BuilderCollectionsSerialised>;
-export type BuilderCollectionConfigValidated = Validated<BuilderCollectionConfigSerialised>;
-export type BuilderUIItemsValidated = Validated<BuilderUIItemsSerialised>;
-export type BuilderUIPageValidated = Validated<BuilderUIPageSerialised>;
-export type BuilderUIDescribeValidated = Validated<BuilderUIDescribeSerialised>;
+export type BuilderValidated = Prettify<Validated<BuilderSerialised>>;
+export type BuilderModelValidated = Prettify<Validated<BuilderModelSerialised>>;
+export type BuilderUIValidated = Prettify<Validated<BuilderUISerialised>>;
+export type BuilderInstanceValidated = Prettify<Validated<BuilderInstance>>;
+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>>;
+export type BuilderUIItemsValidated = Prettify<Validated<BuilderUIItemsSerialised>>;
+export type BuilderUIPageValidated = Prettify<Validated<BuilderUIPageSerialised>>;
+export type BuilderUIDescribeValidated = Prettify<Validated<BuilderUIDescribeSerialised>>;
 export {};

package/dist/entities/when.d.ts

@@ -112,8 +112,6 @@ export declare const BuilderWhenConfigSchema: v.SchemaWithPipe<readonly [v.Varia
         id: string;
     }>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>], undefined>;
 }, undefined>], undefined>, v.ReadonlyAction<{
-    type: "enable";
-} | {
     type: "match";
     matchPath: readonly (string | number)[] | Readonly<{
         type: "parameter";
@@ -133,6 +131,8 @@ export declare const BuilderWhenConfigSchema: v.SchemaWithPipe<readonly [v.Varia
         type: "ref";
         id: string;
     }>;
+} | {
+    type: "enable";
 }>]>;
 export type BuilderWhenConfig = v.InferOutput<typeof BuilderWhenConfigSchema>;
 export type BuilderWhenGeneric = BuilderWhen<unknown, unknown, unknown, unknown>;

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/instance.js

@@ -1,33 +1,37 @@
 import { check } from '../check.js';
 import { modelsMerge, optionValueSchema } from '../entities/index.js';
+import { BuilderInstanceSchema, BuilderInstancesSchema } from '../instance.js';
 import { resolveCollection, resolveOption } from './resolve.js';
 export function createInstance(entity, partial = {}, refs = []) {
     const model = 'model' in entity ? entity.model : entity;
-    return buildInstance(model, partial, refs);
+    const instance = buildInstance(model, partial, refs);
+    check.assert(BuilderInstanceSchema, instance);
+    return instance;
 }
 function buildInstance(model, partial, refs) {
     const merged = modelsMerge(model);
     let instance = { ...partial };
     merged.options.forEach((option) => {
         const { name } = option;
-        const payload = resolveOption(option, instance, refs);
+        const payload = resolveOption(option, model, instance, refs);
         if (payload == null) {
             return;
         }
-        const existing = instance[name];
-        if (check.is(optionValueSchema(payload), existing)) {
+        if (check.is(optionValueSchema(payload), instance[name])) {
             return;
         }
         instance = { ...instance, [name]: payload.defaultValue };
     });
     merged.collections.forEach((collection) => {
         const { name } = collection;
-        const payload = resolveCollection(collection, instance, refs);
+        const payload = resolveCollection(collection, model, instance, refs);
         if (payload == null) {
             return;
         }
         const existing = instance[name];
-        const existingItems = Array.isArray(existing) ? existing : [];
+        const existingItems = check.is(BuilderInstancesSchema, existing)
+            ? existing
+            : [];
         const count = Math.max(existingItems.length, payload.min);
         const items = Array.from({ length: count }, (_, index) => buildInstance(payload.model, existingItems[index] ?? {}, refs));
         instance = { ...instance, [name]: items };

package/dist/mappers/order.js

@@ -1,8 +1,10 @@
+import { check } from '../check.js';
+import { BuilderInstancesSchema } from '../instance.js';
 import { resolveCollection, resolveComponent } from './resolve.js';
 export function order(model, instance, variants, refs = []) {
     const result = {};
     model.components.forEach((component) => {
-        if (resolveComponent(component, instance, refs) == null) {
+        if (resolveComponent(component, model, instance, refs) == null) {
             return;
         }
         const componentVariants = variants[component.name] ?? [];
@@ -11,11 +13,12 @@ export function order(model, instance, variants, refs = []) {
     });
     model.collections.forEach((collection) => {
         const { name } = collection;
-        const payload = resolveCollection(collection, instance, refs);
+        const payload = resolveCollection(collection, model, instance, refs);
         if (payload == null) {
             return;
         }
         const itemInstances = instance[name];
+        check.assert(BuilderInstancesSchema, itemInstances);
         result[name] = itemInstances.map((itemInstance) => order(payload.model, itemInstance, variants, refs));
     });
     return result;

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());