@brixter/brix-builder 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davide Ruggeri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @brixter/brix-builder
+
+Visual page builder for Brixter: Svelte components, definitions, and editor UI consumed by the `brixter` dashboard.
+
+## Install
+
+Installed automatically with [`brixter`](../brixter). To use the builder on its own:
+
+```sh
+npm install @brixter/brix-builder
+```
+
+Peer dependency: Svelte 5.
+
+## Build
+
+Published tarballs ship compiled output from `dist/`:
+
+```sh
+npm run build
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/core.d.ts

@@ -0,0 +1,103 @@
+export type BuilderMode = 'component' | 'markdown';
+export type BuilderBindingType = 'image' | 'richtext' | 'text' | 'icon';
+export type BuilderFieldKind = 'text' | 'boolean' | 'number' | 'object' | 'array' | 'image' | 'icon' | 'richtext-inline' | 'richtext-block';
+export interface BuilderRichTextValue {
+    kind: 'richtext';
+    mode: 'inline' | 'block';
+    html: string;
+    json: Record<string, unknown> | null;
+}
+export interface BuilderField {
+    kind?: BuilderFieldKind;
+    label?: string;
+    description?: string;
+    default?: unknown;
+    fields?: BuilderFields;
+    item?: BuilderField;
+    itemLabel?: string;
+    summaryField?: string;
+    imageField?: string;
+    previewInMarkup?: boolean;
+    previewSelector?: string;
+    previewLabel?: string;
+}
+export type BuilderFields = Record<string, BuilderField>;
+export interface BuilderBlock {
+    id: string;
+    type: string;
+    props: Record<string, unknown>;
+}
+export interface BuilderDocument {
+    title: string;
+    description: string;
+    layout?: string;
+    metadata?: Record<string, unknown>;
+    blocks: BuilderBlock[];
+}
+export interface BrixYamlComponent {
+    type: string;
+    props?: Record<string, unknown>;
+}
+export interface BrixYamlDocument {
+    title?: string;
+    description?: string;
+    layout?: string;
+    components?: BrixYamlComponent[];
+    [key: string]: unknown;
+}
+export interface BuilderPreviewBinding {
+    type: BuilderBindingType;
+    selector: string;
+    path: string;
+    label?: string;
+    richTextMode?: BuilderRichTextValue['mode'];
+}
+export interface BuilderCollection {
+    path: string;
+    label: string;
+    itemLabel: string;
+    defaultItem: Record<string, unknown>;
+    summaryField?: string;
+    imageField?: string;
+    previewSelector?: string;
+}
+export interface BuilderDefinition {
+    type: string;
+    path: string;
+    description: string;
+    mode: BuilderMode;
+    defaults: Record<string, unknown>;
+    previewBindings: BuilderPreviewBinding[];
+    collections: BuilderCollection[];
+    fields: BuilderFields;
+}
+export declare function createRichTextValue(mode: BuilderRichTextValue['mode'], html?: string): BuilderRichTextValue;
+export declare function isRichTextValue(value: unknown): value is BuilderRichTextValue;
+export declare function inferBuilderFieldKind(field: BuilderField): BuilderFieldKind;
+export declare function createBuilderDefaultsFromFields(fields: BuilderFields): Record<string, unknown>;
+export declare function createBuilderFallbackProps(definition: Pick<BuilderDefinition, 'fields' | 'defaults'>, props?: Record<string, unknown>): Record<string, unknown>;
+export declare function createBuilderCollectionsFromFields(fields: BuilderFields, basePath?: string): BuilderCollection[];
+export declare function createBuilderPreviewBindingsFromFields(fields: BuilderFields, basePath?: string): BuilderPreviewBinding[];
+export declare function createInspectorFieldsFromFields(fields: BuilderFields): BuilderFields;
+export declare function normalizeBuilderPropsForRender(value: unknown): unknown;
+export declare function createBuilderDocument(definitions: BuilderDefinition[]): BuilderDocument;
+export declare function createBlock(type: string, definitions: BuilderDefinition[]): BuilderBlock;
+export declare function getDefinition(type: string, definitions: BuilderDefinition[]): BuilderDefinition;
+export declare function getPropsDraft(block: BuilderBlock): string;
+export declare function parsePropsDraft(value: string): Record<string, unknown>;
+export declare function updatePropsAtPath(props: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
+export declare function getValueAtPath(props: Record<string, unknown>, path: string): unknown;
+export declare function getCollectionItems(props: Record<string, unknown>, collection: BuilderCollection): Array<Record<string, unknown>>;
+export declare function addCollectionItem(props: Record<string, unknown>, collection: BuilderCollection): Record<string, unknown>;
+export declare function removeCollectionItem(props: Record<string, unknown>, collection: BuilderCollection, index: number): Record<string, unknown>;
+export declare function moveCollectionItem(props: Record<string, unknown>, collection: BuilderCollection, index: number, direction: -1 | 1): Record<string, unknown>;
+export declare function reorderCollectionItem(props: Record<string, unknown>, collection: BuilderCollection, fromIndex: number, toIndex: number): Record<string, unknown>;
+export declare function getCollectionItemSummary(item: Record<string, unknown>, collection: BuilderCollection, index: number): string;
+export declare function getCollectionItemImagePath(collection: BuilderCollection, index: number): string | null;
+export declare function serializeToMdsvex(document: BuilderDocument, definitions: BuilderDefinition[]): string;
+export declare function parseBrixYamlDocument(source: string, definitions: BuilderDefinition[]): BuilderDocument;
+export declare function serializeToBrixYaml(document: BuilderDocument, definitions: BuilderDefinition[]): string;
+export declare function getFallbackText(key: string): string;
+export declare function getFieldByRawPath(fields: BuilderFields, rawPath: string): BuilderField | null;
+export declare function getFieldByPath(fields: BuilderFields, path: string): BuilderField | null;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../core.ts"],"names":[],"mappings":"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"}