@builder-builder/builder 0.0.19 → 0.0.21

package/dist/index.d.ts

@@ -1,26 +1,27 @@
-export type { BB, BBOptions } from './bb';
-export type { Builder, BuilderBindings, BuilderBindingsSerialised, BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSerialised, BuilderCollections, BuilderCollectionSerialised, BuilderCollectionsSerialised, BuilderCollectionWhen, BuilderCollectionWhenSerialised, BuilderComponent, BuilderComponentDetails, BuilderComponentDetailsSerialised, BuilderComponentField, BuilderComponentFields, BuilderComponentFieldSerialised, BuilderComponentFieldsSerialised, BuilderComponentFieldValueType, BuilderComponents, BuilderComponentSerialised, BuilderComponentsSerialised, BuilderComponentVariantsValidated, BuilderComponentWhen, BuilderComponentWhenSerialised, BuilderDescription, BuilderDescriptionItem, BuilderEnableConfig, BuilderEntityKind, BuilderEntitySerialised, BuilderExpectation, BuilderExpectationKind, BuilderExpectations, BuilderExpectationSerialised, BuilderExpectationsSerialised, BuilderInstanceOf, BuilderInstanceValidated, BuilderMatchConfig, BuilderMatchSelectMap, BuilderModel, BuilderModels, BuilderModelSerialised, BuilderModelValidated, BuilderOption, BuilderOptions, BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionValues, BuilderOptionValuesSerialised, BuilderOptionWhen, BuilderOptionWhenSerialised, BuilderPricing, BuilderPricingExpression, BuilderPricingLookupKey, BuilderPricingReduce, BuilderPricingSerialised, BuilderRefEntities, BuilderRefEntity, BuilderSelectType, BuilderSelectTypeLabels, BuilderSelectTypeSerialised, BuilderSelectTypeValues, BuilderSerialised, BuilderTags, BuilderToggleType, BuilderToggleTypeSerialised, BuilderToggleValueType, BuilderUI, BuilderUIDescribe, BuilderUIDescribeSerialised, BuilderUIInput, BuilderUIInputMetadata, BuilderUIInputMetadataSerialised, BuilderUIInputs, BuilderUIInputSerialised, BuilderUIInputsSerialised, BuilderUIItem, BuilderUIItems, BuilderUIItemsSerialised, BuilderUIPage, BuilderUIPages, BuilderUIPageSerialised, BuilderUIPagesSerialised, BuilderUIs, BuilderUISerialised, BuilderUIsSerialised, BuilderUIValidated, BuilderUnlessConfig, BuilderValidated, BuilderWhen, BuilderWhenConfig, BuilderWhenSerialised } from './entities/index';
+export type { BB, BBOptions, BuilderEntityValidators } from './bb';
+export type { Builder, BuilderBindings, BuilderBindingsSerialised, BuilderCollection, BuilderCollectionConfig, BuilderCollectionConfigSerialised, BuilderCollections, BuilderCollectionSerialised, BuilderCollectionsSerialised, BuilderCollectionWhen, BuilderCollectionWhenSerialised, BuilderComponent, BuilderComponentConfig, BuilderComponentConfigSerialised, BuilderComponentField, BuilderComponentFields, BuilderComponentFieldSerialised, BuilderComponentFieldsSerialised, BuilderComponentFieldValueType, BuilderComponents, BuilderComponentSerialised, BuilderComponentsSerialised, BuilderComponentWhen, BuilderComponentWhenSerialised, BuilderDescription, BuilderDescriptionItem, BuilderEnableConfig, BuilderEntityKind, BuilderEntitySerialised, BuilderExpectation, BuilderExpectationKind, BuilderExpectations, BuilderExpectationSerialised, BuilderExpectationsSerialised, BuilderInstanceOf, BuilderInstanceValidated, BuilderMatchConfig, BuilderMatchSelectMap, BuilderModel, BuilderModels, BuilderModelSerialised, BuilderModelValidated, BuilderOption, BuilderOptionConfig, BuilderOptionConfigSerialised, BuilderOptions, BuilderOptionSerialised, BuilderOptionsSerialised, BuilderOptionWhen, BuilderOptionWhenSerialised, BuilderPath, BuilderPaths, BuilderPricing, BuilderPricingExpression, BuilderPricingLookupKey, BuilderPricingReduce, BuilderPricingSerialised, BuilderReference, BuilderReferences, BuilderSelectConfig, BuilderSelectConfigLabels, BuilderSelectConfigSerialised, BuilderSelectConfigValues, BuilderSerialised, BuilderTags, BuilderToggleConfig, BuilderToggleConfigSerialised, BuilderToggleValueType, BuilderUI, BuilderUIDescribe, BuilderUIDescribeSerialised, BuilderUIInput, BuilderUIInputMetadata, BuilderUIInputMetadataSerialised, BuilderUIInputs, BuilderUIInputSerialised, BuilderUIInputsSerialised, BuilderUIItem, BuilderUIItems, BuilderUIItemsSerialised, BuilderUIPage, BuilderUIPages, BuilderUIPageSerialised, BuilderUIPagesSerialised, BuilderUIs, BuilderUISerialised, BuilderUIsSerialised, BuilderUIValidated, BuilderUnlessConfig, BuilderValidated, BuilderVariantsValidated, BuilderWhen, BuilderWhenConfig, BuilderWhenSerialised } from './entities/index';
 export type { BuilderEnvironment } from './environment';
-export type { BuilderError, BuilderErrorBase, BuilderErrorLocation, BuilderErrors } from './exception';
-export type { BuilderComponentVariants, BuilderInstance, BuilderInstanceInput, BuilderInstances, BuilderVariant, BuilderVariants } from './instance';
-export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidPricing, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidPricingReason, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingRate, 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 { BuilderPath, BuilderPaths } from './paths';
+export type { BuilderError, BuilderErrorLocation, BuilderErrors } from './errors/index';
+export type { BuilderComponentVariant, BuilderComponentVariants, BuilderInstance, BuilderInstanceInput, BuilderInstances, BuilderVariants } from './instance';
+export type { BuilderOrder, BuilderRenderMetadata, BuilderRenderOption, BuilderRenderOptions, BuilderRenderPage, BuilderRenderPages, BuilderRenderResult, BuilderRenderUpdate } from './mappers/index';
 export type { BuilderPrimitive, BuilderPrimitives } from './primitive';
 export type { BuilderParameter, BuilderParameterSerialised, BuilderRef, Paramable, ParamableSerialised } from './references';
+export type { BuilderErrorKind, BuilderInstanceValidationResult, BuilderModelValidationResult, BuilderPricingValidationResult, BuilderUIValidationResult, BuilderValidationResult, BuilderVariantsValidationOptions, BuilderVariantsValidationResult } from './validate/index';
+import { collectionConfig, collectionExpectation, componentConfig, componentExpectation, optionExpectation, uis } from './entities/index.js';
 export { bb } from './bb.js';
-export { builder, detailBoolean, detailNumber, detailString, input, model, parameter, pricing, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
-export { BuilderException } from './exception.js';
+export { builder, detailBoolean, detailNumber, detailString, input, model, pricing, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
+export { BuilderException } from './errors/index.js';
+export { parameter, ref } from './references.js';
 export { ordinal } from './mappers/index.js';
-import { collectionConfig, collectionExpectation, componentDetails, componentExpectation, optionExpectation, uis } from './entities/index.js';
 export declare const collection: typeof collectionConfig & {
     enable: <const Values extends import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>>(values: Values) => import(".").BuilderEnableConfig<Values>;
-    match: <const MatchPayload extends import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>, const MatchPath extends import("./references").Paramable<import("./paths").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<MatchPayload, MatchPath, SelectMap>;
-    unless: <const Values extends import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>, const UnlessPath extends import("./references").Paramable<import("./paths").BuilderPath>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, values: Values) => import(".").BuilderUnlessConfig<Values, UnlessPath>;
+    match: <const MatchPayload extends import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>, const MatchPath extends import("./references").Paramable<import(".").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<MatchPayload, MatchPath, SelectMap>;
+    unless: <const Values extends import("./references").Paramable<import(".").BuilderCollectionConfig<import("./references").Paramable<import("./entities/model").BuilderModelGeneric>, import("./references").Paramable<number>, import("./references").Paramable<number>>>, const UnlessPath extends import("./references").Paramable<import(".").BuilderPath>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, values: Values) => import(".").BuilderUnlessConfig<Values, UnlessPath>;
 };
-export declare const component: typeof componentDetails & {
-    enable: <const Payload extends import("./references").Paramable<import(".").BuilderComponentDetails>>(payload?: Payload) => import(".").BuilderEnableConfig<Payload>;
-    match: <const Payload extends import("./references").Paramable<import(".").BuilderComponentDetails>, const MatchPath extends import("./references").Paramable<import("./paths").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderComponentDetails>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<Payload, MatchPath, SelectMap>;
-    unless: <const UnlessPath extends import("./references").Paramable<import("./paths").BuilderPath>, const Payload extends import("./references").Paramable<import(".").BuilderComponentDetails>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, payload?: Payload) => import(".").BuilderUnlessConfig<Payload, UnlessPath>;
+export declare const component: typeof componentConfig & {
+    enable: <const Payload extends import("./references").Paramable<import(".").BuilderComponentConfig>>(payload?: Payload) => import(".").BuilderEnableConfig<Payload>;
+    match: <const Payload extends import("./references").Paramable<import(".").BuilderComponentConfig>, const MatchPath extends import("./references").Paramable<import(".").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderComponentConfig>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<Payload, MatchPath, SelectMap>;
+    unless: <const UnlessPath extends import("./references").Paramable<import(".").BuilderPath>, const Payload extends import("./references").Paramable<import(".").BuilderComponentConfig>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, payload?: Payload) => import(".").BuilderUnlessConfig<Payload, UnlessPath>;
 };
 export declare const has: {
     collection: typeof collectionExpectation;
@@ -28,8 +29,8 @@ export declare const has: {
     option: typeof optionExpectation;
 };
 export declare const option: {
-    enable: <const Values extends import("./references").Paramable<import(".").BuilderSelectType<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleType<import("valibot").GenericSchema<string | number | boolean | null>>>>(values: Values) => import(".").BuilderEnableConfig<Values>;
-    match: <const MatchPayload extends import("./references").Paramable<import(".").BuilderSelectType<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleType<import("valibot").GenericSchema<string | number | boolean | null>>>, const MatchPath extends import("./references").Paramable<import("./paths").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderSelectType<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleType<import("valibot").GenericSchema<string | number | boolean | null>>>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<MatchPayload, MatchPath, SelectMap>;
-    unless: <const Values extends import("./references").Paramable<import(".").BuilderSelectType<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleType<import("valibot").GenericSchema<string | number | boolean | null>>>, const UnlessPath extends import("./references").Paramable<import("./paths").BuilderPath>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, values: Values) => import(".").BuilderUnlessConfig<Values, UnlessPath>;
+    enable: <const Values extends import("./references").Paramable<import(".").BuilderSelectConfig<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleConfig<import("valibot").GenericSchema<string | number | boolean | null>>>>(values: Values) => import(".").BuilderEnableConfig<Values>;
+    match: <const MatchPayload extends import("./references").Paramable<import(".").BuilderSelectConfig<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleConfig<import("valibot").GenericSchema<string | number | boolean | null>>>, const MatchPath extends import("./references").Paramable<import(".").BuilderPath>, const SelectMap extends import("./references").Paramable<import(".").BuilderMatchSelectMap<import("./references").Paramable<import(".").BuilderSelectConfig<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleConfig<import("valibot").GenericSchema<string | number | boolean | null>>>>>>(matchPath: MatchPath, selectMap: SelectMap) => import(".").BuilderMatchConfig<MatchPayload, MatchPath, SelectMap>;
+    unless: <const Values extends import("./references").Paramable<import(".").BuilderSelectConfig<readonly [string, ...string[]], import("valibot").GenericSchema<string | null>> | import(".").BuilderToggleConfig<import("valibot").GenericSchema<string | number | boolean | null>>>, const UnlessPath extends import("./references").Paramable<import(".").BuilderPath>>(unlessPath: UnlessPath, disabledValues: import("./primitive").BuilderPrimitives, values: Values) => import(".").BuilderUnlessConfig<Values, UnlessPath>;
 };
 export declare const ui: typeof uis;

package/dist/index.js

@@ -1,12 +1,13 @@
+import { collectionConfig, collectionExpectation, collectionWhen, componentConfig, componentExpectation, componentWhen, optionExpectation, optionWhen, uis } from './entities/index.js';
 export { bb } from './bb.js';
-export { builder, detailBoolean, detailNumber, detailString, input, model, parameter, pricing, ref, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
-export { BuilderException } from './exception.js';
+export { builder, detailBoolean, detailNumber, detailString, input, model, pricing, select, serialise, toggleBoolean, toggleNumber, toggleString } from './entities/index.js';
+export { BuilderException } from './errors/index.js';
+export { parameter, ref } from './references.js';
 export { ordinal } from './mappers/index.js';
-import { collectionConfig, collectionExpectation, collectionWhen, componentDetails, componentExpectation, componentWhen, optionExpectation, optionWhen, uis } from './entities/index.js';
 export const collection = Object.assign(collectionConfig, {
     ...collectionWhen
 });
-export const component = Object.assign(componentDetails, {
+export const component = Object.assign(componentConfig, {
     ...componentWhen
 });
 export const has = {

package/dist/instance.d.ts

@@ -1,5 +1,5 @@
+import type { BuilderPrimitive } from './primitive';
 import * as v from 'valibot';
-import { type BuilderPrimitive } from './primitive.js';
 export type BuilderInstance = {
     readonly [key: string]: BuilderPrimitive | BuilderInstances;
 };
@@ -7,7 +7,7 @@ export declare const BuilderInstanceSchema: v.GenericSchema<BuilderInstance>;
 export declare const BuilderInstancesSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.GenericSchema<BuilderInstance>, undefined>, v.ReadonlyAction<BuilderInstance[]>]>;
 export type BuilderInstances = v.InferOutput<typeof BuilderInstancesSchema>;
 export type BuilderInstanceInput = Readonly<Record<string, unknown>>;
-export declare const BuilderVariantSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+export declare const BuilderComponentVariantSchema: 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>;
@@ -18,8 +18,8 @@ export declare const BuilderVariantSchema: v.SchemaWithPipe<readonly [v.ObjectSc
     } | 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<{
+export type BuilderComponentVariant = v.InferOutput<typeof BuilderComponentVariantSchema>;
+export declare const BuilderComponentVariantsSchema: 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>;
@@ -36,8 +36,8 @@ export declare const BuilderVariantsSchema: v.SchemaWithPipe<readonly [v.ArraySc
     } | 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<{
+export type BuilderComponentVariants = v.InferOutput<typeof BuilderComponentVariantsSchema>;
+export declare const BuilderVariantsSchema: 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>;
@@ -62,4 +62,4 @@ export declare const BuilderComponentVariantsSchema: v.SchemaWithPipe<readonly [
         tags?: readonly string[] | undefined;
     }>[];
 }>]>;
-export type BuilderComponentVariants = v.InferOutput<typeof BuilderComponentVariantsSchema>;
+export type BuilderVariants = v.InferOutput<typeof BuilderVariantsSchema>;

package/dist/instance.js

@@ -1,12 +1,12 @@
 import * as v from 'valibot';
+import { BuilderTagsSchema } from './entities/index.js';
 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({
+export const BuilderComponentVariantSchema = v.pipe(v.object({
     instance: BuilderInstanceSchema,
     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());
+export const BuilderComponentVariantsSchema = v.pipe(v.array(BuilderComponentVariantSchema), v.readonly());
+export const BuilderVariantsSchema = v.pipe(v.record(v.string(), BuilderComponentVariantsSchema), v.readonly());

package/dist/mappers/index.d.ts

@@ -1,11 +1,9 @@
-export type { BuilderComponentVariantsValidationResult, BuilderErrorDuplicateName, BuilderErrorInvalidCollection, BuilderErrorInvalidCollectionBounds, BuilderErrorInvalidDetail, BuilderErrorInvalidInput, BuilderErrorInvalidOption, BuilderErrorInvalidPath, BuilderErrorInvalidPathReason, BuilderErrorInvalidPricing, BuilderErrorInvalidSelectMapKey, BuilderErrorInvalidPricingReason, BuilderErrorInvalidVariant, BuilderErrorMissingComponent, BuilderErrorMissingDetail, BuilderErrorMissingRate, 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, validatePricing, validateUI, validateVariants } from '../validate/index.js';
-export type { BuilderOptionGraph } from './variants/index.js';
+export type { BuilderOptionGraph } from './variants/index';
 export { createInstance } from './instance.js';
-export { createVariants, optionGraph, variantsFor } from './variants/index.js';
 export { order } from './order.js';
 export { price } from './price.js';
 export { ordinal, render } from './render/index.js';
 export { resolveCollection, resolveCollections, resolveComponent, resolveComponents, resolveOption, resolveOptions } from './resolve.js';
+export { createVariants, optionGraph, variantsFor } from './variants/index.js';

package/dist/mappers/index.js

@@ -1,7 +1,6 @@
-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 { price } from './price.js';
 export { ordinal, render } from './render/index.js';
 export { resolveCollection, resolveCollections, resolveComponent, resolveComponents, resolveOption, resolveOptions } from './resolve.js';
+export { createVariants, optionGraph, variantsFor } from './variants/index.js';

package/dist/mappers/instance.d.ts

@@ -1,3 +1,3 @@
-import type { BuilderModelValidated, BuilderRefEntities, BuilderValidated } from '../entities/index';
+import type { BuilderModelValidated, BuilderReferences, BuilderValidated } from '../entities/index';
 import type { BuilderInstance, BuilderInstanceInput } from '../instance';
-export declare function createInstance(entity: BuilderValidated | BuilderModelValidated, partial?: BuilderInstanceInput, refs?: BuilderRefEntities): BuilderInstance;
+export declare function createInstance(entity: BuilderValidated | BuilderModelValidated, partial?: BuilderInstanceInput, references?: BuilderReferences): BuilderInstance;

package/dist/mappers/instance.js

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

package/dist/mappers/order.d.ts

@@ -1,6 +1,6 @@
-import type { BuilderComponentVariantsValidated, BuilderInstanceValidated, BuilderModelValidated, BuilderRefEntities } from '../entities/index';
-import type { BuilderVariant } from '../instance';
+import type { BuilderInstanceValidated, BuilderModelValidated, BuilderReferences, BuilderVariantsValidated } from '../entities/index';
+import type { BuilderComponentVariant } from '../instance';
 export interface BuilderOrder {
-    readonly [key: string]: BuilderVariant | BuilderOrder | ReadonlyArray<BuilderOrder> | null;
+    readonly [key: string]: BuilderComponentVariant | BuilderOrder | ReadonlyArray<BuilderOrder> | null;
 }
-export declare function order(model: BuilderModelValidated, instance: BuilderInstanceValidated, variants: BuilderComponentVariantsValidated, refs?: BuilderRefEntities): BuilderOrder;
+export declare function order(model: BuilderModelValidated, instance: BuilderInstanceValidated, variants: BuilderVariantsValidated, references?: BuilderReferences): BuilderOrder;

package/dist/mappers/order.js

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

package/dist/mappers/price.js

@@ -1,7 +1,7 @@
 import * as v from 'valibot';
-import { check } from '../check.js';
 import { BuilderPricingExpressionSchema } from '../entities/index.js';
-import { BuilderVariantSchema } from '../instance.js';
+import { check } from '../errors/index.js';
+import { BuilderComponentVariantSchema } from '../instance.js';
 const NumberSchema = v.number();
 export function price(pricingInput, order) {
     const { rates, formula } = pricingInput;
@@ -10,31 +10,31 @@ export function price(pricingInput, order) {
     }
     const variants = collectVariants(order);
     return evaluate(formula);
-    function evaluate(expression, currentVariant = null) {
+    function evaluate(expression, variant = null) {
         check.assert(BuilderPricingExpressionSchema, expression);
         if (check.is(NumberSchema, expression)) {
             return expression;
         }
         switch (expression.kind) {
             case 'variantPrice':
-                return variantPrice(currentVariant);
+                return variantPrice(variant);
             case 'lookup':
-                return evaluateLookup(expression, currentVariant);
+                return evaluateLookup(expression, variant);
             case 'variants':
                 return evaluateVariants(expression);
             case 'add':
-                return combine(expression.left, expression.right, currentVariant, (l, r) => l + r);
+                return combine(expression.left, expression.right, variant, (l, r) => l + r);
             case 'sub':
-                return combine(expression.left, expression.right, currentVariant, (l, r) => l - r);
+                return combine(expression.left, expression.right, variant, (l, r) => l - r);
             case 'mul':
-                return combine(expression.left, expression.right, currentVariant, (l, r) => l * r);
+                return combine(expression.left, expression.right, variant, (l, r) => l * r);
             case 'div':
-                return combine(expression.left, expression.right, currentVariant, (l, r) => l / r);
+                return combine(expression.left, expression.right, variant, (l, r) => l / r);
         }
     }
-    function combine(left, right, currentVariant, operation) {
-        const leftValue = evaluate(left, currentVariant);
-        const rightValue = evaluate(right, currentVariant);
+    function combine(left, right, variant, operation) {
+        const leftValue = evaluate(left, variant);
+        const rightValue = evaluate(right, variant);
         if (leftValue == null || rightValue == null) {
             return null;
         }
@@ -54,8 +54,8 @@ export function price(pricingInput, order) {
         const candidate = variant?.details?.price;
         return check.is(NumberSchema, candidate) ? candidate : null;
     }
-    function evaluateLookup(expression, currentVariant) {
-        const keys = resolveKey(expression.key, currentVariant);
+    function evaluateLookup(expression, variant) {
+        const keys = resolveKey(expression.key, variant);
         const matches = keys
             .map((key) => lookupRate(expression.rate, key))
             .filter((value) => value != null);
@@ -73,12 +73,12 @@ export function price(pricingInput, order) {
         }
         return reduceValues(results, expression.reduce ?? 'sum');
     }
-    function resolveKey(key, currentVariant) {
+    function resolveKey(key, variant) {
         switch (key.kind) {
             case 'variantTags':
-                return currentVariant?.tags ?? [];
+                return variant?.tags ?? [];
             case 'option': {
-                const value = currentVariant?.instance?.[key.name];
+                const value = variant?.instance?.[key.name];
                 return value == null ? [] : [String(value)];
             }
         }
@@ -100,7 +100,7 @@ function collectVariants(order) {
         if (value == null) {
             return [];
         }
-        if (check.is(BuilderVariantSchema, value)) {
+        if (check.is(BuilderComponentVariantSchema, value)) {
             return [value];
         }
         if (Array.isArray(value)) {

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

@@ -1,4 +1,4 @@
-import type { BuilderOptionValuesSerialised } from '../../entities/index';
+import type { BuilderOptionConfigSerialised } from '../../entities/index';
 import type { BuilderPrimitive } from '../../primitive';
 import type { BuilderInstance } from '../../instance';
 import * as v from 'valibot';
@@ -11,7 +11,7 @@ export type BuilderRenderOption = Readonly<{
     name: string;
     value: BuilderPrimitive;
     update: BuilderRenderUpdate;
-    option: BuilderOptionValuesSerialised;
+    option: BuilderOptionConfigSerialised;
     displayName?: string;
     kind?: string;
     metadata?: BuilderRenderMetadata;

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

@@ -1,7 +1,7 @@
-import type { BuilderDescription, BuilderInstanceValidated, BuilderRefEntities, BuilderValidated } from '../../entities/index';
+import type { BuilderDescription, BuilderInstanceValidated, BuilderReferences, BuilderValidated } from '../../entities/index';
 import type { BuilderRenderPages } from './pages';
 export type BuilderRenderResult = Readonly<{
     layout: BuilderRenderPages;
     description: BuilderDescription;
 }>;
-export declare function render(builder: BuilderValidated, instance: BuilderInstanceValidated, refs?: BuilderRefEntities): BuilderRenderResult;
+export declare function render(builder: BuilderValidated, instance: BuilderInstanceValidated, references?: BuilderReferences): BuilderRenderResult;

package/dist/mappers/render/render.js

@@ -1,12 +1,12 @@
-import { BuilderRenderMetadataSchema } from './pages.js';
 import * as v from 'valibot';
-import { check } from '../../check.js';
+import { check } from '../../errors/index.js';
 import { BuilderInstancesSchema } from '../../instance.js';
 import { BuilderPrimitiveSchema } from '../../primitive.js';
 import { createInstance } from '../instance.js';
-import { resolveCollection, resolvePath, resolveRef } from '../resolve.js';
+import { resolveCollection, resolvePath, resolveReference } from '../resolve.js';
 import { ordinal } from './ordinal.js';
-export function render(builder, instance, refs = []) {
+import { BuilderRenderMetadataSchema } from './pages.js';
+export function render(builder, instance, references = []) {
     const layout = [];
     const description = [];
     walkTree(builder.ui);
@@ -40,7 +40,7 @@ export function render(builder, instance, refs = []) {
     function emitPage(page, model, collectionPath, labelContext, currentInstance) {
         const options = page.inputs.flatMap((input) => {
             const { path } = input;
-            const found = resolvePath(model, currentInstance, path, refs);
+            const found = resolvePath(model, currentInstance, path, references);
             if (found == null) {
                 return [];
             }
@@ -51,7 +51,7 @@ export function render(builder, instance, refs = []) {
                     name: found.name,
                     option: found.payload,
                     value: found.value,
-                    update: (updateInstance, updateValue) => createInstance(builder, setPath(updateInstance, fullPath, updateValue), refs),
+                    update: (updateInstance, updateValue) => createInstance(builder, setPath(updateInstance, fullPath, updateValue), references),
                     displayName: input.displayName && composeString(input.displayName, 'displayName'),
                     kind: input.kind && composeString(input.kind, 'kind'),
                     metadata: input.metadata && composeMetadata(input.metadata)
@@ -67,7 +67,7 @@ export function render(builder, instance, refs = []) {
         const composedLabel = composeLabel(describe.label, labelContext);
         const values = describe.inputs.flatMap((input) => {
             const { path } = input;
-            const found = resolvePath(model, currentInstance, path, refs);
+            const found = resolvePath(model, currentInstance, path, references);
             if (found?.value == null) {
                 return [];
             }
@@ -80,7 +80,7 @@ export function render(builder, instance, refs = []) {
         description.push([composedLabel, values.join(' ')]);
     }
     function composeLabel(label, labelContext = []) {
-        const resolved = resolveRef(label, refs);
+        const resolved = resolveReference(label, references);
         check.assert(v.string(), resolved, 'Label did not resolve to a string! ❌');
         if (labelContext.length === 0) {
             return resolved;
@@ -91,18 +91,18 @@ export function render(builder, instance, refs = []) {
         return `${labelContext.join(', ')}, ${resolved}`;
     }
     function composeString(value, fieldLabel) {
-        const resolved = resolveRef(value, refs);
+        const resolved = resolveReference(value, references);
         check.assert(v.string(), resolved, `Input ${fieldLabel} did not resolve to a string! ❌`);
         return resolved;
     }
     function composeMetadata(value) {
-        const resolved = resolveRef(value, refs);
+        const resolved = resolveReference(value, references);
         check.assert(BuilderRenderMetadataSchema, resolved, 'Input metadata did not resolve to an object! ❌');
-        return Object.fromEntries(Object.entries(resolved).map(([key, entry]) => [key, resolveRef(entry, refs)]));
+        return Object.fromEntries(Object.entries(resolved).map(([key, entry]) => [key, resolveReference(entry, references)]));
     }
     function findCollection(model, instance, collectionName) {
         const entry = model.collections.find((candidate) => candidate.name === collectionName);
-        return entry == null ? null : resolveCollection(entry, model, instance, refs);
+        return entry == null ? null : resolveCollection(entry, model, instance, references);
     }
 }
 function setPath(container, path, value) {

package/dist/mappers/resolve.d.ts

@@ -1,17 +1,16 @@
-import type { BuilderCollectionConfigSerialised, BuilderCollectionConfigValidated, BuilderCollectionSerialised, BuilderCollectionValidated, BuilderComponentDetailsSerialised, BuilderComponentDetailsValidated, BuilderComponentSerialised, BuilderComponentValidated, BuilderModelValidated, BuilderOptionSerialised, BuilderOptionValidated, BuilderOptionValuesSerialised, BuilderOptionValuesValidated, BuilderRefEntities } from '../entities/index';
+import type { BuilderCollectionConfigsSerialised, BuilderCollectionConfigValidated, BuilderCollectionSerialised, BuilderCollectionValidated, BuilderComponentConfigsSerialised, BuilderComponentConfigValidated, BuilderComponentSerialised, BuilderComponentValidated, BuilderModelValidated, BuilderOptionConfigsSerialised, BuilderOptionConfigValidated, BuilderOptionSerialised, BuilderOptionValidated, BuilderPath, BuilderReferences } from '../entities/index';
 import type { BuilderInstance } from '../instance';
-import type { BuilderPath } from '../paths';
-export declare function resolveOption(option: BuilderOptionValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderOptionValuesValidated | null;
-export declare function resolveOptions(option: BuilderOptionSerialised, refs?: BuilderRefEntities): ReadonlyArray<BuilderOptionValuesSerialised>;
-export declare function resolveComponent(component: BuilderComponentValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderComponentDetailsValidated | null;
-export declare function resolveComponents(component: BuilderComponentSerialised, refs?: BuilderRefEntities): ReadonlyArray<BuilderComponentDetailsSerialised>;
-export declare function resolveCollection(collection: BuilderCollectionValidated, model: BuilderModelValidated, instance: unknown, refs?: BuilderRefEntities): BuilderCollectionConfigValidated | null;
-export declare function resolveCollections(collection: BuilderCollectionSerialised, refs?: BuilderRefEntities): ReadonlyArray<BuilderCollectionConfigSerialised>;
-export declare function resolveRef(value: unknown, refs: BuilderRefEntities): unknown;
+export declare function resolveOption(option: BuilderOptionValidated, model: BuilderModelValidated, instance: unknown, references?: BuilderReferences): BuilderOptionConfigValidated | null;
+export declare function resolveOptions(option: BuilderOptionSerialised, references?: BuilderReferences): BuilderOptionConfigsSerialised;
+export declare function resolveComponent(component: BuilderComponentValidated, model: BuilderModelValidated, instance: unknown, references?: BuilderReferences): BuilderComponentConfigValidated | null;
+export declare function resolveComponents(component: BuilderComponentSerialised, references?: BuilderReferences): BuilderComponentConfigsSerialised;
+export declare function resolveCollection(collection: BuilderCollectionValidated, model: BuilderModelValidated, instance: unknown, references?: BuilderReferences): BuilderCollectionConfigValidated | null;
+export declare function resolveCollections(collection: BuilderCollectionSerialised, references?: BuilderReferences): BuilderCollectionConfigsSerialised;
+export declare function resolveReference(value: unknown, references: BuilderReferences): unknown;
 export type ResolvedPath = {
     readonly name: string;
-    readonly payload: BuilderOptionValuesValidated;
+    readonly payload: BuilderOptionConfigValidated;
     readonly value: unknown;
 };
-export declare function resolvePath(model: BuilderModelValidated, instance: unknown, path: BuilderPath, refs?: BuilderRefEntities): ResolvedPath | null;
-export declare function resolveItems(model: BuilderModelValidated, instance: unknown, pairs: ReadonlyArray<string | number>, refs?: BuilderRefEntities): readonly [BuilderModelValidated, BuilderInstance] | null;
+export declare function resolvePath(model: BuilderModelValidated, instance: unknown, path: BuilderPath, references?: BuilderReferences): ResolvedPath | null;
+export declare function resolveItems(model: BuilderModelValidated, instance: unknown, pairs: ReadonlyArray<string | number>, references?: BuilderReferences): readonly [BuilderModelValidated, BuilderInstance] | null;