@builder-builder/builder 0.0.14 → 0.0.15

package/dist/entities/tags.d.ts

@@ -0,0 +1,3 @@
+import * as v from 'valibot';
+export declare const BuilderTagsSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>;
+export type BuilderTags = v.InferOutput<typeof BuilderTagsSchema>;

package/dist/entities/tags.js

@@ -0,0 +1,2 @@
+import * as v from 'valibot';
+export const BuilderTagsSchema = v.pipe(v.array(v.string()), v.readonly());

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

@@ -1,4 +1,5 @@
 import type { Paramable } from '../../references';
+import type { BuilderTags } from '../tags';
 import type { BuilderUIInputs } from './input';
 import * as v from 'valibot';
 export declare const BuilderDescriptionItemSchema: v.SchemaWithPipe<readonly [v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>, v.ReadonlyAction<[string, string]>]>;
@@ -9,7 +10,9 @@ export declare class BuilderUIDescribe<const Label extends Paramable<string> = P
     readonly type: "describe";
     readonly label: Label;
     readonly inputs: Inputs;
-    constructor(label: Label, inputs: Inputs);
+    readonly tags?: BuilderTags;
+    constructor(label: Label, inputs: Inputs, tags?: BuilderTags);
+    tag(...tags: Array<string>): BuilderUIDescribe<Label, Inputs>;
 }
 export declare const BuilderUIDescribeSchema: v.InstanceSchema<typeof BuilderUIDescribe, undefined>;
 export declare const BuilderUIDescribeSerialisedSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -135,6 +138,7 @@ export declare const BuilderUIDescribeSerialisedSchema: v.SchemaWithPipe<readonl
         }>]>, v.UnknownSchema], undefined>, undefined>, v.ReadonlyAction<{
             [x: string]: unknown;
         }>]>], undefined>, undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "input";
         path: readonly (string | number)[] | Readonly<{
@@ -171,6 +175,7 @@ export declare const BuilderUIDescribeSerialisedSchema: v.SchemaWithPipe<readonl
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>]>], undefined>, undefined>, v.ReadonlyAction<(Readonly<{
         type: "parameter";
         id: string;
@@ -214,7 +219,9 @@ export declare const BuilderUIDescribeSerialisedSchema: v.SchemaWithPipe<readonl
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>)[]>]>], undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "describe";
     label: string | Readonly<{
@@ -275,6 +282,8 @@ export declare const BuilderUIDescribeSerialisedSchema: v.SchemaWithPipe<readonl
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>)[];
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderUIDescribeSerialised = v.InferOutput<typeof BuilderUIDescribeSerialisedSchema>;

package/dist/entities/ui/describe.js

@@ -1,6 +1,7 @@
 import * as v from 'valibot';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 import { BuilderUIInputsSerialisedSchema } from './input.js';
 export const BuilderDescriptionItemSchema = v.pipe(v.tuple([v.string(), v.string()]), v.readonly());
 export const BuilderDescriptionSchema = v.pipe(v.array(BuilderDescriptionItemSchema), v.readonly());
@@ -8,14 +9,20 @@ export class BuilderUIDescribe {
     type = 'describe';
     label;
     inputs;
-    constructor(label, inputs) {
+    tags;
+    constructor(label, inputs, tags) {
         this.label = label;
         this.inputs = inputs;
+        this.tags = tags;
+    }
+    tag(...tags) {
+        return new BuilderUIDescribe(this.label, this.inputs, tags);
     }
 }
 export const BuilderUIDescribeSchema = v.instance(BuilderUIDescribe);
 export const BuilderUIDescribeSerialisedSchema = serialisable(v.object({
     type: v.literal('describe'),
     label: paramable(v.string()),
-    inputs: paramable(BuilderUIInputsSerialisedSchema)
+    inputs: paramable(BuilderUIInputsSerialisedSchema),
+    tags: v.optional(BuilderTagsSchema)
 }));

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

@@ -2,20 +2,24 @@ import type { BuilderPath } from '../../paths';
 import type { Paramable, ParamableSerialised } from '../../references';
 import type { BuilderModelGeneric, BuilderModelStateOf } from '../model/model';
 import type { BuilderModelState } from '../model/state';
+import type { BuilderTags } from '../tags';
 import type { BuilderValidPath } from '../when';
 import * as v from 'valibot';
 export type BuilderUIInputMetadata = Paramable<Record<string, Paramable<unknown>>>;
 export type BuilderUIInputMetadataSerialised = ParamableSerialised<Record<string, ParamableSerialised<unknown>>>;
 export declare class BuilderUIInput<const Path extends Paramable<BuilderPath> = Paramable<BuilderPath>, const DisplayName extends Paramable<string> = Paramable<string>, const Kind extends Paramable<string> = Paramable<string>, const Metadata extends BuilderUIInputMetadata = BuilderUIInputMetadata> {
+    #private;
     readonly type: "input";
     readonly path: Path;
     readonly displayName?: DisplayName;
     readonly kind?: Kind;
     readonly metadata?: Metadata;
-    constructor(path: Path, displayName?: DisplayName, kind?: Kind, metadata?: Metadata);
+    readonly tags?: BuilderTags;
+    constructor(path: Path, displayName?: DisplayName, kind?: Kind, metadata?: Metadata, tags?: BuilderTags);
     display<const NewDisplayName extends Paramable<string>>(displayName: NewDisplayName): BuilderUIInput<Path, NewDisplayName, Kind, Metadata>;
     as<const NewKind extends Paramable<string>>(kind: NewKind): BuilderUIInput<Path, DisplayName, NewKind, Metadata>;
     meta<const NewMetadata extends BuilderUIInputMetadata>(metadata: NewMetadata): BuilderUIInput<Path, DisplayName, Kind, NewMetadata>;
+    tag(...tags: Array<string>): BuilderUIInput<Path, DisplayName, Kind, Metadata>;
 }
 export declare function input<const Path extends Paramable<BuilderPath>>(path: Path): BuilderUIInput<Path>;
 export declare const BuilderUIInputSchema: v.InstanceSchema<typeof BuilderUIInput, undefined>;
@@ -114,6 +118,7 @@ export declare const BuilderUIInputSerialisedSchema: v.SchemaWithPipe<readonly [
     }>]>, v.UnknownSchema], undefined>, undefined>, v.ReadonlyAction<{
         [x: string]: unknown;
     }>]>], undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "input";
     path: readonly (string | number)[] | Readonly<{
@@ -150,6 +155,7 @@ export declare const BuilderUIInputSerialisedSchema: v.SchemaWithPipe<readonly [
     }> | Readonly<{
         [x: string]: unknown;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderUIInputSerialised = v.InferOutput<typeof BuilderUIInputSerialisedSchema>;
 export declare const BuilderUIInputsSerialisedSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -244,6 +250,7 @@ export declare const BuilderUIInputsSerialisedSchema: v.SchemaWithPipe<readonly
     }>]>, v.UnknownSchema], undefined>, undefined>, v.ReadonlyAction<{
         [x: string]: unknown;
     }>]>], undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "input";
     path: readonly (string | number)[] | Readonly<{
@@ -280,6 +287,7 @@ export declare const BuilderUIInputsSerialisedSchema: v.SchemaWithPipe<readonly
     }> | Readonly<{
         [x: string]: unknown;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>]>], undefined>, undefined>, v.ReadonlyAction<(Readonly<{
     type: "parameter";
     id: string;
@@ -323,6 +331,7 @@ export declare const BuilderUIInputsSerialisedSchema: v.SchemaWithPipe<readonly
     }> | Readonly<{
         [x: string]: unknown;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>)[]>]>;
 export type BuilderUIInputsSerialised = v.InferOutput<typeof BuilderUIInputsSerialisedSchema>;
 export type BuilderUIInputs = ReadonlyArray<Paramable<BuilderUIInput>>;

package/dist/entities/ui/input.js

@@ -2,26 +2,37 @@ import * as v from 'valibot';
 import { BuilderPathSchema } from '../../paths.js';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 export class BuilderUIInput {
     type = 'input';
     path;
     displayName;
     kind;
     metadata;
-    constructor(path, displayName, kind, metadata) {
+    tags;
+    constructor(path, displayName, kind, metadata, tags) {
         this.path = path;
         this.displayName = displayName;
         this.kind = kind;
         this.metadata = metadata;
+        this.tags = tags;
+    }
+    #next(patch) {
+        return new BuilderUIInput(this.path, patch.displayName ?? this.displayName, patch.kind ?? this.kind, patch.metadata ?? this.metadata, patch.tags ?? this.tags);
     }
     display(displayName) {
-        return new BuilderUIInput(this.path, displayName, this.kind, this.metadata);
+        return this.#next({
+            displayName: displayName
+        });
     }
     as(kind) {
-        return new BuilderUIInput(this.path, this.displayName, kind, this.metadata);
+        return this.#next({ kind: kind });
     }
     meta(metadata) {
-        return new BuilderUIInput(this.path, this.displayName, this.kind, metadata);
+        return this.#next({ metadata: metadata });
+    }
+    tag(...tags) {
+        return this.#next({ tags });
     }
 }
 export function input(path) {
@@ -34,6 +45,7 @@ export const BuilderUIInputSerialisedSchema = serialisable(v.object({
     path: paramable(BuilderPathSchema),
     displayName: v.optional(paramable(v.string())),
     kind: v.optional(paramable(v.string())),
-    metadata: v.optional(paramable(BuilderUIInputMetadataSchema))
+    metadata: v.optional(paramable(BuilderUIInputMetadataSchema)),
+    tags: v.optional(BuilderTagsSchema)
 }));
 export const BuilderUIInputsSerialisedSchema = v.pipe(v.array(paramable(BuilderUIInputSerialisedSchema)), v.readonly());

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

@@ -1,11 +1,14 @@
 import type { Paramable } from '../../references';
+import type { BuilderTags } from '../tags';
 import type { BuilderUIInputs } from './input';
 import * as v from 'valibot';
 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 inputs: Inputs;
-    constructor(label: Label, inputs: Inputs);
+    readonly tags?: BuilderTags;
+    constructor(label: Label, inputs: Inputs, tags?: BuilderTags);
+    tag(...tags: Array<string>): BuilderUIPage<Label, Inputs>;
 }
 export declare const BuilderUIPageSchema: v.InstanceSchema<typeof BuilderUIPage, undefined>;
 export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -131,6 +134,7 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         }>]>, v.UnknownSchema], undefined>, undefined>, v.ReadonlyAction<{
             [x: string]: unknown;
         }>]>], undefined>, undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "input";
         path: readonly (string | number)[] | Readonly<{
@@ -167,6 +171,7 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>]>], undefined>, undefined>, v.ReadonlyAction<(Readonly<{
         type: "parameter";
         id: string;
@@ -210,7 +215,9 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>)[]>]>], undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "page";
     label: string | Readonly<{
@@ -271,6 +278,8 @@ export declare const BuilderUIPageSerialisedSchema: v.SchemaWithPipe<readonly [v
         }> | Readonly<{
             [x: string]: unknown;
         }> | undefined;
+        tags?: readonly string[] | undefined;
     }>)[];
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderUIPageSerialised = v.InferOutput<typeof BuilderUIPageSerialisedSchema>;

package/dist/entities/ui/page.js

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

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

@@ -1,4 +1,5 @@
 import type { Paramable, ParamableSerialised } from '../../references';
+import type { BuilderTags } from '../tags';
 import type { BuilderUIDescribe, BuilderUIDescribeSerialised } from './describe';
 import type { BuilderUIPage, BuilderUIPageSerialised } from './page';
 import * as v from 'valibot';
@@ -9,7 +10,9 @@ export declare class BuilderUIPages<const Name extends string = string, const La
     readonly name: Name;
     readonly label: Label;
     readonly items: Items;
-    constructor(name: Name, label: Label, items: Items);
+    readonly tags?: BuilderTags;
+    constructor(name: Name, label: Label, items: Items, tags?: BuilderTags);
+    tag(...tags: Array<string>): BuilderUIPages<Name, Label, Items>;
 }
 export declare const BuilderUIPagesSchema: v.InstanceSchema<typeof BuilderUIPages, undefined>;
 export type BuilderUIPagesSerialised = {
@@ -17,6 +20,7 @@ export type BuilderUIPagesSerialised = {
     readonly name: string;
     readonly label: ParamableSerialised<string>;
     readonly items: ParamableSerialised<BuilderUIItemsSerialised>;
+    readonly tags?: BuilderTags;
 };
 export type BuilderUIItemSerialised = BuilderUIPageSerialised | BuilderUIDescribeSerialised | BuilderUIPagesSerialised;
 export type BuilderUIItemsSerialised = ReadonlyArray<ParamableSerialised<BuilderUIItemSerialised>>;

package/dist/entities/ui/pages.js

@@ -1,6 +1,7 @@
 import * as v from 'valibot';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 import { BuilderUIDescribeSerialisedSchema } from './describe.js';
 import { BuilderUIPageSerialisedSchema } from './page.js';
 export class BuilderUIPages {
@@ -8,10 +9,15 @@ export class BuilderUIPages {
     name;
     label;
     items;
-    constructor(name, label, items) {
+    tags;
+    constructor(name, label, items, tags) {
         this.name = name;
         this.label = label;
         this.items = items;
+        this.tags = tags;
+    }
+    tag(...tags) {
+        return new BuilderUIPages(this.name, this.label, this.items, tags);
     }
 }
 export const BuilderUIPagesSchema = v.instance(BuilderUIPages);
@@ -19,7 +25,8 @@ export const BuilderUIPagesSerialisedSchema = serialisable(v.object({
     type: v.literal('pages'),
     name: v.string(),
     label: paramable(v.string()),
-    items: paramable(v.lazy(() => BuilderUIItemsSerialisedSchema))
+    items: paramable(v.lazy(() => BuilderUIItemsSerialisedSchema)),
+    tags: v.optional(BuilderTagsSchema)
 }));
 export const BuilderUIItemSerialisedSchema = v.union([
     BuilderUIPageSerialisedSchema,

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

@@ -3,27 +3,32 @@ 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 { BuilderTags } from '../tags';
 import type { BuilderUIValidInputsOf } from './input';
 import type { BuilderUIItems, BuilderUIItemsSerialised } from './pages';
 import * as v from 'valibot';
 export type BuilderUIs = ReadonlyArray<Paramable<BuilderUI>>;
 export type BuilderUIsSerialised = ReadonlyArray<ParamableSerialised<BuilderUISerialised>>;
 export declare class BuilderUI<Model extends BuilderModelGeneric = BuilderModelGeneric> {
+    #private;
     readonly type: 'ui';
     readonly model: Model;
     readonly uis: BuilderUIs;
     readonly items: BuilderUIItems;
     readonly expectations: BuilderExpectations;
-    constructor(uis: BuilderUIs, items: BuilderUIItems, expectations: BuilderExpectations);
+    readonly tags?: BuilderTags;
+    constructor(uis: BuilderUIs, items: BuilderUIItems, expectations: BuilderExpectations, tags?: BuilderTags);
     expect<const Exps extends readonly [BuilderExpectation, ...ReadonlyArray<BuilderExpectation>]>(...expectations: Exps): BuilderUI<BuilderModel<BuilderModelStateAsserted<BuilderModelStateOf<Model>, Exps>>>;
     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>;
+    tag(...tags: Array<string>): BuilderUI<Model>;
 }
 export declare const BuilderUISchema: v.InstanceSchema<typeof BuilderUI, undefined>;
 export interface BuilderUISerialised {
     readonly uis: BuilderUIsSerialised;
     readonly items: BuilderUIItemsSerialised;
     readonly expectations: BuilderExpectationsSerialised;
+    readonly tags?: BuilderTags;
 }
 export declare const BuilderUISerialisedSchema: v.GenericSchema<BuilderUISerialised>;

package/dist/entities/ui/ui.js

@@ -3,6 +3,7 @@ import { check } from '../../check.js';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
 import { BuilderExpectationsSerialisedSchema } from '../expectation.js';
+import { BuilderTagsSchema } from '../tags.js';
 import { BuilderUIDescribe } from './describe.js';
 import { BuilderUIPage } from './page.js';
 import { BuilderUIItemsSerialisedSchema, BuilderUIPages } from './pages.js';
@@ -10,34 +11,48 @@ export class BuilderUI {
     uis;
     items;
     expectations;
-    constructor(uis, items, expectations) {
+    tags;
+    constructor(uis, items, expectations, tags) {
         this.uis = uis;
         this.items = items;
         this.expectations = expectations;
+        this.tags = tags;
+    }
+    #next(patch) {
+        return new BuilderUI(this.uis, patch.items ?? this.items, patch.expectations ?? this.expectations, patch.tags ?? this.tags);
     }
     expect(...expectations) {
-        return new BuilderUI(this.uis, this.items, [
-            ...this.expectations,
-            ...expectations
-        ]);
+        return this.#next({
+            expectations: [...this.expectations, ...expectations]
+        });
     }
     page(label, inputs) {
-        return new BuilderUI(this.uis, [...this.items, new BuilderUIPage(label, inputs)], this.expectations);
+        return this.#next({
+            items: [...this.items, new BuilderUIPage(label, inputs)]
+        });
     }
     describe(label, inputs) {
-        return new BuilderUI(this.uis, [
-            ...this.items,
-            new BuilderUIDescribe(label, inputs)
-        ], this.expectations);
+        return this.#next({
+            items: [
+                ...this.items,
+                new BuilderUIDescribe(label, inputs)
+            ]
+        });
     }
     pages(name, label, itemUI) {
         const items = check.is(BuilderUISchema, itemUI) ? itemUI.items : itemUI;
-        return new BuilderUI(this.uis, [...this.items, new BuilderUIPages(name, label, items)], this.expectations);
+        return this.#next({
+            items: [...this.items, new BuilderUIPages(name, label, items)]
+        });
+    }
+    tag(...tags) {
+        return this.#next({ tags });
     }
 }
 export const BuilderUISchema = v.instance(BuilderUI);
 export const BuilderUISerialisedSchema = serialisable(v.object({
     uis: v.pipe(v.array(paramable(v.lazy(() => BuilderUISerialisedSchema))), v.readonly()),
     items: BuilderUIItemsSerialisedSchema,
-    expectations: BuilderExpectationsSerialisedSchema
+    expectations: BuilderExpectationsSerialisedSchema,
+    tags: v.optional(BuilderTagsSchema)
 }));

package/dist/entities/validated.d.ts

@@ -7,8 +7,9 @@ import type { BuilderCollectionConfigSerialised, BuilderCollectionSerialised, Bu
 import type { BuilderComponentDetailsSerialised, BuilderComponentSerialised, BuilderComponentsSerialised } from './component/index';
 import type { BuilderModelSerialised } from './model/index';
 import type { BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValuesSerialised } from './option/index';
+import type { BuilderPricing } from './pricing';
 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>;
+export type Validated<Input> = Input extends BuilderComponentVariants | BuilderInstance | BuilderModelSerialised | BuilderPricing | 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;
@@ -31,6 +32,7 @@ export type BuilderComponentDetailsValidated = Prettify<Validated<BuilderCompone
 export type BuilderCollectionValidated = Prettify<Validated<BuilderCollectionSerialised>>;
 export type BuilderCollectionsValidated = Prettify<Validated<BuilderCollectionsSerialised>>;
 export type BuilderCollectionConfigValidated = Prettify<Validated<BuilderCollectionConfigSerialised>>;
+export type BuilderPricingValidated = Prettify<Validated<BuilderPricing>>;
 export type BuilderUIItemsValidated = Prettify<Validated<BuilderUIItemsSerialised>>;
 export type BuilderUIPageValidated = Prettify<Validated<BuilderUIPageSerialised>>;
 export type BuilderUIDescribeValidated = Prettify<Validated<BuilderUIDescribeSerialised>>;

package/dist/exception.d.ts

@@ -1,11 +1,11 @@
-import type { BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingReference, BuilderErrorMissingVariant, BuilderErrorUnboundParameter, BuilderErrorUnexpectedComponent, BuilderErrorUnexpectedDetail, BuilderErrorUnmetExpectation, BuilderErrorUnvalidated } from './validate/index';
+import type { BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPricing, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingReference, BuilderErrorMissingVariant, BuilderErrorUnboundParameter, BuilderErrorUnexpectedComponent, BuilderErrorUnexpectedDetail, BuilderErrorUnmetExpectation, BuilderErrorUnvalidated } from './validate/index';
 export type BuilderErrorLocation = ReadonlyArray<string | number>;
 export declare function builderError<Kind extends string>(kind: Kind, location: BuilderErrorLocation): {
     kind: Kind;
     location: BuilderErrorLocation;
 };
 export type BuilderErrorBase = ReturnType<typeof builderError>;
-export type BuilderError = BuilderErrorUnmetExpectation | BuilderErrorUnboundParameter | BuilderErrorMissingReference | BuilderErrorInvalidPath | BuilderErrorInvalidSelectMapKey | BuilderErrorDuplicateName | BuilderErrorInvalidCollectionBounds | BuilderErrorInvalidOption | BuilderErrorInvalidCollection | BuilderErrorMissingComponent | BuilderErrorUnexpectedComponent | BuilderErrorMissingVariant | BuilderErrorInvalidVariant | BuilderErrorMissingDetail | BuilderErrorUnexpectedDetail | BuilderErrorInvalidDetail | BuilderErrorInvalidInput | BuilderErrorUnvalidated;
+export type BuilderError = BuilderErrorUnmetExpectation | BuilderErrorUnboundParameter | BuilderErrorMissingReference | BuilderErrorInvalidPath | BuilderErrorInvalidPricing | BuilderErrorInvalidSelectMapKey | BuilderErrorDuplicateName | BuilderErrorInvalidCollectionBounds | BuilderErrorInvalidOption | BuilderErrorInvalidCollection | BuilderErrorMissingComponent | BuilderErrorUnexpectedComponent | BuilderErrorMissingVariant | BuilderErrorInvalidVariant | BuilderErrorMissingDetail | BuilderErrorUnexpectedDetail | BuilderErrorInvalidDetail | BuilderErrorInvalidInput | BuilderErrorUnvalidated;
 export type BuilderErrors = ReadonlyArray<BuilderError>;
 export declare class BuilderException extends globalThis.Error {
     readonly errors: BuilderErrors;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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, 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 { 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, BuilderPricing, BuilderPricingExpression, BuilderPricingReduce, BuilderPricingTagExpression, BuilderSerialised, BuilderTags, 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, BuilderRenderMetadata, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate, BuilderUIValidationResult, BuilderValidationResult, BuilderVariantsValidationOptions } from './mappers/index';
+export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidPricing, BuilderErrorInvalidPricingReason, 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';

package/dist/instance.d.ts

@@ -10,47 +10,56 @@ export type BuilderInstanceInput = Readonly<Record<string, unknown>>;
 export declare const BuilderVariantSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
     readonly instance: v.GenericSchema<BuilderInstance>;
     readonly details: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     instance: BuilderInstance;
     details?: {
         [x: string]: string | number | boolean | null;
     } | undefined;
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderVariant = v.InferOutput<typeof BuilderVariantSchema>;
 export declare const BuilderVariantsSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
     readonly instance: v.GenericSchema<BuilderInstance>;
     readonly details: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     instance: BuilderInstance;
     details?: {
         [x: string]: string | number | boolean | null;
     } | undefined;
+    tags?: readonly string[] | undefined;
 }>]>, undefined>, v.ReadonlyAction<Readonly<{
     instance: BuilderInstance;
     details?: {
         [x: string]: string | number | boolean | null;
     } | undefined;
+    tags?: readonly string[] | undefined;
 }>[]>]>;
 export type BuilderVariants = v.InferOutput<typeof BuilderVariantsSchema>;
 export declare const BuilderComponentVariantsSchema: v.SchemaWithPipe<readonly [v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
     readonly instance: v.GenericSchema<BuilderInstance>;
     readonly details: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     instance: BuilderInstance;
     details?: {
         [x: string]: string | number | boolean | null;
     } | undefined;
+    tags?: readonly string[] | undefined;
 }>]>, undefined>, v.ReadonlyAction<Readonly<{
     instance: BuilderInstance;
     details?: {
         [x: string]: string | number | boolean | null;
     } | undefined;
+    tags?: readonly string[] | undefined;
 }>[]>]>, undefined>, v.ReadonlyAction<{
     readonly [x: string]: readonly Readonly<{
         instance: BuilderInstance;
         details?: {
             [x: string]: string | number | boolean | null;
         } | undefined;
+        tags?: readonly string[] | undefined;
     }>[];
 }>]>;
 export type BuilderComponentVariants = v.InferOutput<typeof BuilderComponentVariantsSchema>;

package/dist/instance.js

@@ -1,10 +1,12 @@
 import * as v from 'valibot';
 import { BuilderPrimitiveSchema } from './primitive.js';
+import { BuilderTagsSchema } from './entities/tags.js';
 export const BuilderInstanceSchema = v.pipe(v.record(v.string(), v.union([BuilderPrimitiveSchema, v.lazy(() => BuilderInstancesSchema)])), v.readonly());
 export const BuilderInstancesSchema = v.pipe(v.array(BuilderInstanceSchema), v.readonly());
 export const BuilderVariantSchema = v.pipe(v.object({
     instance: BuilderInstanceSchema,
-    details: v.optional(v.record(v.string(), BuilderPrimitiveSchema))
+    details: v.optional(v.record(v.string(), BuilderPrimitiveSchema)),
+    tags: v.optional(BuilderTagsSchema)
 }), v.readonly());
 export const BuilderVariantsSchema = v.pipe(v.array(BuilderVariantSchema), v.readonly());
 export const BuilderComponentVariantsSchema = v.pipe(v.record(v.string(), BuilderVariantsSchema), v.readonly());

package/dist/mappers/index.d.ts

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

package/dist/mappers/index.js

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

package/dist/mappers/pricing.d.ts

@@ -0,0 +1,3 @@
+import type { BuilderModelValidated, BuilderRefEntities } from '../entities/index';
+import type { BuilderOrder } from './order';
+export declare function pricing(model: BuilderModelValidated, pricingInput: unknown, order: BuilderOrder, refs?: BuilderRefEntities): number;