@builder-builder/builder 0.0.7 → 0.0.9

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

@@ -0,0 +1,431 @@
+import type { Refable, RefableSerialised } from '../../references';
+import type { BuilderUIDescribe, BuilderUIDescribeSerialised } from './describe';
+import type { BuilderUILabel, BuilderUILabelSerialised } from './label';
+import type { BuilderUIPage, BuilderUIPageSerialised } from './page';
+import * as v from 'valibot';
+export type BuilderUIItem = Refable<BuilderUIPage | BuilderUIDescribe | BuilderUIPages>;
+export type BuilderUIItems = ReadonlyArray<BuilderUIItem>;
+export declare class BuilderUIPages<const Name extends string = string, const Label extends Refable<BuilderUILabel> = Refable<BuilderUILabel>, const Items extends Refable<BuilderUIItems> = Refable<BuilderUIItems>> {
+    readonly type: "pages";
+    readonly name: Name;
+    readonly label: Label;
+    readonly items: Items;
+    constructor(name: Name, label: Label, items: Items);
+}
+export declare const BuilderUIPagesSchema: v.InstanceSchema<typeof BuilderUIPages, undefined>;
+export type BuilderUIPagesSerialised = {
+    readonly type: 'pages';
+    readonly name: string;
+    readonly label: RefableSerialised<BuilderUILabelSerialised>;
+    readonly items: RefableSerialised<BuilderUIItemsSerialised>;
+};
+export type BuilderUIItemSerialised = RefableSerialised<BuilderUIPageSerialised | BuilderUIDescribeSerialised | BuilderUIPagesSerialised>;
+export type BuilderUIItemsSerialised = ReadonlyArray<BuilderUIItemSerialised>;
+export declare const BuilderUIPagesSerialisedSchema: v.GenericSchema<BuilderUIPagesSerialised>;
+export declare const BuilderUIItemsSerialisedSchema: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"ref", undefined>;
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+}, undefined>, v.ReadonlyAction<{
+    type: "ref";
+    id: string;
+    name: string;
+}>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"page", undefined>;
+    readonly label: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ref", undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly label: v.StringSchema<undefined>;
+    }, undefined>, v.MetadataAction<{
+        label: string;
+    }, {
+        readonly serialisable: typeof BuilderUILabel;
+        readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+    }>, v.ReadonlyAction<{
+        label: string;
+    }>]>], undefined>, v.MetadataAction<import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>, {
+        readonly refable: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+        }, undefined>, v.MetadataAction<{
+            label: string;
+        }, {
+            readonly serialisable: typeof BuilderUILabel;
+            readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+        }>, v.ReadonlyAction<{
+            label: string;
+        }>]>;
+    }>]>;
+    readonly paths: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ref", undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>], undefined>, v.MetadataAction<readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>, {
+        readonly refable: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>;
+    }>]>;
+}, undefined>, v.MetadataAction<{
+    type: "page";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}, {
+    readonly serialisable: typeof BuilderUIPage;
+    readonly instance: v.InstanceSchema<typeof BuilderUIPage, undefined>;
+}>, v.ReadonlyAction<{
+    type: "page";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"describe", undefined>;
+    readonly label: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ref", undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly label: v.StringSchema<undefined>;
+    }, undefined>, v.MetadataAction<{
+        label: string;
+    }, {
+        readonly serialisable: typeof BuilderUILabel;
+        readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+    }>, v.ReadonlyAction<{
+        label: string;
+    }>]>], undefined>, v.MetadataAction<import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>, {
+        readonly refable: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+        }, undefined>, v.MetadataAction<{
+            label: string;
+        }, {
+            readonly serialisable: typeof BuilderUILabel;
+            readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+        }>, v.ReadonlyAction<{
+            label: string;
+        }>]>;
+    }>]>;
+    readonly paths: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ref", undefined>;
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+    }, undefined>, v.ReadonlyAction<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>], undefined>, v.MetadataAction<readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>, {
+        readonly refable: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>;
+    }>]>;
+}, undefined>, v.MetadataAction<{
+    type: "describe";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}, {
+    readonly serialisable: typeof BuilderUIDescribe;
+    readonly instance: v.InstanceSchema<typeof BuilderUIDescribe, undefined>;
+}>, v.ReadonlyAction<{
+    type: "describe";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}>]>, v.GenericSchema<BuilderUIPagesSerialised>], undefined>], undefined>, v.MetadataAction<import("../..").BuilderRef | Readonly<{
+    type: "ref";
+    id: string;
+    name: string;
+}> | Readonly<{
+    type: "describe";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}> | Readonly<{
+    type: "page";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}> | BuilderUIPagesSerialised, {
+    readonly refable: v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"page", undefined>;
+        readonly label: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+        }, undefined>, v.MetadataAction<{
+            label: string;
+        }, {
+            readonly serialisable: typeof BuilderUILabel;
+            readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+        }>, v.ReadonlyAction<{
+            label: string;
+        }>]>], undefined>, v.MetadataAction<import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>, {
+            readonly refable: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                readonly label: v.StringSchema<undefined>;
+            }, undefined>, v.MetadataAction<{
+                label: string;
+            }, {
+                readonly serialisable: typeof BuilderUILabel;
+                readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+            }>, v.ReadonlyAction<{
+                label: string;
+            }>]>;
+        }>]>;
+        readonly paths: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>], undefined>, v.MetadataAction<readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>, {
+            readonly refable: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>;
+        }>]>;
+    }, undefined>, v.MetadataAction<{
+        type: "page";
+        label: import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>;
+        paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>;
+    }, {
+        readonly serialisable: typeof BuilderUIPage;
+        readonly instance: v.InstanceSchema<typeof BuilderUIPage, undefined>;
+    }>, v.ReadonlyAction<{
+        type: "page";
+        label: import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>;
+        paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>;
+    }>]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"describe", undefined>;
+        readonly label: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly label: v.StringSchema<undefined>;
+        }, undefined>, v.MetadataAction<{
+            label: string;
+        }, {
+            readonly serialisable: typeof BuilderUILabel;
+            readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+        }>, v.ReadonlyAction<{
+            label: string;
+        }>]>], undefined>, v.MetadataAction<import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>, {
+            readonly refable: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                readonly label: v.StringSchema<undefined>;
+            }, undefined>, v.MetadataAction<{
+                label: string;
+            }, {
+                readonly serialisable: typeof BuilderUILabel;
+                readonly instance: v.InstanceSchema<typeof BuilderUILabel, undefined>;
+            }>, v.ReadonlyAction<{
+                label: string;
+            }>]>;
+        }>]>;
+        readonly paths: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"ref", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+        }, undefined>, v.ReadonlyAction<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>]>, v.InstanceSchema<typeof import("../..").BuilderRef, undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>], undefined>, v.MetadataAction<readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>, {
+            readonly refable: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, v.ReadonlyAction<(string | number)[]>]>, undefined>, v.ReadonlyAction<(readonly (string | number)[])[]>]>;
+        }>]>;
+    }, undefined>, v.MetadataAction<{
+        type: "describe";
+        label: import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>;
+        paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>;
+    }, {
+        readonly serialisable: typeof BuilderUIDescribe;
+        readonly instance: v.InstanceSchema<typeof BuilderUIDescribe, undefined>;
+    }>, v.ReadonlyAction<{
+        type: "describe";
+        label: import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }> | Readonly<{
+            label: string;
+        }>;
+        paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+            type: "ref";
+            id: string;
+            name: string;
+        }>;
+    }>]>, v.GenericSchema<BuilderUIPagesSerialised>], undefined>;
+}>]>, undefined>, v.ReadonlyAction<(import("../..").BuilderRef | Readonly<{
+    type: "ref";
+    id: string;
+    name: string;
+}> | Readonly<{
+    type: "describe";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}> | Readonly<{
+    type: "page";
+    label: import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }> | Readonly<{
+        label: string;
+    }>;
+    paths: readonly (readonly (string | number)[])[] | import("../..").BuilderRef | Readonly<{
+        type: "ref";
+        id: string;
+        name: string;
+    }>;
+}> | BuilderUIPagesSerialised)[]>]>;

package/dist/entities/ui/pages.js

@@ -0,0 +1,29 @@
+import * as v from 'valibot';
+import { refable } from '../../references.js';
+import { serialisable } from '../../serialisable.js';
+import { BuilderUIDescribeSerialisedSchema } from './describe.js';
+import { BuilderUILabelSerialisedSchema } from './label.js';
+import { BuilderUIPageSerialisedSchema } from './page.js';
+export class BuilderUIPages {
+    type = 'pages';
+    name;
+    label;
+    items;
+    constructor(name, label, items) {
+        this.name = name;
+        this.label = label;
+        this.items = items;
+    }
+}
+export const BuilderUIPagesSchema = v.instance(BuilderUIPages);
+export const BuilderUIPagesSerialisedSchema = serialisable(BuilderUIPages, v.object({
+    type: v.literal('pages'),
+    name: v.string(),
+    label: refable(BuilderUILabelSerialisedSchema),
+    items: refable(v.lazy(() => BuilderUIItemsSerialisedSchema))
+}));
+export const BuilderUIItemsSerialisedSchema = v.pipe(v.array(refable(v.union([
+    BuilderUIPageSerialisedSchema,
+    BuilderUIDescribeSerialisedSchema,
+    BuilderUIPagesSerialisedSchema
+]))), v.readonly());

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

@@ -0,0 +1,7 @@
+import type { Refable } from '../../references';
+import type { BuilderGeneric } from '../builder/index';
+import type { BuilderUIItems } from './pages';
+import type { BuilderUIGeneric } from './ui';
+import { BuilderUI } from './ui.js';
+export type BuilderUIBindings = Record<string, string | BuilderUIGeneric | BuilderUIItems | unknown>;
+export declare function bindUI<BuilderType extends Refable<BuilderGeneric>>(ui: BuilderUI<BuilderType>, bindings: BuilderUIBindings): BuilderUI<BuilderType>;

package/dist/entities/ui/parameter.js

@@ -0,0 +1,29 @@
+import * as v from 'valibot';
+import { createWalkerBinding } from '../../walker/index.js';
+import { BuilderUILabel } from './label.js';
+import { BuilderUIItemsSerialisedSchema } from './pages.js';
+import { BuilderUI, BuilderUISchema } from './ui.js';
+import { mergeUIParts } from './uis.js';
+export function bindUI(ui, bindings) {
+    const merged = mergeUIParts(Object.values(bindings));
+    const walk = createWalkerBinding({
+        lookupBinding: (ref) => {
+            const binding = bindings[ref.name];
+            if (binding == null) {
+                return null;
+            }
+            if (typeof binding === 'string') {
+                return new BuilderUILabel(binding);
+            }
+            if (v.is(BuilderUISchema, binding)) {
+                return [...binding.items];
+            }
+            return binding;
+        }
+    });
+    const boundItems = walk(BuilderUIItemsSerialisedSchema, ui.items);
+    return new BuilderUI(ui.builder, [...ui.references, ...merged.references], boundItems, [
+        ...ui.expectations,
+        ...merged.expectations
+    ]);
+}