@mzebley/mark-down 1.0.0

package/dist/index.cjs

@@ -0,0 +1,228 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  SnippetClient: () => SnippetClient,
+  normalizeSlug: () => normalizeSlug
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/snippet-client.ts
+var import_gray_matter = __toESM(require("gray-matter"), 1);
+var import_marked = require("marked");
+var OPTIONAL_FIELDS = [
+  "title",
+  "order",
+  "type",
+  "tags",
+  "draft"
+];
+var SnippetClient = class {
+  constructor(options) {
+    this.snippetCache = /* @__PURE__ */ new Map();
+    this.manifestSource = options.manifest;
+    this.fetcher = options.fetcher ?? defaultFetch;
+    this.markdownRenderer = options.markdownRenderer ?? import_marked.marked.parse;
+    this.resolveSnippetPath = options.resolveSnippetPath ?? ((meta) => meta.path);
+  }
+  async get(slug) {
+    const manifest = await this.loadManifest();
+    const entry = manifest.find((snippet) => snippet.slug === slug);
+    if (!entry) {
+      return void 0;
+    }
+    return this.loadSnippet(entry);
+  }
+  async list(filter, options) {
+    const manifest = await this.loadManifest();
+    let predicate;
+    let finalOptions = {};
+    if (typeof filter === "function") {
+      predicate = filter;
+      finalOptions = options ?? {};
+    } else if (filter) {
+      finalOptions = filter;
+    } else if (options) {
+      finalOptions = options;
+    }
+    let items = manifest;
+    const filters = [];
+    if (predicate) {
+      filters.push(predicate);
+    }
+    if (finalOptions.filter) {
+      filters.push(finalOptions.filter);
+    }
+    if (filters.length) {
+      items = items.filter((entry) => filters.every((fn) => fn(entry)));
+    }
+    const offset = finalOptions.offset ?? 0;
+    const limit = finalOptions.limit;
+    if (offset > 0) {
+      items = items.slice(offset);
+    }
+    if (typeof limit === "number") {
+      items = items.slice(0, limit);
+    }
+    return [...items];
+  }
+  listByType(type, options) {
+    return this.list((entry) => entry.type === type, options);
+  }
+  listByGroup(group, options) {
+    return this.list((entry) => entry.group === group, options);
+  }
+  loadSnippet(meta) {
+    const cached = this.snippetCache.get(meta.slug);
+    if (cached) {
+      return cached;
+    }
+    const promise = this.fetchSnippet(meta);
+    this.snippetCache.set(meta.slug, promise);
+    return promise;
+  }
+  async fetchSnippet(meta) {
+    const snippetPath = this.resolveSnippetPath(meta);
+    const response = await this.fetcher(snippetPath);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch snippet '${meta.slug}' (status ${response.status})`);
+    }
+    const rawContent = await response.text();
+    const parsed = (0, import_gray_matter.default)(rawContent);
+    const frontMatter = sanitizeFrontMatter(parsed.data ?? {});
+    const mergedMeta = mergeFrontMatter(meta, frontMatter.meta);
+    const html = await this.markdownRenderer(parsed.content);
+    const baseExtra = mergedMeta.extra ?? {};
+    return {
+      ...mergedMeta,
+      extra: {
+        ...baseExtra,
+        ...frontMatter.extra
+      },
+      markdown: parsed.content,
+      html
+    };
+  }
+  loadManifest() {
+    if (!this.manifestPromise) {
+      this.manifestPromise = this.resolveManifest();
+    }
+    return this.manifestPromise;
+  }
+  async resolveManifest() {
+    if (Array.isArray(this.manifestSource)) {
+      return this.manifestSource;
+    }
+    if (typeof this.manifestSource === "function") {
+      const result = await this.manifestSource();
+      return Array.isArray(result) ? result : Promise.reject(new Error("Manifest function must return an array"));
+    }
+    const raw = await this.fetchText(this.manifestSource);
+    const manifest = JSON.parse(raw);
+    if (!Array.isArray(manifest)) {
+      throw new Error("Manifest must be an array");
+    }
+    return manifest;
+  }
+  async fetchText(path) {
+    const response = await this.fetcher(path);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch manifest from ${path} (status ${response.status})`);
+    }
+    return response.text();
+  }
+};
+function sanitizeFrontMatter(data) {
+  const meta = {};
+  const extra = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (OPTIONAL_FIELDS.includes(key)) {
+      if (key === "tags") {
+        meta.tags = normalizeTags(value);
+      } else {
+        meta[key] = value;
+      }
+    } else {
+      extra[key] = value;
+    }
+  }
+  return { meta, extra };
+}
+function normalizeTags(value) {
+  if (!value) {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    return value.map((tag) => String(tag));
+  }
+  if (typeof value === "string") {
+    return value.split(",").map((tag) => tag.trim()).filter(Boolean);
+  }
+  return void 0;
+}
+function mergeFrontMatter(base, overrides) {
+  const merged = { ...base };
+  for (const field of OPTIONAL_FIELDS) {
+    const overrideValue = overrides[field];
+    if (overrideValue !== void 0 && merged[field] === void 0) {
+      merged[field] = overrideValue;
+    }
+  }
+  return merged;
+}
+async function defaultFetch(input) {
+  const runtimeFetch = globalThis.fetch;
+  if (!runtimeFetch) {
+    throw new Error("No global fetch implementation found. Provide a custom fetcher.");
+  }
+  return runtimeFetch(input);
+}
+
+// src/slug.ts
+var NON_ALPHANUMERIC = /[^a-z0-9]+/gi;
+var LEADING_TRAILING_DASH = /^-+|-+$/g;
+function normalizeSlug(input) {
+  const value = input?.trim();
+  if (!value) {
+    throw new Error("Cannot normalize an empty slug");
+  }
+  const normalized = value.toLowerCase().replace(NON_ALPHANUMERIC, "-").replace(/-{2,}/g, "-").replace(LEADING_TRAILING_DASH, "");
+  if (!normalized) {
+    throw new Error(`Slug '${input}' does not contain any alphanumeric characters`);
+  }
+  return normalized;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SnippetClient,
+  normalizeSlug
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/snippet-client.ts","../src/slug.ts"],"sourcesContent":["export * from \"./types\";\nexport * from \"./snippet-client\";\nexport { normalizeSlug } from \"./slug\";\n","import matter from \"gray-matter\";\nimport { marked } from \"marked\";\nimport type {\n  ListOptions,\n  ManifestSource,\n  ResponseLike,\n  Snippet,\n  SnippetClientOptions,\n  SnippetFilter,\n  SnippetMeta\n} from \"./types\";\n\nconst OPTIONAL_FIELDS: Array<keyof SnippetMeta> = [\n  \"title\",\n  \"order\",\n  \"type\",\n  \"tags\",\n  \"draft\"\n];\n\nexport class SnippetClient {\n  private readonly manifestSource: ManifestSource;\n  private readonly fetcher: (input: string) => Promise<ResponseLike>;\n  private readonly markdownRenderer: (markdown: string) => Promise<string> | string;\n  private readonly resolveSnippetPath: (meta: SnippetMeta) => string;\n  private manifestPromise?: Promise<SnippetMeta[]>;\n  private snippetCache = new Map<string, Promise<Snippet>>();\n\n  constructor(options: SnippetClientOptions) {\n    this.manifestSource = options.manifest;\n    this.fetcher = options.fetcher ?? defaultFetch;\n    this.markdownRenderer = options.markdownRenderer ?? marked.parse;\n    this.resolveSnippetPath = options.resolveSnippetPath ?? ((meta) => meta.path);\n  }\n\n  async get(slug: string): Promise<Snippet | undefined> {\n    const manifest = await this.loadManifest();\n    const entry = manifest.find((snippet) => snippet.slug === slug);\n    if (!entry) {\n      return undefined;\n    }\n\n    return this.loadSnippet(entry);\n  }\n\n  async list(filter?: SnippetFilter | ListOptions, options?: ListOptions): Promise<SnippetMeta[]> {\n    const manifest = await this.loadManifest();\n    let predicate: SnippetFilter | undefined;\n    let finalOptions: ListOptions = {};\n\n    if (typeof filter === \"function\") {\n      predicate = filter;\n      finalOptions = options ?? {};\n    } else if (filter) {\n      finalOptions = filter;\n    } else if (options) {\n      finalOptions = options;\n    }\n\n    let items = manifest;\n    const filters: SnippetFilter[] = [];\n    if (predicate) {\n      filters.push(predicate);\n    }\n    if (finalOptions.filter) {\n      filters.push(finalOptions.filter);\n    }\n    if (filters.length) {\n      items = items.filter((entry) => filters.every((fn) => fn(entry)));\n    }\n\n    const offset = finalOptions.offset ?? 0;\n    const limit = finalOptions.limit;\n    if (offset > 0) {\n      items = items.slice(offset);\n    }\n    if (typeof limit === \"number\") {\n      items = items.slice(0, limit);\n    }\n\n    return [...items];\n  }\n\n  listByType(type: string, options?: ListOptions): Promise<SnippetMeta[]> {\n    return this.list((entry) => entry.type === type, options);\n  }\n\n  listByGroup(group: string, options?: ListOptions): Promise<SnippetMeta[]> {\n    return this.list((entry) => entry.group === group, options);\n  }\n\n  private loadSnippet(meta: SnippetMeta): Promise<Snippet> {\n    const cached = this.snippetCache.get(meta.slug);\n    if (cached) {\n      return cached;\n    }\n\n    const promise = this.fetchSnippet(meta);\n    this.snippetCache.set(meta.slug, promise);\n    return promise;\n  }\n\n  private async fetchSnippet(meta: SnippetMeta): Promise<Snippet> {\n    const snippetPath = this.resolveSnippetPath(meta);\n    const response = await this.fetcher(snippetPath);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch snippet '${meta.slug}' (status ${response.status})`);\n    }\n\n    const rawContent = await response.text();\n    const parsed = matter(rawContent);\n    const frontMatter = sanitizeFrontMatter(parsed.data ?? {});\n    const mergedMeta = mergeFrontMatter(meta, frontMatter.meta);\n\n    const html = await this.markdownRenderer(parsed.content);\n\n    const baseExtra = mergedMeta.extra ?? {};\n    return {\n      ...mergedMeta,\n      extra: {\n        ...baseExtra,\n        ...frontMatter.extra\n      },\n      markdown: parsed.content,\n      html\n    };\n  }\n\n  private loadManifest(): Promise<SnippetMeta[]> {\n    if (!this.manifestPromise) {\n      this.manifestPromise = this.resolveManifest();\n    }\n    return this.manifestPromise;\n  }\n\n  private async resolveManifest(): Promise<SnippetMeta[]> {\n    if (Array.isArray(this.manifestSource)) {\n      return this.manifestSource;\n    }\n\n    if (typeof this.manifestSource === \"function\") {\n      const result = await this.manifestSource();\n      return Array.isArray(result) ? result : Promise.reject(new Error(\"Manifest function must return an array\"));\n    }\n\n    const raw = await this.fetchText(this.manifestSource);\n    const manifest = JSON.parse(raw);\n    if (!Array.isArray(manifest)) {\n      throw new Error(\"Manifest must be an array\");\n    }\n    return manifest;\n  }\n\n  private async fetchText(path: string): Promise<string> {\n    const response = await this.fetcher(path);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch manifest from ${path} (status ${response.status})`);\n    }\n    return response.text();\n  }\n}\n\nfunction sanitizeFrontMatter(data: Record<string, unknown>) {\n  const meta: Partial<SnippetMeta> = {};\n  const extra: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(data)) {\n    if (OPTIONAL_FIELDS.includes(key as keyof SnippetMeta)) {\n      if (key === \"tags\") {\n        meta.tags = normalizeTags(value);\n      } else {\n        (meta as Record<string, unknown>)[key] = value;\n      }\n    } else {\n      extra[key] = value;\n    }\n  }\n\n  return { meta, extra };\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((tag) => String(tag));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((tag) => tag.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction mergeFrontMatter(base: SnippetMeta, overrides: Partial<SnippetMeta>): SnippetMeta {\n  const merged: SnippetMeta = { ...base };\n  for (const field of OPTIONAL_FIELDS) {\n    const overrideValue = overrides[field];\n    if (overrideValue !== undefined && merged[field] === undefined) {\n      merged[field] = overrideValue as never;\n    }\n  }\n  return merged;\n}\n\nasync function defaultFetch(input: string): Promise<ResponseLike> {\n  const runtimeFetch = (globalThis as typeof globalThis & { fetch?: typeof fetch }).fetch;\n  if (!runtimeFetch) {\n    throw new Error(\"No global fetch implementation found. Provide a custom fetcher.\");\n  }\n  return runtimeFetch(input);\n}\n","const NON_ALPHANUMERIC = /[^a-z0-9]+/gi;\nconst LEADING_TRAILING_DASH = /^-+|-+$/g;\n\nexport function normalizeSlug(input: string): string {\n  const value = input?.trim();\n  if (!value) {\n    throw new Error(\"Cannot normalize an empty slug\");\n  }\n\n  const normalized = value\n    .toLowerCase()\n    .replace(NON_ALPHANUMERIC, \"-\")\n    .replace(/-{2,}/g, \"-\")\n    .replace(LEADING_TRAILING_DASH, \"\");\n\n  if (!normalized) {\n    throw new Error(`Slug '${input}' does not contain any alphanumeric characters`);\n  }\n\n  return normalized;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAAmB;AACnB,oBAAuB;AAWvB,IAAM,kBAA4C;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,gBAAN,MAAoB;AAAA,EAQzB,YAAY,SAA+B;AAF3C,SAAQ,eAAe,oBAAI,IAA8B;AAGvD,SAAK,iBAAiB,QAAQ;AAC9B,SAAK,UAAU,QAAQ,WAAW;AAClC,SAAK,mBAAmB,QAAQ,oBAAoB,qBAAO;AAC3D,SAAK,qBAAqB,QAAQ,uBAAuB,CAAC,SAAS,KAAK;AAAA,EAC1E;AAAA,EAEA,MAAM,IAAI,MAA4C;AACpD,UAAM,WAAW,MAAM,KAAK,aAAa;AACzC,UAAM,QAAQ,SAAS,KAAK,CAAC,YAAY,QAAQ,SAAS,IAAI;AAC9D,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,YAAY,KAAK;AAAA,EAC/B;AAAA,EAEA,MAAM,KAAK,QAAsC,SAA+C;AAC9F,UAAM,WAAW,MAAM,KAAK,aAAa;AACzC,QAAI;AACJ,QAAI,eAA4B,CAAC;AAEjC,QAAI,OAAO,WAAW,YAAY;AAChC,kBAAY;AACZ,qBAAe,WAAW,CAAC;AAAA,IAC7B,WAAW,QAAQ;AACjB,qBAAe;AAAA,IACjB,WAAW,SAAS;AAClB,qBAAe;AAAA,IACjB;AAEA,QAAI,QAAQ;AACZ,UAAM,UAA2B,CAAC;AAClC,QAAI,WAAW;AACb,cAAQ,KAAK,SAAS;AAAA,IACxB;AACA,QAAI,aAAa,QAAQ;AACvB,cAAQ,KAAK,aAAa,MAAM;AAAA,IAClC;AACA,QAAI,QAAQ,QAAQ;AAClB,cAAQ,MAAM,OAAO,CAAC,UAAU,QAAQ,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;AAAA,IAClE;AAEA,UAAM,SAAS,aAAa,UAAU;AACtC,UAAM,QAAQ,aAAa;AAC3B,QAAI,SAAS,GAAG;AACd,cAAQ,MAAM,MAAM,MAAM;AAAA,IAC5B;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,cAAQ,MAAM,MAAM,GAAG,KAAK;AAAA,IAC9B;AAEA,WAAO,CAAC,GAAG,KAAK;AAAA,EAClB;AAAA,EAEA,WAAW,MAAc,SAA+C;AACtE,WAAO,KAAK,KAAK,CAAC,UAAU,MAAM,SAAS,MAAM,OAAO;AAAA,EAC1D;AAAA,EAEA,YAAY,OAAe,SAA+C;AACxE,WAAO,KAAK,KAAK,CAAC,UAAU,MAAM,UAAU,OAAO,OAAO;AAAA,EAC5D;AAAA,EAEQ,YAAY,MAAqC;AACvD,UAAM,SAAS,KAAK,aAAa,IAAI,KAAK,IAAI;AAC9C,QAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,KAAK,aAAa,IAAI;AACtC,SAAK,aAAa,IAAI,KAAK,MAAM,OAAO;AACxC,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,aAAa,MAAqC;AAC9D,UAAM,cAAc,KAAK,mBAAmB,IAAI;AAChD,UAAM,WAAW,MAAM,KAAK,QAAQ,WAAW;AAC/C,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,4BAA4B,KAAK,IAAI,aAAa,SAAS,MAAM,GAAG;AAAA,IACtF;AAEA,UAAM,aAAa,MAAM,SAAS,KAAK;AACvC,UAAM,aAAS,mBAAAA,SAAO,UAAU;AAChC,UAAM,cAAc,oBAAoB,OAAO,QAAQ,CAAC,CAAC;AACzD,UAAM,aAAa,iBAAiB,MAAM,YAAY,IAAI;AAE1D,UAAM,OAAO,MAAM,KAAK,iBAAiB,OAAO,OAAO;AAEvD,UAAM,YAAY,WAAW,SAAS,CAAC;AACvC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG;AAAA,QACH,GAAG,YAAY;AAAA,MACjB;AAAA,MACA,UAAU,OAAO;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,eAAuC;AAC7C,QAAI,CAAC,KAAK,iBAAiB;AACzB,WAAK,kBAAkB,KAAK,gBAAgB;AAAA,IAC9C;AACA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,kBAA0C;AACtD,QAAI,MAAM,QAAQ,KAAK,cAAc,GAAG;AACtC,aAAO,KAAK;AAAA,IACd;AAEA,QAAI,OAAO,KAAK,mBAAmB,YAAY;AAC7C,YAAM,SAAS,MAAM,KAAK,eAAe;AACzC,aAAO,MAAM,QAAQ,MAAM,IAAI,SAAS,QAAQ,OAAO,IAAI,MAAM,wCAAwC,CAAC;AAAA,IAC5G;AAEA,UAAM,MAAM,MAAM,KAAK,UAAU,KAAK,cAAc;AACpD,UAAM,WAAW,KAAK,MAAM,GAAG;AAC/B,QAAI,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC5B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,UAAU,MAA+B;AACrD,UAAM,WAAW,MAAM,KAAK,QAAQ,IAAI;AACxC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,iCAAiC,IAAI,YAAY,SAAS,MAAM,GAAG;AAAA,IACrF;AACA,WAAO,SAAS,KAAK;AAAA,EACvB;AACF;AAEA,SAAS,oBAAoB,MAA+B;AAC1D,QAAM,OAA6B,CAAC;AACpC,QAAM,QAAiC,CAAC;AAExC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,gBAAgB,SAAS,GAAwB,GAAG;AACtD,UAAI,QAAQ,QAAQ;AAClB,aAAK,OAAO,cAAc,KAAK;AAAA,MACjC,OAAO;AACL,QAAC,KAAiC,GAAG,IAAI;AAAA,MAC3C;AAAA,IACF,OAAO;AACL,YAAM,GAAG,IAAI;AAAA,IACf;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,MAAM;AACvB;AAEA,SAAS,cAAc,OAAsC;AAC3D,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,QAAQ,OAAO,GAAG,CAAC;AAAA,EACvC;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,EACvB,OAAO,OAAO;AAAA,EACnB;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,MAAmB,WAA8C;AACzF,QAAM,SAAsB,EAAE,GAAG,KAAK;AACtC,aAAW,SAAS,iBAAiB;AACnC,UAAM,gBAAgB,UAAU,KAAK;AACrC,QAAI,kBAAkB,UAAa,OAAO,KAAK,MAAM,QAAW;AAC9D,aAAO,KAAK,IAAI;AAAA,IAClB;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,aAAa,OAAsC;AAChE,QAAM,eAAgB,WAA4D;AAClF,MAAI,CAAC,cAAc;AACjB,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AACA,SAAO,aAAa,KAAK;AAC3B;;;ACtNA,IAAM,mBAAmB;AACzB,IAAM,wBAAwB;AAEvB,SAAS,cAAc,OAAuB;AACnD,QAAM,QAAQ,OAAO,KAAK;AAC1B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD;AAEA,QAAM,aAAa,MAChB,YAAY,EACZ,QAAQ,kBAAkB,GAAG,EAC7B,QAAQ,UAAU,GAAG,EACrB,QAAQ,uBAAuB,EAAE;AAEpC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,SAAS,KAAK,gDAAgD;AAAA,EAChF;AAEA,SAAO;AACT;","names":["matter"]}

package/dist/index.d.cts

@@ -0,0 +1,60 @@
+export { normalizeSlug } from './slug.cjs';
+
+interface SnippetMeta {
+    slug: string;
+    title?: string;
+    order?: number | null;
+    type?: string;
+    tags?: string[];
+    draft?: boolean;
+    path: string;
+    group: string;
+    extra?: Record<string, unknown>;
+}
+interface Snippet extends SnippetMeta {
+    markdown: string;
+    html: string;
+}
+type SnippetFilter = (snippet: SnippetMeta) => boolean;
+interface ListOptions {
+    filter?: SnippetFilter;
+    limit?: number;
+    offset?: number;
+}
+type ManifestSource = string | SnippetMeta[] | (() => Promise<SnippetMeta[]> | SnippetMeta[]);
+interface SnippetClientOptions {
+    /** Where to load the manifest; defaults to `/snippets-index.json`. */
+    manifest: ManifestSource;
+    /** Custom fetch to use in Node environments. Falls back to global `fetch`. */
+    fetcher?: (input: string) => Promise<ResponseLike>;
+    /** Allows overriding markdown → HTML rendering. Defaults to `marked`. */
+    markdownRenderer?: (markdown: string) => Promise<string> | string;
+    /** Customize how snippet URLs are resolved; defaults to the manifest `path`. */
+    resolveSnippetPath?: (meta: SnippetMeta) => string;
+}
+interface ResponseLike {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}
+
+declare class SnippetClient {
+    private readonly manifestSource;
+    private readonly fetcher;
+    private readonly markdownRenderer;
+    private readonly resolveSnippetPath;
+    private manifestPromise?;
+    private snippetCache;
+    constructor(options: SnippetClientOptions);
+    get(slug: string): Promise<Snippet | undefined>;
+    list(filter?: SnippetFilter | ListOptions, options?: ListOptions): Promise<SnippetMeta[]>;
+    listByType(type: string, options?: ListOptions): Promise<SnippetMeta[]>;
+    listByGroup(group: string, options?: ListOptions): Promise<SnippetMeta[]>;
+    private loadSnippet;
+    private fetchSnippet;
+    private loadManifest;
+    private resolveManifest;
+    private fetchText;
+}
+
+export { type ListOptions, type ManifestSource, type ResponseLike, type Snippet, SnippetClient, type SnippetClientOptions, type SnippetFilter, type SnippetMeta };

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+export { normalizeSlug } from './slug.js';
+
+interface SnippetMeta {
+    slug: string;
+    title?: string;
+    order?: number | null;
+    type?: string;
+    tags?: string[];
+    draft?: boolean;
+    path: string;
+    group: string;
+    extra?: Record<string, unknown>;
+}
+interface Snippet extends SnippetMeta {
+    markdown: string;
+    html: string;
+}
+type SnippetFilter = (snippet: SnippetMeta) => boolean;
+interface ListOptions {
+    filter?: SnippetFilter;
+    limit?: number;
+    offset?: number;
+}
+type ManifestSource = string | SnippetMeta[] | (() => Promise<SnippetMeta[]> | SnippetMeta[]);
+interface SnippetClientOptions {
+    /** Where to load the manifest; defaults to `/snippets-index.json`. */
+    manifest: ManifestSource;
+    /** Custom fetch to use in Node environments. Falls back to global `fetch`. */
+    fetcher?: (input: string) => Promise<ResponseLike>;
+    /** Allows overriding markdown → HTML rendering. Defaults to `marked`. */
+    markdownRenderer?: (markdown: string) => Promise<string> | string;
+    /** Customize how snippet URLs are resolved; defaults to the manifest `path`. */
+    resolveSnippetPath?: (meta: SnippetMeta) => string;
+}
+interface ResponseLike {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}
+
+declare class SnippetClient {
+    private readonly manifestSource;
+    private readonly fetcher;
+    private readonly markdownRenderer;
+    private readonly resolveSnippetPath;
+    private manifestPromise?;
+    private snippetCache;
+    constructor(options: SnippetClientOptions);
+    get(slug: string): Promise<Snippet | undefined>;
+    list(filter?: SnippetFilter | ListOptions, options?: ListOptions): Promise<SnippetMeta[]>;
+    listByType(type: string, options?: ListOptions): Promise<SnippetMeta[]>;
+    listByGroup(group: string, options?: ListOptions): Promise<SnippetMeta[]>;
+    private loadSnippet;
+    private fetchSnippet;
+    private loadManifest;
+    private resolveManifest;
+    private fetchText;
+}
+
+export { type ListOptions, type ManifestSource, type ResponseLike, type Snippet, SnippetClient, type SnippetClientOptions, type SnippetFilter, type SnippetMeta };

package/dist/index.mjs

@@ -0,0 +1,179 @@
+import {
+  normalizeSlug
+} from "./chunk-TQ5Y4RZJ.mjs";
+
+// src/snippet-client.ts
+import matter from "gray-matter";
+import { marked } from "marked";
+var OPTIONAL_FIELDS = [
+  "title",
+  "order",
+  "type",
+  "tags",
+  "draft"
+];
+var SnippetClient = class {
+  constructor(options) {
+    this.snippetCache = /* @__PURE__ */ new Map();
+    this.manifestSource = options.manifest;
+    this.fetcher = options.fetcher ?? defaultFetch;
+    this.markdownRenderer = options.markdownRenderer ?? marked.parse;
+    this.resolveSnippetPath = options.resolveSnippetPath ?? ((meta) => meta.path);
+  }
+  async get(slug) {
+    const manifest = await this.loadManifest();
+    const entry = manifest.find((snippet) => snippet.slug === slug);
+    if (!entry) {
+      return void 0;
+    }
+    return this.loadSnippet(entry);
+  }
+  async list(filter, options) {
+    const manifest = await this.loadManifest();
+    let predicate;
+    let finalOptions = {};
+    if (typeof filter === "function") {
+      predicate = filter;
+      finalOptions = options ?? {};
+    } else if (filter) {
+      finalOptions = filter;
+    } else if (options) {
+      finalOptions = options;
+    }
+    let items = manifest;
+    const filters = [];
+    if (predicate) {
+      filters.push(predicate);
+    }
+    if (finalOptions.filter) {
+      filters.push(finalOptions.filter);
+    }
+    if (filters.length) {
+      items = items.filter((entry) => filters.every((fn) => fn(entry)));
+    }
+    const offset = finalOptions.offset ?? 0;
+    const limit = finalOptions.limit;
+    if (offset > 0) {
+      items = items.slice(offset);
+    }
+    if (typeof limit === "number") {
+      items = items.slice(0, limit);
+    }
+    return [...items];
+  }
+  listByType(type, options) {
+    return this.list((entry) => entry.type === type, options);
+  }
+  listByGroup(group, options) {
+    return this.list((entry) => entry.group === group, options);
+  }
+  loadSnippet(meta) {
+    const cached = this.snippetCache.get(meta.slug);
+    if (cached) {
+      return cached;
+    }
+    const promise = this.fetchSnippet(meta);
+    this.snippetCache.set(meta.slug, promise);
+    return promise;
+  }
+  async fetchSnippet(meta) {
+    const snippetPath = this.resolveSnippetPath(meta);
+    const response = await this.fetcher(snippetPath);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch snippet '${meta.slug}' (status ${response.status})`);
+    }
+    const rawContent = await response.text();
+    const parsed = matter(rawContent);
+    const frontMatter = sanitizeFrontMatter(parsed.data ?? {});
+    const mergedMeta = mergeFrontMatter(meta, frontMatter.meta);
+    const html = await this.markdownRenderer(parsed.content);
+    const baseExtra = mergedMeta.extra ?? {};
+    return {
+      ...mergedMeta,
+      extra: {
+        ...baseExtra,
+        ...frontMatter.extra
+      },
+      markdown: parsed.content,
+      html
+    };
+  }
+  loadManifest() {
+    if (!this.manifestPromise) {
+      this.manifestPromise = this.resolveManifest();
+    }
+    return this.manifestPromise;
+  }
+  async resolveManifest() {
+    if (Array.isArray(this.manifestSource)) {
+      return this.manifestSource;
+    }
+    if (typeof this.manifestSource === "function") {
+      const result = await this.manifestSource();
+      return Array.isArray(result) ? result : Promise.reject(new Error("Manifest function must return an array"));
+    }
+    const raw = await this.fetchText(this.manifestSource);
+    const manifest = JSON.parse(raw);
+    if (!Array.isArray(manifest)) {
+      throw new Error("Manifest must be an array");
+    }
+    return manifest;
+  }
+  async fetchText(path) {
+    const response = await this.fetcher(path);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch manifest from ${path} (status ${response.status})`);
+    }
+    return response.text();
+  }
+};
+function sanitizeFrontMatter(data) {
+  const meta = {};
+  const extra = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (OPTIONAL_FIELDS.includes(key)) {
+      if (key === "tags") {
+        meta.tags = normalizeTags(value);
+      } else {
+        meta[key] = value;
+      }
+    } else {
+      extra[key] = value;
+    }
+  }
+  return { meta, extra };
+}
+function normalizeTags(value) {
+  if (!value) {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    return value.map((tag) => String(tag));
+  }
+  if (typeof value === "string") {
+    return value.split(",").map((tag) => tag.trim()).filter(Boolean);
+  }
+  return void 0;
+}
+function mergeFrontMatter(base, overrides) {
+  const merged = { ...base };
+  for (const field of OPTIONAL_FIELDS) {
+    const overrideValue = overrides[field];
+    if (overrideValue !== void 0 && merged[field] === void 0) {
+      merged[field] = overrideValue;
+    }
+  }
+  return merged;
+}
+async function defaultFetch(input) {
+  const runtimeFetch = globalThis.fetch;
+  if (!runtimeFetch) {
+    throw new Error("No global fetch implementation found. Provide a custom fetcher.");
+  }
+  return runtimeFetch(input);
+}
+export {
+  SnippetClient,
+  normalizeSlug
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/snippet-client.ts"],"sourcesContent":["import matter from \"gray-matter\";\nimport { marked } from \"marked\";\nimport type {\n  ListOptions,\n  ManifestSource,\n  ResponseLike,\n  Snippet,\n  SnippetClientOptions,\n  SnippetFilter,\n  SnippetMeta\n} from \"./types\";\n\nconst OPTIONAL_FIELDS: Array<keyof SnippetMeta> = [\n  \"title\",\n  \"order\",\n  \"type\",\n  \"tags\",\n  \"draft\"\n];\n\nexport class SnippetClient {\n  private readonly manifestSource: ManifestSource;\n  private readonly fetcher: (input: string) => Promise<ResponseLike>;\n  private readonly markdownRenderer: (markdown: string) => Promise<string> | string;\n  private readonly resolveSnippetPath: (meta: SnippetMeta) => string;\n  private manifestPromise?: Promise<SnippetMeta[]>;\n  private snippetCache = new Map<string, Promise<Snippet>>();\n\n  constructor(options: SnippetClientOptions) {\n    this.manifestSource = options.manifest;\n    this.fetcher = options.fetcher ?? defaultFetch;\n    this.markdownRenderer = options.markdownRenderer ?? marked.parse;\n    this.resolveSnippetPath = options.resolveSnippetPath ?? ((meta) => meta.path);\n  }\n\n  async get(slug: string): Promise<Snippet | undefined> {\n    const manifest = await this.loadManifest();\n    const entry = manifest.find((snippet) => snippet.slug === slug);\n    if (!entry) {\n      return undefined;\n    }\n\n    return this.loadSnippet(entry);\n  }\n\n  async list(filter?: SnippetFilter | ListOptions, options?: ListOptions): Promise<SnippetMeta[]> {\n    const manifest = await this.loadManifest();\n    let predicate: SnippetFilter | undefined;\n    let finalOptions: ListOptions = {};\n\n    if (typeof filter === \"function\") {\n      predicate = filter;\n      finalOptions = options ?? {};\n    } else if (filter) {\n      finalOptions = filter;\n    } else if (options) {\n      finalOptions = options;\n    }\n\n    let items = manifest;\n    const filters: SnippetFilter[] = [];\n    if (predicate) {\n      filters.push(predicate);\n    }\n    if (finalOptions.filter) {\n      filters.push(finalOptions.filter);\n    }\n    if (filters.length) {\n      items = items.filter((entry) => filters.every((fn) => fn(entry)));\n    }\n\n    const offset = finalOptions.offset ?? 0;\n    const limit = finalOptions.limit;\n    if (offset > 0) {\n      items = items.slice(offset);\n    }\n    if (typeof limit === \"number\") {\n      items = items.slice(0, limit);\n    }\n\n    return [...items];\n  }\n\n  listByType(type: string, options?: ListOptions): Promise<SnippetMeta[]> {\n    return this.list((entry) => entry.type === type, options);\n  }\n\n  listByGroup(group: string, options?: ListOptions): Promise<SnippetMeta[]> {\n    return this.list((entry) => entry.group === group, options);\n  }\n\n  private loadSnippet(meta: SnippetMeta): Promise<Snippet> {\n    const cached = this.snippetCache.get(meta.slug);\n    if (cached) {\n      return cached;\n    }\n\n    const promise = this.fetchSnippet(meta);\n    this.snippetCache.set(meta.slug, promise);\n    return promise;\n  }\n\n  private async fetchSnippet(meta: SnippetMeta): Promise<Snippet> {\n    const snippetPath = this.resolveSnippetPath(meta);\n    const response = await this.fetcher(snippetPath);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch snippet '${meta.slug}' (status ${response.status})`);\n    }\n\n    const rawContent = await response.text();\n    const parsed = matter(rawContent);\n    const frontMatter = sanitizeFrontMatter(parsed.data ?? {});\n    const mergedMeta = mergeFrontMatter(meta, frontMatter.meta);\n\n    const html = await this.markdownRenderer(parsed.content);\n\n    const baseExtra = mergedMeta.extra ?? {};\n    return {\n      ...mergedMeta,\n      extra: {\n        ...baseExtra,\n        ...frontMatter.extra\n      },\n      markdown: parsed.content,\n      html\n    };\n  }\n\n  private loadManifest(): Promise<SnippetMeta[]> {\n    if (!this.manifestPromise) {\n      this.manifestPromise = this.resolveManifest();\n    }\n    return this.manifestPromise;\n  }\n\n  private async resolveManifest(): Promise<SnippetMeta[]> {\n    if (Array.isArray(this.manifestSource)) {\n      return this.manifestSource;\n    }\n\n    if (typeof this.manifestSource === \"function\") {\n      const result = await this.manifestSource();\n      return Array.isArray(result) ? result : Promise.reject(new Error(\"Manifest function must return an array\"));\n    }\n\n    const raw = await this.fetchText(this.manifestSource);\n    const manifest = JSON.parse(raw);\n    if (!Array.isArray(manifest)) {\n      throw new Error(\"Manifest must be an array\");\n    }\n    return manifest;\n  }\n\n  private async fetchText(path: string): Promise<string> {\n    const response = await this.fetcher(path);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch manifest from ${path} (status ${response.status})`);\n    }\n    return response.text();\n  }\n}\n\nfunction sanitizeFrontMatter(data: Record<string, unknown>) {\n  const meta: Partial<SnippetMeta> = {};\n  const extra: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(data)) {\n    if (OPTIONAL_FIELDS.includes(key as keyof SnippetMeta)) {\n      if (key === \"tags\") {\n        meta.tags = normalizeTags(value);\n      } else {\n        (meta as Record<string, unknown>)[key] = value;\n      }\n    } else {\n      extra[key] = value;\n    }\n  }\n\n  return { meta, extra };\n}\n\nfunction normalizeTags(value: unknown): string[] | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (Array.isArray(value)) {\n    return value.map((tag) => String(tag));\n  }\n  if (typeof value === \"string\") {\n    return value\n      .split(\",\")\n      .map((tag) => tag.trim())\n      .filter(Boolean);\n  }\n  return undefined;\n}\n\nfunction mergeFrontMatter(base: SnippetMeta, overrides: Partial<SnippetMeta>): SnippetMeta {\n  const merged: SnippetMeta = { ...base };\n  for (const field of OPTIONAL_FIELDS) {\n    const overrideValue = overrides[field];\n    if (overrideValue !== undefined && merged[field] === undefined) {\n      merged[field] = overrideValue as never;\n    }\n  }\n  return merged;\n}\n\nasync function defaultFetch(input: string): Promise<ResponseLike> {\n  const runtimeFetch = (globalThis as typeof globalThis & { fetch?: typeof fetch }).fetch;\n  if (!runtimeFetch) {\n    throw new Error(\"No global fetch implementation found. Provide a custom fetcher.\");\n  }\n  return runtimeFetch(input);\n}\n"],"mappings":"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","names":[]}

package/dist/slug.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/slug.ts
+var slug_exports = {};
+__export(slug_exports, {
+  normalizeSlug: () => normalizeSlug
+});
+module.exports = __toCommonJS(slug_exports);
+var NON_ALPHANUMERIC = /[^a-z0-9]+/gi;
+var LEADING_TRAILING_DASH = /^-+|-+$/g;
+function normalizeSlug(input) {
+  const value = input?.trim();
+  if (!value) {
+    throw new Error("Cannot normalize an empty slug");
+  }
+  const normalized = value.toLowerCase().replace(NON_ALPHANUMERIC, "-").replace(/-{2,}/g, "-").replace(LEADING_TRAILING_DASH, "");
+  if (!normalized) {
+    throw new Error(`Slug '${input}' does not contain any alphanumeric characters`);
+  }
+  return normalized;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  normalizeSlug
+});
+//# sourceMappingURL=slug.cjs.map

package/dist/slug.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/slug.ts"],"sourcesContent":["const NON_ALPHANUMERIC = /[^a-z0-9]+/gi;\nconst LEADING_TRAILING_DASH = /^-+|-+$/g;\n\nexport function normalizeSlug(input: string): string {\n  const value = input?.trim();\n  if (!value) {\n    throw new Error(\"Cannot normalize an empty slug\");\n  }\n\n  const normalized = value\n    .toLowerCase()\n    .replace(NON_ALPHANUMERIC, \"-\")\n    .replace(/-{2,}/g, \"-\")\n    .replace(LEADING_TRAILING_DASH, \"\");\n\n  if (!normalized) {\n    throw new Error(`Slug '${input}' does not contain any alphanumeric characters`);\n  }\n\n  return normalized;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAM,mBAAmB;AACzB,IAAM,wBAAwB;AAEvB,SAAS,cAAc,OAAuB;AACnD,QAAM,QAAQ,OAAO,KAAK;AAC1B,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD;AAEA,QAAM,aAAa,MAChB,YAAY,EACZ,QAAQ,kBAAkB,GAAG,EAC7B,QAAQ,UAAU,GAAG,EACrB,QAAQ,uBAAuB,EAAE;AAEpC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,SAAS,KAAK,gDAAgD;AAAA,EAChF;AAEA,SAAO;AACT;","names":[]}

package/dist/slug.d.cts

@@ -0,0 +1,3 @@
+declare function normalizeSlug(input: string): string;
+
+export { normalizeSlug };

package/dist/slug.d.ts

@@ -0,0 +1,3 @@
+declare function normalizeSlug(input: string): string;
+
+export { normalizeSlug };

package/dist/slug.mjs

@@ -0,0 +1,7 @@
+import {
+  normalizeSlug
+} from "./chunk-TQ5Y4RZJ.mjs";
+export {
+  normalizeSlug
+};
+//# sourceMappingURL=slug.mjs.map

package/dist/slug.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}