@bagelink/blox 1.10.40 → 1.10.42

package/dist/core.d.ts

@@ -1,10 +1,12 @@
 import { App } from 'vue';
 import { Router } from 'vue-router';
 import { StrategyOptions } from './localeStrategy';
-import { BlockDefinition } from './schema';
+import { BlockComponent, BlockDefinition } from './schema';
+/** Either a full `{ component, schema }` definition or a self-defining component (used `defineBlock()`). */
+export type BloxComponent = BlockDefinition | BlockComponent;
 export interface BloxOptions extends StrategyOptions {
-    /** Block definitions to register, keyed by block type. */
-    components?: Record<string, BlockDefinition>;
+    /** Block components or definitions to register. Self-defining components (those that called `defineBlock()`) are auto-discovered. */
+    components?: Record<string, BloxComponent>;
     /** Vue Router instance — adds the CMS catch-all and preview routes. */
     router?: Router;
     /** CMS website name (must match the `name` field on the Website record). */
@@ -18,7 +20,7 @@ export declare class BloxInstance {
     private _config;
     private _strategy;
     constructor(options?: BloxOptions);
-    registerComponents(components: Record<string, BlockDefinition>): this;
+    registerComponents(components: Record<string, BloxComponent>): this;
     registerRoutes(router: Router): this;
     install(app: App, options?: BloxOptions): void;
 }

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAS/C,MAAM,WAAW,WAAY,SAAQ,eAAe;IACnD,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC5C,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,CAAC,EAAE,WAAW;IAQjC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;IAKrE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CA+B9C;AAED,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAQ9D"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,KAAK,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAS/D,4GAA4G;AAC5G,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,cAAc,CAAA;AAE5D,MAAM,WAAW,WAAY,SAAQ,eAAe;IACnD,qIAAqI;IACrI,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC1C,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,CAAC,EAAE,WAAW;IAQjC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAqBnE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CA+B9C;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAQ9D"}

package/dist/defineBlock.d.ts

@@ -0,0 +1,27 @@
+import { SchemaDefinition } from '../../vue/src/index.ts';
+export interface BlockMeta {
+    /** Block type key — must be unique across the app. */
+    name: string;
+    /** Human-readable label shown in the editor block picker. */
+    label: string;
+    /** Material icon name. */
+    icon?: string;
+    /** FormFlow schema for editable props. */
+    schema: SchemaDefinition;
+    description?: string;
+}
+/**
+ * Declare the current component as a blox block.
+ * Call this inside `<script setup>` — it stamps the component definition
+ * so that `createBlox({ components })` can auto-discover it without
+ * needing a manual `{ component, schema }` wrapper.
+ *
+ * @example
+ * ```ts
+ * const schema = defineSchema<MyProps>({ ... })
+ * defineProps<MyProps>()
+ * defineBlock({ name: 'my-block', label: 'My Block', icon: 'star', schema })
+ * ```
+ */
+export declare function defineBlock(meta: BlockMeta): void;
+//# sourceMappingURL=defineBlock.d.ts.map

package/dist/defineBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineBlock.d.ts","sourceRoot":"","sources":["../src/defineBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrD,MAAM,WAAW,SAAS;IACzB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,MAAM,EAAE,gBAAgB,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAYjD"}

package/dist/index.cjs

@@ -304,7 +304,22 @@ class BloxInstance {
     this._strategy = createLocaleStrategy(options ?? {});
   }
   registerComponents(components) {
-    Object.assign(this._registry, components);
+    for (const [key, value] of Object.entries(components)) {
+      if (isBlockDefinition(value)) {
+        this._registry[key] = value;
+      } else {
+        const meta = value.__blox;
+        this._registry[meta.name ?? key] = {
+          component: value,
+          schema: {
+            label: meta.label,
+            description: meta.description,
+            icon: meta.icon,
+            fields: meta.schema
+          }
+        };
+      }
+    }
     return this;
   }
   registerRoutes(router) {
@@ -355,6 +370,9 @@ class BloxInstance {
     app.component("RouterLink", _sfc_main$1);
   }
 }
+function isBlockDefinition(value) {
+  return typeof value === "object" && "component" in value && "schema" in value;
+}
 function createBlox(options) {
   const instance = new BloxInstance(options);
   if ((options == null ? void 0 : options.websiteName) || (options == null ? void 0 : options.store)) {
@@ -364,6 +382,17 @@ function createBlox(options) {
   if (options == null ? void 0 : options.router) instance.registerRoutes(options.router);
   return instance;
 }
+function defineBlock(meta) {
+  const instance = vue.getCurrentInstance();
+  if (!instance) {
+    console.warn("[defineBlock] Must be called inside <script setup>");
+    return;
+  }
+  const type = instance.type;
+  if (!type.__blox) {
+    type.__blox = meta;
+  }
+}
 const PreviewRenderer = vue.defineComponent({
   name: "PreviewRenderer",
   props: {
@@ -515,6 +544,7 @@ exports.PreviewApp = _sfc_main;
 exports.PreviewRenderer = PreviewRenderer;
 exports.configureApi = configureApi;
 exports.createBlox = createBlox;
+exports.defineBlock = defineBlock;
 exports.listItems = listItems;
 exports.resolvePath = resolvePath;
 exports.sendToEditor = sendToEditor;

package/dist/index.d.ts

@@ -9,12 +9,14 @@ export type { Locale } from './composables/useLocale';
 export { useLocaleNav } from './composables/useLocaleNav';
 export { usePageContext } from './composables/usePageContext';
 export { BloxInstance, createBlox } from './core';
-export type { BloxOptions } from './core';
+export type { BloxComponent, BloxOptions } from './core';
+export { defineBlock } from './defineBlock';
+export type { BlockMeta } from './defineBlock';
 export type { LocaleStrategy } from './localeStrategy';
 export { default as PageRenderer } from './PageRenderer';
 export { default as PreviewApp } from './PreviewApp.vue';
 export { default as PreviewRenderer } from './PreviewRenderer';
-export type { BlockDefinition, BlockSchema } from './schema';
+export type { BlockComponent, BlockDefinition, BlockSchema } from './schema';
 export { BLOX_CONFIG_KEY, BLOX_LOCALE_STRATEGY_KEY } from './symbols';
 export type { BloxConfig } from './symbols';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKnD,YAAY,EACX,cAAc,EACd,KAAK,EAEL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,EACd,WAAW,GACX,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAI9E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK1D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAK7D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEzC,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAK9D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI5D,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAErE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKnD,YAAY,EACX,cAAc,EACd,KAAK,EAEL,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,cAAc,EACd,QAAQ,EACR,eAAe,EACf,cAAc,EACd,WAAW,GACX,MAAM,aAAa,CAAA;AAIpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAI9E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK1D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAK7D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACjD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAKxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAK9D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAI5E,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAErE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.mjs

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { computed, ref, defineComponent, inject, h, provide, watch, resolveComponent, createElementBlock, openBlock, createBlock, createElementVNode, createVNode, toDisplayString, unref, withCtx, createTextVNode, normalizeProps, guardReactiveProps, renderSlot, onMounted, onUnmounted, nextTick } from "vue";
+import { computed, ref, defineComponent, inject, h, provide, watch, resolveComponent, createElementBlock, openBlock, createBlock, createElementVNode, createVNode, toDisplayString, unref, withCtx, createTextVNode, normalizeProps, guardReactiveProps, renderSlot, getCurrentInstance, onMounted, onUnmounted, nextTick } from "vue";
 import { useRoute, useRouter, RouterLink } from "vue-router";
 import { getI18n } from "@bagelink/vue";
 const BASE = "/api";
@@ -302,7 +302,22 @@ class BloxInstance {
     this._strategy = createLocaleStrategy(options ?? {});
   }
   registerComponents(components) {
-    Object.assign(this._registry, components);
+    for (const [key, value] of Object.entries(components)) {
+      if (isBlockDefinition(value)) {
+        this._registry[key] = value;
+      } else {
+        const meta = value.__blox;
+        this._registry[meta.name ?? key] = {
+          component: value,
+          schema: {
+            label: meta.label,
+            description: meta.description,
+            icon: meta.icon,
+            fields: meta.schema
+          }
+        };
+      }
+    }
     return this;
   }
   registerRoutes(router) {
@@ -353,6 +368,9 @@ class BloxInstance {
     app.component("RouterLink", _sfc_main$1);
   }
 }
+function isBlockDefinition(value) {
+  return typeof value === "object" && "component" in value && "schema" in value;
+}
 function createBlox(options) {
   const instance = new BloxInstance(options);
   if ((options == null ? void 0 : options.websiteName) || (options == null ? void 0 : options.store)) {
@@ -362,6 +380,17 @@ function createBlox(options) {
   if (options == null ? void 0 : options.router) instance.registerRoutes(options.router);
   return instance;
 }
+function defineBlock(meta) {
+  const instance = getCurrentInstance();
+  if (!instance) {
+    console.warn("[defineBlock] Must be called inside <script setup>");
+    return;
+  }
+  const type = instance.type;
+  if (!type.__blox) {
+    type.__blox = meta;
+  }
+}
 const PreviewRenderer = defineComponent({
   name: "PreviewRenderer",
   props: {
@@ -514,6 +543,7 @@ export {
   PreviewRenderer,
   configureApi,
   createBlox,
+  defineBlock,
   listItems,
   resolvePath,
   sendToEditor,

package/dist/schema.d.ts

@@ -1,5 +1,6 @@
 import { SchemaDefinition } from '../../vue/src/index.ts';
 import { Component } from 'vue';
+import { BlockMeta } from './defineBlock';
 export interface BlockSchema {
     /** Human-readable name shown in the editor. */
     label: string;
@@ -16,4 +17,8 @@ export interface BlockDefinition {
     component: Component;
     schema: BlockSchema;
 }
+/** A Vue component that has called `defineBlock()` in its `<script setup>`. */
+export type BlockComponent = Component & {
+    __blox: BlockMeta;
+};
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;CACnB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,WAAW;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;CACnB;AAED,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/blox",
   "type": "module",
-  "version": "1.10.40",
+  "version": "1.10.42",
   "description": "Blox page builder library for drag-and-drop page building and static data management",
   "author": {
     "name": "Bagel Studio",