@levo-so/site-runtime 0.2.0 → 0.2.2

package/dist/inspector/textEditController.d.ts

@@ -1,24 +0,0 @@
-import { IEditorChannel } from './editorChannel';
-import { IOriginalsStash } from './originalsStash';
-export type ITextEditController = ReturnType<typeof createTextEditController>;
-export declare const createTextEditController: (deps: {
-    channel: IEditorChannel;
-    originals: IOriginalsStash;
-    /**
-     * Drop the text-mode hover affordance (outline + tracked hover target). Cursor is NOT
-     * reset here — the pointer tracker owns it (hovering the edited node clears it there).
-     */
-    clearTextHover: () => void;
-}) => {
-    startEdit: (el: Element, caretAtEnd?: boolean) => void;
-    /** The node currently in contenteditable, or null — read by hover/click/staged logic. */
-    editingNode: () => Element | null;
-    /** Commit any in-flight edit (mode exit, defensive re-entry). No-op when idle. */
-    commitIfEditing: () => void;
-    /**
-     * Teardown for unmount: end any in-flight edit WITHOUT committing (no report on
-     * teardown — matches the original closure's cleanup, which called endEdit directly).
-     */
-    teardown: () => void;
-};
-//# sourceMappingURL=textEditController.d.ts.map

package/dist/inspector/textEditController.js

@@ -1,62 +0,0 @@
-import { COLOR as e, nodesForSource as t, sourceIndex as n, sourceOf as r } from "./dom.js";
-//#region src/inspector/textEditController.ts
-var i = (i) => {
-	let { channel: a, originals: o, clearTextHover: s } = i, c = null, l = "", u = 0, d = (() => {
-		try {
-			let e = document.createElement("div");
-			return e.setAttribute("contenteditable", "plaintext-only"), e.contentEditable === "plaintext-only";
-		} catch {
-			return !1;
-		}
-	})(), f = () => {
-		c && _(c);
-	}, p = (e) => {
-		e.key === "Enter" ? (e.preventDefault(), c && _(c)) : e.key === "Escape" && (e.preventDefault(), c && v(c));
-	}, m = (e) => {
-		let t = window.getSelection();
-		if (!t) return;
-		let n = document.createRange();
-		n.selectNodeContents(e), n.collapse(!1), t.removeAllRanges(), t.addRange(n);
-	}, h = (t, i = !1) => {
-		if (c === t) return;
-		c && _(c), c = t, l = r(t) || "", u = n(t, l), s(), o.capture(`${l}#${u}`, t.textContent ?? ""), t.setAttribute("contenteditable", d ? "plaintext-only" : "true");
-		let a = t;
-		a.style.outline = `2px solid ${e.hover}`, a.style.outlineOffset = "3px", a.style.borderRadius = "3px", a.focus(), i && m(t), a.addEventListener("blur", f, !0), a.addEventListener("keydown", p, !0);
-	}, g = (e) => {
-		e.removeAttribute("contenteditable");
-		let t = e;
-		t.style.outline = "", t.style.outlineOffset = "", t.style.borderRadius = "", t.removeEventListener("blur", f, !0), t.removeEventListener("keydown", p, !0), c = null;
-	}, _ = (e) => {
-		let n = r(e), i = u, s = o.get(`${l}#${u}`);
-		g(e);
-		let c = (e.textContent ?? "").replace(/\s+/g, " ").trim();
-		a.send({
-			type: "element-text-changed",
-			element: {
-				source: n,
-				index: i,
-				tag: e.tagName.toLowerCase(),
-				value: c,
-				previous: s,
-				occurrences: n ? t(n).length : 1
-			}
-		});
-	}, v = (e) => {
-		let t = `${l}#${u}`;
-		g(e);
-		let n = o.restore(t);
-		n != null && (e.textContent = n);
-	};
-	return {
-		startEdit: h,
-		editingNode: () => c,
-		commitIfEditing: () => {
-			c && _(c);
-		},
-		teardown: () => {
-			c && g(c);
-		}
-	};
-};
-//#endregion
-export { i as createTextEditController };

package/dist/pageHead.d.ts

@@ -1,77 +0,0 @@
-/** One page's head metadata. Every field optional — site defaults fill gaps per-field. */
-export interface IPageMeta {
-    title?: string;
-    description?: string;
-    /** Absolute URL. Rendered as `<link rel="canonical">`. */
-    canonical?: string;
-    /** e.g. "index,follow" / "noindex,nofollow". */
-    robots?: string;
-    og?: {
-        title?: string;
-        description?: string;
-        image?: string;
-        /** Absolute share URL. Falls back to `canonical` when unset. */
-        url?: string;
-        /** Defaults to "website" when any og field is present. */
-        type?: string;
-    };
-    twitter?: {
-        /** Defaults to "summary_large_image" when any twitter field is present. */
-        card?: string;
-        title?: string;
-        description?: string;
-        image?: string;
-    };
-    /** JSON-LD object(s) — each becomes a `<script type="application/ld+json">`. */
-    ldJson?: Record<string, unknown> | Array<Record<string, unknown>>;
-    /**
-     * Raw head snippet for THIS page. v1 supports `<script>`, `<meta>` and `<link>` tags
-     * only (the analytics / verification / preload cases) — anything else is dropped by
-     * `parseRawHead`, since arbitrary markup can't be expressed as document metadata.
-     */
-    customHead?: string;
-}
-/** Site-wide defaults + site-wide raw head, from `src/pages/_site.meta.ts`. */
-export interface ISiteMeta extends IPageMeta {
-    /** "%s · Acme" — %s is the page title. Applied only when the page provides a title. */
-    titleTemplate?: string;
-}
-interface IHeadEntry {
-    [attr: string]: string | undefined;
-}
-export interface IComposedHead {
-    meta: IHeadEntry[];
-    links: IHeadEntry[];
-    scripts: IHeadEntry[];
-}
-/**
- * Tolerant extraction of `<script>` / `<meta>` / `<link>` tags from a raw head snippet.
- * Unsupported tags are DROPPED (documented v1 limitation) — silently at runtime; the
- * editor warns at save time.
- */
-export declare const parseRawHead: (raw: string) => IComposedHead;
-/**
- * Compose one page's document metadata from its sidecar + the site defaults. Page
- * values win per-FIELD (an empty page og.title still inherits the site og.title).
- * The object shape doubles as a TanStack Start route `head()` result for when the
- * scaffold wires routes directly.
- */
-export declare const pageHead: (meta?: IPageMeta, site?: ISiteMeta) => IComposedHead;
-/**
- * Renders a page's metadata as document tags. Pages include it anywhere in their JSX —
- * React 19 hoists <title>/<meta>/<link> into <head> (SSR too); scripts render in place
- * (see the file header caveat). The studio wires this automatically on a page's first
- * meta save:
- *
- *   import meta from "./about.meta";
- *   import siteMeta from "./_site.meta";
- *   import { PageHead } from "../lib/pageHead";
- *   …
- *   <PageHead meta={meta} site={siteMeta} />
- */
-export declare function PageHead({ meta, site }: {
-    meta?: IPageMeta;
-    site?: ISiteMeta;
-}): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=pageHead.d.ts.map

package/dist/pageHead.js

@@ -1,105 +0,0 @@
-import { Fragment as e, jsx as t, jsxs as n } from "react/jsx-runtime";
-//#region src/pageHead.tsx
-var r = (e) => JSON.stringify(e).replace(/<\//g, "<\\/"), i = (e) => {
-	let t = {}, n = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)(?:\s*=\s*("([^"]*)"|'([^']*)'|[^\s"'>]+))?/g;
-	for (let r = n.exec(e); r; r = n.exec(e)) {
-		let e = r[1];
-		!e || /^on/i.test(e) || (t[e] = r[3] ?? r[4] ?? (r[2] ? r[2] : ""));
-	}
-	return t;
-}, a = (e) => {
-	let t = {
-		meta: [],
-		links: [],
-		scripts: []
-	};
-	if (!e?.trim()) return t;
-	let n = e.replace(/<script\b([^>]*)>([\s\S]*?)<\/script\s*>/gi, (e, n, r) => {
-		let a = i(n), o = r.trim();
-		return o && (a.children = o), t.scripts.push(a), "";
-	});
-	return n = n.replace(/<(meta|link)\b([^>]*?)\/?>/gi, (e, n, r) => ((n.toLowerCase() === "meta" ? t.meta : t.links).push(i(r)), "")), t;
-}, o = (e = {}, t = {}) => {
-	let n = {
-		meta: [],
-		links: [],
-		scripts: []
-	}, i = e.title?.trim(), o = t.title?.trim(), s = t.titleTemplate?.includes("%s") ? t.titleTemplate : void 0, c = i ? s ? s.replace("%s", i) : i : o;
-	c && n.meta.push({ title: c });
-	let l = e.description ?? t.description;
-	l && n.meta.push({
-		name: "description",
-		content: l
-	});
-	let u = e.robots ?? t.robots;
-	u && n.meta.push({
-		name: "robots",
-		content: u
-	});
-	let d = e.canonical ?? t.canonical;
-	d && n.links.push({
-		rel: "canonical",
-		href: d
-	});
-	let f = {
-		...t.og,
-		...e.og
-	}, p = f.title ?? i ?? o, m = f.description ?? l, h = !!(p || m || f.image), g = f.url ?? d;
-	h && (n.meta.push({
-		property: "og:type",
-		content: f.type ?? "website"
-	}), p && n.meta.push({
-		property: "og:title",
-		content: p
-	}), m && n.meta.push({
-		property: "og:description",
-		content: m
-	}), f.image && n.meta.push({
-		property: "og:image",
-		content: f.image
-	}), g && n.meta.push({
-		property: "og:url",
-		content: g
-	}));
-	let _ = {
-		...t.twitter,
-		...e.twitter
-	}, v = _.title ?? p, y = _.description ?? m, b = _.image ?? f.image;
-	(v || y || b) && (n.meta.push({
-		name: "twitter:card",
-		content: _.card ?? "summary_large_image"
-	}), v && n.meta.push({
-		name: "twitter:title",
-		content: v
-	}), y && n.meta.push({
-		name: "twitter:description",
-		content: y
-	}), b && n.meta.push({
-		name: "twitter:image",
-		content: b
-	}));
-	let x = e.ldJson ? Array.isArray(e.ldJson) ? e.ldJson : [e.ldJson] : [];
-	for (let e of x) n.scripts.push({
-		type: "application/ld+json",
-		children: r(e)
-	});
-	for (let r of [t.customHead, e.customHead]) {
-		if (!r) continue;
-		let e = a(r);
-		n.meta.push(...e.meta), n.links.push(...e.links), n.scripts.push(...e.scripts);
-	}
-	return n;
-};
-function s({ meta: r, site: i }) {
-	let a = o(r, i);
-	return /* @__PURE__ */ n(e, { children: [
-		a.meta.map((e, n) => e.title === void 0 ? /* @__PURE__ */ t("meta", { ...e }, `m${n}`) : /* @__PURE__ */ t("title", { children: e.title }, `t${n}`)),
-		a.links.map((e, n) => /* @__PURE__ */ t("link", { ...e }, `l${n}`)),
-		a.scripts.map(({ children: e, ...n }, r) => e === void 0 ? /* @__PURE__ */ t("script", { ...n }, `s${r}`) : /* @__PURE__ */ t("script", {
-			...n,
-			dangerouslySetInnerHTML: { __html: e }
-		}, `s${r}`))
-	] });
-}
-//#endregion
-export { s as PageHead, o as pageHead, a as parseRawHead };

package/dist/scaffold.d.ts

@@ -1,110 +0,0 @@
-import { ILevoSiteConfig } from './client';
-import { ILevoDataSources, IQueryClientLike } from './data';
-import { IComposedHead } from './pageHead';
-/** The platform's per-page SEO object — the `meta` key of `meta/<route>.json`. */
-export interface IPlatformPageMeta {
-    meta_title?: string;
-    meta_description?: string;
-    keywords?: string;
-    og_title?: string;
-    og_description?: string;
-    /** Plain URL string, or the platform media object (older rows) — `.location` is read. */
-    og_image?: string | {
-        location?: string;
-    } | null;
-    og_url?: string;
-    canonical?: string;
-    twitter_card?: string;
-    /** JSON-LD structured data — rendered as an `application/ld+json` script tag. */
-    ld_json?: Record<string, unknown> | Array<Record<string, unknown>>;
-    /** Page-scoped raw head snippet — script/meta/link tags only. */
-    head_code?: string;
-    disable_indexing?: boolean;
-    robots?: string;
-}
-/** The full `meta/<route>.json` shape: page identity (platform-owned) + the SEO object. */
-export interface IPlatformMetaFile {
-    title?: string;
-    description?: string;
-    meta?: IPlatformPageMeta;
-}
-/** The slice of the project's root `site.json` the runtime reads. */
-export interface ISiteJson {
-    id?: string;
-    workspace_id?: string;
-    name?: string;
-    description?: string;
-    /** The site's live URL host (with or without protocol) — feeds auto-canonicals. */
-    domain?: string;
-    settings?: {
-        head_code?: string;
-    };
-    levo?: {
-        api_url?: string;
-        insights_url?: string | null;
-        app_mode?: string;
-    };
-}
-/**
- * Per-record head config for a dynamic (`$slug`) route — `levoHead`'s optional second
- * argument. A static literal (AI/editor-written, next to the route's meta import); each
- * field names a FIELD on the loaded record (the `dataSources` entry named by `source`).
- * At request time the record's values override the static meta file per-field, so every
- * slug ships its own title, description, and share image.
- */
-export interface ILevoDynamicHead {
-    /** Key in the page's `dataSources` whose loaded record feeds the head. */
-    source: string;
-    /** Record field holding the page title (the site name is appended automatically). */
-    title?: string;
-    /** Record field holding the description. */
-    description?: string;
-    /** Record field holding the share image (platform image object or URL). */
-    image?: string;
-}
-/**
- * The slice of the router's head-fn context we read. Structural on purpose (like
- * IQueryClientLike) so the package never depends on the router's types: `loaderData` is
- * the loader's return value — `prefetchLevoSources`' source-keyed map — and
- * `match.pathname` is the request path. Both read defensively; absent = skipped.
- */
-interface IHeadCtx {
-    loaderData?: unknown;
-    match?: {
-        pathname?: string;
-    };
-}
-/**
- * The site's Levo client config from its `site.json`. The platform stamps that file at
- * provision and re-syncs it on settings saves; the `?.` on `levo` is load-bearing — a
- * site provisioned before the block shipped degrades to an inert client, never a crash.
- */
-export declare const siteConfigFromJson: (site: ISiteJson) => ILevoSiteConfig;
-/**
- * Build the site's `levoHead` from its `site.json`. Each route passes its OWN imported
- * meta file (`head: levoHead(meta)`) — no path matching anywhere; the import IS the
- * pairing. The argument default lets a meta-less route render pure site defaults.
- *
- * Dynamic (`$slug`) routes pass a second argument naming the record fields that feed the
- * head (`head: levoHead(meta, { source: "post", title: "title", … })`), so every slug
- * gets its own title/description/share image instead of the route's shared static meta.
- * Pages that set no `canonical` get a self-referencing one derived from the site domain
- * + request path (og:url follows it in pageHead) — per-slug correct on dynamic routes.
- */
-export declare const createLevoHead: (site: ISiteJson) => (meta?: IPlatformMetaFile, dynamic?: ILevoDynamicHead) => (ctx?: IHeadCtx) => IComposedHead;
-/**
- * Build the one-line route loader (`loader: levoLoader(dataSources)`): prefetch the
- * page's declared data sources on the server so SSR ships fully-rendered HTML, and
- * return them keyed by source key — that map is the route's `loaderData`, which
- * `levoHead`'s dynamic config reads for per-record heads. An empty `dataSources` ({})
- * resolves to an empty map. Context is typed structurally (just `queryClient`) so the
- * scaffold's router types never enter the package.
- */
-export declare const createLevoLoader: (config: ILevoSiteConfig) => (sources: ILevoDataSources) => ({ context, params, }: {
-    context: {
-        queryClient: IQueryClientLike;
-    };
-    params?: Record<string, string>;
-}) => Promise<Record<string, unknown>>;
-export {};
-//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.js

@@ -1,64 +0,0 @@
-import { prefetchLevoSources as e } from "./data/index.js";
-import { pageHead as t } from "./pageHead.js";
-//#region src/scaffold.ts
-var n = (e) => typeof e == "string" && e.trim() ? e : void 0, r = (e) => ({
-	apiUrl: e.levo?.api_url || "",
-	workspace: e.workspace_id || "",
-	siteId: e.id || "",
-	insightsUrl: e.levo?.insights_url || null,
-	appMode: e.levo?.app_mode || "production"
-}), i = (e) => typeof e == "string" ? e : e?.location ?? void 0, a = (e, t) => {
-	let n = e.meta ?? {}, r = e.title && t ? `${e.title} | ${t}` : e.title || t || void 0;
-	return {
-		title: n.meta_title || r,
-		description: n.meta_description || void 0,
-		canonical: n.canonical || void 0,
-		robots: n.disable_indexing ? "noindex,nofollow" : n.robots || void 0,
-		og: {
-			title: n.og_title || void 0,
-			description: n.og_description || void 0,
-			image: i(n.og_image),
-			url: n.og_url || void 0
-		},
-		twitter: { card: n.twitter_card || void 0 },
-		ldJson: n.ld_json || void 0,
-		customHead: n.head_code || void 0
-	};
-}, o = (e) => ({
-	description: e.description || void 0,
-	customHead: e.settings?.head_code || void 0
-}), s = (e) => (r = {}, s) => (c) => {
-	let l = a(r, e.name);
-	if (s) {
-		let t = c?.loaderData?.[s.source];
-		if (t) {
-			let r = s.title ? n(t[s.title]) : void 0;
-			r && (l.title = e.name ? `${r} | ${e.name}` : r, l.og = {
-				...l.og,
-				title: r
-			});
-			let a = s.description ? n(t[s.description]) : void 0;
-			a && (l.description = a, l.og = {
-				...l.og,
-				description: a
-			});
-			let o = s.image ? i(t[s.image]) : void 0;
-			o && (l.og = {
-				...l.og,
-				image: o
-			});
-		}
-	}
-	if (!l.canonical) {
-		let t = c?.match?.pathname, n = (e.domain || "").trim();
-		n && t?.startsWith("/") && (l.canonical = (/^https?:\/\//.test(n) ? n : `https://${n}`).replace(/\/+$/, "") + t);
-	}
-	return t(l, o(e));
-}, c = (t) => (n) => ({ context: r, params: i }) => e({
-	queryClient: r.queryClient,
-	config: t,
-	sources: n,
-	params: i
-});
-//#endregion
-export { s as createLevoHead, c as createLevoLoader, r as siteConfigFromJson };