@builder-builder/builder 0.0.14 → 0.0.15

package/dist/entities/component/field.d.ts

@@ -1,16 +1,20 @@
 import type { BuilderPrimitive } from '../../primitive';
+import type { BuilderTags } from '../tags';
 import * as v from 'valibot';
 export declare const BuilderComponentFieldValueTypeSchema: v.PicklistSchema<["string", "boolean", "number"], undefined>;
 export type BuilderComponentFieldValueType = v.InferOutput<typeof BuilderComponentFieldValueTypeSchema>;
 export declare class BuilderComponentField<const Name extends string = string, const ValueSchema extends v.GenericSchema<BuilderPrimitive> = v.GenericSchema<BuilderPrimitive>> {
+    #private;
     readonly value: v.InferOutput<ValueSchema>;
     readonly type: "component-field";
     readonly name: Name;
     readonly valueType: BuilderComponentFieldValueType;
     readonly valueSchema: ValueSchema;
     readonly isOptional: boolean;
-    constructor(name: Name, valueType: BuilderComponentFieldValueType, optional?: boolean);
+    readonly tags?: BuilderTags;
+    constructor(name: Name, valueType: BuilderComponentFieldValueType, optional?: boolean, tags?: BuilderTags);
     optional(): BuilderComponentField<Name, v.NullableSchema<ValueSchema, undefined>>;
+    tag(...tags: Array<string>): BuilderComponentField<Name, ValueSchema>;
 }
 export declare function detailString<const Name extends string>(name: Name): BuilderComponentField<Name, v.StringSchema<undefined>>;
 export declare function detailNumber<const Name extends string>(name: Name): BuilderComponentField<Name, v.NumberSchema<undefined>>;
@@ -23,11 +27,13 @@ export declare const BuilderComponentFieldSerialisedSchema: v.SchemaWithPipe<rea
     readonly name: v.StringSchema<undefined>;
     readonly valueType: v.PicklistSchema<["string", "boolean", "number"], undefined>;
     readonly isOptional: v.BooleanSchema<undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "component-field";
     name: string;
     valueType: "string" | "number" | "boolean";
     isOptional: boolean;
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderComponentFieldSerialised = v.InferOutput<typeof BuilderComponentFieldSerialisedSchema>;
 export declare const BuilderComponentFieldsSerialisedSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -35,16 +41,19 @@ export declare const BuilderComponentFieldsSerialisedSchema: v.SchemaWithPipe<re
     readonly name: v.StringSchema<undefined>;
     readonly valueType: v.PicklistSchema<["string", "boolean", "number"], undefined>;
     readonly isOptional: v.BooleanSchema<undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "component-field";
     name: string;
     valueType: "string" | "number" | "boolean";
     isOptional: boolean;
+    tags?: readonly string[] | undefined;
 }>]>, undefined>, v.ReadonlyAction<Readonly<{
     type: "component-field";
     name: string;
     valueType: "string" | "number" | "boolean";
     isOptional: boolean;
+    tags?: readonly string[] | undefined;
 }>[]>]>;
 export type BuilderComponentFieldsSerialised = v.InferOutput<typeof BuilderComponentFieldsSerialisedSchema>;
 export declare function detailValueSchema(valueType: BuilderComponentFieldValueType, optional: boolean): v.GenericSchema<BuilderPrimitive>;

package/dist/entities/component/field.js

@@ -1,5 +1,6 @@
 import * as v from 'valibot';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 export const BuilderComponentFieldValueTypeSchema = v.picklist(['string', 'boolean', 'number']);
 export class BuilderComponentField {
     type = 'component-field';
@@ -7,14 +8,22 @@ export class BuilderComponentField {
     valueType;
     valueSchema;
     isOptional;
-    constructor(name, valueType, optional = false) {
+    tags;
+    constructor(name, valueType, optional = false, tags) {
         this.name = name;
         this.valueType = valueType;
         this.valueSchema = detailValueSchema(valueType, optional);
         this.isOptional = optional;
+        this.tags = tags;
+    }
+    #next(patch) {
+        return new BuilderComponentField(this.name, this.valueType, patch.optional ?? this.isOptional, patch.tags ?? this.tags);
     }
     optional() {
-        return new BuilderComponentField(this.name, this.valueType, true);
+        return this.#next({ optional: true });
+    }
+    tag(...tags) {
+        return this.#next({ tags });
     }
 }
 export function detailString(name) {
@@ -32,7 +41,8 @@ export const BuilderComponentFieldSerialisedSchema = serialisable(v.object({
     type: v.literal('component-field'),
     name: v.string(),
     valueType: BuilderComponentFieldValueTypeSchema,
-    isOptional: v.boolean()
+    isOptional: v.boolean(),
+    tags: v.optional(BuilderTagsSchema)
 }));
 export const BuilderComponentFieldsSerialisedSchema = v.pipe(v.array(BuilderComponentFieldSerialisedSchema), v.readonly());
 export function detailValueSchema(valueType, optional) {

package/dist/entities/index.d.ts

@@ -7,14 +7,18 @@ export type { BuilderModelEntrySerialised } from './entry';
 export type { BuilderInstanceOf, BuilderModelGeneric, BuilderModels, BuilderModelSerialised, BuilderModelState, BuilderModelStateEmpty, BuilderModelStateOf } from './model/index';
 export { BuilderModel, BuilderModelSchema, BuilderModelSerialisedSchema, model, modelsMerge } from './model/index.js';
 export type { BuilderOptionPayload, BuilderOptions, BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValues, BuilderOptionValuesSerialised, BuilderOptionWhen, BuilderOptionWhenSerialised, BuilderSelectTypeLabels, BuilderSelectTypeSerialised, BuilderSelectTypeValues, BuilderToggleTypeSerialised, BuilderToggleValueType } from './option/index';
+export type { BuilderPricing, BuilderPricingExpression, BuilderPricingReduce, BuilderPricingTagExpression } from './pricing';
 export type { BuilderRefEntities, BuilderRefEntity } from './refs.js';
+export type { BuilderTags } from './tags';
 export type { BuilderDescription, BuilderDescriptionItem, BuilderUIDescribeSerialised, BuilderUIInputMetadata, BuilderUIInputMetadataSerialised, BuilderUIInputs, BuilderUIInputsSerialised, BuilderUIInputSerialised, BuilderUIItem, BuilderUIItems, BuilderUIItemSerialised, BuilderUIItemsSerialised, BuilderUIPageSerialised, BuilderUIPagesSerialised, BuilderUIs, BuilderUIsSerialised, BuilderUISerialised } from './ui/index';
-export type { BuilderCollectionConfigValidated, BuilderCollectionsValidated, BuilderCollectionValidated, BuilderComponentDetailsValidated, BuilderComponentsValidated, BuilderComponentValidated, BuilderComponentVariantsValidated, BuilderInstancesValidated, BuilderInstanceValidated, BuilderModelValidated, BuilderOptionsValidated, BuilderOptionValidated, BuilderOptionValuesValidated, BuilderUIDescribeValidated, BuilderUIItemsValidated, BuilderUIPageValidated, BuilderUIValidated, BuilderValidated } from './validated';
+export type { BuilderCollectionConfigValidated, BuilderCollectionsValidated, BuilderCollectionValidated, BuilderComponentDetailsValidated, BuilderComponentsValidated, BuilderComponentValidated, BuilderComponentVariantsValidated, BuilderInstancesValidated, BuilderInstanceValidated, BuilderModelValidated, BuilderOptionsValidated, BuilderOptionValidated, BuilderOptionValuesValidated, BuilderPricingValidated, BuilderUIDescribeValidated, BuilderUIItemsValidated, BuilderUIPageValidated, BuilderUIValidated, BuilderValidated } from './validated';
 export type { BuilderEnableConfig, BuilderMatchConfig, BuilderMatchSelectMap, BuilderUnlessConfig, BuilderWhen, BuilderWhenConfig, BuilderWhenSerialised } from './when';
 export { Builder, builder, BuilderSchema, BuilderSerialisedSchema } from './builder/index.js';
 export { BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSchema, BuilderCollectionConfigSerialisedSchema, BuilderCollectionSchema, BuilderCollectionSelectMapSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionsSerialisedSchema, BuilderCollectionWhenSerialisedSchema, collectionConfig, collectionExpectation, collectionWhen } from './collection/index.js';
 export { BuilderComponent, BuilderComponentDetails, BuilderComponentDetailsSchema, BuilderComponentDetailsSerialisedSchema, BuilderComponentField, BuilderComponentFieldSchema, BuilderComponentFieldSerialisedSchema, BuilderComponentFieldsSchema, BuilderComponentFieldsSerialisedSchema, BuilderComponentFieldValueTypeSchema, BuilderComponentSchema, BuilderComponentSelectMapSerialisedSchema, BuilderComponentSerialisedSchema, BuilderComponentsSerialisedSchema, BuilderComponentWhenSerialisedSchema, componentDetails, componentExpectation, componentWhen, detailBoolean, detailNumber, detailString, detailValueSchema } from './component/index.js';
 export { parameter, ref } from '../references.js';
+export { BuilderPricingExpressionSchema, BuilderPricingReduceSchema, BuilderPricingSchema, BuilderPricingTagExpressionSchema } from './pricing.js';
+export { BuilderTagsSchema } from './tags.js';
 export { BuilderExpectation, BuilderExpectationKindSchema, BuilderExpectationSchema, BuilderExpectationSerialisedSchema, BuilderExpectationsSchema, BuilderExpectationsSerialisedSchema } from './expectation.js';
 export { BuilderEntityKindSchema, BuilderEntitySerialisedSchema } from './kind.js';
 export { BuilderOption, BuilderOptionSchema, BuilderOptionSelectMapSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionsSerialisedSchema, BuilderOptionValuesSchema, BuilderOptionValuesSerialisedSchema, BuilderOptionWhenSerialisedSchema, BuilderSelectType, BuilderSelectTypeSchema, BuilderSelectTypeSerialisedSchema, BuilderToggleType, BuilderToggleTypeSchema, BuilderToggleTypeSerialisedSchema, optionExpectation, optionValueSchema, optionWhen, select, toggleBoolean, toggleNumber, toggleString } from './option/index.js';

package/dist/entities/index.js

@@ -3,6 +3,8 @@ export { Builder, builder, BuilderSchema, BuilderSerialisedSchema } from './buil
 export { BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSchema, BuilderCollectionConfigSerialisedSchema, BuilderCollectionSchema, BuilderCollectionSelectMapSerialisedSchema, BuilderCollectionSerialisedSchema, BuilderCollectionsSerialisedSchema, BuilderCollectionWhenSerialisedSchema, collectionConfig, collectionExpectation, collectionWhen } from './collection/index.js';
 export { BuilderComponent, BuilderComponentDetails, BuilderComponentDetailsSchema, BuilderComponentDetailsSerialisedSchema, BuilderComponentField, BuilderComponentFieldSchema, BuilderComponentFieldSerialisedSchema, BuilderComponentFieldsSchema, BuilderComponentFieldsSerialisedSchema, BuilderComponentFieldValueTypeSchema, BuilderComponentSchema, BuilderComponentSelectMapSerialisedSchema, BuilderComponentSerialisedSchema, BuilderComponentsSerialisedSchema, BuilderComponentWhenSerialisedSchema, componentDetails, componentExpectation, componentWhen, detailBoolean, detailNumber, detailString, detailValueSchema } from './component/index.js';
 export { parameter, ref } from '../references.js';
+export { BuilderPricingExpressionSchema, BuilderPricingReduceSchema, BuilderPricingSchema, BuilderPricingTagExpressionSchema } from './pricing.js';
+export { BuilderTagsSchema } from './tags.js';
 export { BuilderExpectation, BuilderExpectationKindSchema, BuilderExpectationSchema, BuilderExpectationSerialisedSchema, BuilderExpectationsSchema, BuilderExpectationsSerialisedSchema } from './expectation.js';
 export { BuilderEntityKindSchema, BuilderEntitySerialisedSchema } from './kind.js';
 export { BuilderOption, BuilderOptionSchema, BuilderOptionSelectMapSerialisedSchema, BuilderOptionSerialisedSchema, BuilderOptionsSerialisedSchema, BuilderOptionValuesSchema, BuilderOptionValuesSerialisedSchema, BuilderOptionWhenSerialisedSchema, BuilderSelectType, BuilderSelectTypeSchema, BuilderSelectTypeSerialisedSchema, BuilderToggleType, BuilderToggleTypeSchema, BuilderToggleTypeSerialisedSchema, optionExpectation, optionValueSchema, optionWhen, select, toggleBoolean, toggleNumber, toggleString } from './option/index.js';

package/dist/entities/kind.d.ts

@@ -2,7 +2,7 @@ import type { EntitiesMap } from './serialise';
 import * as v from 'valibot';
 import { entitiesMap } from './serialise.js';
 export type BuilderEntityKind = keyof typeof entitiesMap;
-export declare const BuilderEntityKindSchema: v.PicklistSchema<readonly ("string" | "number" | "boolean" | "builder" | "model" | "ui" | "select" | "toggle" | "path" | "uiPage" | "uiDescribe" | "uiPages" | "uiInput" | "componentDetails" | "collectionConfig" | "expectations" | "uiItems" | "optionWhen" | "componentWhen" | "collectionWhen" | "optionSelectMap" | "componentSelectMap" | "collectionSelectMap" | "paths")[], undefined>;
+export declare const BuilderEntityKindSchema: v.PicklistSchema<readonly ("string" | "number" | "boolean" | "builder" | "model" | "pricing" | "ui" | "select" | "toggle" | "path" | "uiPage" | "uiDescribe" | "uiPages" | "uiInput" | "componentDetails" | "collectionConfig" | "expectations" | "uiItems" | "optionWhen" | "componentWhen" | "collectionWhen" | "optionSelectMap" | "componentSelectMap" | "collectionSelectMap" | "paths")[], undefined>;
 export type BuilderEntitySerialised = {
     [Kind in keyof EntitiesMap]: v.InferOutput<EntitiesMap[Kind]['serialised']>;
 }[keyof EntitiesMap];

package/dist/entities/model/model.d.ts

@@ -5,6 +5,7 @@ import type { BuilderCollections, BuilderCollectionsSerialised } from '../collec
 import type { BuilderComponents, BuilderComponentsSerialised } from '../component/index';
 import type { BuilderExpectation, BuilderExpectations, BuilderExpectationsSerialised } from '../expectation';
 import type { BuilderOptions, BuilderOptionsSerialised } from '../option/index';
+import type { BuilderTags } from '../tags';
 import type { BuilderModelStateAsserted } from './expectation';
 import type { BuilderCollectionMethod, BuilderComponentMethod, BuilderOptionMethod } from './methods';
 import type { BuilderModels, BuilderModelsMerge, BuilderModelsSerialised } from './models';
@@ -18,7 +19,9 @@ export declare class BuilderModel<State extends BuilderModelState = BuilderModel
     readonly components: State['components'];
     readonly collections: State['collections'];
     readonly expectations: BuilderExpectations;
-    constructor(models?: BuilderModels, options?: BuilderOptions, components?: BuilderComponents, collections?: BuilderCollections, expectations?: BuilderExpectations);
+    readonly tags?: BuilderTags;
+    constructor(models?: BuilderModels, options?: BuilderOptions, components?: BuilderComponents, collections?: BuilderCollections, expectations?: BuilderExpectations, tags?: BuilderTags);
+    tag(...tags: Array<string>): BuilderModel<State>;
     get option(): BuilderOptionMethod<State>;
     get component(): BuilderComponentMethod<State>;
     get collection(): BuilderCollectionMethod<State>;
@@ -33,6 +36,7 @@ export interface BuilderModelSerialised {
     readonly components: BuilderComponentsSerialised;
     readonly collections: BuilderCollectionsSerialised;
     readonly expectations: BuilderExpectationsSerialised;
+    readonly tags?: BuilderTags;
 }
 export declare const BuilderModelSerialisedSchema: v.GenericSchema<BuilderModelSerialised>;
 export type BuilderModelStateOf<Input extends Paramable<BuilderModelGeneric>> = Input extends BuilderModel<infer State extends BuilderModelState> ? State : BuilderModelStateEmpty;

package/dist/entities/model/model.js

@@ -4,6 +4,7 @@ import { BuilderCollectionsSerialisedSchema } from '../collection/index.js';
 import { BuilderComponentsSerialisedSchema } from '../component/index.js';
 import { BuilderExpectationsSerialisedSchema } from '../expectation.js';
 import { BuilderOptionsSerialisedSchema } from '../option/index.js';
+import { BuilderTagsSchema } from '../tags.js';
 import { builderCollectionMethod, builderComponentMethod, builderOptionMethod } from './methods.js';
 import { BuilderModelsSerialisedSchema } from './models.js';
 export class BuilderModel {
@@ -12,12 +13,17 @@ export class BuilderModel {
     components;
     collections;
     expectations;
-    constructor(models = [], options = [], components = [], collections = [], expectations = []) {
+    tags;
+    constructor(models = [], options = [], components = [], collections = [], expectations = [], tags) {
         this.models = models;
         this.options = options;
         this.components = components;
         this.collections = collections;
         this.expectations = expectations;
+        this.tags = tags;
+    }
+    tag(...tags) {
+        return new BuilderModel(this.models, this.options, this.components, this.collections, this.expectations, tags);
     }
     get option() {
         const method = builderOptionMethod();
@@ -57,7 +63,7 @@ export class BuilderModel {
         return this.#next({ expectations: [...this.expectations, ...expectations] });
     }
     #next(patch) {
-        return new BuilderModel(this.models, patch.options ?? this.options, patch.components ?? this.components, patch.collections ?? this.collections, patch.expectations ?? this.expectations);
+        return new BuilderModel(this.models, patch.options ?? this.options, patch.components ?? this.components, patch.collections ?? this.collections, patch.expectations ?? this.expectations, this.tags);
     }
 }
 export function model(...parts) {
@@ -69,5 +75,6 @@ export const BuilderModelSerialisedSchema = serialisable(v.object({
     options: BuilderOptionsSerialisedSchema,
     components: BuilderComponentsSerialisedSchema,
     collections: BuilderCollectionsSerialisedSchema,
-    expectations: BuilderExpectationsSerialisedSchema
+    expectations: BuilderExpectationsSerialisedSchema,
+    tags: v.optional(BuilderTagsSchema)
 }));

package/dist/entities/model/models.js

@@ -3,12 +3,16 @@ import { paramable } from '../../references.js';
 import { BuilderModelSerialisedSchema } from './model.js';
 export const BuilderModelsSerialisedSchema = v.pipe(v.array(paramable(v.lazy(() => BuilderModelSerialisedSchema))), v.readonly());
 export function modelsMerge(model) {
-    const merged = model.models.map(modelsMerge);
+    const flat = flattenModels(model);
     return {
         models: [],
-        options: [...model.options, ...merged.flatMap((nested) => nested.options)],
-        components: [...model.components, ...merged.flatMap((nested) => nested.components)],
-        collections: [...model.collections, ...merged.flatMap((nested) => nested.collections)],
-        expectations: [...model.expectations, ...merged.flatMap((nested) => nested.expectations)]
+        options: flat.flatMap((entry) => entry.options),
+        components: flat.flatMap((entry) => entry.components),
+        collections: flat.flatMap((entry) => entry.collections),
+        expectations: flat.flatMap((entry) => entry.expectations),
+        tags: Array.from(new Set(flat.flatMap((entry) => entry.tags ?? [])))
     };
 }
+function flattenModels(model) {
+    return [model, ...model.models.flatMap(flattenModels)];
+}

package/dist/entities/option/option.d.ts

@@ -1,5 +1,6 @@
 import type { BuilderPaths } from '../../paths';
 import type { Paramable } from '../../references';
+import type { BuilderTags } from '../tags';
 import type { BuilderWhenSerialised } from '../when';
 import type { BuilderOptionValues, BuilderOptionValuesSerialised } from './values';
 import type { BuilderOptionWhen } from './when';
@@ -10,7 +11,9 @@ export declare class BuilderOption<const Name extends string = string, const Pay
     readonly name: Name;
     readonly payload: Payload;
     readonly paths?: Paths;
-    constructor(name: Name, payload: Payload, paths?: Paths);
+    readonly tags?: BuilderTags;
+    constructor(name: Name, payload: Payload, paths?: Paths, tags?: BuilderTags);
+    tag(...tags: Array<string>): BuilderOption<Name, Payload, Paths>;
 }
 export declare const BuilderOptionSchema: v.InstanceSchema<typeof BuilderOption, undefined>;
 export type BuilderOptions = ReadonlyArray<BuilderOption>;
@@ -22,11 +25,13 @@ export declare const BuilderOptionWhenSerialisedSchema: v.GenericSchema<BuilderW
     optionLabels: {
         [x: string]: string;
     };
+    tags?: readonly string[] | undefined;
 }>> | Readonly<Readonly<{
     type: "toggle";
     valueType: "string" | "number" | "boolean";
     defaultValue: string | number | boolean | null;
     isOptional: boolean;
+    tags?: readonly string[] | undefined;
 }>>>>;
 export type BuilderOptionWhenSerialised = BuilderWhenSerialised<BuilderOptionValuesSerialised>;
 export declare const BuilderOptionSelectMapSerialisedSchema: v.GenericSchema<import("..").BuilderMatchSelectMap<Readonly<{
@@ -41,11 +46,13 @@ export declare const BuilderOptionSelectMapSerialisedSchema: v.GenericSchema<imp
     optionLabels: {
         [x: string]: string;
     };
+    tags?: readonly string[] | undefined;
 }>> | Readonly<Readonly<{
     type: "toggle";
     valueType: "string" | "number" | "boolean";
     defaultValue: string | number | boolean | null;
     isOptional: boolean;
+    tags?: readonly string[] | undefined;
 }>>>>;
 export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
@@ -69,6 +76,7 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         readonly defaultValue: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly isOptional: v.BooleanSchema<undefined>;
         readonly optionLabels: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -77,16 +85,19 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"toggle", undefined>;
         readonly valueType: v.PicklistSchema<["string", "boolean", "number"], undefined>;
         readonly defaultValue: v.NullableSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
         readonly isOptional: v.BooleanSchema<undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>]>], undefined>, v.ReadonlyAction<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -95,11 +106,13 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }> | Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>]>, v.GenericSchema<BuilderWhenSerialised<Readonly<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -108,11 +121,13 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>>>], undefined>], undefined>;
     readonly paths: v.OptionalSchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"parameter", undefined>;
@@ -129,6 +144,7 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         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>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     name: string;
     payload: Readonly<{
@@ -146,11 +162,13 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>> | BuilderWhenSerialised<Readonly<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -159,11 +177,13 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>>;
     paths?: readonly (readonly (string | number)[])[] | Readonly<{
         type: "parameter";
@@ -173,6 +193,7 @@ export declare const BuilderOptionSerialisedSchema: v.SchemaWithPipe<readonly [v
         type: "ref";
         id: string;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderOptionSerialised = v.InferOutput<typeof BuilderOptionSerialisedSchema>;
 export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
@@ -197,6 +218,7 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         readonly defaultValue: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly isOptional: v.BooleanSchema<undefined>;
         readonly optionLabels: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -205,16 +227,19 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"toggle", undefined>;
         readonly valueType: v.PicklistSchema<["string", "boolean", "number"], undefined>;
         readonly defaultValue: v.NullableSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
         readonly isOptional: v.BooleanSchema<undefined>;
+        readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
     }, undefined>, v.ReadonlyAction<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>]>], undefined>, v.ReadonlyAction<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -223,11 +248,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }> | Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>]>, v.GenericSchema<BuilderWhenSerialised<Readonly<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -236,11 +263,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>>>], undefined>], undefined>;
     readonly paths: v.OptionalSchema<v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"parameter", undefined>;
@@ -257,6 +286,7 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         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>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     name: string;
     payload: Readonly<{
@@ -274,11 +304,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>> | BuilderWhenSerialised<Readonly<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -287,11 +319,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>>;
     paths?: readonly (readonly (string | number)[])[] | Readonly<{
         type: "parameter";
@@ -301,6 +335,7 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         type: "ref";
         id: string;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>]>, undefined>, v.ReadonlyAction<Readonly<{
     name: string;
     payload: Readonly<{
@@ -318,11 +353,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>> | BuilderWhenSerialised<Readonly<Readonly<{
         type: "select";
         readonly options: readonly [string, ...string[]];
@@ -331,11 +368,13 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         optionLabels: {
             [x: string]: string;
         };
+        tags?: readonly string[] | undefined;
     }>> | Readonly<Readonly<{
         type: "toggle";
         valueType: "string" | "number" | "boolean";
         defaultValue: string | number | boolean | null;
         isOptional: boolean;
+        tags?: readonly string[] | undefined;
     }>>>;
     paths?: readonly (readonly (string | number)[])[] | Readonly<{
         type: "parameter";
@@ -345,5 +384,6 @@ export declare const BuilderOptionsSerialisedSchema: v.SchemaWithPipe<readonly [
         type: "ref";
         id: string;
     }> | undefined;
+    tags?: readonly string[] | undefined;
 }>[]>]>;
 export type BuilderOptionsSerialised = v.InferOutput<typeof BuilderOptionsSerialisedSchema>;

package/dist/entities/option/option.js

@@ -2,16 +2,22 @@ import * as v from 'valibot';
 import { BuilderPathsSchema } from '../../paths.js';
 import { paramable } from '../../references.js';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 import { createSelectMapSerialisedSchema, createWhenSerialisedSchema } from '../when.js';
 import { BuilderOptionValuesSerialisedSchema } from './values.js';
 export class BuilderOption {
     name;
     payload;
     paths;
-    constructor(name, payload, paths) {
+    tags;
+    constructor(name, payload, paths, tags) {
         this.name = name;
         this.payload = payload;
         this.paths = paths;
+        this.tags = tags;
+    }
+    tag(...tags) {
+        return new BuilderOption(this.name, this.payload, this.paths, tags);
     }
 }
 export const BuilderOptionSchema = v.instance(BuilderOption);
@@ -20,6 +26,7 @@ export const BuilderOptionSelectMapSerialisedSchema = createSelectMapSerialisedS
 export const BuilderOptionSerialisedSchema = serialisable(v.object({
     name: v.string(),
     payload: paramable(v.union([BuilderOptionValuesSerialisedSchema, BuilderOptionWhenSerialisedSchema])),
-    paths: v.optional(paramable(BuilderPathsSchema))
+    paths: v.optional(paramable(BuilderPathsSchema)),
+    tags: v.optional(BuilderTagsSchema)
 }));
 export const BuilderOptionsSerialisedSchema = v.pipe(v.array(BuilderOptionSerialisedSchema), v.readonly());

package/dist/entities/option/select.d.ts

@@ -1,7 +1,9 @@
+import type { BuilderTags } from '../tags';
 import * as v from 'valibot';
 export type BuilderSelectTypeLabels<Values extends BuilderSelectTypeValues> = Partial<Record<Values[number], string>>;
 export type BuilderSelectTypeValues = readonly [string, ...ReadonlyArray<string>];
 export declare class BuilderSelectType<const Values extends BuilderSelectTypeValues = BuilderSelectTypeValues, const ValueSchema extends v.GenericSchema<string | null> = v.GenericSchema<string | null>> {
+    #private;
     readonly value: v.InferOutput<ValueSchema>;
     readonly type: "select";
     readonly options: Values;
@@ -9,10 +11,12 @@ export declare class BuilderSelectType<const Values extends BuilderSelectTypeVal
     readonly defaultValue: v.InferOutput<ValueSchema>;
     readonly isOptional: boolean;
     readonly optionLabels: BuilderSelectTypeLabels<Values>;
-    constructor(values: Values, defaultValue: v.InferOutput<ValueSchema>, optional?: boolean, optionLabels?: BuilderSelectTypeLabels<Values>);
+    readonly tags?: BuilderTags;
+    constructor(values: Values, defaultValue: v.InferOutput<ValueSchema>, optional?: boolean, optionLabels?: BuilderSelectTypeLabels<Values>, tags?: BuilderTags);
     default(newDefault: v.InferOutput<ValueSchema>): BuilderSelectType<Values, ValueSchema>;
     optional(): BuilderSelectType<Values, v.NullableSchema<ValueSchema, undefined>>;
     labels(optionLabels: BuilderSelectTypeLabels<Values>): BuilderSelectType<Values, ValueSchema>;
+    tag(...tags: Array<string>): BuilderSelectType<Values, ValueSchema>;
 }
 type SelectSchema<Values extends BuilderSelectTypeValues> = v.UnionSchema<{
     [K in keyof Values]: v.LiteralSchema<Values[K], undefined>;
@@ -25,6 +29,7 @@ export declare const BuilderSelectTypeSerialisedSchema: v.SchemaWithPipe<readonl
     readonly defaultValue: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly isOptional: v.BooleanSchema<undefined>;
     readonly optionLabels: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
+    readonly tags: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ReadonlyAction<string[]>]>, undefined>;
 }, undefined>, v.ReadonlyAction<{
     type: "select";
     readonly options: readonly [string, ...string[]];
@@ -33,6 +38,7 @@ export declare const BuilderSelectTypeSerialisedSchema: v.SchemaWithPipe<readonl
     optionLabels: {
         [x: string]: string;
     };
+    tags?: readonly string[] | undefined;
 }>]>;
 export type BuilderSelectTypeSerialised = v.InferOutput<typeof BuilderSelectTypeSerialisedSchema>;
 export declare function selectValueSchema(options: ReadonlyArray<string>, optional: boolean): v.GenericSchema<string | null>;

package/dist/entities/option/select.js

@@ -1,5 +1,6 @@
 import * as v from 'valibot';
 import { serialisable } from '../../serialisable.js';
+import { BuilderTagsSchema } from '../tags.js';
 export class BuilderSelectType {
     type = 'select';
     options;
@@ -7,22 +8,31 @@ export class BuilderSelectType {
     defaultValue;
     isOptional;
     optionLabels;
-    constructor(values, defaultValue, optional = false, optionLabels = {}) {
+    tags;
+    constructor(values, defaultValue, optional = false, optionLabels = {}, tags) {
         this.options = values;
         this.valueSchema = selectValueSchema(values, optional);
         this.defaultValue = defaultValue;
         this.isOptional = optional;
         this.optionLabels = optionLabels;
+        this.tags = tags;
+    }
+    #next(patch) {
+        return new BuilderSelectType(this.options, 'defaultValue' in patch
+            ? patch.defaultValue
+            : this.defaultValue, patch.optional ?? this.isOptional, patch.optionLabels ?? this.optionLabels, patch.tags ?? this.tags);
     }
     default(newDefault) {
-        return new BuilderSelectType(this.options, newDefault, this.isOptional, this.optionLabels);
+        return this.#next({ defaultValue: newDefault });
     }
     optional() {
-        const { options, defaultValue } = this;
-        return new BuilderSelectType(options, defaultValue, true, this.optionLabels);
+        return this.#next({ optional: true });
     }
     labels(optionLabels) {
-        return new BuilderSelectType(this.options, this.defaultValue, this.isOptional, optionLabels);
+        return this.#next({ optionLabels });
+    }
+    tag(...tags) {
+        return this.#next({ tags });
     }
 }
 export function select(values) {
@@ -35,7 +45,8 @@ export const BuilderSelectTypeSerialisedSchema = serialisable(v.object({
     options: v.pipe(v.tupleWithRest([v.string()], v.string()), v.readonly()),
     defaultValue: v.nullable(v.string()),
     isOptional: v.boolean(),
-    optionLabels: v.record(v.string(), v.string())
+    optionLabels: v.record(v.string(), v.string()),
+    tags: v.optional(BuilderTagsSchema)
 }));
 export function selectValueSchema(options, optional) {
     const baseSchema = v.union(options.map((value) => v.literal(value)));