@bagelink/blox 1.12.22 → 1.12.23

package/dist/core-_fnHoEZN.cjs

@@ -0,0 +1,459 @@
+"use strict";
+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);
+const ssg_client = require("./ssg/client.cjs");
+const vue = require("vue");
+const vueRouter = require("vue-router");
+const vue$1 = require("@bagelink/vue");
+const BASE = "/api";
+let _websiteName = "";
+let _store = "";
+let _websiteId = null;
+function configureApi(websiteName, store) {
+  _websiteName = websiteName;
+  _store = store;
+  _websiteId = null;
+}
+async function request(path, { locale: locale2, params, ...opts } = {}) {
+  const url = new URL(`${BASE}${path}`, window.location.origin);
+  if (locale2) url.searchParams.set("locale", locale2);
+  if (params) {
+    for (const [k, v] of Object.entries(params)) url.searchParams.set(k, String(v));
+  }
+  const res = await fetch(url.toString(), opts);
+  if (!res.ok) throw new Error(`API ${res.status}: ${path}`);
+  if (res.status === 204) return null;
+  return res.json();
+}
+async function getWebsiteId() {
+  if (_websiteId) return _websiteId;
+  if (typeof window !== "undefined") {
+    const embedded = window[ssg_client.BLOX_WEBSITE_ID_WINDOW_KEY];
+    if (typeof embedded === "string" && embedded !== "") {
+      _websiteId = embedded;
+      return _websiteId;
+    }
+  }
+  const websites = await request("/cms/websites");
+  const website = websites.find((w) => w.name === _websiteName);
+  if (!website) throw new Error(`Website "${_websiteName}" not found. Run: npm run seed`);
+  _websiteId = website.id;
+  return _websiteId;
+}
+async function resolvePath(path, locale2) {
+  const websiteId = await getWebsiteId();
+  return request(`/cms/websites/${websiteId}/resolve-path`, {
+    locale: locale2,
+    params: { path }
+  });
+}
+async function listItems(collection, { locale: locale2, q, offset = 0, limit = 100 } = {}) {
+  return request(`/datastore/${_store}/collections/${collection}`, {
+    locale: locale2,
+    params: { ...q ? { q } : {}, offset, limit }
+  });
+}
+const locale = vue.ref(localStorage.getItem("blox:locale") || "en");
+const currentAlternates = vue.ref({});
+function useLocale() {
+  const dir = vue.computed(() => locale.value === "he" || locale.value === "ar" ? "rtl" : "ltr");
+  function setLocale(l) {
+    locale.value = l;
+    localStorage.setItem("blox:locale", l);
+    document.documentElement.lang = l;
+    document.documentElement.dir = dir.value;
+    try {
+      const i18n = vue$1.getI18n();
+      if (i18n == null ? void 0 : i18n.global) i18n.global.locale.value = l;
+    } catch {
+    }
+  }
+  function setAlternates(alternates) {
+    currentAlternates.value = alternates;
+  }
+  return { locale, dir, setLocale, currentAlternates, setAlternates };
+}
+const BLOX_REGISTRY_KEY = Symbol("blox:registry");
+const BLOX_CONFIG_KEY = Symbol("blox:config");
+const BLOX_LOCALE_STRATEGY_KEY = Symbol("blox:locale-strategy");
+const PageRenderer = vue.defineComponent({
+  name: "PageRenderer",
+  props: {
+    blocks: {
+      type: Array,
+      default: () => []
+    }
+  },
+  setup(props) {
+    const registry = vue.inject(BLOX_REGISTRY_KEY, {});
+    return () => vue.h(
+      "div",
+      props.blocks.flatMap((block, i) => {
+        const definition = registry[block.type];
+        if (!definition) return [];
+        const props2 = { ...definition.schema.defaults, ...block.props };
+        return [vue.h(definition.component, { key: i, ...props2 })];
+      })
+    );
+  }
+});
+const _hoisted_1 = {
+  key: 0,
+  class: "blox-loading"
+};
+const _hoisted_2 = {
+  key: 1,
+  class: "blox-not-found"
+};
+const _hoisted_3 = {
+  key: 2,
+  class: "blox-error color-red"
+};
+const _hoisted_4 = {
+  key: 0,
+  class: "blox-nav-progress"
+};
+const _sfc_main$1 = /* @__PURE__ */ vue.defineComponent({
+  __name: "CmsPageView",
+  setup(__props) {
+    const route = vueRouter.useRoute();
+    const router = vueRouter.useRouter();
+    const { locale: locale2, setLocale, setAlternates } = useLocale();
+    const strategy = vue.inject(BLOX_LOCALE_STRATEGY_KEY, null);
+    const blocks = vue.ref([]);
+    const contexts = vue.ref({});
+    vue.provide("contexts", contexts);
+    const notFound = vue.ref(false);
+    const error = vue.ref(null);
+    const initialLoading = vue.ref(true);
+    const navigating = vue.ref(false);
+    function tryHydrateFromState(path) {
+      var _a, _b;
+      const win = typeof window !== "undefined" ? window : typeof globalThis !== "undefined" ? globalThis : void 0;
+      if (!win) return false;
+      const state = win[ssg_client.BLOX_STATE_WINDOW_KEY];
+      if (!state || typeof state !== "object") return false;
+      const entry = state[path];
+      if (!entry) return false;
+      blocks.value = ((_b = (_a = entry.page) == null ? void 0 : _a.content) == null ? void 0 : _b.blocks) ?? [];
+      contexts.value = entry.contexts ?? {};
+      setAlternates(entry.alternates ?? {});
+      return true;
+    }
+    function updateDocumentTitle(resolved) {
+      if (typeof document === "undefined") return;
+      const { page } = resolved;
+      const ctx = resolved.contexts ? Object.values(resolved.contexts).find((c) => c != null) : null;
+      const ctxTitle = ctx && typeof ctx.title === "string" ? ctx.title : null;
+      const title = page.meta_title || ctxTitle || page.title;
+      if (title) document.title = title;
+    }
+    const initialSlug = (() => {
+      var _a;
+      if (strategy) {
+        const hostname = typeof window !== "undefined" ? ((_a = window.location) == null ? void 0 : _a.hostname) ?? "" : "";
+        return strategy.detect(hostname, route.path).slug;
+      }
+      return route.path || "/";
+    })();
+    const ssrHydrated = tryHydrateFromState(initialSlug);
+    if (ssrHydrated) initialLoading.value = false;
+    async function load() {
+      var _a;
+      notFound.value = false;
+      error.value = null;
+      const { locale: urlLocale, slug } = strategy ? strategy.detect(typeof window !== "undefined" ? window.location.hostname : "", route.path) : { locale: locale2.value, slug: route.path || "/" };
+      if (urlLocale !== locale2.value) setLocale(urlLocale);
+      if (tryHydrateFromState(slug)) {
+        initialLoading.value = false;
+        return;
+      }
+      navigating.value = true;
+      try {
+        const resolved = await resolvePath(slug, urlLocale);
+        blocks.value = ((_a = resolved.page.content) == null ? void 0 : _a.blocks) ?? [];
+        contexts.value = resolved.contexts ?? {};
+        setAlternates(resolved.alternates ?? {});
+        updateDocumentTitle(resolved);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes("404")) {
+          const home = strategy ? strategy.toPath("/") : "/";
+          router.replace(home);
+        } else {
+          error.value = msg;
+        }
+      } finally {
+        initialLoading.value = false;
+        navigating.value = false;
+      }
+    }
+    if (!ssrHydrated) {
+      load();
+    }
+    vue.watch(() => route.path, load);
+    return (_ctx, _cache) => {
+      const _component_RouterLink = vue.resolveComponent("RouterLink");
+      return vue.openBlock(), vue.createElementBlock("div", null, [
+        initialLoading.value && blocks.value.length === 0 ? (vue.openBlock(), vue.createElementBlock("div", _hoisted_1, " Loading… ")) : notFound.value ? (vue.openBlock(), vue.createElementBlock("div", _hoisted_2, [
+          _cache[0] || (_cache[0] = vue.createElementVNode("h2", null, "404", -1)),
+          vue.createElementVNode("p", null, vue.toDisplayString(vue.unref(locale2) === "he" ? "הדף לא נמצא" : "Page not found"), 1),
+          vue.createVNode(_component_RouterLink, { to: "/" }, {
+            default: vue.withCtx(() => [
+              vue.createTextVNode(vue.toDisplayString(vue.unref(locale2) === "he" ? "חזרה הביתה" : "Go home"), 1)
+            ]),
+            _: 1
+          })
+        ])) : error.value ? (vue.openBlock(), vue.createElementBlock("div", _hoisted_3, vue.toDisplayString(error.value), 1)) : (vue.openBlock(), vue.createElementBlock(vue.Fragment, { key: 3 }, [
+          navigating.value ? (vue.openBlock(), vue.createElementBlock("div", _hoisted_4)) : vue.createCommentVNode("", true),
+          vue.createVNode(vue.unref(PageRenderer), { blocks: blocks.value }, null, 8, ["blocks"])
+        ], 64))
+      ]);
+    };
+  }
+});
+const _sfc_main = /* @__PURE__ */ vue.defineComponent({
+  __name: "LocaleRouterLink",
+  props: {
+    to: {},
+    replace: { type: Boolean },
+    activeClass: {},
+    exactActiveClass: {},
+    ariaCurrentValue: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const strategy = vue.inject(BLOX_LOCALE_STRATEGY_KEY, null);
+    const localizedTo = vue.computed(() => {
+      if (!strategy || typeof props.to !== "string") return props.to;
+      return strategy.toPath(props.to);
+    });
+    return (_ctx, _cache) => {
+      return vue.openBlock(), vue.createBlock(vue.unref(vueRouter.RouterLink), vue.normalizeProps(vue.guardReactiveProps({ ...props, to: localizedTo.value })), {
+        default: vue.withCtx(() => [
+          vue.renderSlot(_ctx.$slots, "default")
+        ]),
+        _: 3
+      }, 16);
+    };
+  }
+});
+function createPathStrategy(options) {
+  const { defaultLocale, supportedLocales } = options;
+  let _currentLocale = defaultLocale;
+  return {
+    get locales() {
+      return supportedLocales;
+    },
+    get currentLocale() {
+      return _currentLocale;
+    },
+    detect(_hostname, path) {
+      const segments = path.replace(/^\//, "").split("/");
+      const first = segments[0];
+      if (supportedLocales.includes(first)) {
+        _currentLocale = first;
+        return {
+          locale: first,
+          slug: `/${segments.slice(1).join("/")}` || "/"
+        };
+      }
+      _currentLocale = defaultLocale;
+      return { locale: defaultLocale, slug: path || "/" };
+    },
+    toPath(slug) {
+      if (_currentLocale === defaultLocale) return slug || "/";
+      const s = slug || "/";
+      return s === "/" ? `/${_currentLocale}` : `/${_currentLocale}${s}`;
+    },
+    switchTo(locale2, slug, router) {
+      const s = slug || "/";
+      const target = locale2 === defaultLocale ? s : s === "/" ? `/${locale2}` : `/${locale2}${s}`;
+      router.push(target);
+    }
+  };
+}
+function createDomainStrategy(options) {
+  const { localeDomains } = options;
+  const locales = Object.keys(localeDomains);
+  const _currentLocale = locales.find((l) => localeDomains[l] === window.location.hostname) ?? locales[0] ?? "en";
+  return {
+    get locales() {
+      return locales;
+    },
+    get currentLocale() {
+      return _currentLocale;
+    },
+    detect(_hostname, path) {
+      return { locale: _currentLocale, slug: path || "/" };
+    },
+    toPath(slug) {
+      return slug || "/";
+    },
+    switchTo(locale2, slug, _router) {
+      const domain = localeDomains[locale2];
+      if (!domain) return;
+      if (locale2 === _currentLocale) {
+        _router.push(slug || "/");
+        return;
+      }
+      const { protocol } = window.location;
+      const s = slug || "/";
+      window.location.href = `${protocol}//${domain}${s}`;
+    }
+  };
+}
+function createLocaleStrategy(options) {
+  if (options.localeStrategy === "domain" && options.localeDomains) {
+    return createDomainStrategy({ localeDomains: options.localeDomains });
+  }
+  return createPathStrategy({
+    defaultLocale: options.defaultLocale ?? "en",
+    supportedLocales: options.supportedLocales ?? []
+  });
+}
+function applyDefaultsToFields(schema, defaults) {
+  var _a;
+  if (!schema || !defaults) return;
+  for (const [key, value] of Object.entries(defaults)) {
+    const field = (_a = schema._fields) == null ? void 0 : _a[key];
+    if (field && field._config.default === void 0) {
+      field._config.default = value;
+    }
+  }
+}
+class BloxInstance {
+  constructor(options) {
+    __publicField(this, "_registry", {});
+    __publicField(this, "_routeRegistered", false);
+    __publicField(this, "_config");
+    __publicField(this, "_strategy");
+    this._config = {
+      defaultLocale: (options == null ? void 0 : options.defaultLocale) ?? "en",
+      supportedLocales: (options == null ? void 0 : options.supportedLocales) ?? []
+    };
+    this._strategy = createLocaleStrategy(options ?? {});
+  }
+  registerModules(modules) {
+    const list = Array.isArray(modules) ? modules : Object.values(modules);
+    for (const mod of list) {
+      if (!(mod == null ? void 0 : mod.default)) continue;
+      for (const [key, value] of Object.entries(mod)) {
+        if (key === "default") continue;
+        if (value && typeof value === "object" && "label" in value) {
+          const meta = value;
+          applyDefaultsToFields(meta.schema, meta.defaults);
+          this._registry[meta.name ?? key] = {
+            component: mod.default,
+            schema: {
+              label: meta.label,
+              description: meta.description,
+              icon: meta.icon,
+              fields: meta.schema,
+              defaults: meta.defaults,
+              dataSource: meta.dataSource
+            }
+          };
+          break;
+        }
+      }
+    }
+    return this;
+  }
+  registerComponents(components) {
+    for (const [key, value] of Object.entries(components)) {
+      if (!value || typeof value !== "object" && typeof value !== "function") continue;
+      if (isBlockDefinition(value)) {
+        this._registry[key] = value;
+      } else if (value.__blox) {
+        const meta = value.__blox;
+        applyDefaultsToFields(meta.schema, meta.defaults);
+        this._registry[meta.name ?? key] = {
+          component: value,
+          schema: {
+            label: meta.label,
+            description: meta.description,
+            icon: meta.icon,
+            fields: meta.schema,
+            defaults: meta.defaults,
+            dataSource: meta.dataSource
+          }
+        };
+      }
+    }
+    return this;
+  }
+  registerRoutes(router) {
+    if (this._routeRegistered) return this;
+    if (this._config.supportedLocales.length > 0) {
+      const { defaultLocale } = this._config;
+      router.beforeEach((to) => {
+        const segments = to.path.replace(/^\//, "").split("/");
+        if (segments[0] === defaultLocale) {
+          const rest = segments.slice(1).join("/");
+          return { path: `/${rest}`, replace: true };
+        }
+      });
+    }
+    router.addRoute({
+      path: "/_blox_preview",
+      component: () => Promise.resolve().then(() => require("./PreviewApp-C2T03Jm9.cjs")),
+      beforeEnter: () => window.parent !== window ? true : "/"
+    });
+    router.addRoute({ path: "/:pathMatch(.*)*", component: _sfc_main$1 });
+    this._routeRegistered = true;
+    return this;
+  }
+  install(app, options) {
+    if (options) {
+      this._config = {
+        defaultLocale: options.defaultLocale ?? this._config.defaultLocale,
+        supportedLocales: options.supportedLocales ?? this._config.supportedLocales
+      };
+      this._strategy = createLocaleStrategy({
+        ...options,
+        defaultLocale: this._config.defaultLocale,
+        supportedLocales: this._config.supportedLocales
+      });
+    }
+    if (options == null ? void 0 : options.modules) this.registerModules(options.modules);
+    if (options == null ? void 0 : options.components) this.registerComponents(options.components);
+    if (options == null ? void 0 : options.router) this.registerRoutes(options.router);
+    if ((options == null ? void 0 : options.websiteName) || (options == null ? void 0 : options.store)) {
+      configureApi(options.websiteName ?? "", options.store ?? "");
+    }
+    if (options == null ? void 0 : options.defaultLocale) {
+      const { setLocale } = useLocale();
+      if (!localStorage.getItem("blox:locale")) setLocale(options.defaultLocale);
+    }
+    app.provide(BLOX_REGISTRY_KEY, this._registry);
+    app.provide(BLOX_CONFIG_KEY, this._config);
+    app.provide(BLOX_LOCALE_STRATEGY_KEY, this._strategy);
+    app.component("RouterLink", _sfc_main);
+  }
+}
+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)) {
+    configureApi(options.websiteName ?? "", options.store ?? "");
+  }
+  if (options == null ? void 0 : options.modules) instance.registerModules(options.modules);
+  if (options == null ? void 0 : options.components) instance.registerComponents(options.components);
+  if (options == null ? void 0 : options.router) instance.registerRoutes(options.router);
+  return instance;
+}
+exports.BLOX_CONFIG_KEY = BLOX_CONFIG_KEY;
+exports.BLOX_LOCALE_STRATEGY_KEY = BLOX_LOCALE_STRATEGY_KEY;
+exports.BLOX_REGISTRY_KEY = BLOX_REGISTRY_KEY;
+exports.BloxInstance = BloxInstance;
+exports.PageRenderer = PageRenderer;
+exports._sfc_main = _sfc_main$1;
+exports.configureApi = configureApi;
+exports.createBlox = createBlox;
+exports.listItems = listItems;
+exports.resolvePath = resolvePath;
+exports.useLocale = useLocale;

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,EAAa,MAAM,KAAK,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAoB/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;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACrD,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,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IA2B3E,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAwBnE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CAgC9C;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAS9D"}
+{"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,EAAa,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAoB/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;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACrD,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,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IA4B3E,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IAyBnE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CAgC9C;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAS9D"}

package/dist/createBloxApp.d.ts

@@ -0,0 +1,107 @@
+import { App, Component, Plugin } from 'vue';
+import { Router } from 'vue-router';
+import { BloxInstance } from './core';
+import { BlockModule } from './defineBlock';
+export interface CreateBloxAppOptions {
+    /** Root Vue component (App.vue). */
+    rootComponent: Component;
+    /** Vue Router instance. */
+    router: Router;
+    /**
+     * Block SFC modules. Accepts:
+     * - `import.meta.glob('./components/blocks/*.vue', { eager: true })` result (recommended)
+     * - An array of `import * as X from './X.vue'` modules
+     * - A barrel `import * as blox from './blox'` object
+     */
+    modules: BlockModule[] | Record<string, BlockModule>;
+    /** CMS website name (must match the `name` field on the Website record). */
+    websiteName: string;
+    /** Datastore store identifier. */
+    store: string;
+    /** Default locale code. @default 'en' */
+    locale?: string;
+    /** All supported locale codes. @default ['en'] */
+    supportedLocales?: string[];
+    /** API base URL. @default '/api' */
+    apiBaseURL?: string;
+    /** Mount target — CSS selector or Element. @default '#app' */
+    mount?: string | Element;
+    /**
+     * Callback to create the shared API instance.
+     * Receives `{ baseURL }` and should call your project's `createApi()`
+     * and return `{ axios }` for collection cache interceptor installation.
+     *
+     * If omitted, no project-level API is configured (the Blox internal
+     * fetch-based API still works via `configureApi`).
+     */
+    createApi?: (opts: {
+        baseURL: string;
+    }) => {
+        axios?: AxiosLike;
+    };
+    /**
+     * Vue plugins to install on the app.
+     * Typically `[BagelVue, ModalPlugin]` from `@bagelink/vue`.
+     */
+    plugins?: Array<Plugin | [Plugin, ...unknown[]]>;
+    /**
+     * Global components to register.
+     * Typically `{ RouterWrapper }` from `@bagelink/vue`.
+     */
+    globalComponents?: Record<string, Component>;
+    /**
+     * Extra setup to run after the app is created but before mount.
+     * Receives the Vue app instance.
+     */
+    setup?: (app: App) => void;
+}
+/** Minimal axios shape for interceptor installation. */
+interface AxiosLike {
+    interceptors: {
+        request: {
+            use: (fn: (config: any) => any) => void;
+        };
+    };
+}
+export interface BloxAppResult {
+    app: App;
+    router: Router;
+    blox: BloxInstance;
+}
+/**
+ * One-liner factory to create and mount a Blox marketing/preview site.
+ *
+ * Handles the full ceremony:
+ * 1. Install SSG state cache (fetch interceptor for `__BLOX_STATE__`)
+ * 2. Configure project API + install collection cache (axios interceptor)
+ * 3. Create Vue app, Pinia, Blox, plugins
+ * 4. Mount after router is ready
+ *
+ * @example
+ * ```ts
+ * import { createBloxApp } from '@bagelink/blox'
+ * import { BagelVue, ModalPlugin, RouterWrapper } from '@bagelink/vue'
+ * import App from './App.vue'
+ * import router from './router'
+ * import { createApi, axios } from '@shared/api'
+ *
+ * import '@bagelink/vue/dist/style.css'
+ * import '@bagelink/blox/dist/style.css'
+ *
+ * const blocks = import.meta.glob('./components/blocks/*.vue', { eager: true })
+ *
+ * createBloxApp({
+ *   rootComponent: App,
+ *   router,
+ *   modules: Object.values(blocks),
+ *   websiteName: 'cylogic',
+ *   store: 'cylogic',
+ *   createApi: ({ baseURL }) => { createApi({ baseURL }); return { axios } },
+ *   plugins: [ModalPlugin, BagelVue],
+ *   globalComponents: { RouterWrapper },
+ * })
+ * ```
+ */
+export declare function createBloxApp(options: CreateBloxAppOptions): BloxAppResult;
+export {};
+//# sourceMappingURL=createBloxApp.d.ts.map

package/dist/createBloxApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBloxApp.d.ts","sourceRoot":"","sources":["../src/createBloxApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAOhD,MAAM,WAAW,oBAAoB;IACpC,oCAAoC;IACpC,aAAa,EAAE,SAAS,CAAA;IACxB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpD,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAA;IAChE;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAA;IAChD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC5C;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;CAC1B;AAED,wDAAwD;AACxD,UAAU,SAAS;IAClB,YAAY,EAAE;QACb,OAAO,EAAE;YAER,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,IAAI,CAAA;SACvC,CAAA;KACD,CAAA;CACD;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,GAAG,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA8E1E"}

package/dist/defineBlock.d.ts

@@ -11,6 +11,8 @@ export interface BlockMeta {
     /** Default prop values. Merged with block props at render time so blocks show content before editing. */
     defaults?: Record<string, unknown>;
     description?: string;
+    /** Set to true when this block fetches its own data from a datastore collection. Used by the editor to show a hint when both schema fields and data source are present. */
+    dataSource?: boolean;
 }
 /** A Vue SFC module that has `export const <name> = defineBlock(...)` in its `<script setup>`. */
 export interface BlockModule {

package/dist/defineBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineBlock.d.ts","sourceRoot":"","sources":["../src/defineBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,WAAW,SAAS;IACzB,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,kGAAkG;AAClG,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAEtD"}
+{"version":3,"file":"defineBlock.d.ts","sourceRoot":"","sources":["../src/defineBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,WAAW,SAAS;IACzB,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2KAA2K;IAC3K,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,kGAAkG;AAClG,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAEtD"}