@stackbox/cms 0.0.5 → 0.1.1

package/dist/plugin.js

@@ -0,0 +1,156 @@
+import { cpSync, existsSync, mkdirSync, statSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+export class PluginError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PluginError";
+    }
+}
+function requireNonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new PluginError(`createPlugin(): ${label} is required`);
+    }
+    return value.trim();
+}
+function assertSafePluginName(name) {
+    if (name === "." ||
+        name === ".." ||
+        name.includes("/") ||
+        name.includes("\\")) {
+        throw new PluginError(`createPlugin(): name must be a single path segment (got "${name}")`);
+    }
+}
+function requireKeywords(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new PluginError("createPlugin(): keywords must be a non-empty array of strings");
+    }
+    const keywords = value.map((keyword, index) => {
+        if (typeof keyword !== "string" || keyword.trim().length === 0) {
+            throw new PluginError(`createPlugin(): keywords[${index}] must be a non-empty string`);
+        }
+        return keyword.trim();
+    });
+    return Object.freeze(keywords);
+}
+function requireRootDir(root) {
+    return resolve(requireNonEmptyString(root, "root"));
+}
+/**
+ * When a plugin is compiled to `dist/plugins/<folder>`, `assets/` and
+ * `public_assets/` may still live next to the TypeScript source.
+ * Uses the on-disk folder name, which can differ from `plugin.name`.
+ */
+function sourcePluginSubdir(root, folder) {
+    const needle = `${sep}dist${sep}plugins${sep}`;
+    const index = root.lastIndexOf(needle);
+    if (index === -1) {
+        return null;
+    }
+    const dirName = root.slice(index + needle.length).split(sep)[0];
+    if (!dirName) {
+        return null;
+    }
+    const candidate = join(root.slice(0, index), "src", "plugins", dirName, folder);
+    return existsSync(candidate) ? candidate : null;
+}
+function resolvePluginSubdir(root, folder) {
+    const local = join(root, folder);
+    if (existsSync(local)) {
+        return local;
+    }
+    return sourcePluginSubdir(root, folder) ?? local;
+}
+export function createPlugin(options) {
+    if (!options || typeof options !== "object" || Array.isArray(options)) {
+        throw new PluginError("createPlugin(): name, description, version, keywords, and root are required");
+    }
+    const name = requireNonEmptyString(options.name, "name");
+    assertSafePluginName(name);
+    const description = requireNonEmptyString(options.description, "description");
+    const version = requireNonEmptyString(options.version, "version");
+    const keywords = requireKeywords(options.keywords);
+    const root = requireRootDir(options.root);
+    return {
+        __kind: "plugin",
+        name,
+        description,
+        version,
+        keywords,
+        root,
+        assetsDir: resolvePluginSubdir(root, "assets"),
+        publicAssetsDir: resolvePluginSubdir(root, "public_assets"),
+        ...(options.routes ? { routes: options.routes } : {}),
+        ...(options.build ? { build: options.build } : {}),
+        ...(options.hooks ? { hooks: options.hooks } : {}),
+    };
+}
+export function isPlugin(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__kind === "plugin" &&
+        typeof value.name === "string" &&
+        value.name.length > 0 &&
+        typeof value.description === "string" &&
+        value.description.length > 0 &&
+        typeof value.version === "string" &&
+        value.version.length > 0 &&
+        Array.isArray(value.keywords) &&
+        value.keywords.length > 0 &&
+        typeof value.root === "string" &&
+        typeof value.assetsDir === "string" &&
+        typeof value.publicAssetsDir === "string");
+}
+export function assertPlugin(value, label = "plugin") {
+    if (!isPlugin(value)) {
+        throw new PluginError(`${label}: each plugin must be created with createPlugin() and include name, description, version, and keywords`);
+    }
+    return value;
+}
+function copyDirIfPresent(source, dest) {
+    if (!existsSync(source) || !statSync(source).isDirectory()) {
+        return;
+    }
+    if (resolve(source) === resolve(dest)) {
+        return;
+    }
+    mkdirSync(dest, { recursive: true });
+    cpSync(source, dest, { recursive: true });
+}
+/**
+ * Copy each registered plugin's private `assets/` next to its compiled entry
+ * (`{plugin.root}/assets`). Used by this package's build — not a site public copy.
+ */
+export function copyPluginPrivateAssets(plugins) {
+    for (const plugin of plugins) {
+        assertPlugin(plugin, "copyPluginPrivateAssets()");
+        copyDirIfPresent(plugin.assetsDir, join(plugin.root, "assets"));
+    }
+}
+/**
+ * Copy each registered plugin's `public_assets/` to
+ * `{publicDir}/_sb/plugins/{name}/`. Only plugins you pass in are copied.
+ */
+export function copyRegisteredPluginAssets(plugins, publicDir) {
+    const destRoot = requireNonEmptyString(publicDir, "publicDir");
+    const seen = new Set();
+    for (const plugin of plugins) {
+        assertPlugin(plugin, "copyRegisteredPluginAssets()");
+        if (seen.has(plugin.name)) {
+            throw new PluginError(`copyRegisteredPluginAssets(): duplicate plugin name "${plugin.name}"`);
+        }
+        seen.add(plugin.name);
+        copyDirIfPresent(plugin.publicAssetsDir, join(destRoot, "_sb", "plugins", plugin.name));
+    }
+}
+/**
+ * Run each registered plugin's `build` hook (e.g. write sitemap.xml).
+ */
+export async function runRegisteredPluginBuilds(plugins, ctx) {
+    for (const plugin of plugins) {
+        assertPlugin(plugin, "runRegisteredPluginBuilds()");
+        if (plugin.build) {
+            await plugin.build(ctx);
+        }
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/blog/index.d.ts

@@ -1,16 +1,17 @@
-import type { PageMeta } from "../../pages.js";
-import type { DefaultSlotContent } from "../../slot-content.js";
+import type { Stackbox as SB } from "../../types.js";
 import { type BlogOptions } from "./posts.js";
+declare const _default: SB.Plugin;
+export default _default;
 export type { BlogPost, BlogOptions } from "./posts.js";
 export type BlogPostContent = {
     path: string;
     title: string;
-    meta?: PageMeta;
-    content: DefaultSlotContent[];
+    meta?: SB.PageMeta;
+    content: SB.DefaultSlotContent[];
 };
 export type BlogListingContent = {
     path: string;
-    content: DefaultSlotContent[];
+    content: SB.DefaultSlotContent[];
 };
 export type Blog = {
     readonly posts: readonly BlogPostContent[];

package/dist/plugins/blog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/blog/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAa,KAAK,WAAW,EAAiB,MAAM,YAAY,CAAC;AAExE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD,CAAC;AAwDF,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAQrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/blog/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAa,KAAK,WAAW,EAAiB,MAAM,YAAY,CAAC;;AAExE,wBAeG;AAEH,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC;IACnB,OAAO,EAAE,EAAE,CAAC,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,EAAE,CAAC,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD,CAAC;AAwDF,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAQrD"}

package/dist/plugins/blog/index.js

@@ -1,4 +1,20 @@
+import { createPlugin } from "../../plugin.js";
 import { loadPosts } from "./posts.js";
+export default createPlugin({
+    name: "sb-blog",
+    description: "Load markdown posts at bundle time and return listing and post content objects to wire into createPage().",
+    version: "1.0.0",
+    keywords: [
+        "blog",
+        "posts",
+        "articles",
+        "journal",
+        "markdown posts",
+        "blog listing",
+        "blog page",
+    ],
+    root: import.meta.dirname,
+});
 function postToContent(post) {
     return {
         path: post.path,

package/dist/plugins/blog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/blog/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAmC,MAAM,YAAY,CAAC;AAqBxE,SAAS,aAAa,CAAC,IAAc;IACnC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QACtE,OAAO,EAAE;YACP,mDAAmD,IAAI,CAAC,IAAI;QAC1D,IAAI,CAAC,KAAK;IACd,IAAI,CAAC,QAAQ;WACN;SACN;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,IAAY;IACnD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,SAAS,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAiB;IAC1C,OAAO,OAAO,KAAK;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,WAAW,CAAC;SAClE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAiB,EACjB,UAAkB,EAClB,YAAqB;IAErB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,CAAC,6BAA6B,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,YAAY,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACjE,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC;YACnC,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAChC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC;KACtE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/blog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAmC,MAAM,YAAY,CAAC;AAExE,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE,SAAS;IACf,WAAW,EACT,2GAA2G;IAC7G,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE;QACR,MAAM;QACN,OAAO;QACP,UAAU;QACV,SAAS;QACT,gBAAgB;QAChB,cAAc;QACd,WAAW;KACZ;IACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;CAC1B,CAAC,CAAC;AAqBH,SAAS,aAAa,CAAC,IAAc;IACnC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QACtE,OAAO,EAAE;YACP,mDAAmD,IAAI,CAAC,IAAI;QAC1D,IAAI,CAAC,KAAK;IACd,IAAI,CAAC,QAAQ;WACN;SACN;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,IAAY;IACnD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,SAAS,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAiB;IAC1C,OAAO,OAAO,KAAK;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,WAAW,CAAC;SAClE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAiB,EACjB,UAAkB,EAClB,YAAqB;IAErB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,CAAC,6BAA6B,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GACX,YAAY,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACjE,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC;YACnC,OAAO,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;QAChC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/dist/plugins/random-quote/assets/quotes.json

@@ -0,0 +1,230 @@
+[
+    {
+        "text": "You can beat 40 scholars with one fact, but you can't beat one idiot with 40 facts.",
+        "author": "Rumi"
+    },
+    {
+        "text": "You will observe with concern how long a useful truth may be known and exist before it is generally recieved and practices on",
+        "author": "Benjamin Franklin"
+    },
+    {
+        "text": "Life can only be understood backwards; but it must be lived forwards.",
+        "author": "Søren Kierkegaard"
+    },
+    {
+        "text": "We are what we repeatedly do. Excellence, then, is not an act, but a habit.",
+        "author": "Will Durant"
+    },
+    {
+        "text": "Time has a wonderful way of showing us what really matters.",
+        "author": "Margaret Peters"
+    },
+    {
+        "text": "When a person can't find a deep sense of meaning, they distract themselves with pleasure.",
+        "author": "Viktor Frankl"
+    },
+    {
+        "text": "To attain knowledge, add things everyday. To attain wisdom, remove things every day.",
+        "author": "Lao Tzu"
+    },
+    {
+        "text": "At the end of the day, we can endure much more than we think we can.",
+        "author": "Frida Kahlo"
+    },
+    {
+        "text": "People rarely succeed unless they have fun in what they are doing.",
+        "author": "Dale Carnegie"
+    },
+    {
+        "text": "If you don't design your own life plan, chances are you'll fall into someone else's plan.",
+        "author": "Jim Rohn"
+    },
+    {
+        "text": "Not everything that is faced can be changed, but nothing can be changed until it is faced.",
+        "author": "James Baldwin"
+    },
+    {
+        "text": "The surface of the Earth is the shore of the cosmic ocean.",
+        "author": "Carl Sagan"
+    },
+    {
+        "text": "I do not feel obliged to believe that that same God who has endowed us with senses, reason, and intellect has intended to forgo their use",
+        "author": "Galileo Galilei"
+    },
+    {
+        "text": "In science the authority embodied in the opinion of thousands is not worth a spark of reason in one man.",
+        "author": "Galileo Galilei"
+    },
+    {
+        "text": "Mathematics is the language in which God wrote the universe.",
+        "author": "Galileo Galilei"
+    },
+    {
+        "text": "Ignorance is preferable to error; and he is less remote from the truth who believes nothing, than he who believes what is wrong.",
+        "author": "Thomas Jefferson"
+    },
+    {
+        "text": "The essence of Government is power; and power, lodged as it must be in human hands, will ever be liable to abuse.",
+        "author": "James Madison"
+    },
+    {
+        "text": "A workman who wants to do his work well must first prepare his tools.",
+        "author": "Confucius"
+    },
+    {
+        "text": "It is only the very wisest and the very stupidest who cannot change.",
+        "author": "Confucius"
+    },
+    {
+        "text": "Our wretched species is so made that those who walk on the well-trodden path always throw stones at those who are showing a new road.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "I have always thought the actions of men the best interpreters of their thoughts.",
+        "author": "John Locke"
+    },
+    {
+        "text": "There are two tragedies in life. One is not to get your heart's desire. The other is to get it.",
+        "author": "George Bernard Shaw"
+    },
+    {
+        "text": "Marriage is the only adventure open to the cowardly.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "Even the rich are hungry for love, for being cared for, for being wanted, for having someone to call their own.",
+        "author": "Mother Teresa"
+    },
+    {
+        "text": "Loneliness and the feeling of being unwanted is the most terrible poverty.",
+        "author": "Mother Teresa"
+    },
+    {
+        "text": "To know what life is worth you have to risk it once in a while.",
+        "author": "Jean-Paul Sartre"
+    },
+    {
+        "text": "Conformity is the jailer of freedom and the enemy of growth.",
+        "author": "John F. Kennedy"
+    },
+    {
+        "text": "Man is not born to solve the problem of the universe, but to find out what he has to do; and to restrain himself within the limits of his comprehension.",
+        "author": "Goethe"
+    },
+    {
+        "text": "Love does not dominate, it cultivates. And that is more.",
+        "author": "Goethe"
+    },
+    {
+        "text": "He alone is great and happy who fills his own station of independence, and has neither to command nor to obey.",
+        "author": "Goethe"
+    },
+    {
+        "text": "If you wish to advance into the infinite, explore the finite in all directions.",
+        "author": "Goethe"
+    },
+    {
+        "text": "One ought to hold on to one's heart; for if one lets it go, one soon loses control of the head too.",
+        "author": "Friedrich Nietzsche"
+    },
+    {
+        "text": "A faith is a necessity to man. Woe to him who believes nothing.",
+        "author": "Victor Hugo"
+    },
+    {
+        "text": "To live a life which is a perpetual falsehood is to suffer unknown tortures.",
+        "author": "Victor Hugo"
+    },
+    {
+        "text": "A man may be a fine genius, and yet understand nothing of an art which he has not studied.",
+        "author": "Victor Hugo"
+    },
+    {
+        "text": "How much more grievous are the consequences of anger than the causes of it.",
+        "author": "Marcus Aurelius"
+    },
+    {
+        "text": "You always own the option of having no opinion. There is never any need to get worked up or to trouble your soul about things you can't control. These things are not asking to be judged by you. Leave them alone.",
+        "author": "Marcus Aurelius"
+    },
+    {
+        "text": "It never ceases to amaze me: we all love ourselves more than other people, but care more about their opinions than our own.",
+        "author": "Marcus Aurelius"
+    },
+    {
+        "text": "External things are not the problem. It's your assessment of them. Which you can erase right now.",
+        "author": "Marcus Aurelius"
+    },
+    {
+        "text": "The man who reads nothing at all is more educated than the man who reads nothing but newspapers.",
+        "author": "Thomas Jefferson"
+    },
+    {
+        "text": "Nothing gives one person so much advantage over anohter as to remain always cool and unruffled under all circumstances.",
+        "author": "Thomas Jefferson"
+    },
+    {
+        "text": "Doubt is an uncomfortable condition, but certainty is a ridiculous one.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "The longer we dwell on our misfortunes, the greater is their power to harm us.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "Those who can make you believe absurdities, can make you commit atrocities.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "It is dangerous to be right in matters on which the established authorities are wrong.",
+        "author": "Voltaire"
+    },
+    {
+        "text": "One can stand anything except a succession of ordinary days.",
+        "author": "Goethe"
+    },
+    {
+        "text": "Good times become good memories and bad times become good lessons in life.",
+        "author": "Unknown"
+    },
+    {
+        "text": "It's better to have a short life that is full of what you like doing, than a long life spent in a miserable way.",
+        "author": "Alan Watts"
+    },
+    {
+        "text": "To have faith is to trust yourself to the water. When you swim you don't grab hold of the water, because if you do you will sink and drown. Instead you relax, and float.",
+        "author": "Alan Watts"
+    },
+    {
+        "text": "I've been searching for years for the ideal place. And I've come to the realization that the only way to find it is to be it.",
+        "author": "Alan Watts"
+    },
+    {
+        "text": "I would rather be governed by the first 2,000 people in the Boston telephone directory than by the 2,000 people on the faculty of Harvard University.",
+        "author": "William F. Buckley Jr."
+    },
+    {
+        "text": "Never confuse education with intelligence, you can have a PhD and still be an idiot.",
+        "author": "Richard Feynman"
+    },
+    {
+        "text": "The enemy is anybody who's going to get you killed, no matter which side he's on.",
+        "author": "Joseph Heller"
+    },
+    {
+        "text": "People often say motivation doesn't last. Neither does bathing—that's why we recommend it daily.",
+        "author": "Zig Ziglar"
+    },
+    {
+        "text": "Live free ot die; death is not the worst of evils.",
+        "author": "General John Stark"
+    },
+    {
+        "text": "Equality only exists in theory. Social law can give all men equal rights. Nature will never give them equal faculties.",
+        "author": "Napoleon"
+    },
+    {
+        "text": "One who does not want to reason exists as a fanatic; one who ignores how to reason exists as a fool; and one who will not dare to reason exists as a slave.",
+        "author": "Carlos Drummond de Andrade"
+    }
+]

package/dist/plugins/random-quote/index.d.ts

@@ -1,3 +1,5 @@
+declare const _default: import("../../types.js").Stackbox.Plugin;
+export default _default;
 export type Quote = {
     text: string;
     author: string;
@@ -8,5 +10,5 @@ export type RandomQuoteBlockOptions = {
 };
 export declare const defaultQuotes: readonly Quote[];
 export declare function pickRandomQuote(quotes: readonly Quote[]): Quote;
-export declare const randomQuoteBlock: import("../../blocks.js").BlockFactory<RandomQuoteBlockOptions | undefined>;
+export declare const randomQuoteBlock: import("../../types.js").Stackbox.BlockFactory<RandomQuoteBlockOptions | undefined>;
 //# sourceMappingURL=index.d.ts.map

package/dist/plugins/random-quote/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/random-quote/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,mDAAmD;IACnD,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,KAAK,EAAkB,CAAC;AAE7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,CAK/D;AAED,eAAO,MAAM,gBAAgB,6EAS3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/random-quote/index.ts"],"names":[],"mappings":";AAKA,wBAaG;AAEH,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,mDAAmD;IACnD,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,KAAK,EAAkB,CAAC;AAE7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,CAK/D;AAED,eAAO,MAAM,gBAAgB,qFAS3B,CAAC"}

package/dist/plugins/random-quote/index.js

@@ -1,6 +1,20 @@
 import { html } from "@hyperspan/html";
 import { createBlock } from "../../blocks.js";
-import bundledQuotes from "./public_assets/quotes.json" with { type: "json" };
+import { createPlugin } from "../../plugin.js";
+import bundledQuotes from "./assets/quotes.json" with { type: "json" };
+export default createPlugin({
+    name: "sb-random-quote",
+    description: "A block that renders a random inspirational quote, using bundled defaults or a site-supplied list.",
+    version: "1.0.0",
+    keywords: [
+        "random quote",
+        "quote of the day",
+        "inspirational quote",
+        "sidebar quote",
+        "quotation",
+    ],
+    root: import.meta.dirname,
+});
 export const defaultQuotes = bundledQuotes;
 export function pickRandomQuote(quotes) {
     if (quotes.length === 0) {

package/dist/plugins/random-quote/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/random-quote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,aAAa,MAAM,6BAA6B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAY9E,MAAM,CAAC,MAAM,aAAa,GAAqB,aAAa,CAAC;AAE7D,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,cAAc;IACpB,MAAM,CAAC,OAAiC;QACtC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC,CAAC;QAChE,OAAO,IAAI,CAAA,+CAA+C,KAAK,CAAC,MAAM;OACnE,KAAK,CAAC,IAAI;cACH,KAAK,CAAC,MAAM;cACZ,CAAC;IACb,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/random-quote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,aAAa,MAAM,sBAAsB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEvE,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,oGAAoG;IACtG,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE;QACR,cAAc;QACd,kBAAkB;QAClB,qBAAqB;QACrB,eAAe;QACf,WAAW;KACZ;IACD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;CAC1B,CAAC,CAAC;AAYH,MAAM,CAAC,MAAM,aAAa,GAAqB,aAAa,CAAC;AAE7D,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;IAC1C,IAAI,EAAE,cAAc;IACpB,MAAM,CAAC,OAAiC;QACtC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC,CAAC;QAChE,OAAO,IAAI,CAAA,+CAA+C,KAAK,CAAC,MAAM;OACnE,KAAK,CAAC,IAAI;cACH,KAAK,CAAC,MAAM;cACZ,CAAC;IACb,CAAC;CACF,CAAC,CAAC"}

package/dist/plugins/sitemap/index.d.ts

@@ -0,0 +1,14 @@
+import type { Stackbox as SB } from "../../types.js";
+export type SitemapOptions = {
+    /** Site origin. Defaults to `siteConfig.config.url`. */
+    baseUrl?: string;
+    /** Extra site-relative or absolute URLs. */
+    extraUrls?: readonly string[];
+    exclude?: readonly string[] | ((path: string) => boolean);
+};
+export declare function collectSitemapUrls(site: SB.Site, options?: SitemapOptions): string[];
+export declare function renderSitemapXml(site: SB.Site, options?: SitemapOptions): string;
+export declare function createSitemap(options?: SitemapOptions): SB.Plugin;
+declare const _default: SB.Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/sitemap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/sitemap/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;CAC3D,CAAC;AAkCF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,GAAE,cAAmB,GAC3B,MAAM,EAAE,CA4BV;AAWD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAMR;AAgCD,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,EAAE,CAAC,MAAM,CAsBrE;;AAED,wBAA+B"}

package/dist/plugins/sitemap/index.js

@@ -0,0 +1,119 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createPlugin, } from "../../plugin.js";
+import { normalizePathname } from "../../routing.js";
+function resolveBaseUrl(site, options) {
+    const raw = options.baseUrl ?? site.siteConfig.config.url;
+    if (typeof raw !== "string" || raw.trim().length === 0) {
+        throw new Error("sb-sitemap: baseUrl or siteConfig.url is required");
+    }
+    const url = raw.trim().replace(/\/+$/, "");
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new Error(`sb-sitemap: invalid base URL "${raw}"`);
+    }
+    return url;
+}
+function isExcluded(path, options) {
+    const normalized = normalizePathname(path);
+    if (!options.exclude) {
+        return false;
+    }
+    if (typeof options.exclude === "function") {
+        return options.exclude(normalized);
+    }
+    return options.exclude.some((entry) => normalizePathname(entry) === normalized);
+}
+function isNoindexPage(page) {
+    const robots = page.meta?.robots?.toLowerCase() ?? "";
+    return robots.includes("noindex");
+}
+export function collectSitemapUrls(site, options = {}) {
+    const base = resolveBaseUrl(site, options);
+    const locs = new Set();
+    for (const page of site.pages) {
+        if (isNoindexPage(page)) {
+            continue;
+        }
+        if (isExcluded(page.path, options)) {
+            continue;
+        }
+        locs.add(`${base}${normalizePathname(page.path)}`);
+    }
+    for (const extra of options.extraUrls ?? []) {
+        if (extra.startsWith("http://") || extra.startsWith("https://")) {
+            if (!isExcluded(extra, options)) {
+                locs.add(extra);
+            }
+            continue;
+        }
+        const path = normalizePathname(extra);
+        if (!isExcluded(path, options)) {
+            locs.add(`${base}${path}`);
+        }
+    }
+    return [...locs].sort();
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+export function renderSitemapXml(site, options = {}) {
+    const urls = collectSitemapUrls(site, options);
+    const body = urls
+        .map((loc) => `  <url>\n    <loc>${escapeXml(loc)}</loc>\n  </url>`)
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</urlset>\n`;
+}
+function sitemapResponse(request, xml) {
+    const headers = { "content-type": "application/xml; charset=utf-8" };
+    if (request.method === "HEAD") {
+        const bytes = new TextEncoder().encode(xml);
+        return new globalThis.Response(null, {
+            status: 200,
+            headers: { ...headers, "content-length": String(bytes.byteLength) },
+        });
+    }
+    return new globalThis.Response(xml, { status: 200, headers });
+}
+function createSitemapRoutes(ctx, options) {
+    return [
+        {
+            path: "/sitemap.xml",
+            fetch(request) {
+                const xml = renderSitemapXml(ctx.site, options);
+                return sitemapResponse(request, xml);
+            },
+        },
+    ];
+}
+export function createSitemap(options = {}) {
+    return createPlugin({
+        name: "sb-sitemap",
+        description: "Generate sitemap.xml from site pages for search engines and static deploys.",
+        version: "1.0.0",
+        keywords: [
+            "sitemap",
+            "sitemap.xml",
+            "seo",
+            "search engines",
+            "xml sitemap",
+        ],
+        root: import.meta.dirname,
+        routes(ctx) {
+            return createSitemapRoutes(ctx, options);
+        },
+        build(ctx) {
+            const xml = renderSitemapXml(ctx.site, options);
+            writeFileSync(join(ctx.publicDir, "sitemap.xml"), xml, "utf8");
+        },
+    });
+}
+export default createSitemap();
+//# sourceMappingURL=index.js.map