@bagelink/blox 1.15.176 → 1.15.180

package/dist/{PreviewApp-B8EmNfyH.cjs → PreviewApp-APyemzqx.cjs}

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const PreviewApp_vue_vue_type_style_index_0_lang = require("./PreviewApp.vue_vue_type_style_index_0_lang-CPBuld3j.cjs");
+const PreviewApp_vue_vue_type_style_index_0_lang = require("./PreviewApp.vue_vue_type_style_index_0_lang-C0ZVst7R.cjs");
 exports.default = PreviewApp_vue_vue_type_style_index_0_lang._sfc_main;

package/dist/{PreviewApp-DdkAQqw2.js → PreviewApp-BKTydm92.js}

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "./PreviewApp.vue_vue_type_style_index_0_lang-1JKQVLm2.js";
+import { _ as _sfc_main } from "./PreviewApp.vue_vue_type_style_index_0_lang-DHb-NJ4C.js";
 export {
   _sfc_main as default
 };

package/dist/{PreviewApp.vue_vue_type_style_index_0_lang-CPBuld3j.cjs → PreviewApp.vue_vue_type_style_index_0_lang-C0ZVst7R.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 const vue = require("vue");
-const core = require("./core-KRHc4Bob.cjs");
+const routes = require("./routes-C97aL4cQ.cjs");
 function sendToEditor(msg) {
   window.parent.postMessage(msg, "*");
 }
@@ -30,7 +30,7 @@ const PreviewRenderer = vue.defineComponent({
     }
   },
   setup(props) {
-    const registry = vue.inject(core.BLOX_REGISTRY_KEY, {});
+    const registry = vue.inject(routes.BLOX_REGISTRY_KEY, {});
     const localHovered = vue.ref(null);
     function onBlockClick(index) {
       sendToEditor({ type: "BLOX_BLOCK_CLICK", index });
@@ -92,7 +92,7 @@ const PreviewRenderer = vue.defineComponent({
         const isSelected = props.selectedIndex === i;
         const isHovered = (props.hoveredIndex === i || localHovered.value === i) && !isSelected;
         const { label } = definition.schema;
-        const globalRef = core.globalRefOf(block);
+        const globalRef = routes.globalRefOf(block);
         const isGlobal = props.globalBlockTypes.includes(block.type) || !!globalRef;
         const palette = isGlobal ? GLOBAL : REGULAR;
         const overlayStyle = { ...overlayBaseFor(palette.rgb) };
@@ -124,7 +124,7 @@ const PreviewRenderer = vue.defineComponent({
               "onMouseleave": onBlockLeave
             },
             [
-              globalRef ? vue.h(core.GlobalBlockHost, {
+              globalRef ? vue.h(routes.GlobalBlockHost, {
                 component: definition.component,
                 defaults: definition.schema.defaults,
                 blockProps: block.props,
@@ -144,8 +144,8 @@ const _hoisted_1 = { class: "blox-preview-root" };
 const _sfc_main = /* @__PURE__ */ vue.defineComponent({
   __name: "PreviewApp",
   setup(__props) {
-    const registry = vue.inject(core.BLOX_REGISTRY_KEY, {});
-    const { setLocale } = core.useLocale();
+    const registry = vue.inject(routes.BLOX_REGISTRY_KEY, {});
+    const { setLocale } = routes.useLocale();
     const blocks = vue.ref([]);
     const contexts = vue.ref({});
     const selectedIndex = vue.ref(null);

package/dist/{PreviewApp.vue_vue_type_style_index_0_lang-1JKQVLm2.js → PreviewApp.vue_vue_type_style_index_0_lang-DHb-NJ4C.js}

@@ -1,5 +1,5 @@
 import { defineComponent, inject, ref, h, provide, onMounted, onUnmounted, openBlock, createElementBlock, createVNode, unref, nextTick } from "vue";
-import { B as BLOX_REGISTRY_KEY, g as globalRefOf, G as GlobalBlockHost, u as useLocale } from "./core-Bp2bf8e4.js";
+import { e as BLOX_REGISTRY_KEY, f as globalRefOf, G as GlobalBlockHost, u as useLocale } from "./routes-bhjTTXfU.js";
 function sendToEditor(msg) {
   window.parent.postMessage(msg, "*");
 }

package/dist/api/index.d.ts

@@ -1,5 +1,11 @@
 import { CollectionItemsPage, PageResolveRead } from './types';
 export declare function configureApi(websiteName: string, store: string): void;
+/**
+ * Point blox's datastore client at an absolute API base (SSG/Node, where
+ * `window.location.origin` + a `/api` proxy don't exist). `base` may include a
+ * path prefix (e.g. `https://host` or `https://host/api`).
+ */
+export declare function setApiOrigin(base: string): void;
 /** Synchronously read the resolved website id if already known (SSG-embedded or cached). */
 export declare function getWebsiteIdSync(): string | null;
 export declare function getWebsiteId(): Promise<string>;
@@ -13,4 +19,20 @@ export interface ListItemsOptions {
 export declare function listItems<T = Record<string, unknown>>(collection: string, { locale, q, offset, limit }?: ListItemsOptions): Promise<CollectionItemsPage & {
     items: T[];
 }>;
+/**
+ * Fetch a single item from a collection by its `slug`, in the given locale.
+ *
+ * The datastore returns the row already translated for `?locale=`, so `item.*`
+ * fields (incl. `slug`) are the active-locale values. Returns null if no item
+ * matches. `available_locales` (when present) is used by the content router's
+ * cross-locale fallback.
+ */
+export declare function getItemBySlug<T = Record<string, unknown>>(collection: string, slug: string, locale?: string): Promise<T | null>;
+/**
+ * Fetch a single item by its `id`, translated for `locale`. Used to resolve an
+ * entity's slug in OTHER locales (hreflang alternates) — the id is
+ * locale-independent, the returned `slug`/fields are the requested locale's.
+ * Returns null if the item isn't available in that locale (datastore 406/404).
+ */
+export declare function getItemById<T = Record<string, unknown>>(collection: string, id: string, locale?: string): Promise<T | null>;
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAe,MAAM,SAAS,CAAA;AAUhF,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAsBD,4FAA4F;AAC5F,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAOhD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBpD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMxF;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,UAAU,EAAE,MAAM,EAClB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAU,EAAE,KAAW,EAAE,GAAE,gBAAqB,GAC3D,OAAO,CAAC,mBAAmB,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC,CAK/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAe,MAAM,SAAS,CAAA;AAahF,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAU/C;AAuBD,4FAA4F;AAC5F,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAOhD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBpD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMxF;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAsB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,UAAU,EAAE,MAAM,EAClB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAU,EAAE,KAAW,EAAE,GAAE,gBAAqB,GAC3D,OAAO,CAAC,mBAAmB,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC,CAK/C;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAMnB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAInB"}

package/dist/components/BloxRouterView.vue.d.ts

@@ -1,18 +1,29 @@
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: {
-        fallback?(_: {}): any;
-    };
-    refs: {};
-    rootEl: any;
+/**
+ * Router outlet for Blox apps — renders the matched route component directly
+ * under the app-root `<Suspense>`.
+ *
+ * WHY NOT a plain `<RouterView>` wrapped in `<transition>` (the common pattern)?
+ * A `<transition>` around the routed view prevents Vue's server renderer from
+ * awaiting that view's `onServerPrefetch`. Data-driven detail pages
+ * (blog/event/product) fetch via `useData()`/`useContentItem()` in
+ * `onServerPrefetch`; behind a transition their data never resolves during SSG,
+ * so they prerender EMPTY. Keeping the routed view directly under the root
+ * `<Suspense>` lets the prefetch resolve and the content land in static HTML.
+ *
+ * `transition` is therefore OFF by default. Opt in only for client-only apps
+ * (no SSG) where page-transition animation matters more than prerendered
+ * content — passing `transition` re-introduces the empty-SSG behavior for
+ * data-driven routes, by design.
+ *
+ * `:key` is the matched leaf record's path, so a real page change remounts while
+ * param-only navigation (same route, new `:slug`) does not.
+ */
+type __VLS_Props = {
+    /** CSS transition name. When set, wraps the view in `<transition>` (client-only apps). */
+    transition?: string;
 };
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    transition: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
 //# sourceMappingURL=BloxRouterView.vue.d.ts.map

package/dist/components/BloxRouterView.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BloxRouterView.vue.d.ts","sourceRoot":"","sources":["../../src/components/BloxRouterView.vue"],"names":[],"mappings":"AA4BA,iBAAS,cAAc;WAqDT,OAAO,IAA6B;;0BAVnB,GAAG;;;;EAejC;AAOD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,+QAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"BloxRouterView.vue.d.ts","sourceRoot":"","sources":["../../src/components/BloxRouterView.vue"],"names":[],"mappings":"AA4CA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,WAAW,GAAG;IAClB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAC;;gBADY,MAAM;;AA4FpB,wBAQG"}

package/dist/composables/useLocale.d.ts

@@ -1,4 +1,11 @@
 export type Locale = string;
+/**
+ * Set the active locale ref directly, without touching `localStorage`/`document`.
+ * Used by the SSG entry to align `useLocale()` with the URL-detected render
+ * locale for app-router pages (which don't pass through `CmsPageView`). Keeps
+ * `@bagelink/vue` i18n in sync when present.
+ */
+export declare function setActiveLocale(l: Locale): void;
 export declare function useLocale(): {
     locale: import('vue').Ref<string, string>;
     dir: import('vue').ComputedRef<"ltr" | "rtl">;

package/dist/composables/useLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.d.ts","sourceRoot":"","sources":["../../src/composables/useLocale.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAA;AAO3B,wBAAgB,SAAS;;;mBAGF,MAAM;;gCAcO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;EAKzD"}
+{"version":3,"file":"useLocale.d.ts","sourceRoot":"","sources":["../../src/composables/useLocale.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAA;AAW3B;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ/C;AAED,wBAAgB,SAAS;;;mBAGF,MAAM;;gCAgBO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;EAKzD"}

package/dist/composables/useLocaleNav.d.ts

@@ -12,11 +12,11 @@
 export declare function useLocaleNav(): {
     switchLocale: (targetLocale: string) => void;
     toPath: (slug: string) => string;
-    locale: import('vue').Ref<string, string>;
-    availableLocales: import('vue').ComputedRef<string[]>;
     detect: (path: string) => {
         locale: string;
         slug: string;
     };
+    availableLocales: import('vue').ComputedRef<string[]>;
+    locale: import('vue').Ref<string, string>;
 };
 //# sourceMappingURL=useLocaleNav.d.ts.map

package/dist/composables/useLocaleNav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocaleNav.d.ts","sourceRoot":"","sources":["../../src/composables/useLocaleNav.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY;iCAYS,MAAM;mBAkBpB,MAAM,KAAG,MAAM;;;mBAOf,MAAM;;;;EAO5B"}
+{"version":3,"file":"useLocaleNav.d.ts","sourceRoot":"","sources":["../../src/composables/useLocaleNav.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY;iCAYS,MAAM;mBAkBpB,MAAM,KAAG,MAAM;mBAaf,MAAM,KAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;;EAa/D"}

package/dist/content/{ContentDetailHost.vue.d.ts → ContentDetailView.vue.d.ts}

@@ -1,3 +1,3 @@
 declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
-//# sourceMappingURL=ContentDetailHost.vue.d.ts.map
+//# sourceMappingURL=ContentDetailView.vue.d.ts.map

package/dist/content/ContentDetailView.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentDetailView.vue.d.ts","sourceRoot":"","sources":["../../src/content/ContentDetailView.vue"],"names":[],"mappings":";AAgKA,wBAKG"}

package/dist/content/ContentHost.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+//# sourceMappingURL=ContentHost.vue.d.ts.map

package/dist/content/ContentHost.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHost.vue.d.ts","sourceRoot":"","sources":["../../src/content/ContentHost.vue"],"names":[],"mappings":";AAyGA,wBAMG"}

package/dist/content/index.d.ts

@@ -0,0 +1,9 @@
+export { defineContent, contentRoutes, getContentRoute, getContentRouteByCollection, __clearContentRegistry, } from './registry';
+export type { ContentItem, ContentRoute, ContentRouteInput, ContentViewSchema } from './registry';
+export { generateContentRoutes, installContentFallback, installLocaleAwareResolve } from './routes';
+export { provideContentItem, useContentItem } from './useContentItem';
+export { useContentSeo } from './useContentSeo';
+export { getItemBySlug, getItemById } from '../api';
+export { default as ContentHost } from './ContentHost.vue';
+export { default as ContentDetailView } from './ContentDetailView.vue';
+//# sourceMappingURL=index.d.ts.map

package/dist/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,aAAa,EACb,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEjG,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AACnG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAEnD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/content/registry.d.ts

@@ -0,0 +1,73 @@
+import { Component } from 'vue';
+/**
+ * Content registry — the SINGLE source of truth binding a datastore collection
+ * to its detail route. Everything locale/routing/prerender-related is a
+ * projection of this one declaration:
+ *   - router            → named, locale-prefixed routes (meta.content)
+ *   - links             → vanilla `<RouterLink :to="{ name, params:{ slug } }">`
+ *                         (blox adds the locale prefix under the hood)
+ *   - detail data       → route loader fetches the item (active locale) + provides it
+ *   - prerender/sitemap → enumerate collections × available locales → URLs
+ *
+ * The datastore returns items already translated for `?locale=`, so `item.slug`
+ * is ALWAYS the active-locale slug — no slug-field/translation logic lives here.
+ * Registration is pure routing data, so a new data-powered route can be added at
+ * runtime with a single `defineContent` call (no per-route component code when
+ * using the generic detail view).
+ */
+export type ContentItem = Record<string, any>;
+export interface ContentRouteInput {
+    /** Stable route name used by links: `{ name, params: { slug } }`. */
+    name: string;
+    /** Datastore collection this content lives in. */
+    collection: string;
+    /**
+     * Bare (default-locale) route pattern with a `:slug` param, e.g.
+     * `/event/:slug` or `/blog/:category/:slug`. Locale prefixing is added by the
+     * router generator.
+     */
+    route: string;
+    /**
+     * Detail component. Optional — defaults to the generic schema-driven
+     * `ContentDetailView`, so a data-only collection needs no bespoke component.
+     */
+    component?: Component;
+    /**
+     * Optional render schema for the generic detail view (field → display).
+     * Ignored when a custom `component` is supplied.
+     */
+    view?: ContentViewSchema;
+}
+export interface ContentViewSchema {
+    /** Field used as the <h1> / page title + SEO title. */
+    title?: string;
+    /** Field used as the hero image (expects `{ imageURL }` or a URL string). */
+    image?: string;
+    /** Rich-text/HTML body field. */
+    body?: string;
+    /** Short description field for SEO (stripped to text). */
+    description?: string;
+}
+export interface ContentRoute {
+    readonly name: string;
+    readonly collection: string;
+    readonly route: string;
+    readonly component?: Component;
+    readonly view?: ContentViewSchema;
+    /** Param names in `route`, in order (e.g. ['category','slug']). */
+    readonly params: string[];
+}
+/**
+ * Register content routes. Idempotent per `name` (last write wins) so it's safe
+ * to call from both the client and the SSR entry.
+ */
+export declare function defineContent(inputs: ContentRouteInput[]): void;
+/** All registered content routes (router generation + prerender). */
+export declare function contentRoutes(): ContentRoute[];
+/** Look up a registered content route by name. */
+export declare function getContentRoute(name: string): ContentRoute | undefined;
+/** Look up a registered content route by collection. */
+export declare function getContentRouteByCollection(collection: string): ContentRoute | undefined;
+/** Reset — test/hot-reload only. */
+export declare function __clearContentRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/content/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/content/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IACjC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CACzB;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAe/D;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAE9C;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE;AAED,wDAAwD;AACxD,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGxF;AAED,oCAAoC;AACpC,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/content/routes.d.ts

@@ -0,0 +1,48 @@
+import { RouteRecordRaw, Router } from 'vue-router';
+import { LocaleStrategy } from '../localeStrategy';
+/**
+ * Generate vue-router route records for every registered content route.
+ *
+ * Each registration yields a NAMED default-locale route + one NAMED route per
+ * non-default locale (`event`, `event:it`, `event:fr`, …), all rendered by
+ * `ContentHost` (which fetches + provides the entity). `meta.content` carries the
+ * registration name so the host, the fallback guard, and prerender can find it.
+ *
+ * Links stay pure-vanilla: `<RouterLink :to="{ name, params: { slug } }">`; the
+ * locale prefix is added by the locale strategy, and `item.slug` is already the
+ * active-locale slug (per-locale fetch), so no slug translation is needed.
+ */
+export declare function generateContentRoutes(supportedLocales: string[], defaultLocale: string): RouteRecordRaw[];
+/**
+ * Make `router.resolve` locale-aware so that **plain vue-router usage is enough**
+ * — no `LocaleRouterLink`, no per-block/per-project locale code.
+ *
+ * `<RouterLink>` computes its href via `router.resolve(to)` (see vue-router
+ * `useLink`), and `router.push`/`replace` route through it too. Wrapping it once
+ * makes BOTH rendered links and programmatic navigation locale-correct, on the
+ * client AND during SSG (where `setActiveLocale()` sets the per-page active
+ * locale before each render, so static hrefs come out prefixed).
+ *
+ * Two cases, both keeping call sites 100% vanilla:
+ *  • STRING `to` (`"/blog"`, `"/get-the-best-offer"`): prefixed with the active
+ *    locale via the strategy (`/it/blog`). Idempotent — an already-prefixed or
+ *    external/special value is left alone.
+ *  • NAMED content route (`{ name:'event', params:{ slug } }`): the bare name is
+ *    swapped for the active locale's variant (`event` → `event:it`) so it
+ *    resolves to `/it/event/<slug>`.
+ *
+ * Raw `<a href>` in CMS/editor content is handled at click-time by
+ * `installSmartLinks` (client) — orthogonal to this.
+ */
+export declare function installLocaleAwareResolve(router: Router, strategy: LocaleStrategy): void;
+/**
+ * Cross-locale fallback for content detail routes.
+ *
+ * If a content URL's slug isn't available in the URL's locale but the entity
+ * exists in another locale, REDIRECT to that locale's URL (real navigation →
+ * correct URL, correct hreflang, no content/URL mismatch). Order: URL locale →
+ * default locale → any available locale. Only runs for content routes; anything
+ * unresolved falls through untouched (soft not-found handled by the view).
+ */
+export declare function installContentFallback(router: Router, supportedLocales: string[], defaultLocale: string): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/content/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/content/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAOvD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACpC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,aAAa,EAAE,MAAM,GACnB,cAAc,EAAE,CA4BlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,GACtB,IAAI,CA4BN;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EAAE,EAC1B,aAAa,EAAE,MAAM,GACnB,IAAI,CAsCN"}

package/dist/content/useContentItem.d.ts

@@ -1,6 +1,38 @@
-import { InjectionKey, Ref } from 'vue';
-export type ContentItem = Record<string, any>;
-export declare const BLOX_CONTENT_ITEM_KEY: InjectionKey<Ref<ContentItem | null>>;
-/** Active content-route entity (provided by `ContentDetailHost`). */
-export declare function useContentItem<T extends ContentItem = ContentItem>(): Ref<T | null>;
+import { InjectionKey, Ref, MaybeRefOrGetter } from 'vue';
+import { ContentItem } from './registry';
+/**
+ * Optional override: the content route host can provide `{ collection, slug }`
+ * so a view calling `useContentItem()` with no args resolves them from context.
+ * (Views normally just call `useContentItem()` and let it read route + registry.)
+ */
+export interface ContentItemContext {
+    collection: MaybeRefOrGetter<string>;
+    slug: MaybeRefOrGetter<string>;
+}
+export declare const CONTENT_ITEM_CTX: InjectionKey<ContentItemContext>;
+/**
+ * Fetch the current detail entity (active locale) for a content route.
+ *
+ * Vanilla for views: `const item = useContentItem()` — no args. It resolves the
+ * collection + slug from the route (`meta.content` → registry, `params.slug`),
+ * fetches in the active locale, and returns a reactive ref. The datastore
+ * returns the row already translated, so `item.value.slug`/`.city`/… are the
+ * active-locale values (read them directly, no `tdbLocale`).
+ *
+ * SSR-safe: the fetch runs via `useData` (onServerPrefetch on THIS component),
+ * so the value is present in the SSR render and hydrated synchronously on the
+ * client. Because the fetch lives on the consuming component, its resolved value
+ * participates in the same render pass (no cross-component provide/inject SSR
+ * timing gap).
+ *
+ * Optional args let non-route callers (or custom hosts) pass explicit
+ * collection/slug.
+ */
+export declare function useContentItem(collectionArg?: MaybeRefOrGetter<string>, slugArg?: MaybeRefOrGetter<string>): Ref<ContentItem | null>;
+/**
+ * Legacy provide entry point kept for the host: it now just provides the
+ * collection/slug context (no fetch), so the VIEW's `useContentItem()` performs
+ * the fetch on its own component (correct SSR timing).
+ */
+export declare function provideContentItem(collection: MaybeRefOrGetter<string>, slug: MaybeRefOrGetter<string>): void;
 //# sourceMappingURL=useContentItem.d.ts.map

package/dist/content/useContentItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useContentItem.d.ts","sourceRoot":"","sources":["../../src/content/useContentItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAG5C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAE7C,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAA+B,CAAA;AAEvG,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAEnF"}
+{"version":3,"file":"useContentItem.d.ts","sourceRoot":"","sources":["../../src/content/useContentItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC5C,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAKrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;CAC9B;AACD,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAmC,CAAA;AAEjG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC7B,aAAa,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,EACxC,OAAO,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAChC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAuCzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,EACpC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAC5B,IAAI,CAEN"}

package/dist/content/useContentSeo.d.ts

@@ -1,10 +1,23 @@
-import { Ref } from 'vue';
-import { SeoGetter } from '../composables/useSeo';
-import { ContentItem } from './useContentItem';
+import { MaybeRefOrGetter } from 'vue';
+import { BloxSeoHead } from '../data/useData';
+import { ContentItem } from './registry';
+type BaseHead = Omit<BloxSeoHead, 'alternates'>;
 /**
- * `useSeo` plus hreflang alternates from the entity's `available_locales`.
- * Alternate values are the current bare path (locale prefix stripped); SSG
- * head prefixes non-default locales with `/xx`.
+ * SEO for a data-driven detail page — same as `useSeo`, plus hreflang alternates
+ * that point at each available locale's real URL.
+ *
+ * CMS pages get hreflang from the backend resolve-path; content detail pages
+ * (blog/event/product) are entity URLs the CMS doesn't know, so this fills the
+ * gap. It reads the current registration (via `route.meta.content`), the
+ * entity's `available_locales`, resolves each locale's `slug` (by id — the id is
+ * locale-independent), builds `{ locale → routePath }` from the route pattern,
+ * and hands it to `useSeo({ alternates })` which `buildPageHead` emits as
+ * `<link rel="alternate" hreflang=…>` during SSG.
+ *
+ * Call this INSTEAD of `useSeo` in a detail view to get hreflang for free.
+ * Alternates resolve during `onServerPrefetch` (SSG only); on the client it's a
+ * plain `useSeo` (hreflang is a build-time concern).
  */
-export declare function useContentSeo(item: Ref<ContentItem | null | undefined>, getter: SeoGetter): void;
+export declare function useContentSeo(item: MaybeRefOrGetter<ContentItem | null>, head: () => BaseHead | null | undefined): void;
+export {};
 //# sourceMappingURL=useContentSeo.d.ts.map

package/dist/content/useContentSeo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useContentSeo.d.ts","sourceRoot":"","sources":["../../src/content/useContentSeo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9B,OAAO,EAAU,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAA;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,EACzC,MAAM,EAAE,SAAS,GACf,IAAI,CAqBN"}
+{"version":3,"file":"useContentSeo.d.ts","sourceRoot":"","sources":["../../src/content/useContentSeo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAI3C,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,KAAK,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,EAC1C,IAAI,EAAE,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,GACrC,IAAI,CAmDN"}

package/dist/core.d.ts

@@ -1,7 +1,7 @@
 import { App } from 'vue';
 import { Router } from 'vue-router';
 import { BlockModule } from './defineBlock';
-import { StrategyOptions } from './localeStrategy';
+import { LocaleStrategy, StrategyOptions } from './localeStrategy';
 import { BlockComponent, BlockDefinition } from './schema';
 import { BloxAdminConfig } from './symbols';
 /** Either a full `{ component, schema }` definition or a self-defining component (used `defineBlock()`). */
@@ -38,6 +38,8 @@ export declare class BloxInstance {
     private _strategy;
     private _adminEdit?;
     constructor(options?: BloxOptions);
+    /** The active locale strategy (path/domain). Used by the nav guard. */
+    get strategy(): LocaleStrategy;
     registerModules(modules: BlockModule[] | Record<string, BlockModule>): this;
     registerComponents(components: Record<string, BloxComponent>): this;
     /** The resolved block registry (type → definition with component + schema). */

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AACA,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;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,WAAW,CAAA;AAoB5D,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;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B;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;IACjC,OAAO,CAAC,UAAU,CAAC,CAAiB;gBAExB,OAAO,CAAC,EAAE,WAAW;IASjC,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IA+B3E,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IA4BnE,+EAA+E;IAC/E,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAI9C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA+BpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CAqC9C;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAS9D"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AACA,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,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,WAAW,CAAA;AAkB5D,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;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B;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;IACjC,OAAO,CAAC,UAAU,CAAC,CAAiB;gBAExB,OAAO,CAAC,EAAE,WAAW;IASjC,uEAAuE;IACvE,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IA+B3E,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI;IA4BnE,+EAA+E;IAC/E,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAI9C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;CAoC9C;AAMD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAS9D"}

package/dist/createBloxApp.d.ts.map

@@ -1 +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;AAQhD,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;IAC1B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAA;CACrC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAoBvE;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,CAmF1E"}
+{"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;AAWhD,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;IAC1B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAA;CACrC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAoCvE;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,CA+I1E"}

package/dist/data/useData.d.ts

@@ -0,0 +1,91 @@
+import { App, MaybeRefOrGetter, Ref } from 'vue';
+export declare const BLOX_DATA_WINDOW_KEY: "__BLOX_DATA__";
+export declare const BLOX_DATA_KEY: unique symbol;
+/** Per-page SEO overrides a block can set during SSR (see `useSeo`). */
+export interface BloxSeoHead {
+    title?: string;
+    description?: string;
+    image?: string;
+    /**
+     * Per-locale alternate URLs for hreflang. Map of `locale → absolute-or-root
+     * path` (e.g. `{ en: '/event/rome', it: '/it/event/roma' }`). Detail pages
+     * (blog/event/product) contribute this so hreflang points at each locale's
+     * real prerendered URL — CMS pages get theirs from the backend resolve-path
+     * instead. Emitted by `buildPageHead` when present.
+     */
+    alternates?: Record<string, string>;
+}
+export interface BloxDataRegistry {
+    /** Resolved values collected during SSR, serialized into the payload. */
+    readonly ssr: Map<string, unknown>;
+    /** Hydration payload read from `window.__BLOX_DATA__` on the client. */
+    readonly payload: Record<string, unknown> | null;
+    /** True while rendering on the server (collect phase). */
+    readonly isServer: boolean;
+    /** SEO head override collected during SSR (last writer wins). */
+    seo: BloxSeoHead;
+    /** SEO source getters registered by `useSeo`, evaluated *after* render. */
+    readonly seoSources: Array<() => BloxSeoHead | null | undefined>;
+}
+export interface UseDataResult<T> {
+    /** Reactive data — populated synchronously on server/hydration, async on SPA nav. */
+    data: Ref<T>;
+    /** True only while a client-side (SPA) fetch is in flight. */
+    pending: Ref<boolean>;
+    /** Last error thrown by the fetcher, if any. */
+    error: Ref<unknown>;
+    /** Imperatively re-run the fetcher (always hits the network). */
+    refresh: () => Promise<void>;
+}
+export interface UseDataOptions<T> {
+    /** Value used before the first resolution (SPA nav) and as SSR fallback on error. */
+    default: T;
+    /**
+     * When false, skip SSR prefetch for this key (client-only data, e.g. it depends
+     * on `window`/user state). Defaults to true.
+     */
+    server?: boolean;
+}
+/**
+ * Create the per-app data registry and provide it. Call once per app instance.
+ *
+ * @param opts.server  Explicit "this is a server/SSG render" flag. Required
+ *   because the SSG runtime polyfills `window` (happy-dom), so `typeof window`
+ *   cannot distinguish server from client. The SSR entry passes `true`; the
+ *   client `createBloxApp` passes `false` (default).
+ */
+export declare function provideBloxData(app: App, opts?: {
+    server?: boolean;
+}): BloxDataRegistry;
+/** Public accessor for the per-request data registry (SSR detection, SEO). */
+export declare function getRegistryData(): BloxDataRegistry | null;
+/**
+ * Serialize everything collected during an SSR render into a payload object.
+ * Call after `renderToString` resolves. Returns `{}` if nothing was collected.
+ */
+export declare function collectBloxData(registry: BloxDataRegistry): Record<string, unknown>;
+/**
+ * Set per-page SEO head (title/description/image) from block data.
+ *
+ * - SSR: collected into the registry (after data prefetch) and merged into the
+ *   prerendered `<head>` — so detail pages get real titles/OG tags.
+ * - Client: updates `document.title` on change (SPA navigation).
+ *
+ * @param source Getter returning the head values (may read reactive data).
+ */
+export declare function useSeo(source: () => BloxSeoHead | null | undefined): void;
+/**
+ * Evaluate all `useSeo` sources and return the merged head. Call AFTER
+ * `renderToString` resolves so the sources read fully-resolved data.
+ */
+export declare function collectBloxSeo(registry: BloxDataRegistry): BloxSeoHead;
+/**
+ * Declare a keyed data dependency.
+ *
+ * @param key     Stable, unique cache key — a string, ref, or getter. Include
+ *                locale + params (e.g. `blog:it`, `product:<slug>:it`). When the
+ *                key changes on the client (SPA navigation), the data re-fetches.
+ * @param fetcher Async function that returns the data for the current key.
+ */
+export declare function useData<T>(key: MaybeRefOrGetter<string>, fetcher: () => Promise<T>, options: UseDataOptions<T>): UseDataResult<T>;
+//# sourceMappingURL=useData.d.ts.map

package/dist/data/useData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useData.d.ts","sourceRoot":"","sources":["../../src/data/useData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAGrD,eAAO,MAAM,oBAAoB,EAAG,eAAwB,CAAA;AAC5D,eAAO,MAAM,aAAa,eAAsB,CAAA;AAEhD,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAChD,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,iEAAiE;IACjE,GAAG,EAAE,WAAW,CAAA;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CAChE;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,qFAAqF;IACrF,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACZ,8DAA8D;IAC9D,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACrB,gDAAgD;IAChD,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACnB,iEAAiE;IACjE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,qFAAqF;IACrF,OAAO,EAAE,CAAC,CAAA;IACV;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,gBAAgB,CAS3F;AAoBD,8EAA8E;AAC9E,wBAAgB,eAAe,IAAI,gBAAgB,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAezE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAUtE;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACxB,GAAG,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,aAAa,CAAC,CAAC,CAAC,CAiElB"}