@brightsideoy/kama 1.0.0-alpha.16 → 1.0.0-alpha.18

package/dist/index.html

@@ -6,9 +6,40 @@
     <title>KAMA</title>
     <link rel="icon" href="/favicon.png">
     <link rel="apple-touch-icon" sizes="180x180" href="/favicon.png">
-    <script type="module" crossorigin src="/assets/index-CHczMewv.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-CTn6xl4w.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-BbV9FaG-.css">
+    <script type="module" crossorigin src="/assets/index-AQYAbg3R.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/_plugin-vue_export-helper-CQxWhVtr.js">
+    <link rel="modulepreload" crossorigin href="/assets/schema-helpers-1UXlO0Ye.js">
+    <link rel="modulepreload" crossorigin href="/assets/useNodes-W5j_uxdQ.js">
+    <link rel="modulepreload" crossorigin href="/assets/plus-mqZr4I1D.js">
+    <link rel="modulepreload" crossorigin href="/assets/send-F-mJeL54.js">
+    <link rel="modulepreload" crossorigin href="/assets/CmsPaneResizer-B62ZqsnE.js">
+    <link rel="modulepreload" crossorigin href="/assets/user-IFlT6mYq.js">
+    <link rel="modulepreload" crossorigin href="/assets/useLocalStorage-C805uplI.js">
+    <link rel="modulepreload" crossorigin href="/assets/circle-check-A-QeFqt3.js">
+    <link rel="modulepreload" crossorigin href="/assets/loader-circle-BoUkhDjq.js">
+    <link rel="modulepreload" crossorigin href="/assets/CmsImagePreview-DuHPBzml.js">
+    <link rel="modulepreload" crossorigin href="/assets/database-hg5SqKLG.js">
+    <link rel="modulepreload" crossorigin href="/assets/NodeContextMenu-C_HWBGeb.js">
+    <link rel="modulepreload" crossorigin href="/assets/monitor-CrpvInqG.js">
+    <link rel="modulepreload" crossorigin href="/assets/rotate-ccw-CWE4pOjs.js">
+    <link rel="modulepreload" crossorigin href="/assets/trash-2-CAUF1KtI.js">
+    <link rel="modulepreload" crossorigin href="/assets/folder-tree-BWYot72H.js">
+    <link rel="modulepreload" crossorigin href="/assets/globe-BraoljaN.js">
+    <link rel="modulepreload" crossorigin href="/assets/history-pqIbKK9u.js">
+    <link rel="modulepreload" crossorigin href="/assets/layers-B6RgfpPR.js">
+    <link rel="modulepreload" crossorigin href="/assets/panel-left-close-CVFakVaA.js">
+    <link rel="modulepreload" crossorigin href="/assets/save-Ctv8vW9H.js">
+    <link rel="modulepreload" crossorigin href="/assets/smartphone-EPce6VdP.js">
+    <link rel="modulepreload" crossorigin href="/assets/CmsButton-CbOfxvjr.js">
+    <link rel="modulepreload" crossorigin href="/assets/CmsDataRow--H4iI_u_.js">
+    <link rel="modulepreload" crossorigin href="/assets/CmsBadge-D0Ob9qPU.js">
+    <link rel="stylesheet" crossorigin href="/assets/CmsPaneResizer-Dkidd4pI.css">
+    <link rel="stylesheet" crossorigin href="/assets/CmsImagePreview-CujwG8r_.css">
+    <link rel="stylesheet" crossorigin href="/assets/NodeContextMenu-BYeWzmQ5.css">
+    <link rel="stylesheet" crossorigin href="/assets/CmsButton-BQ85-YXn.css">
+    <link rel="stylesheet" crossorigin href="/assets/CmsDataRow-CYNxfVaZ.css">
+    <link rel="stylesheet" crossorigin href="/assets/CmsBadge-BNsgxyyB.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DcKiaRjI.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/index.js

@@ -20777,9 +20777,14 @@ var Tb = /* @__PURE__ */ o({
 			label: "Category",
 			hierarchical: !0,
 			fields: {
+				label: {
+					type: "text",
+					label: "Label",
+					required: !0,
+					rules: { required: !0 }
+				},
 				slug: {
-					label: "Slug",
-					linkedTo: "key",
+					linkedTo: "label",
 					rules: {}
 				},
 				description: {
@@ -20807,9 +20812,14 @@ var Tb = /* @__PURE__ */ o({
 			label: "Tag",
 			hierarchical: !1,
 			fields: {
+				label: {
+					type: "text",
+					label: "Label",
+					required: !0,
+					rules: { required: !0 }
+				},
 				slug: {
-					label: "Slug",
-					linkedTo: "key",
+					linkedTo: "label",
 					rules: {}
 				},
 				iconName: {
@@ -21268,6 +21278,13 @@ var Tb = /* @__PURE__ */ o({
 					default: 0,
 					public: !0,
 					rules: {}
+				},
+				targetPage: {
+					label: "Target Page for \"Read More\" Links",
+					type: "link",
+					public: !0,
+					allowedLinkTypes: ["tree", "node"],
+					rules: {}
 				}
 			},
 			tabs: { access: {
@@ -21407,6 +21424,54 @@ var Tb = /* @__PURE__ */ o({
 				}
 			},
 			category: "Content"
+		},
+		form: {
+			id: "form",
+			label: "Dynamic Form",
+			description: "Embeds a form definition from content/forms/",
+			category: "Interactive",
+			icon: "ClipboardList",
+			fieldSets: ["access"],
+			fields: {
+				formId: {
+					label: "Select Form",
+					type: "select",
+					required: !0,
+					description: "Choose a YAML form definition",
+					optionsEndpoint: "/api/admin/ext/kama-forms/forms",
+					optionsValueKey: "id",
+					optionsLabelKey: "title",
+					rules: { required: !0 }
+				},
+				isHidden: {
+					type: "boolean",
+					label: "Hidden",
+					default: !1,
+					public: !1,
+					variant: "danger",
+					dbType: "integer",
+					index: !0,
+					position: "sidebar",
+					liveSync: !0,
+					rules: {}
+				},
+				startShowingAt: {
+					type: "datetime",
+					label: "Start Showing At",
+					position: "sidebar",
+					public: !1,
+					index: !0,
+					rules: {}
+				},
+				stopShowingAt: {
+					type: "datetime",
+					label: "Stop Showing At",
+					position: "sidebar",
+					public: !1,
+					index: !0,
+					rules: {}
+				}
+			}
 		}
 	},
 	nodeLayouts: {
@@ -22225,11 +22290,14 @@ async function jb(e, t) {
 		return /* @__PURE__ */ new Set();
 	}
 }
-async function Mb(e, t) {
+async function Mb(e, t, n = []) {
 	try {
 		await e.prepare("PRAGMA foreign_keys = ON;").run();
 	} catch {}
 	for (let [t, n] of Object.entries(Ob)) await e.prepare(`CREATE TABLE IF NOT EXISTS "${t}" (${n});`).run();
+	if (n && n.length > 0) {
+		for (let t of n) if (t.db && t.db.tables) for (let [n, r] of Object.entries(t.db.tables)) (await jb(e, n)).size === 0 && (await e.prepare(`CREATE TABLE IF NOT EXISTS "${n}" (${r});`).run(), console.log(`[Extension: ${t.id}] Created database table: ${n}`));
+	}
 	for (let [t] of Object.entries(Ob)) {
 		let n = await jb(e, t);
 		if (n.size > 0) {
@@ -22274,11 +22342,11 @@ async function Mb(e, t) {
 	for (let t of kb) try {
 		await e.prepare(t).run();
 	} catch {}
-	let n = t || Db;
-	for (let t of Ab(n?.rawNodes || {})) try {
+	let r = t || Db;
+	for (let t of Ab(r?.rawNodes || {})) try {
 		await e.prepare(t).run();
 	} catch {}
-	await Nb(e, n);
+	await Nb(e, r);
 }
 async function Nb(e, t) {
 	if (t) for (let [n, r] of Object.entries(t.rawNodes || {})) {
@@ -25238,13 +25306,15 @@ function qx() {
 			t = e;
 			break;
 		}
-		if (!t) return null;
-		let i = (e) => {
+		let i = Rx.resolve(e, "extensions"), a = Lx.existsSync(i);
+		if (!t && !a) return null;
+		let o = (e, t) => {
+			if (!e) return {};
 			let n = "";
-			for (let r of e) {
-				let e = Rx.join(t, r);
-				if (Lx.existsSync(e)) {
-					n = e;
+			for (let r of t) {
+				let t = Rx.join(e, r);
+				if (Lx.existsSync(t)) {
+					n = t;
 					break;
 				}
 			}
@@ -25260,24 +25330,46 @@ function qx() {
 				}
 			}
 			return r;
-		};
+		}, s = o(t, ["nodes", "node"]), c = o(t, ["trees", "tree"]), l = o(t, ["channels", "channel"]), u = o(t, ["taxonomies", "taxonomy"]), d = o(t, [
+			"blocks",
+			"elements",
+			"block"
+		]), f = o(t, [
+			"node-layouts",
+			"layouts",
+			"layout"
+		]), p = o(t, ["block-layouts"]), m = o(t, ["field-sets", "fieldsets"]);
+		if (a) {
+			let e = Lx.readdirSync(i);
+			for (let t of e) {
+				let e = Rx.join(i, t);
+				if (Lx.statSync(e).isDirectory()) {
+					let t = Rx.join(e, "content");
+					if (!Lx.existsSync(t)) {
+						let n = Rx.join(e, "content", "definitions");
+						Lx.existsSync(n) && (t = n);
+					}
+					Lx.existsSync(t) && (Object.assign(s, o(t, ["nodes", "node"])), Object.assign(c, o(t, ["trees", "tree"])), Object.assign(l, o(t, ["channels", "channel"])), Object.assign(u, o(t, ["taxonomies", "taxonomy"])), Object.assign(d, o(t, [
+						"blocks",
+						"elements",
+						"block"
+					])), Object.assign(f, o(t, [
+						"node-layouts",
+						"layouts",
+						"layout"
+					])), Object.assign(p, o(t, ["block-layouts"])), Object.assign(m, o(t, ["field-sets", "fieldsets"])));
+				}
+			}
+		}
 		return {
-			rawNodes: i(["nodes", "node"]),
-			rawTrees: i(["trees", "tree"]),
-			rawChannels: i(["channels", "channel"]),
-			rawTaxonomies: i(["taxonomies", "taxonomy"]),
-			rawBlocks: i([
-				"blocks",
-				"elements",
-				"block"
-			]),
-			rawNodeLayouts: i([
-				"node-layouts",
-				"layouts",
-				"layout"
-			]),
-			rawBlockLayouts: i(["block-layouts"]),
-			rawFieldSets: i(["field-sets", "fieldsets"])
+			rawNodes: s,
+			rawTrees: c,
+			rawChannels: l,
+			rawTaxonomies: u,
+			rawBlocks: d,
+			rawNodeLayouts: f,
+			rawBlockLayouts: p,
+			rawFieldSets: m
 		};
 	} catch (e) {
 		return console.error("❌ Exception inside readLocalFsBundle:", e), null;
@@ -25349,7 +25441,7 @@ function Zx(e) {
 		return Qx(t);
 	}
 	let t = qx();
-	return t && Object.keys(t.rawNodes || {}).length > 0 ? Qx(t) : Qx(null);
+	return t && (Object.keys(t.rawNodes || {}).length > 0 || Object.keys(t.rawBlocks || {}).length > 0) ? Qx(t) : Qx(null);
 }
 function Qx(e) {
 	if (!e) return {
@@ -27432,18 +27524,51 @@ $.use("*", t()), $.use("/media/*", t({
 	e.set("currentDomain", r);
 	let i = wb(e);
 	if (e.set("db", i), !vC) try {
-		await Mb(i), vC = !0;
+		await Mb(i, e.env?.BUNDLED_DEFINITIONS, e.env?.KAMA_EXTENSIONS), vC = !0;
 	} catch (e) {
 		console.error("❌ [CMS Server] Failed to initialize system tables on cold start:", e);
 	}
 	await t();
-}), $.route("/media", tC), $.use("/media/*", Pb()), $.route("/api/cms/nodes", gx), $.route("/api/cms/nodes.json", gx), $.route("/api/cms/formcsv", gx), $.route("/api/cms/formcsv.json", gx), $.route("/api/cms/stats", iS), $.route("/api/cms/stats.json", iS), $.route("/api/cms", Ox), $.route("/api/cms/trees.json", Ox), $.route("/api/cms/channels", Mx), $.route("/api/cms/channels.json", Mx), $.route("/api/cms/taxonomies", Nx), $.route("/api/cms/taxonomies.json", Nx), $.route("/api/cms/schemas", $x), $.route("/api/cms/schemas.json", $x), $.route("/api/cms", tS), $.route("/api/admin/assets", aS), $.use("/api/v1/*", async (e, t) => {
+}), $.route("/media", tC), $.use("/media/*", Pb()), $.get("/api/cms/ui-extensions", (e) => {
+	let t = (e.env?.KAMA_EXTENSIONS || []).filter((e) => e.ui).map((e) => ({
+		id: e.id,
+		name: e.name || e.id,
+		ui: e.ui
+	}));
+	return e.json(t);
+}), $.route("/api/cms/nodes", gx), $.route("/api/cms/nodes.json", gx), $.route("/api/cms/formcsv", gx), $.route("/api/cms/formcsv.json", gx), $.route("/api/cms/stats", iS), $.route("/api/cms/stats.json", iS), $.route("/api/cms", Ox), $.route("/api/cms/trees.json", Ox), $.route("/api/cms/channels", Mx), $.route("/api/cms/channels.json", Mx), $.route("/api/cms/taxonomies", Nx), $.route("/api/cms/taxonomies.json", Nx), $.route("/api/cms/schemas", $x), $.route("/api/cms/schemas.json", $x), $.route("/api/cms", tS), $.route("/api/admin/assets", aS), $.use("/api/v1/*", async (e, t) => {
 	let n = e.env?.FRONTEND_API_SECRET;
 	if (n) {
 		let t = e.req.header("Authorization"), r = e.req.header("x-api-key"), i = t?.startsWith("Bearer ") ? t.substring(7).trim() : r?.trim();
 		if (!i || i !== n) return e.json({ error: "Unauthorized: Invalid or missing API secret." }, 401);
 	} else console.warn("⚠️ [CMS Security] FRONTEND_API_SECRET is not set in .env. The API is completely exposed to the public.");
 	return t();
+}), $.use("/api/v1/ext/*", async (e, t) => {
+	let n = e.env?.KAMA_EXTENSIONS || [], r = e.req.path.match(/^\/api\/v1\/ext\/([^/]+)/);
+	if (r) {
+		let t = r[1], i = n.find((e) => e.id === t);
+		if (i && i.routes?.public) {
+			let t = {
+				...e.env,
+				KAMA_DB: e.get("db")
+			};
+			return i.routes.public.fetch(e.req.raw, t, e.executionCtx);
+		}
+	}
+	return t();
+}), $.use("/api/admin/ext/*", async (e, t) => {
+	let n = e.env?.KAMA_EXTENSIONS || [], r = e.req.path.match(/^\/api\/admin\/ext\/([^/]+)/);
+	if (r) {
+		let t = r[1], i = n.find((e) => e.id === t);
+		if (i && i.routes?.admin) {
+			let t = {
+				...e.env,
+				KAMA_DB: e.get("db")
+			};
+			return i.routes.admin.fetch(e.req.raw, t, e.executionCtx);
+		}
+	}
+	return t();
 }), $.route("/api/v1/node", lS), $.route("/api/v1/nodes", kS), $.route("/api/v1/tree", NS), $.route("/api/v1/channel", HS), $.route("/api/v1/all-paths", oC), $.route("/api/v1/taxonomies", fC), $.doc("/api/openapi.json", {
 	openapi: "3.0.0",
 	info: {

package/dist/schema-compiler.js

@@ -30,7 +30,7 @@ async function f() {
 	if (n(f)) l = (await import(t(f).href)).compileDefinitions;
 	else if (n(p)) l = (await import(t(p).href)).compileDefinitions;
 	else try {
-		l = (await import("./dist-Ca4GRlV3.js")).compileDefinitions;
+		l = (await import("./dist-Bta0OpXl.js")).compileDefinitions;
 	} catch (e) {
 		console.error("\x1B[31m  ✖\x1B[0m \x1B[31mCould not resolve Kama Schema Engine:\x1B[0m", e), process.exit(1);
 	}

package/documentation/EXTENSIONS.md

@@ -0,0 +1,204 @@
+# KAMA CMS — Extension Development Guide
+
+KAMA features a **Drop-In Extension Architecture**. Extensions are built using native TypeScript, Vue, and YAML, and are automatically discovered, registered, and compiled into the Cloudflare Worker and Vite SPA at build time.
+
+This guarantees zero core bloat, perfect native performance, and a completely isolated development environment.
+
+## 1. How It Works (The Auto-Discovery Pipeline)
+
+Extensions live in the `extensions/` directory at the root of your workspace.
+
+When you run `npm run dev` or `npm run build:schema`, the KAMA CLI automatically:
+
+1. Scans the `extensions/` folder.
+2. Generates an `extension-registry.js` file.
+3. Injects your Database tables into the SQLite/D1 initialization sequence.
+4. Mounts your Hono API routes securely behind KAMA's authentication.
+5. Injects your Vue `.vue` components into the SPA routing and sidebars.
+6. Merges your extension's `.yaml` schemas natively into the core bundle.
+
+---
+
+## 2. Directory Structure
+
+A standard extension uses the following structure:
+
+kama-workspace/
+├─ extensions/
+│ └─ forms/ <-- Your Extension Folder
+│ ├─ index.ts <-- The Manifest (Exports UI, DB, and Routes)
+│ ├─ api/
+│ │ ├─ admin.ts <-- Hono routes for the Admin UI
+│ │ └─ public.ts <-- Hono routes for the Public API
+│ ├─ ui/
+│ │ ├─ SidebarPane.vue <-- Custom Left Drawer Vue Component
+│ │ └─ Dashboard.vue <-- Custom Main Workspace Vue Component
+│ └─ content/ <-- 🎯 Schema folder matching Core
+│ └─ blocks/
+│ └─ form-block.yaml <-- YAML Schemas (Auto-merged into KAMA)
+
+---
+
+## 3. The Extension Manifest (`index.ts`)
+
+Every extension must export a default object serving as the contract between your code and the KAMA core.
+
+// extensions/forms/index.ts
+import { adminFormsRouter } from "./api/admin.js";
+import { publicFormsRouter } from "./api/public.js";
+
+export default {
+id: "kama-forms",
+name: "Form Builder",
+
+// 🎯 1. DATABASE HOOKS
+// KAMA will automatically CREATE TABLE IF NOT EXISTS on boot.
+db: {
+tables: {
+kama_forms_table: `         id INTEGER PRIMARY KEY AUTOINCREMENT,
+        form_id TEXT NOT NULL,
+        payload_json TEXT NOT NULL,
+        createdAt TEXT DEFAULT CURRENT_TIMESTAMP
+      `,
+},
+},
+
+// 🎯 2. API ROUTING HOOKS
+// Handled natively by Hono. KAMA injects c.env.DB automatically.
+routes: {
+public: publicFormsRouter, // Mounted at: /api/ext/kama-forms/_
+admin: adminFormsRouter, // Mounted at: /api/admin/ext/kama-forms/_
+},
+
+// 🎯 3. FRONTEND UI HOOKS
+ui: {
+sidebar: [
+{
+id: "forms-nav",
+label: "Forms",
+icon: "Inbox", // Uses KAMA's global icon resolver
+sidebarViewId: "forms-sidebar", // 🎯 Renders in the left drawer panel
+viewId: "forms-dashboard", // 🎯 Renders in the main workspace canvas
+},
+],
+
+    // Map your view IDs to your Vue component chunks
+    views: [
+      { id: "forms-sidebar", url: "/api/ext/kama-forms/ui-pane.js" },
+      { id: "forms-dashboard", url: "/api/ext/kama-forms/ui.js" }
+    ],
+
+},
+};
+
+---
+
+## 4. API Routing (`api/admin.ts`)
+
+Extension APIs are built using standard Hono syntax.
+
+**Important:** Your extension routes do not need to connect to the database manually. KAMA intercepts the request and injects the active database connection directly into the request context.
+
+// extensions/forms/api/admin.ts
+import { Hono } from "hono";
+export const adminFormsRouter = new Hono();
+
+adminFormsRouter.get("/submissions", async (c) => {
+// Access the core database connection
+const db = (c as any).env?.DB;
+const formId = c.req.query("formId");
+
+const stmt = db.prepare("SELECT \* FROM kama_forms_table WHERE form_id = ? ORDER BY createdAt DESC");
+const results = typeof stmt.all === "function" ? await stmt.bind(formId).all() : [];
+
+return c.json({ submissions: results?.results || results || [] });
+});
+
+---
+
+## 5. Frontend UI & Cross-Component Communication
+
+KAMA enforces strict decoupling. Extensions shouldn't mutate core routing states directly. Instead, KAMA provides generic Event Buses and State Stores.
+
+### Triggering Workspace Navigation
+
+If a user clicks an item in your left `SidebarPane.vue` and you want to open your main `Dashboard.vue` in the primary workspace, dispatch a standard custom event. Core KAMA listens to this universally:
+
+// Inside extensions/forms/ui/SidebarPane.vue
+const openWorkspaceView = () => {
+window.dispatchEvent(new CustomEvent('cms-open-extension-view', {
+detail: { viewId: 'forms-dashboard' }
+}));
+};
+
+### Passing State Between Extension Components
+
+To pass data (like a selected Form ID) from your Sidebar to your Dashboard, use the global `window.Kama` SDK:
+
+**Setting State & Emitting Events (Sidebar):**
+
+// Set state synchronously
+(window as any).Kama?.state?.set('kama-forms', 'activeFormId', 'contact-form');
+
+// Notify other components live
+(window as any).Kama?.events?.emit('kama-forms:select-form', { formId: 'contact-form' });
+
+**Listening for State (Dashboard):**
+
+// Read initial state on mount
+const initialId = (window as any).Kama?.state?.get('kama-forms', 'activeFormId');
+
+// Listen for live changes
+(window as any).Kama?.events?.on('kama-forms:select-form', (payload) => {
+console.log("Form Selected:", payload.formId);
+});
+
+---
+
+## 6. Extension YAML Schemas (`content/`)
+
+Extensions can bundle their own content schemas (Nodes, Blocks, Taxonomies). Place them in your extension's `content/` folder (e.g., `extensions/forms/content/blocks/form.yaml`).
+
+Run `npm run build:schema` to compile them automatically into KAMA.
+
+### 🎯 NEW: Dynamic API Dropdowns (`optionsEndpoint`)
+
+KAMA's frontend features Universal Async Field fetching. You can define a `select` or `pills` field that dynamically pulls its options from your extension's API endpoint!
+
+**Example YAML Block Definition:**
+
+# extensions/forms/content/blocks/form-block.yaml
+
+id: form
+label: Dynamic Form
+description: Embeds a form definition into the page.
+category: Interactive
+icon: ClipboardList
+
+# You can inherit standard KAMA fieldsets!
+
+fieldSets:
+
+- access
+
+fields:
+
+# This dropdown populates automatically via your API!
+
+formId:
+label: Select Form
+type: select
+required: true
+optionsEndpoint: /api/admin/ext/kama-forms/forms
+optionsValueKey: id # Maps to the option value
+optionsLabelKey: title # Maps to the visible label
+
+---
+
+## 7. Caching and Extension Updates
+
+Because KAMA caches HTML at the Edge (Cloudflare CDN) and inside Worker KV:
+
+If your extension API modifies public-facing content (e.g., approving a review, updating inventory), your extension's Hono router must manually trigger KAMA's cache purger to drop the cached Edge pages.
+
+_(Note: KAMA's `EdgeCacheManager` is currently scoped to the core, so for now, extensions should rely on KAMA's internal APIs or direct node updates if immediate Edge Purging is required)._

package/extension-registry.js

@@ -0,0 +1,5 @@
+import kamaForms from './extensions/kama-forms/index.ts';
+
+export const activeExtensions = [
+  kamaForms
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightsideoy/kama",
-  "version": "1.0.0-alpha.16",
+  "version": "1.0.0-alpha.18",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -54,6 +54,7 @@
     "@tiptap/vue-3": "^3.30.0",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.13.2",
+    "js-yaml": "^5.5.0",
     "locale-codes": "^1.3.1",
     "lru-cache": "^11.5.2",
     "lucide-vue-next": "^1.0.0",
@@ -68,6 +69,7 @@
     "@iconify-json/heroicons": "^1.2.3",
     "@iconify-json/lucide": "^1.2.123",
     "@libsql/client": "^0.14.0",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^26.2.0",
     "@types/sharp": "^0.31.1",
     "@types/yaml": "^1.9.6",