@builder-builder/builder 0.0.3 → 0.0.4

package/dist/core/option/select.js

@@ -1,4 +1,5 @@
 import * as v from 'valibot';
+import { BuilderParameter } from '../parameter.js';
 export class BuilderSelectType {
     options;
     valueSchema;
@@ -23,8 +24,11 @@ export class BuilderSelectType {
         return new BuilderSelectType(this.options, this.valueSchema, this.defaultValue, this.isOptional, optionLabels);
     }
 }
-export function select(values) {
+function createSelect(values) {
     const [defaultValue] = values;
     const valueSchema = v.union(values.map((value) => v.literal(value)));
     return new BuilderSelectType(values, valueSchema, defaultValue, false);
 }
+export const select = Object.assign(createSelect, {
+    parameter: () => new BuilderParameter()
+});

package/dist/core/parameter.d.ts

@@ -0,0 +1,35 @@
+import type { BuilderState, BuilderStateMerge } from './builder';
+import type { BuilderOption, BuilderOptionEntries, BuilderOptionValues, BuilderOptionWhenConfig } from './option/index';
+export declare class BuilderParameter {
+    readonly parameter: true;
+}
+export declare function bindOptions<Bindings extends Record<string, unknown>>(options: BuilderOptionEntries, bindings: Bindings): BuilderOptionEntries;
+export type ParameterisedOptions<Options extends BuilderOptionEntries> = {
+    [K in keyof Options]: Options[K] extends BuilderOption<infer Name, infer Values> ? Values extends BuilderParameter ? BuilderOption<Name, Values> : never : never;
+}[number];
+export type BuilderBindings<State extends BuilderState> = {
+    readonly [P in ParameterisedOptions<State['options']> as P['name']]?: BuilderOptionValues | BuilderOptionWhenConfig;
+};
+export type ReplaceOption<Options extends BuilderOptionEntries, BoundNames extends string> = Options extends readonly [
+    infer Head extends BuilderOption,
+    ...infer Tail extends BuilderOptionEntries
+] ? Head extends BuilderOption<infer Name, infer Values> ? Values extends BuilderParameter ? Name extends BoundNames ? [...ReplaceOption<Tail, BoundNames>] : [Head, ...ReplaceOption<Tail, BoundNames>] : [Head, ...ReplaceOption<Tail, BoundNames>] : [Head, ...ReplaceOption<Tail, BoundNames>] : [];
+type BindingModelType<Binding> = Binding extends {
+    readonly type: 'match';
+    readonly selectMap: infer SelectMap extends Record<string, unknown>;
+} ? NonNullable<SelectMap[keyof SelectMap]> extends {
+    readonly value: infer Value;
+} ? Value | null : string | null : Binding extends {
+    readonly values: infer Values;
+} ? Values extends {
+    readonly value: infer Value;
+} ? Value | null : string | null : Binding extends {
+    readonly value: infer Value;
+} ? Value : string;
+export type BuilderBoundState<State extends BuilderState, Bindings extends Record<string, unknown>> = BuilderStateMerge<State, {
+    options: ReplaceOption<State['options'], Extract<keyof Bindings, string>>;
+    model: Omit<State['model'], keyof Bindings> & {
+        [K in Extract<keyof Bindings, string>]: BindingModelType<Bindings[K]>;
+    };
+}>;
+export {};

package/dist/core/parameter.js

@@ -0,0 +1,25 @@
+export class BuilderParameter {
+    parameter = true;
+}
+function createOption(option, values, config) {
+    const OptionConstructor = option.constructor;
+    return new OptionConstructor(option.name, values, option.gatePaths, config);
+}
+function isWhenConfig(binding) {
+    return typeof binding === 'object' && binding !== null && 'type' in binding;
+}
+function bindOption(option, binding) {
+    if (isWhenConfig(binding)) {
+        return createOption(option, binding.values, binding);
+    }
+    return createOption(option, binding, option.config);
+}
+export function bindOptions(options, bindings) {
+    return options.map((option) => {
+        const binding = bindings[option.name];
+        if (binding === undefined) {
+            return option;
+        }
+        return bindOption(option, binding);
+    });
+}

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export type { BuilderUI, BuilderUIFactory, BuilderUIPart, BuilderUIParts } from
 export type { BuilderCollectionSerialised, BuilderCollectionWhenConfigSerialised, BuilderComponentSerialised, BuilderOptionSerialised, BuilderOptionWhenConfigSerialised, BuilderSelectTypeSerialised, BuilderSerialised, BuilderToggleTypeSerialised, BuilderUISerialised, BuilderValuesSerialised } from './serialise/index';
 export { BuilderExpectation } from './assert/expectation.js';
 export { assert, component, option } from './assert/index.js';
-export { builder, BuilderCollection, BuilderComponent, BuilderOption, BuilderSelectType, BuilderToggleType, collection, enable, match, select, toggleBoolean, toggleNumber, toggleString, unless } from './core/index.js';
+export { builder, BuilderCollection, BuilderComponent, BuilderOption, BuilderParameter, BuilderSelectType, BuilderToggleType, collection, enable, match, select, toggleBoolean, toggleNumber, toggleString, unless } from './core/index.js';
 export { instance, models, order, ordinal, render, validate } from './resolve/index.js';
 export { deserialise, serialise } from './serialise/index.js';
 export { ui } from './ui.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { BuilderExpectation } from './assert/expectation.js';
 export { assert, component, option } from './assert/index.js';
-export { builder, BuilderCollection, BuilderComponent, BuilderOption, BuilderSelectType, BuilderToggleType, collection, enable, match, select, toggleBoolean, toggleNumber, toggleString, unless } from './core/index.js';
+export { builder, BuilderCollection, BuilderComponent, BuilderOption, BuilderParameter, BuilderSelectType, BuilderToggleType, collection, enable, match, select, toggleBoolean, toggleNumber, toggleString, unless } from './core/index.js';
 export { instance, models, order, ordinal, render, validate } from './resolve/index.js';
 export { deserialise, serialise } from './serialise/index.js';
 export { ui } from './ui.js';

package/dist/paths.d.ts

@@ -2,9 +2,9 @@ export type { BuilderPath, BuilderPaths } from './schemas/index';
 import type { BuilderGeneric, BuilderModelOf } from './core/index';
 import type { BuilderPath, BuilderPrimitive } from './schemas/index';
 export type BuilderValidPath<Model, Depth extends ReadonlyArray<never> = []> = Depth['length'] extends 10 ? never : Model extends BuilderPrimitive | null ? never : Model extends ReadonlyArray<infer Item> ? [number] | [number, ...BuilderValidPath<Item, [...Depth, never]>] : {
-    [K in keyof Model & string]: [K] | (Model[K] extends BuilderPrimitive | null ? never : [K, ...BuilderValidPath<Model[K], [...Depth, never]>]);
+    [Key in keyof Model & string]: [Key] | (Model[Key] extends BuilderPrimitive | null ? never : [Key, ...BuilderValidPath<Model[Key], [...Depth, never]>]);
 }[keyof Model & string];
-export type BuilderModelPaths<B extends BuilderGeneric> = ReadonlyArray<BuilderValidPath<BuilderModelOf<B>>>;
+export type BuilderModelPaths<Builder extends BuilderGeneric> = ReadonlyArray<BuilderValidPath<BuilderModelOf<Builder>>>;
 export type BuilderResolvePath<Model, Path extends BuilderPath> = Path extends readonly [
     infer Head extends keyof Model & string
 ] ? Model[Head] : Path extends readonly [

package/dist/resolve/instance.d.ts

@@ -1,3 +1,3 @@
 import type { BuilderGeneric, BuilderModelOf } from '../core/index';
 import type { BuilderModelMutable } from '../config';
-export declare function instance<const B extends BuilderGeneric>(builder: B, partial?: BuilderModelMutable): BuilderModelOf<B>;
+export declare function instance<const Builder extends BuilderGeneric>(builder: Builder, partial?: BuilderModelMutable): BuilderModelOf<Builder>;

package/dist/resolve/order.d.ts

@@ -1,11 +1,11 @@
 import type { BuilderModel, BuilderVariant } from '../config';
 import type { BuilderCollection, BuilderCollectionEntries, BuilderComponentEntries, BuilderComponentNamesOf, BuilderGeneric, BuilderTupleOf } from '../core/index';
 import type { BuilderDataValidated } from './validate';
-export type BuilderOrder<B extends BuilderGeneric> = B extends {
+export type BuilderOrder<Builder extends BuilderGeneric> = Builder extends {
     readonly _components: infer Components extends BuilderComponentEntries;
     readonly _collections: infer Collections extends BuilderCollectionEntries;
 } ? Prettify<ComponentsOrder<Components> & CollectionsOrder<Collections>> : Record<string, unknown>;
-export declare function order<const B extends BuilderGeneric>(builder: B, model: BuilderModel, componentModels: BuilderDataValidated): BuilderOrder<B>;
+export declare function order<const Builder extends BuilderGeneric>(builder: Builder, model: BuilderModel, componentModels: BuilderDataValidated): BuilderOrder<Builder>;
 import type { Prettify } from '../prettify';
 type ComponentsOrder<Components extends BuilderComponentEntries> = {
     readonly [Name in BuilderComponentNamesOf<Components>]: BuilderVariant | null;

package/dist/schemas/index.d.ts

@@ -4,7 +4,7 @@ export type { BuilderLayout, BuilderLayoutOption, BuilderLayoutOptions, BuilderL
 export { BuilderLayoutOptionSchema, BuilderLayoutOptionsSchema, BuilderLayoutPageSchema, BuilderLayoutSchema } from './layout.js';
 export type { BuilderPath, BuilderPaths, BuilderPrimitive, BuilderPrimitives } from './primitives';
 export { BuilderPathSchema, BuilderPathsSchema, BuilderPrimitiveSchema, BuilderPrimitivesSchema } from './primitives.js';
-export type { BuilderCollectionSerialised, BuilderCollectionConfigSerialised, BuilderCollectionEnableConfigSerialised, BuilderCollectionMatchConfigSerialised, BuilderCollectionUnlessConfigSerialised, BuilderCollectionWhenConfigSerialised, BuilderComponentSerialised, BuilderValuesSerialised, BuilderOptionSerialised, BuilderOptionEnableConfigSerialised, BuilderOptionMatchConfigSerialised, BuilderOptionUnlessConfigSerialised, BuilderOptionWhenConfigSerialised, BuilderSerialised, BuilderSelectTypeSerialised, BuilderToggleTypeSerialised, BuilderUISerialised, BuilderUIDescribeSerialised, BuilderUICollectionSerialised, BuilderUIItemSerialised, BuilderUIItemsSerialised, BuilderUIPageSerialised } from './serialise';
-export { BuilderCollectionConfigSerialisedSchema, BuilderCollectionEnableConfigSerialisedSchema, BuilderCollectionMatchConfigSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionUnlessConfigSerialisedSchema, BuilderCollectionWhenConfigSerialisedSchema, BuilderComponentSerialisedSchema, BuilderValuesSerialisedSchema, BuilderOptionEnableConfigSerialisedSchema, BuilderOptionMatchConfigSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionUnlessConfigSerialisedSchema, BuilderOptionWhenConfigSerialisedSchema, BuilderSerialisedSchema, BuilderSelectTypeSerialisedSchema, BuilderToggleTypeSerialisedSchema, BuilderUIDescribeSerialisedSchema, BuilderUICollectionSerialisedSchema, BuilderUIItemSerialisedSchema, BuilderUIItemsSerialisedSchema, BuilderUIPageSerialisedSchema } from './serialise.js';
-export type { BuilderUIDescribe, BuilderUICollection, BuilderUIItem, BuilderUIItems, BuilderUIPage } from './ui';
-export { BuilderUIDescribeSchema, BuilderUICollectionSchema, BuilderUIItemSchema, BuilderUIItemsSchema, BuilderUIPageSchema } from './ui.js';
+export type { BuilderCollectionConfigSerialised, BuilderCollectionEnableConfigSerialised, BuilderCollectionMatchConfigSerialised, BuilderCollectionSerialised, BuilderCollectionUnlessConfigSerialised, BuilderCollectionWhenConfigSerialised, BuilderComponentSerialised, BuilderOptionEnableConfigSerialised, BuilderOptionMatchConfigSerialised, BuilderOptionSerialised, BuilderOptionUnlessConfigSerialised, BuilderOptionValues, BuilderOptionValuesMap, BuilderOptionWhenConfigSerialised, BuilderSelectTypeSerialised, BuilderSerialised, BuilderToggleTypeSerialised, BuilderUICollectionSerialised, BuilderUIDescribeSerialised, BuilderUIItemSerialised, BuilderUIItemsSerialised, BuilderUIPageSerialised, BuilderUISerialised, BuilderParameterSerialised, BuilderValuesSerialised } from './serialise';
+export { BuilderCollectionConfigSerialisedSchema, BuilderCollectionEnableConfigSerialisedSchema, BuilderCollectionMatchConfigSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionUnlessConfigSerialisedSchema, BuilderCollectionWhenConfigSerialisedSchema, BuilderComponentSerialisedSchema, BuilderOptionEnableConfigSerialisedSchema, BuilderOptionMatchConfigSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionUnlessConfigSerialisedSchema, BuilderOptionValuesMapSchema, BuilderOptionValuesSchema, BuilderOptionWhenConfigSerialisedSchema, BuilderParameterSchema, BuilderSelectTypeSerialisedSchema, BuilderSerialisedSchema, BuilderToggleTypeSerialisedSchema, BuilderUICollectionSerialisedSchema, BuilderUIDescribeSerialisedSchema, BuilderUIItemSerialisedSchema, BuilderUIItemsSerialisedSchema, BuilderUIPageSerialisedSchema, BuilderValuesSerialisedSchema } from './serialise.js';
+export type { BuilderUICollection, BuilderUIDescribe, BuilderUIItem, BuilderUIItems, BuilderUIPage } from './ui';
+export { BuilderUICollectionSchema, BuilderUIDescribeSchema, BuilderUIItemSchema, BuilderUIItemsSchema, BuilderUIPageSchema } from './ui.js';

package/dist/schemas/index.js

@@ -1,5 +1,5 @@
 export { BuilderDescriptionItemSchema, BuilderDescriptionSchema } from './description.js';
 export { BuilderLayoutOptionSchema, BuilderLayoutOptionsSchema, BuilderLayoutPageSchema, BuilderLayoutSchema } from './layout.js';
 export { BuilderPathSchema, BuilderPathsSchema, BuilderPrimitiveSchema, BuilderPrimitivesSchema } from './primitives.js';
-export { BuilderCollectionConfigSerialisedSchema, BuilderCollectionEnableConfigSerialisedSchema, BuilderCollectionMatchConfigSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionUnlessConfigSerialisedSchema, BuilderCollectionWhenConfigSerialisedSchema, BuilderComponentSerialisedSchema, BuilderValuesSerialisedSchema, BuilderOptionEnableConfigSerialisedSchema, BuilderOptionMatchConfigSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionUnlessConfigSerialisedSchema, BuilderOptionWhenConfigSerialisedSchema, BuilderSerialisedSchema, BuilderSelectTypeSerialisedSchema, BuilderToggleTypeSerialisedSchema, BuilderUIDescribeSerialisedSchema, BuilderUICollectionSerialisedSchema, BuilderUIItemSerialisedSchema, BuilderUIItemsSerialisedSchema, BuilderUIPageSerialisedSchema } from './serialise.js';
-export { BuilderUIDescribeSchema, BuilderUICollectionSchema, BuilderUIItemSchema, BuilderUIItemsSchema, BuilderUIPageSchema } from './ui.js';
+export { BuilderCollectionConfigSerialisedSchema, BuilderCollectionEnableConfigSerialisedSchema, BuilderCollectionMatchConfigSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionUnlessConfigSerialisedSchema, BuilderCollectionWhenConfigSerialisedSchema, BuilderComponentSerialisedSchema, BuilderOptionEnableConfigSerialisedSchema, BuilderOptionMatchConfigSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionUnlessConfigSerialisedSchema, BuilderOptionValuesMapSchema, BuilderOptionValuesSchema, BuilderOptionWhenConfigSerialisedSchema, BuilderParameterSchema, BuilderSelectTypeSerialisedSchema, BuilderSerialisedSchema, BuilderToggleTypeSerialisedSchema, BuilderUICollectionSerialisedSchema, BuilderUIDescribeSerialisedSchema, BuilderUIItemSerialisedSchema, BuilderUIItemsSerialisedSchema, BuilderUIPageSerialisedSchema, BuilderValuesSerialisedSchema } from './serialise.js';
+export { BuilderUICollectionSchema, BuilderUIDescribeSchema, BuilderUIItemSchema, BuilderUIItemsSchema, BuilderUIPageSchema } from './ui.js';