@prudentbird/voxx-core 1.0.0

package/dist/util.d.mts

@@ -0,0 +1,98 @@
+//#region src/util.d.ts
+/**
+ * Converts a string to a URL-safe slug.
+ *
+ * Normalizes unicode, lowercases, trims, and replaces non-alphanumeric
+ * characters with hyphens.
+ */
+declare function slugify(input: string): string;
+/**
+ * Strips a `YYYY-MM-DD` prefix from a filename stem.
+ *
+ * @param name - Filename stem without extension.
+ * @returns The extracted ISO date and the remaining name, or just `rest` if no prefix found.
+ */
+declare function splitDatePrefix(name: string): {
+  date?: string;
+  rest: string;
+};
+/**
+ * Strips a numeric order prefix (up to 4 digits) from a filename or directory stem.
+ *
+ * @param name - Filename stem without extension, e.g. `"01-getting-started"`.
+ * @returns The extracted order number and the remaining name.
+ */
+declare function splitOrderPrefix(name: string): {
+  order?: number;
+  rest: string;
+};
+/**
+ * Converts a slug or filename stem to a human-readable title.
+ *
+ * @param segment - Slug segment, e.g. `"getting-started"`.
+ * @returns Title-cased string, e.g. `"Getting Started"`.
+ */
+declare function humanize(segment: string): string;
+/**
+ * Joins a base path and a slug into a clean URL path.
+ *
+ * Ensures exactly one leading slash and removes duplicate slashes.
+ */
+declare function joinPath(base: string, slug: string): string;
+/**
+ * Resolves a site-relative path to a full absolute URL.
+ *
+ * Returns the path unchanged if it already starts with `http(s)://`.
+ *
+ * @param siteUrl - Canonical site origin, e.g. `https://example.com`.
+ * @param path - Absolute or relative URL path.
+ */
+declare function absoluteUrl(siteUrl: string, path: string): string;
+/**
+ * Estimates reading time in minutes, assuming 200 words per minute.
+ * Always returns at least 1.
+ */
+declare function readingTimeMinutes(markdown: string): number;
+/**
+ * Extracts a plain-text excerpt from Markdown, stripping code blocks,
+ * headings, and inline markup.
+ *
+ * @param markdown - Raw Markdown source.
+ * @param max - Maximum character length before truncation. Defaults to `180`.
+ */
+declare function deriveExcerpt(markdown: string, max?: number): string;
+/**
+ * Formats an ISO 8601 date string for display.
+ *
+ * @param iso - ISO date string, e.g. `"2024-01-15"`.
+ * @param locale - BCP 47 locale. Defaults to `"en-US"`.
+ * @returns Formatted string like `"January 15, 2024"`, or the original string if invalid.
+ */
+declare function formatDate(iso: string, locale?: string): string;
+/**
+ * Parses a semver string from a filename stem, stripping any leading `v`.
+ *
+ * @param name - Filename stem, e.g. `"v1.2.3"` or `"1.0.0-rc.1"`.
+ * @returns Normalized version string, or `undefined` if not a valid version.
+ */
+declare function parseVersion(name: string): string | undefined;
+/**
+ * Compares two semver-like version strings numerically.
+ *
+ * @returns Negative if `a < b`, positive if `a > b`, zero if equal.
+ */
+declare function compareVersions(a: string, b: string): number;
+/**
+ * Escapes a string for safe inclusion in XML/HTML attribute values and text nodes.
+ */
+declare function escapeXml(value: string): string;
+/**
+ * Serializes a JSON-LD object to a string safe for inline `<script>` tags.
+ *
+ * Escapes `<`, `>`, `&`, and Unicode line/paragraph separators to prevent
+ * XSS and parser errors.
+ */
+declare function serializeJsonLd(data: unknown): string;
+//#endregion
+export { absoluteUrl, compareVersions, deriveExcerpt, escapeXml, formatDate, humanize, joinPath, parseVersion, readingTimeMinutes, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix };
+//# sourceMappingURL=util.d.mts.map

package/dist/util.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.mts","names":[],"sources":["../src/util.ts"],"mappings":";;AAMA;;;;AAAqC;iBAArB,OAAA,CAAQ,KAAa;;;;;;;iBAkBrB,eAAA,CAAgB,IAAA;EAAiB,IAAA;EAAe,IAAA;AAAA;;;;;;;iBAchD,gBAAA,CAAiB,IAAA;EAC/B,KAAA;EACA,IAAA;AAAA;;AAasC;AAYxC;;;;iBAZgB,QAAA,CAAS,OAAe;AA2BxC;;;;AAAyD;AAAzD,iBAfgB,QAAA,CAAS,IAAA,UAAc,IAAY;;;;AA0BA;AAYnD;;;;iBAvBgB,WAAA,CAAY,OAAA,UAAiB,IAAY;AA6CzD;;;;AAAA,iBAlCgB,kBAAA,CAAmB,QAAgB;AAoDnD;;;;AAAyC;AAUzC;;AAVA,iBAxCgB,aAAA,CAAc,QAAA,UAAkB,GAAS;;AAkDL;AAwBpD;;;;AAAuC;iBApDvB,UAAA,CAAW,GAAA,UAAa,MAAgB;;;;AAmEX;;;iBAjD7B,YAAA,CAAa,IAAY;;;;;;iBAUzB,eAAA,CAAgB,CAAA,UAAW,CAAS;;;;iBAwBpC,SAAA,CAAU,KAAa;;;;;;;iBAevB,eAAA,CAAgB,IAAa"}

package/dist/util.mjs

@@ -0,0 +1,171 @@
+//#region src/util.ts
+/**
+* Converts a string to a URL-safe slug.
+*
+* Normalizes unicode, lowercases, trims, and replaces non-alphanumeric
+* characters with hyphens.
+*/
+function slugify(input) {
+	return input.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+const DATE_PREFIX_RE = /^(\d{4})-(\d{2})-(\d{2})[-_.](.+)$/;
+/**
+* Strips a `YYYY-MM-DD` prefix from a filename stem.
+*
+* @param name - Filename stem without extension.
+* @returns The extracted ISO date and the remaining name, or just `rest` if no prefix found.
+*/
+function splitDatePrefix(name) {
+	const m = DATE_PREFIX_RE.exec(name);
+	if (!m) return { rest: name };
+	return {
+		date: `${m[1]}-${m[2]}-${m[3]}`,
+		rest: m[4]
+	};
+}
+const ORDER_PREFIX_RE = /^(\d{1,4})[-_.](.+)$/;
+/**
+* Strips a numeric order prefix (up to 4 digits) from a filename or directory stem.
+*
+* @param name - Filename stem without extension, e.g. `"01-getting-started"`.
+* @returns The extracted order number and the remaining name.
+*/
+function splitOrderPrefix(name) {
+	const m = ORDER_PREFIX_RE.exec(name);
+	if (!m) return { rest: name };
+	return {
+		order: Number(m[1]),
+		rest: m[2]
+	};
+}
+/**
+* Converts a slug or filename stem to a human-readable title.
+*
+* @param segment - Slug segment, e.g. `"getting-started"`.
+* @returns Title-cased string, e.g. `"Getting Started"`.
+*/
+function humanize(segment) {
+	return segment.replace(/[-_]+/g, " ").replace(/\b\w/g, (ch) => ch.toUpperCase()).trim();
+}
+/**
+* Joins a base path and a slug into a clean URL path.
+*
+* Ensures exactly one leading slash and removes duplicate slashes.
+*/
+function joinPath(base, slug) {
+	const left = base.replace(/\/+$/, "");
+	const right = slug.replace(/^\/+/, "");
+	return `${left.startsWith("/") ? left : `/${left}`}/${right}`.replace(/([^:])\/{2,}/g, "$1/");
+}
+/**
+* Resolves a site-relative path to a full absolute URL.
+*
+* Returns the path unchanged if it already starts with `http(s)://`.
+*
+* @param siteUrl - Canonical site origin, e.g. `https://example.com`.
+* @param path - Absolute or relative URL path.
+*/
+function absoluteUrl(siteUrl, path) {
+	if (/^https?:\/\//i.test(path)) return path;
+	return `${siteUrl.replace(/\/+$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+}
+/**
+* Estimates reading time in minutes, assuming 200 words per minute.
+* Always returns at least 1.
+*/
+function readingTimeMinutes(markdown) {
+	const words = markdown.trim().split(/\s+/).filter(Boolean).length;
+	return Math.max(1, Math.round(words / 200));
+}
+/**
+* Extracts a plain-text excerpt from Markdown, stripping code blocks,
+* headings, and inline markup.
+*
+* @param markdown - Raw Markdown source.
+* @param max - Maximum character length before truncation. Defaults to `180`.
+*/
+function deriveExcerpt(markdown, max = 180) {
+	const text = markdown.replace(/```[\s\S]*?```/g, " ").replace(/`[^`]*`/g, " ").replace(/^#{1,6}\s.*$/gm, " ").replace(/!\[[^\]]*\]\([^)]*\)/g, " ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/[*_>#~]/g, " ").replace(/\s+/g, " ").replace(/\s+([.,;:!?])/g, "$1").trim();
+	if (text.length <= max) return text;
+	return `${text.slice(0, max).replace(/\s+\S*$/, "")}…`;
+}
+/**
+* Formats an ISO 8601 date string for display.
+*
+* @param iso - ISO date string, e.g. `"2024-01-15"`.
+* @param locale - BCP 47 locale. Defaults to `"en-US"`.
+* @returns Formatted string like `"January 15, 2024"`, or the original string if invalid.
+*/
+function formatDate(iso, locale = "en-US") {
+	const d = new Date(iso);
+	if (Number.isNaN(d.getTime())) return iso;
+	return d.toLocaleDateString(locale, {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	});
+}
+const VERSION_RE = /^v?(\d+(?:\.\d+)*(?:[-.][\w.]+)?)$/i;
+/**
+* Parses a semver string from a filename stem, stripping any leading `v`.
+*
+* @param name - Filename stem, e.g. `"v1.2.3"` or `"1.0.0-rc.1"`.
+* @returns Normalized version string, or `undefined` if not a valid version.
+*/
+function parseVersion(name) {
+	const m = VERSION_RE.exec(name);
+	return m ? m[1] : void 0;
+}
+/**
+* Compares two semver-like version strings numerically.
+*
+* @returns Negative if `a < b`, positive if `a > b`, zero if equal.
+*/
+function compareVersions(a, b) {
+	const partsA = a.split(/[-.]/);
+	const partsB = b.split(/[-.]/);
+	const len = Math.max(partsA.length, partsB.length);
+	for (let i = 0; i < len; i++) {
+		const ai = partsA[i] ?? "";
+		const bi = partsB[i] ?? "";
+		const na = Number(ai);
+		const nb = Number(bi);
+		if (!Number.isNaN(na) && !Number.isNaN(nb)) {
+			if (na !== nb) return na - nb;
+		} else if (ai !== bi) {
+			if (ai === "") return 1;
+			if (bi === "") return -1;
+			return ai < bi ? -1 : 1;
+		}
+	}
+	return 0;
+}
+/**
+* Escapes a string for safe inclusion in XML/HTML attribute values and text nodes.
+*/
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+/**
+* Serializes a JSON-LD object to a string safe for inline `<script>` tags.
+*
+* Escapes `<`, `>`, `&`, and Unicode line/paragraph separators to prevent
+* XSS and parser errors.
+*/
+function serializeJsonLd(data) {
+	return JSON.stringify(data).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+/** Formats an ISO 8601 date string as RFC 822 (used in RSS feeds). */
+function rfc822(date) {
+	const d = new Date(date);
+	return (isNaN(d.getTime()) ? /* @__PURE__ */ new Date() : d).toUTCString();
+}
+/** Formats an ISO 8601 date string as `YYYY-MM-DD` (used in sitemaps). */
+function isoDate(date) {
+	const d = new Date(date);
+	return (isNaN(d.getTime()) ? /* @__PURE__ */ new Date() : d).toISOString().slice(0, 10);
+}
+//#endregion
+export { absoluteUrl, compareVersions, deriveExcerpt, escapeXml, formatDate, humanize, isoDate, joinPath, parseVersion, readingTimeMinutes, rfc822, serializeJsonLd, slugify, splitDatePrefix, splitOrderPrefix };
+
+//# sourceMappingURL=util.mjs.map

package/dist/util.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.mjs","names":[],"sources":["../src/util.ts"],"sourcesContent":["/**\n * Converts a string to a URL-safe slug.\n *\n * Normalizes unicode, lowercases, trims, and replaces non-alphanumeric\n * characters with hyphens.\n */\nexport function slugify(input: string): string {\n  return input\n    .normalize(\"NFKD\")\n    .replace(/[̀-ͯ]/g, \"\")\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nconst DATE_PREFIX_RE = /^(\\d{4})-(\\d{2})-(\\d{2})[-_.](.+)$/;\n\n/**\n * Strips a `YYYY-MM-DD` prefix from a filename stem.\n *\n * @param name - Filename stem without extension.\n * @returns The extracted ISO date and the remaining name, or just `rest` if no prefix found.\n */\nexport function splitDatePrefix(name: string): { date?: string; rest: string } {\n  const m = DATE_PREFIX_RE.exec(name);\n  if (!m) return { rest: name };\n  return { date: `${m[1]}-${m[2]}-${m[3]}`, rest: m[4]! };\n}\n\nconst ORDER_PREFIX_RE = /^(\\d{1,4})[-_.](.+)$/;\n\n/**\n * Strips a numeric order prefix (up to 4 digits) from a filename or directory stem.\n *\n * @param name - Filename stem without extension, e.g. `\"01-getting-started\"`.\n * @returns The extracted order number and the remaining name.\n */\nexport function splitOrderPrefix(name: string): {\n  order?: number;\n  rest: string;\n} {\n  const m = ORDER_PREFIX_RE.exec(name);\n  if (!m) return { rest: name };\n  return { order: Number(m[1]), rest: m[2]! };\n}\n\n/**\n * Converts a slug or filename stem to a human-readable title.\n *\n * @param segment - Slug segment, e.g. `\"getting-started\"`.\n * @returns Title-cased string, e.g. `\"Getting Started\"`.\n */\nexport function humanize(segment: string): string {\n  return segment\n    .replace(/[-_]+/g, \" \")\n    .replace(/\\b\\w/g, (ch) => ch.toUpperCase())\n    .trim();\n}\n\n/**\n * Joins a base path and a slug into a clean URL path.\n *\n * Ensures exactly one leading slash and removes duplicate slashes.\n */\nexport function joinPath(base: string, slug: string): string {\n  const left = base.replace(/\\/+$/, \"\");\n  const right = slug.replace(/^\\/+/, \"\");\n  const prefix = left.startsWith(\"/\") ? left : `/${left}`;\n  return `${prefix}/${right}`.replace(/([^:])\\/{2,}/g, \"$1/\");\n}\n\n/**\n * Resolves a site-relative path to a full absolute URL.\n *\n * Returns the path unchanged if it already starts with `http(s)://`.\n *\n * @param siteUrl - Canonical site origin, e.g. `https://example.com`.\n * @param path - Absolute or relative URL path.\n */\nexport function absoluteUrl(siteUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  const origin = siteUrl.replace(/\\/+$/, \"\");\n  const rel = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${origin}${rel}`;\n}\n\n/**\n * Estimates reading time in minutes, assuming 200 words per minute.\n * Always returns at least 1.\n */\nexport function readingTimeMinutes(markdown: string): number {\n  const words = markdown.trim().split(/\\s+/).filter(Boolean).length;\n  return Math.max(1, Math.round(words / 200));\n}\n\n/**\n * Extracts a plain-text excerpt from Markdown, stripping code blocks,\n * headings, and inline markup.\n *\n * @param markdown - Raw Markdown source.\n * @param max - Maximum character length before truncation. Defaults to `180`.\n */\nexport function deriveExcerpt(markdown: string, max = 180): string {\n  const text = markdown\n    .replace(/```[\\s\\S]*?```/g, \" \")\n    .replace(/`[^`]*`/g, \" \")\n    .replace(/^#{1,6}\\s.*$/gm, \" \")\n    .replace(/!\\[[^\\]]*\\]\\([^)]*\\)/g, \" \")\n    .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n    .replace(/[*_>#~]/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .replace(/\\s+([.,;:!?])/g, \"$1\")\n    .trim();\n  if (text.length <= max) return text;\n  return `${text.slice(0, max).replace(/\\s+\\S*$/, \"\")}…`;\n}\n\n/**\n * Formats an ISO 8601 date string for display.\n *\n * @param iso - ISO date string, e.g. `\"2024-01-15\"`.\n * @param locale - BCP 47 locale. Defaults to `\"en-US\"`.\n * @returns Formatted string like `\"January 15, 2024\"`, or the original string if invalid.\n */\nexport function formatDate(iso: string, locale = \"en-US\"): string {\n  const d = new Date(iso);\n  if (Number.isNaN(d.getTime())) return iso;\n  return d.toLocaleDateString(locale, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n  });\n}\n\nconst VERSION_RE = /^v?(\\d+(?:\\.\\d+)*(?:[-.][\\w.]+)?)$/i;\n\n/**\n * Parses a semver string from a filename stem, stripping any leading `v`.\n *\n * @param name - Filename stem, e.g. `\"v1.2.3\"` or `\"1.0.0-rc.1\"`.\n * @returns Normalized version string, or `undefined` if not a valid version.\n */\nexport function parseVersion(name: string): string | undefined {\n  const m = VERSION_RE.exec(name);\n  return m ? m[1] : undefined;\n}\n\n/**\n * Compares two semver-like version strings numerically.\n *\n * @returns Negative if `a < b`, positive if `a > b`, zero if equal.\n */\nexport function compareVersions(a: string, b: string): number {\n  const partsA = a.split(/[-.]/);\n  const partsB = b.split(/[-.]/);\n  const len = Math.max(partsA.length, partsB.length);\n  for (let i = 0; i < len; i++) {\n    const ai = partsA[i] ?? \"\";\n    const bi = partsB[i] ?? \"\";\n    const na = Number(ai);\n    const nb = Number(bi);\n    const bothNumeric = !Number.isNaN(na) && !Number.isNaN(nb);\n    if (bothNumeric) {\n      if (na !== nb) return na - nb;\n    } else if (ai !== bi) {\n      if (ai === \"\") return 1;\n      if (bi === \"\") return -1;\n      return ai < bi ? -1 : 1;\n    }\n  }\n  return 0;\n}\n\n/**\n * Escapes a string for safe inclusion in XML/HTML attribute values and text nodes.\n */\nexport function escapeXml(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n\n/**\n * Serializes a JSON-LD object to a string safe for inline `<script>` tags.\n *\n * Escapes `<`, `>`, `&`, and Unicode line/paragraph separators to prevent\n * XSS and parser errors.\n */\nexport function serializeJsonLd(data: unknown): string {\n  return JSON.stringify(data)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/>/g, \"\\\\u003e\")\n    .replace(/&/g, \"\\\\u0026\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\n/** Formats an ISO 8601 date string as RFC 822 (used in RSS feeds). */\nexport function rfc822(date: string): string {\n  const d = new Date(date);\n  return (isNaN(d.getTime()) ? new Date() : d).toUTCString();\n}\n\n/** Formats an ISO 8601 date string as `YYYY-MM-DD` (used in sitemaps). */\nexport function isoDate(date: string): string {\n  const d = new Date(date);\n  return (isNaN(d.getTime()) ? new Date() : d).toISOString().slice(0, 10);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@prudentbird/voxx-core",
+  "version": "1.0.0",
+  "description": "The portable content engine behind Voxx: markdown + frontmatter -> SEO-ready blogs, docs, and changelogs.",
+  "license": "MIT",
+  "author": "prudentbird <me@prudentbird.com> (https://prudentbird.com)",
+  "homepage": "https://github.com/prudentbird/voxx#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prudentbird/voxx.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/prudentbird/voxx/issues"
+  },
+  "keywords": [
+    "cms",
+    "markdown",
+    "blog",
+    "docs",
+    "changelog",
+    "static-site",
+    "seo",
+    "rss",
+    "llms-txt",
+    "effect"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "theme",
+    "voxx.schema.json",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./effect": {
+      "import": {
+        "types": "./dist/effect.d.mts",
+        "default": "./dist/effect.mjs"
+      },
+      "require": {
+        "types": "./dist/effect.d.cts",
+        "default": "./dist/effect.cjs"
+      }
+    },
+    "./theme/voxx.css": "./theme/voxx.css",
+    "./theme/demo-globals.css": "./theme/demo-globals.css",
+    "./voxx.schema.json": "./voxx.schema.json",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@effect/platform": "^0.96.1",
+    "@effect/platform-node": "^0.107.0",
+    "@shikijs/rehype": "^4.2.0",
+    "effect": "^3.21.3",
+    "gray-matter": "^4.0.3",
+    "hast-util-to-string": "^3.0.1",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-raw": "^7.0.0",
+    "rehype-slug": "^6.0.0",
+    "rehype-stringify": "^10.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.2",
+    "shiki": "^4.2.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.4",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^25.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260610.1",
+    "eslint": "^10.0.2",
+    "jiti": "^2.7.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "@voxx/typescript-config": "0.0.1",
+    "@voxx/eslint-config": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsdown && node ./scripts/gen-schema.ts",
+    "dev": "tsdown --watch",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "typecheck": "tsgo --pretty --noEmit",
+    "test": "vitest run"
+  }
+}

package/theme/demo-globals.css

@@ -0,0 +1,61 @@
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+:root {
+  --background: #ffffff;
+  --foreground: #09090b;
+  --muted: #f4f4f5;
+  --muted-foreground: #71717a;
+  --border: #e4e4e7;
+  --input: #e4e4e7;
+  --primary: #18181b;
+  --primary-foreground: #fafafa;
+  --accent: #f4f4f5;
+  --accent-foreground: #18181b;
+  --ring: #18181b;
+  --radius: 0.5rem;
+}
+
+.dark {
+  --background: #09090b;
+  --foreground: #fafafa;
+  --muted: #18181b;
+  --muted-foreground: #a1a1aa;
+  --border: #27272a;
+  --input: #27272a;
+  --primary: #fafafa;
+  --primary-foreground: #18181b;
+  --accent: #27272a;
+  --accent-foreground: #fafafa;
+  --ring: #d4d4d8;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not(.light) {
+    --background: #09090b;
+    --foreground: #fafafa;
+    --muted: #18181b;
+    --muted-foreground: #a1a1aa;
+    --border: #27272a;
+    --input: #27272a;
+    --primary: #fafafa;
+    --primary-foreground: #18181b;
+    --accent: #27272a;
+    --accent-foreground: #fafafa;
+    --ring: #d4d4d8;
+  }
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  background: var(--background);
+  color: var(--foreground);
+  font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+}