@moku-labs/web 0.1.0-alpha.1

package/dist/index.mjs

@@ -0,0 +1,36 @@
+import { c as route, d as coreConfig, f as createCore, l as site, o as head, s as router, t as createComponent, u as i18n } from "./factory-DwpBwjDk.mjs";
+import { n as build, r as content, t as project } from "./project-BTNUWbGQ.mjs";
+import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-gO5i1tD8.mjs";
+import { spa } from "./plugins/spa/index.mjs";
+
+//#region src/index.ts
+/** @file Framework entry — Layer-2 createApp wrapper + barrel re-exports. */
+const { createApp: kernelCreateApp } = createCore(coreConfig, { plugins: [
+	site,
+	i18n,
+	content,
+	router,
+	head,
+	build,
+	spa
+] });
+/**
+* Layer-2 createApp wrapper — generic-preserving signature.
+*
+* Projects the consumer's flat config into pluginConfigs before delegating to
+* the kernel-bound createApp. The Routes generic flows through to
+* `app.router.routes` so callers get typed access to their route names.
+*
+* @param input - Consumer-facing flat web-app config.
+* @returns The assembled app with typed router routes.
+*/
+function createApp(input) {
+	const projected = project(input);
+	return kernelCreateApp({
+		...projected.config === void 0 ? {} : { config: projected.config },
+		pluginConfigs: projected.pluginConfigs
+	});
+}
+
+//#endregion
+export { canonical, createApp, createComponent, feedLink, hreflang, jsonLd, meta, og, route, twitter };

package/dist/plugins/head/build.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_primitives = require('../../primitives-BYUp6kae.cjs');
+
+//#region src/plugins/head/build.ts
+/** @file Sub-path /build entry — pure build-time helpers (no plugin state access). */
+/**
+* Build a list of head elements for an article page from its frontmatter.
+* Pure function — safe to call at build time without a plugin context.
+*
+* Always emits `<link rel=canonical>` and `<meta property=og:type content=article>`.
+* Adds `og:article:*` meta tags for any provided frontmatter fields.
+*
+* @param meta - Article frontmatter (publishedTime, modifiedTime, author, section, tags).
+* @param canonicalUrl - The fully-qualified canonical URL for the article.
+* @returns Ordered array of HeadElements ready to feed into `head.render()`.
+*/
+const buildArticleHead = (meta, canonicalUrl) => {
+	const elements = [require_primitives.canonical(canonicalUrl), require_primitives.og("type", "article")];
+	if (meta.publishedTime) elements.push(require_primitives.og("article:published_time", meta.publishedTime));
+	if (meta.modifiedTime) elements.push(require_primitives.og("article:modified_time", meta.modifiedTime));
+	if (meta.author) elements.push(require_primitives.og("article:author", meta.author));
+	if (meta.section) elements.push(require_primitives.og("article:section", meta.section));
+	if (meta.tags) for (const tag of meta.tags) elements.push(require_primitives.og("article:tag", tag));
+	return elements;
+};
+
+//#endregion
+exports.buildArticleHead = buildArticleHead;
+exports.canonical = require_primitives.canonical;
+exports.feedLink = require_primitives.feedLink;
+exports.hreflang = require_primitives.hreflang;
+exports.jsonLd = require_primitives.jsonLd;
+exports.meta = require_primitives.meta;
+exports.og = require_primitives.og;
+exports.twitter = require_primitives.twitter;

package/dist/plugins/head/build.d.cts

@@ -0,0 +1,17 @@
+import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-BBo4wxUL.cjs";
+
+//#region src/plugins/head/build.d.ts
+/**
+ * Build a list of head elements for an article page from its frontmatter.
+ * Pure function — safe to call at build time without a plugin context.
+ *
+ * Always emits `<link rel=canonical>` and `<meta property=og:type content=article>`.
+ * Adds `og:article:*` meta tags for any provided frontmatter fields.
+ *
+ * @param meta - Article frontmatter (publishedTime, modifiedTime, author, section, tags).
+ * @param canonicalUrl - The fully-qualified canonical URL for the article.
+ * @returns Ordered array of HeadElements ready to feed into `head.render()`.
+ */
+declare const buildArticleHead: (meta: ArticleMeta, canonicalUrl: string) => HeadElement[];
+//#endregion
+export { type ArticleMeta, type HeadElement, buildArticleHead, canonical, feedLink, hreflang, jsonLd, meta, og, twitter };

package/dist/plugins/head/build.d.mts

@@ -0,0 +1,17 @@
+import { a as meta, c as ArticleMeta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical, u as HeadElement } from "../../primitives-kuZFxqV7.mjs";
+
+//#region src/plugins/head/build.d.ts
+/**
+ * Build a list of head elements for an article page from its frontmatter.
+ * Pure function — safe to call at build time without a plugin context.
+ *
+ * Always emits `<link rel=canonical>` and `<meta property=og:type content=article>`.
+ * Adds `og:article:*` meta tags for any provided frontmatter fields.
+ *
+ * @param meta - Article frontmatter (publishedTime, modifiedTime, author, section, tags).
+ * @param canonicalUrl - The fully-qualified canonical URL for the article.
+ * @returns Ordered array of HeadElements ready to feed into `head.render()`.
+ */
+declare const buildArticleHead: (meta: ArticleMeta, canonicalUrl: string) => HeadElement[];
+//#endregion
+export { type ArticleMeta, type HeadElement, buildArticleHead, canonical, feedLink, hreflang, jsonLd, meta, og, twitter };

package/dist/plugins/head/build.mjs

@@ -0,0 +1,27 @@
+import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "../../primitives-gO5i1tD8.mjs";
+
+//#region src/plugins/head/build.ts
+/** @file Sub-path /build entry — pure build-time helpers (no plugin state access). */
+/**
+* Build a list of head elements for an article page from its frontmatter.
+* Pure function — safe to call at build time without a plugin context.
+*
+* Always emits `<link rel=canonical>` and `<meta property=og:type content=article>`.
+* Adds `og:article:*` meta tags for any provided frontmatter fields.
+*
+* @param meta - Article frontmatter (publishedTime, modifiedTime, author, section, tags).
+* @param canonicalUrl - The fully-qualified canonical URL for the article.
+* @returns Ordered array of HeadElements ready to feed into `head.render()`.
+*/
+const buildArticleHead = (meta, canonicalUrl) => {
+	const elements = [canonical(canonicalUrl), og("type", "article")];
+	if (meta.publishedTime) elements.push(og("article:published_time", meta.publishedTime));
+	if (meta.modifiedTime) elements.push(og("article:modified_time", meta.modifiedTime));
+	if (meta.author) elements.push(og("article:author", meta.author));
+	if (meta.section) elements.push(og("article:section", meta.section));
+	if (meta.tags) for (const tag of meta.tags) elements.push(og("article:tag", tag));
+	return elements;
+};
+
+//#endregion
+export { buildArticleHead, canonical, feedLink, hreflang, jsonLd, meta, og, twitter };

package/dist/plugins/spa/index.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_factory = require('../../factory-CixCpR9C.cjs');
+
+//#region src/plugins/spa/index.ts
+/** @file spa plugin: Very Complex tier — router + head + progress + components sub-modules. */
+const defaultConfig = {
+	config: {
+		viewTransitions: false,
+		progressBar: true
+	},
+	components: []
+};
+const spa = require_factory.createPlugin("spa", {
+	depends: [require_factory.router, require_factory.head],
+	config: defaultConfig,
+	events: require_factory.registerSpaEvents,
+	createState: require_factory.createSpaState,
+	api: require_factory.createSpaApi,
+	onStart: async (ctx) => {
+		if (typeof window !== "undefined") await require_factory.createClientRuntime(ctx).start();
+	}
+});
+
+//#endregion
+exports.createComponent = require_factory.createComponent;
+exports.spa = spa;

package/dist/plugins/spa/index.d.cts

@@ -0,0 +1,30 @@
+import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-D0m7Xil2.cjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/plugins/spa/index.d.ts
+declare const spa: _moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  'component:create': {
+    name: string;
+    element: Element;
+  };
+  'component:mount': {
+    name: string;
+    element: Element;
+  };
+  'component:unmount': {
+    name: string;
+    reason: "navigation" | "destroy";
+  };
+  'component:destroy': {
+    name: string;
+  };
+  'nav:start': {
+    url: string;
+    fromUrl: string;
+  };
+  'nav:end': {
+    url: string;
+  };
+}> & Record<never, never>;
+//#endregion
+export { createComponent, spa };

package/dist/plugins/spa/index.d.mts

@@ -0,0 +1,30 @@
+import { a as SpaConfig, i as SpaApi, o as SpaState, t as createComponent } from "../../factory-BBVQO5ZG.mjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/plugins/spa/index.d.ts
+declare const spa: _moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  'component:create': {
+    name: string;
+    element: Element;
+  };
+  'component:mount': {
+    name: string;
+    element: Element;
+  };
+  'component:unmount': {
+    name: string;
+    reason: "navigation" | "destroy";
+  };
+  'component:destroy': {
+    name: string;
+  };
+  'nav:start': {
+    url: string;
+    fromUrl: string;
+  };
+  'nav:end': {
+    url: string;
+  };
+}> & Record<never, never>;
+//#endregion
+export { createComponent, spa };

package/dist/plugins/spa/index.mjs

@@ -0,0 +1,24 @@
+import { a as createSpaApi, i as createClientRuntime, n as createSpaState, o as head, p as createPlugin, r as registerSpaEvents, s as router, t as createComponent } from "../../factory-DwpBwjDk.mjs";
+
+//#region src/plugins/spa/index.ts
+/** @file spa plugin: Very Complex tier — router + head + progress + components sub-modules. */
+const defaultConfig = {
+	config: {
+		viewTransitions: false,
+		progressBar: true
+	},
+	components: []
+};
+const spa = createPlugin("spa", {
+	depends: [router, head],
+	config: defaultConfig,
+	events: registerSpaEvents,
+	createState: createSpaState,
+	api: createSpaApi,
+	onStart: async (ctx) => {
+		if (typeof window !== "undefined") await createClientRuntime(ctx).start();
+	}
+});
+
+//#endregion
+export { createComponent, spa };

package/dist/primitives-BBo4wxUL.d.cts

@@ -0,0 +1,69 @@
+//#region src/plugins/head/types.d.ts
+/** @file head plugin types — HeadElement, HeadConfig, ArticleMeta, OGImageConfig. */
+type HeadElement = {
+  tag: 'meta' | 'link' | 'script' | 'title';
+  attrs: Record<string, string>;
+  content?: string;
+};
+type HeadConfig = {
+  title?: string;
+  elements?: HeadElement[];
+};
+type ArticleMeta = {
+  publishedTime?: string;
+  modifiedTime?: string;
+  author?: string;
+  tags?: string[];
+  section?: string;
+};
+type OGFontConfig = {
+  subset: string;
+  weights: number[];
+};
+type OGImageConfig = {
+  template?: unknown;
+  fontDir?: string;
+  fontName?: string;
+  fonts?: OGFontConfig[];
+};
+type HeadPluginConfig = {
+  ogImage?: OGImageConfig;
+  titleSeparator?: string;
+  autoCanonical?: boolean;
+};
+type HeadState = {
+  config: Readonly<HeadPluginConfig>;
+  ogImageDefaults: Readonly<OGImageConfig> | null;
+};
+type RenderContext = {
+  url: string;
+  locale: string;
+};
+type HeadApi = {
+  render(config: HeadConfig, ctx: RenderContext): string;
+  primitives: {
+    meta(name: string, content: string): HeadElement;
+    og(property: string, content: string): HeadElement;
+    jsonLd(data: unknown): HeadElement;
+    canonical(url: string): HeadElement;
+    hreflang(locale: string, url: string): HeadElement;
+    twitter(name: string, content: string): HeadElement;
+    feedLink(title: string, url: string, type?: 'rss' | 'atom'): HeadElement;
+  };
+  buildArticleHead(meta: ArticleMeta, canonicalUrl: string): HeadElement[];
+};
+//#endregion
+//#region src/plugins/head/primitives.d.ts
+declare const meta: (name: string, content: string) => HeadElement;
+declare const og: (property: string, content: string) => HeadElement;
+/**
+ * JSON-LD with unicode-escape XSS protection. `JSON.stringify` alone is exploitable via `</script>` injection.
+ * Escape sequence prevents script-context breakout. NEVER add an `unsafe: true` opt-out — this is non-negotiable.
+ */
+declare const jsonLd: (data: unknown) => HeadElement;
+declare const canonical: (url: string) => HeadElement;
+declare const hreflang: (locale: string, url: string) => HeadElement;
+declare const twitter: (name: string, content: string) => HeadElement;
+declare const feedLink: (title: string, url: string, type?: "rss" | "atom") => HeadElement;
+//#endregion
+export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };

package/dist/primitives-BYUp6kae.cjs

@@ -0,0 +1,100 @@
+
+//#region src/plugins/head/primitives.ts
+const meta = (name, content) => ({
+	tag: "meta",
+	attrs: {
+		name,
+		content
+	}
+});
+const og = (property, content) => ({
+	tag: "meta",
+	attrs: {
+		property: `og:${property}`,
+		content
+	}
+});
+/**
+* JSON-LD with unicode-escape XSS protection. `JSON.stringify` alone is exploitable via `<\/script>` injection.
+* Escape sequence prevents script-context breakout. NEVER add an `unsafe: true` opt-out — this is non-negotiable.
+*/
+const jsonLd = (data) => ({
+	tag: "script",
+	attrs: { type: "application/ld+json" },
+	content: JSON.stringify(data).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026")
+});
+const canonical = (url) => ({
+	tag: "link",
+	attrs: {
+		rel: "canonical",
+		href: url
+	}
+});
+const hreflang = (locale, url) => ({
+	tag: "link",
+	attrs: {
+		rel: "alternate",
+		hreflang: locale,
+		href: url
+	}
+});
+const twitter = (name, content) => ({
+	tag: "meta",
+	attrs: {
+		name: `twitter:${name}`,
+		content
+	}
+});
+const feedLink = (title, url, type = "rss") => ({
+	tag: "link",
+	attrs: {
+		rel: "alternate",
+		type: type === "rss" ? "application/rss+xml" : "application/atom+xml",
+		title,
+		href: url
+	}
+});
+
+//#endregion
+Object.defineProperty(exports, 'canonical', {
+  enumerable: true,
+  get: function () {
+    return canonical;
+  }
+});
+Object.defineProperty(exports, 'feedLink', {
+  enumerable: true,
+  get: function () {
+    return feedLink;
+  }
+});
+Object.defineProperty(exports, 'hreflang', {
+  enumerable: true,
+  get: function () {
+    return hreflang;
+  }
+});
+Object.defineProperty(exports, 'jsonLd', {
+  enumerable: true,
+  get: function () {
+    return jsonLd;
+  }
+});
+Object.defineProperty(exports, 'meta', {
+  enumerable: true,
+  get: function () {
+    return meta;
+  }
+});
+Object.defineProperty(exports, 'og', {
+  enumerable: true,
+  get: function () {
+    return og;
+  }
+});
+Object.defineProperty(exports, 'twitter', {
+  enumerable: true,
+  get: function () {
+    return twitter;
+  }
+});

package/dist/primitives-gO5i1tD8.mjs

@@ -0,0 +1,58 @@
+//#region src/plugins/head/primitives.ts
+const meta = (name, content) => ({
+	tag: "meta",
+	attrs: {
+		name,
+		content
+	}
+});
+const og = (property, content) => ({
+	tag: "meta",
+	attrs: {
+		property: `og:${property}`,
+		content
+	}
+});
+/**
+* JSON-LD with unicode-escape XSS protection. `JSON.stringify` alone is exploitable via `<\/script>` injection.
+* Escape sequence prevents script-context breakout. NEVER add an `unsafe: true` opt-out — this is non-negotiable.
+*/
+const jsonLd = (data) => ({
+	tag: "script",
+	attrs: { type: "application/ld+json" },
+	content: JSON.stringify(data).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026")
+});
+const canonical = (url) => ({
+	tag: "link",
+	attrs: {
+		rel: "canonical",
+		href: url
+	}
+});
+const hreflang = (locale, url) => ({
+	tag: "link",
+	attrs: {
+		rel: "alternate",
+		hreflang: locale,
+		href: url
+	}
+});
+const twitter = (name, content) => ({
+	tag: "meta",
+	attrs: {
+		name: `twitter:${name}`,
+		content
+	}
+});
+const feedLink = (title, url, type = "rss") => ({
+	tag: "link",
+	attrs: {
+		rel: "alternate",
+		type: type === "rss" ? "application/rss+xml" : "application/atom+xml",
+		title,
+		href: url
+	}
+});
+
+//#endregion
+export { meta as a, jsonLd as i, feedLink as n, og as o, hreflang as r, twitter as s, canonical as t };

package/dist/primitives-kuZFxqV7.d.mts

@@ -0,0 +1,69 @@
+//#region src/plugins/head/types.d.ts
+/** @file head plugin types — HeadElement, HeadConfig, ArticleMeta, OGImageConfig. */
+type HeadElement = {
+  tag: 'meta' | 'link' | 'script' | 'title';
+  attrs: Record<string, string>;
+  content?: string;
+};
+type HeadConfig = {
+  title?: string;
+  elements?: HeadElement[];
+};
+type ArticleMeta = {
+  publishedTime?: string;
+  modifiedTime?: string;
+  author?: string;
+  tags?: string[];
+  section?: string;
+};
+type OGFontConfig = {
+  subset: string;
+  weights: number[];
+};
+type OGImageConfig = {
+  template?: unknown;
+  fontDir?: string;
+  fontName?: string;
+  fonts?: OGFontConfig[];
+};
+type HeadPluginConfig = {
+  ogImage?: OGImageConfig;
+  titleSeparator?: string;
+  autoCanonical?: boolean;
+};
+type HeadState = {
+  config: Readonly<HeadPluginConfig>;
+  ogImageDefaults: Readonly<OGImageConfig> | null;
+};
+type RenderContext = {
+  url: string;
+  locale: string;
+};
+type HeadApi = {
+  render(config: HeadConfig, ctx: RenderContext): string;
+  primitives: {
+    meta(name: string, content: string): HeadElement;
+    og(property: string, content: string): HeadElement;
+    jsonLd(data: unknown): HeadElement;
+    canonical(url: string): HeadElement;
+    hreflang(locale: string, url: string): HeadElement;
+    twitter(name: string, content: string): HeadElement;
+    feedLink(title: string, url: string, type?: 'rss' | 'atom'): HeadElement;
+  };
+  buildArticleHead(meta: ArticleMeta, canonicalUrl: string): HeadElement[];
+};
+//#endregion
+//#region src/plugins/head/primitives.d.ts
+declare const meta: (name: string, content: string) => HeadElement;
+declare const og: (property: string, content: string) => HeadElement;
+/**
+ * JSON-LD with unicode-escape XSS protection. `JSON.stringify` alone is exploitable via `</script>` injection.
+ * Escape sequence prevents script-context breakout. NEVER add an `unsafe: true` opt-out — this is non-negotiable.
+ */
+declare const jsonLd: (data: unknown) => HeadElement;
+declare const canonical: (url: string) => HeadElement;
+declare const hreflang: (locale: string, url: string) => HeadElement;
+declare const twitter: (name: string, content: string) => HeadElement;
+declare const feedLink: (title: string, url: string, type?: "rss" | "atom") => HeadElement;
+//#endregion
+export { meta as a, ArticleMeta as c, HeadPluginConfig as d, HeadState as f, jsonLd as i, HeadApi as l, feedLink as n, og as o, OGImageConfig as p, hreflang as r, twitter as s, canonical as t, HeadElement as u };