zreader 0.0.0-stage → 0.2.0

package/dist/config/index.d.ts

@@ -0,0 +1,159 @@
+import { z } from 'zod/v4';
+export { z } from 'zod/v4';
+
+/** Shared, framework-agnostic data model for zreader. */
+type ISODate = string;
+type PadScope = {
+    kind: "global";
+} | {
+    kind: "book";
+    bookId: string;
+} | {
+    kind: "chapter";
+    bookId: string;
+    chapterId: string;
+};
+type PadScopeKind = PadScope["kind"];
+type ThemeName = "system" | "light" | "sepia" | "dark";
+type Measure = "narrow" | "normal" | "wide";
+type FontFamily = "serif" | "sans" | "mono";
+type TextSize = "sm" | "base" | "lg" | "xl" | "2xl";
+type Leading = "tight" | "normal" | "relaxed";
+/** The palette the UI ships styles for (`::highlight(zr-<color>)`). */
+declare const HIGHLIGHT_COLORS: readonly ["yellow", "green", "blue", "pink", "purple", "orange"];
+type HighlightColor = (typeof HIGHLIGHT_COLORS)[number];
+interface ReaderSettings {
+    textSize: TextSize;
+    leading: Leading;
+    measure: Measure;
+    fontFamily: FontFamily;
+    /** Tap a sentence to highlight it with the default colour. */
+    highlightMode: boolean;
+    updatedAt: ISODate;
+}
+/** Serializable client options (the `reader` half of reader.config.ts). */
+interface ReaderClientOptions {
+    storagePrefix: string;
+    highlightColors: HighlightColor[];
+    defaultHighlightColor: HighlightColor;
+    scratchpad: {
+        enabled: boolean;
+        scopes: PadScopeKind[];
+    };
+    /** Themes offered in the UI. Applied as a class on <html> via next-themes. */
+    themes: ThemeName[];
+    defaultTheme: ThemeName;
+    defaultSettings: Omit<ReaderSettings, "updatedAt">;
+    progress: {
+        completeAt: number;
+        saveIntervalMs: number;
+    };
+    /** Show a "your notes only live in this browser" reminder. */
+    backupReminder: boolean;
+    /** Base path used to build links back into the reader (e.g. quote-to-pad). */
+    basePath: string;
+}
+
+interface GlobLoader {
+    kind: "glob";
+    /** Directory containing one folder per book. Relative to the project root. */
+    base: string;
+    /** Chapter files, relative to `base`. */
+    pattern: string | string[];
+    ignore?: string[];
+}
+/** Astro-style glob loader: `content/books/<book>/{book.json, 01-intro.md, ...}` */
+declare function glob(opts: {
+    base: string;
+    pattern?: string | string[];
+    ignore?: string[];
+}): GlobLoader;
+type PluginList = unknown[];
+interface SanitizeOptions {
+    /** Hostnames allowed for <iframe src>. Iframes are stripped unless listed here. */
+    allowIframes?: string[];
+    /** Extra tags to allow on top of DOMPurify's safe HTML profile. */
+    allowTags?: string[];
+    /** Extra attributes to allow. */
+    allowAttributes?: string[];
+}
+interface ContentConfig {
+    loader: GlobLoader;
+    schemas: {
+        book: z.ZodType;
+        chapter: z.ZodType;
+    };
+    /** Applied to `.md` and `.mdx`. */
+    remarkPlugins: PluginList;
+    rehypePlugins: PluginList;
+    sanitize: SanitizeOptions;
+    /** Include chapters with `draft: true`. Defaults to `true` in development. */
+    includeDrafts: boolean;
+    /** Where compiled chapters are cached. */
+    cacheDir: string;
+}
+type DeepPartial<T> = T extends unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+interface ReaderUserConfig {
+    content?: DeepPartial<Omit<ContentConfig, "schemas" | "loader">> & {
+        loader?: GlobLoader;
+        schemas?: Partial<ContentConfig["schemas"]>;
+    };
+    reader?: DeepPartial<ReaderClientOptions>;
+}
+interface ResolvedReaderConfig {
+    root: string;
+    content: ContentConfig;
+    reader: ReaderClientOptions;
+}
+declare const defaultBookSchema: z.ZodObject<{
+    title: z.ZodString;
+    subtitle: z.ZodOptional<z.ZodString>;
+    authors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    cover: z.ZodOptional<z.ZodString>;
+    /** Optional explicit chapter order (chapter slugs). */
+    chapters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+declare const defaultChapterSchema: z.ZodObject<{
+    title: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    part: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    number: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    draft: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>;
+declare function defaultContentConfig(): ContentConfig;
+/** Identity helper that gives `reader.config.ts` full type-checking. */
+declare function defineConfig(config: ReaderUserConfig): ReaderUserConfig;
+/**
+ * Deep merge: plain objects merge key-by-key, arrays and class instances
+ * (e.g. zod schemas) replace, `undefined` never overrides.
+ */
+declare function mergeConfig<T>(base: T, ...overrides: unknown[]): T;
+declare class ReaderConfigError extends Error {
+    readonly issues: {
+        path: string;
+        message: string;
+    }[];
+    constructor(message: string, issues?: {
+        path: string;
+        message: string;
+    }[]);
+}
+/**
+ * Resolve the final config: package defaults ← reader.config.ts ← inline overrides.
+ * Throws `ReaderConfigError` with readable messages.
+ */
+declare function resolveConfig(user?: ReaderUserConfig | null, inline?: ReaderUserConfig | null, opts?: {
+    root?: string;
+    source?: string;
+}): ResolvedReaderConfig;
+/** Only the serializable, client-safe half. */
+declare function clientOptions(config: ResolvedReaderConfig): ReaderClientOptions;
+declare const CONFIG_FILE_NAMES: string[];
+
+export { CONFIG_FILE_NAMES, ReaderConfigError, clientOptions, defaultBookSchema, defaultChapterSchema, defaultContentConfig, defineConfig, glob, mergeConfig, resolveConfig };
+export type { ContentConfig, GlobLoader, PluginList, ReaderUserConfig, ResolvedReaderConfig, SanitizeOptions };

package/dist/config/index.js

@@ -0,0 +1,182 @@
+import { z } from 'zod/v4';
+export { z } from 'zod/v4';
+
+// src/config/index.ts
+
+// src/core/defaults.ts
+var DEFAULT_CLIENT_OPTIONS = {
+  storagePrefix: "zr",
+  highlightColors: ["yellow", "green", "blue", "pink"],
+  defaultHighlightColor: "yellow",
+  scratchpad: { enabled: true, scopes: ["chapter", "book", "global"] },
+  themes: ["system", "light", "sepia", "dark"],
+  defaultTheme: "system",
+  defaultSettings: {
+    textSize: "lg",
+    leading: "relaxed",
+    measure: "normal",
+    fontFamily: "serif",
+    highlightMode: false
+  },
+  progress: { completeAt: 0.9, saveIntervalMs: 1e3 },
+  backupReminder: true,
+  basePath: "/books"
+};
+
+// src/core/types.ts
+var THEMES = ["system", "light", "sepia", "dark"];
+var TEXT_SIZES = ["sm", "base", "lg", "xl", "2xl"];
+var LEADINGS = ["tight", "normal", "relaxed"];
+var MEASURES = ["narrow", "normal", "wide"];
+var FONT_FAMILIES = ["serif", "sans", "mono"];
+var HIGHLIGHT_COLORS = ["yellow", "green", "blue", "pink", "purple", "orange"];
+
+// src/config/index.ts
+function glob(opts) {
+  return { kind: "glob", base: opts.base, pattern: opts.pattern ?? "**/*.{md,mdx,html}", ignore: opts.ignore };
+}
+var defaultBookSchema = z.looseObject({
+  title: z.string(),
+  subtitle: z.string().optional(),
+  authors: z.array(z.string()).default([]),
+  description: z.string().optional(),
+  cover: z.string().optional(),
+  /** Optional explicit chapter order (chapter slugs). */
+  chapters: z.array(z.string()).optional()
+});
+var defaultChapterSchema = z.looseObject({
+  title: z.string(),
+  order: z.number().optional(),
+  description: z.string().optional(),
+  part: z.string().optional(),
+  label: z.string().optional(),
+  number: z.union([z.string(), z.number()]).transform(String).optional(),
+  draft: z.boolean().default(false)
+});
+function isDev() {
+  return typeof process !== "undefined" && process.env?.NODE_ENV === "development";
+}
+function defaultContentConfig() {
+  return {
+    loader: glob({ base: "./content/books" }),
+    schemas: { book: defaultBookSchema, chapter: defaultChapterSchema },
+    remarkPlugins: [],
+    rehypePlugins: [],
+    sanitize: {},
+    includeDrafts: isDev(),
+    cacheDir: typeof process !== "undefined" && process.env?.ZREADER_CACHE_DIR || "node_modules/.cache/zreader"
+  };
+}
+function defineConfig(config) {
+  return config;
+}
+function isPlainObject(x) {
+  if (typeof x !== "object" || x === null || Array.isArray(x)) return false;
+  const proto = Object.getPrototypeOf(x);
+  return proto === Object.prototype || proto === null;
+}
+function mergeConfig(base, ...overrides) {
+  let out = base;
+  for (const o of overrides) out = mergeTwo(out, o);
+  return out;
+}
+function mergeTwo(a, b) {
+  if (b === void 0) return a;
+  if (isPlainObject(a) && isPlainObject(b)) {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) out[k] = mergeTwo(a[k], v);
+    return out;
+  }
+  return b;
+}
+var themeName = z.enum(THEMES);
+var highlightColor = z.enum(HIGHLIGHT_COLORS);
+var clientSchema = z.object({
+  storagePrefix: z.string().regex(/^[a-z0-9_-]+$/i, "use letters, digits, '-' or '_'"),
+  highlightColors: z.array(highlightColor).min(1, "must be non-empty"),
+  defaultHighlightColor: highlightColor,
+  scratchpad: z.object({
+    enabled: z.boolean(),
+    scopes: z.array(z.enum(["global", "book", "chapter"])).min(1, "must be non-empty")
+  }),
+  themes: z.array(themeName).min(1),
+  defaultTheme: themeName,
+  defaultSettings: z.object({
+    textSize: z.enum(TEXT_SIZES),
+    leading: z.enum(LEADINGS),
+    measure: z.enum(MEASURES),
+    fontFamily: z.enum(FONT_FAMILIES),
+    highlightMode: z.boolean()
+  }),
+  progress: z.object({ completeAt: z.number().gt(0).max(1), saveIntervalMs: z.number().min(100) }),
+  backupReminder: z.boolean(),
+  basePath: z.string().startsWith("/")
+}).refine((c) => c.highlightColors.includes(c.defaultHighlightColor), {
+  message: "defaultHighlightColor must be one of highlightColors",
+  path: ["defaultHighlightColor"]
+}).refine((c) => c.themes.includes(c.defaultTheme), {
+  message: "defaultTheme must be one of themes",
+  path: ["defaultTheme"]
+});
+function isSchemaLike(v) {
+  return typeof v === "object" && v !== null && typeof v.safeParse === "function";
+}
+var contentSchema = z.object({
+  loader: z.object({
+    kind: z.literal("glob"),
+    base: z.string().min(1),
+    pattern: z.union([z.string(), z.array(z.string()).min(1)]),
+    ignore: z.array(z.string()).optional()
+  }),
+  schemas: z.object({
+    book: z.custom(isSchemaLike, "must be a zod (or safeParse-compatible) schema"),
+    chapter: z.custom(isSchemaLike, "must be a zod (or safeParse-compatible) schema")
+  }),
+  remarkPlugins: z.array(z.any()),
+  rehypePlugins: z.array(z.any()),
+  sanitize: z.object({
+    allowIframes: z.array(z.string()).optional(),
+    allowTags: z.array(z.string()).optional(),
+    allowAttributes: z.array(z.string()).optional()
+  }),
+  includeDrafts: z.boolean(),
+  cacheDir: z.string()
+});
+var ReaderConfigError = class extends Error {
+  constructor(message, issues = []) {
+    super(message);
+    this.issues = issues;
+    this.name = "ReaderConfigError";
+  }
+  issues;
+};
+function formatIssues(source, section, error) {
+  const issues = error.issues.map((i) => ({ path: [section, ...i.path.map(String)].join("."), message: i.message }));
+  return new ReaderConfigError(
+    `Invalid reader config${source ? ` (${source})` : ""}:
+` + issues.map((i) => `  - ${i.path}: ${i.message}`).join("\n"),
+    issues
+  );
+}
+function resolveConfig(user, inline, opts = {}) {
+  const root = opts.root ?? (typeof process !== "undefined" && process.cwd ? process.cwd() : "/");
+  const reader = mergeConfig(
+    structuredClone(DEFAULT_CLIENT_OPTIONS),
+    user?.reader,
+    inline?.reader
+  );
+  const content = mergeConfig(defaultContentConfig(), user?.content, inline?.content);
+  const r = clientSchema.safeParse(reader);
+  if (!r.success) throw formatIssues(opts.source ?? "", "reader", r.error);
+  const c = contentSchema.safeParse(content);
+  if (!c.success) throw formatIssues(opts.source ?? "", "content", c.error);
+  return { root, content, reader };
+}
+function clientOptions(config) {
+  return config.reader;
+}
+var CONFIG_FILE_NAMES = ["reader.config.ts", "reader.config.mts", "reader.config.mjs", "reader.config.js"];
+
+export { CONFIG_FILE_NAMES, ReaderConfigError, clientOptions, defaultBookSchema, defaultChapterSchema, defaultContentConfig, defineConfig, glob, mergeConfig, resolveConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/defaults.ts","../../src/core/types.ts","../../src/config/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ReaderClientOptions } from \"./types\";\n\nexport const DEFAULT_CLIENT_OPTIONS: ReaderClientOptions = {\n  storagePrefix: \"zr\",\n  highlightColors: [\"yellow\", \"green\", \"blue\", \"pink\"],\n  defaultHighlightColor: \"yellow\",\n  scratchpad: { enabled: true, scopes: [\"chapter\", \"book\", \"global\"] },\n  themes: [\"system\", \"light\", \"sepia\", \"dark\"],\n  defaultTheme: \"system\",\n  defaultSettings: {\n    textSize: \"lg\",\n    leading: \"relaxed\",\n    measure: \"normal\",\n    fontFamily: \"serif\",\n    highlightMode: false,\n  },\n  progress: { completeAt: 0.9, saveIntervalMs: 1000 },\n  backupReminder: true,\n  basePath: \"/books\",\n};\n","/** Shared, framework-agnostic data model for zreader. */\n\nexport type ISODate = string;\n\n/** W3C Web Annotation-style anchor. Offsets are measured over the chapter root's text. */\nexport interface Anchor {\n  /** `data-block-id` of the block containing the start of the selection. */\n  blockId: string;\n  /** Offsets relative to the start block's text (fast path). */\n  blockStart: number;\n  /** TextPositionSelector over the whole chapter text. */\n  start: number;\n  end: number;\n  /** TextQuoteSelector. */\n  exact: string;\n  prefix: string;\n  suffix: string;\n  /** Content hash of the chapter when the anchor was created. */\n  contentHash?: string;\n}\n\nexport interface Highlight {\n  id: string;\n  bookId: string;\n  chapterId: string;\n  anchor: Anchor;\n  color: string;\n  note?: string;\n  createdAt: ISODate;\n  updatedAt: ISODate;\n}\n\nexport interface Bookmark {\n  id: string;\n  bookId: string;\n  chapterId: string;\n  /** Absent for whole-chapter bookmarks. */\n  blockId?: string;\n  label?: string;\n  excerpt?: string;\n  createdAt: ISODate;\n  updatedAt: ISODate;\n}\n\nexport interface ChapterProgress {\n  chapterId: string;\n  blockId?: string;\n  /** 0..1 */\n  percent: number;\n  completed: boolean;\n  updatedAt: ISODate;\n}\n\nexport interface BookProgress {\n  bookId: string;\n  chapters: Record<string, ChapterProgress>;\n  last?: { chapterId: string; blockId?: string; updatedAt: ISODate };\n}\n\nexport type PadScope =\n  | { kind: \"global\" }\n  | { kind: \"book\"; bookId: string }\n  | { kind: \"chapter\"; bookId: string; chapterId: string };\n\nexport type PadScopeKind = PadScope[\"kind\"];\n\nexport interface Pad {\n  /** Markdown is the interchange/source format. */\n  markdown: string;\n  /** Lossless editor JSON cache. Cleared whenever `markdown` is changed outside the editor. */\n  json?: unknown;\n  updatedAt: ISODate;\n}\n\nexport type ThemeName = \"system\" | \"light\" | \"sepia\" | \"dark\";\nexport type Measure = \"narrow\" | \"normal\" | \"wide\";\nexport type FontFamily = \"serif\" | \"sans\" | \"mono\";\nexport type TextSize = \"sm\" | \"base\" | \"lg\" | \"xl\" | \"2xl\";\nexport type Leading = \"tight\" | \"normal\" | \"relaxed\";\n\nexport const THEMES = [\"system\", \"light\", \"sepia\", \"dark\"] as const satisfies readonly ThemeName[];\nexport const TEXT_SIZES = [\"sm\", \"base\", \"lg\", \"xl\", \"2xl\"] as const satisfies readonly TextSize[];\nexport const LEADINGS = [\"tight\", \"normal\", \"relaxed\"] as const satisfies readonly Leading[];\nexport const MEASURES = [\"narrow\", \"normal\", \"wide\"] as const satisfies readonly Measure[];\nexport const FONT_FAMILIES = [\"serif\", \"sans\", \"mono\"] as const satisfies readonly FontFamily[];\n/** The palette the UI ships styles for (`::highlight(zr-<color>)`). */\nexport const HIGHLIGHT_COLORS = [\"yellow\", \"green\", \"blue\", \"pink\", \"purple\", \"orange\"] as const;\nexport type HighlightColor = (typeof HIGHLIGHT_COLORS)[number];\n\nexport interface ReaderSettings {\n  textSize: TextSize;\n  leading: Leading;\n  measure: Measure;\n  fontFamily: FontFamily;\n  /** Tap a sentence to highlight it with the default colour. */\n  highlightMode: boolean;\n  updatedAt: ISODate;\n}\n\n/** Serializable client options (the `reader` half of reader.config.ts). */\nexport interface ReaderClientOptions {\n  storagePrefix: string;\n  highlightColors: HighlightColor[];\n  defaultHighlightColor: HighlightColor;\n  scratchpad: { enabled: boolean; scopes: PadScopeKind[] };\n  /** Themes offered in the UI. Applied as a class on <html> via next-themes. */\n  themes: ThemeName[];\n  defaultTheme: ThemeName;\n  defaultSettings: Omit<ReaderSettings, \"updatedAt\">;\n  progress: { completeAt: number; saveIntervalMs: number };\n  /** Show a \"your notes only live in this browser\" reminder. */\n  backupReminder: boolean;\n  /** Base path used to build links back into the reader (e.g. quote-to-pad). */\n  basePath: string;\n}\n\nexport interface TocEntry {\n  id: string;\n  depth: number;\n  text: string;\n}\n\nexport interface ChapterMeta {\n  id: string;\n  title: string;\n  order: number;\n  description?: string;\n  /** Section the chapter belongs to, e.g. \"Part I · For the Builders\". Groups the contents list. */\n  part?: string;\n  /** Eyebrow shown above the title, e.g. \"Chapter 5\" or \"Appendix A\". */\n  label?: string;\n  /** Short marker for lists, e.g. \"5\" or \"A\". */\n  number?: string;\n}\n\nexport interface BookMeta {\n  id: string;\n  title: string;\n  subtitle?: string;\n  authors: string[];\n  description?: string;\n  cover?: string;\n  chapters: ChapterMeta[];\n}\n","import { z } from \"zod/v4\";\nimport { DEFAULT_CLIENT_OPTIONS } from \"../core/defaults\";\nimport {\n  FONT_FAMILIES,\n  HIGHLIGHT_COLORS,\n  LEADINGS,\n  MEASURES,\n  TEXT_SIZES,\n  THEMES,\n  type ReaderClientOptions,\n} from \"../core/types\";\n\nexport { z };\n\n// ---------------------------------------------------------------- types\n\nexport interface GlobLoader {\n  kind: \"glob\";\n  /** Directory containing one folder per book. Relative to the project root. */\n  base: string;\n  /** Chapter files, relative to `base`. */\n  pattern: string | string[];\n  ignore?: string[];\n}\n\n/** Astro-style glob loader: `content/books/<book>/{book.json, 01-intro.md, ...}` */\nexport function glob(opts: { base: string; pattern?: string | string[]; ignore?: string[] }): GlobLoader {\n  return { kind: \"glob\", base: opts.base, pattern: opts.pattern ?? \"**/*.{md,mdx,html}\", ignore: opts.ignore };\n}\n\n// unified's PluggableList, kept loose to avoid a type dependency in this entry.\nexport type PluginList = unknown[];\n\nexport interface SanitizeOptions {\n  /** Hostnames allowed for <iframe src>. Iframes are stripped unless listed here. */\n  allowIframes?: string[];\n  /** Extra tags to allow on top of DOMPurify's safe HTML profile. */\n  allowTags?: string[];\n  /** Extra attributes to allow. */\n  allowAttributes?: string[];\n}\n\nexport interface ContentConfig {\n  loader: GlobLoader;\n  schemas: { book: z.ZodType; chapter: z.ZodType };\n  /** Applied to `.md` and `.mdx`. */\n  remarkPlugins: PluginList;\n  rehypePlugins: PluginList;\n  sanitize: SanitizeOptions;\n  /** Include chapters with `draft: true`. Defaults to `true` in development. */\n  includeDrafts: boolean;\n  /** Where compiled chapters are cached. */\n  cacheDir: string;\n}\n\ntype DeepPartial<T> = T extends unknown[] ? T : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;\n\nexport interface ReaderUserConfig {\n  content?: DeepPartial<Omit<ContentConfig, \"schemas\" | \"loader\">> & {\n    loader?: GlobLoader;\n    schemas?: Partial<ContentConfig[\"schemas\"]>;\n  };\n  reader?: DeepPartial<ReaderClientOptions>;\n}\n\nexport interface ResolvedReaderConfig {\n  root: string;\n  content: ContentConfig;\n  reader: ReaderClientOptions;\n}\n\n// ------------------------------------------------------------- defaults\n\nexport const defaultBookSchema = z.looseObject({\n  title: z.string(),\n  subtitle: z.string().optional(),\n  authors: z.array(z.string()).default([]),\n  description: z.string().optional(),\n  cover: z.string().optional(),\n  /** Optional explicit chapter order (chapter slugs). */\n  chapters: z.array(z.string()).optional(),\n});\n\nexport const defaultChapterSchema = z.looseObject({\n  title: z.string(),\n  order: z.number().optional(),\n  description: z.string().optional(),\n  part: z.string().optional(),\n  label: z.string().optional(),\n  number: z.union([z.string(), z.number()]).transform(String).optional(),\n  draft: z.boolean().default(false),\n});\n\nfunction isDev() {\n  return typeof process !== \"undefined\" && process.env?.NODE_ENV === \"development\";\n}\n\nexport function defaultContentConfig(): ContentConfig {\n  return {\n    loader: glob({ base: \"./content/books\" }),\n    schemas: { book: defaultBookSchema, chapter: defaultChapterSchema },\n    remarkPlugins: [],\n    rehypePlugins: [],\n    sanitize: {},\n    includeDrafts: isDev(),\n    cacheDir:\n      (typeof process !== \"undefined\" && process.env?.ZREADER_CACHE_DIR) || \"node_modules/.cache/zreader\",\n  };\n}\n\n// ------------------------------------------------------------ define/merge\n\n/** Identity helper that gives `reader.config.ts` full type-checking. */\nexport function defineConfig(config: ReaderUserConfig): ReaderUserConfig {\n  return config;\n}\n\nfunction isPlainObject(x: unknown): x is Record<string, unknown> {\n  if (typeof x !== \"object\" || x === null || Array.isArray(x)) return false;\n  const proto = Object.getPrototypeOf(x);\n  return proto === Object.prototype || proto === null;\n}\n\n/**\n * Deep merge: plain objects merge key-by-key, arrays and class instances\n * (e.g. zod schemas) replace, `undefined` never overrides.\n */\nexport function mergeConfig<T>(base: T, ...overrides: unknown[]): T {\n  let out: unknown = base;\n  for (const o of overrides) out = mergeTwo(out, o);\n  return out as T;\n}\n\nfunction mergeTwo(a: unknown, b: unknown): unknown {\n  if (b === undefined) return a;\n  if (isPlainObject(a) && isPlainObject(b)) {\n    const out: Record<string, unknown> = { ...a };\n    for (const [k, v] of Object.entries(b)) out[k] = mergeTwo(a[k], v);\n    return out;\n  }\n  return b;\n}\n\n// --------------------------------------------------------------- validate\n\nconst themeName = z.enum(THEMES);\nconst highlightColor = z.enum(HIGHLIGHT_COLORS);\nconst clientSchema = z\n  .object({\n    storagePrefix: z.string().regex(/^[a-z0-9_-]+$/i, \"use letters, digits, '-' or '_'\"),\n    highlightColors: z.array(highlightColor).min(1, \"must be non-empty\"),\n    defaultHighlightColor: highlightColor,\n    scratchpad: z.object({\n      enabled: z.boolean(),\n      scopes: z.array(z.enum([\"global\", \"book\", \"chapter\"])).min(1, \"must be non-empty\"),\n    }),\n    themes: z.array(themeName).min(1),\n    defaultTheme: themeName,\n    defaultSettings: z.object({\n      textSize: z.enum(TEXT_SIZES),\n      leading: z.enum(LEADINGS),\n      measure: z.enum(MEASURES),\n      fontFamily: z.enum(FONT_FAMILIES),\n      highlightMode: z.boolean(),\n    }),\n    progress: z.object({ completeAt: z.number().gt(0).max(1), saveIntervalMs: z.number().min(100) }),\n    backupReminder: z.boolean(),\n    basePath: z.string().startsWith(\"/\"),\n  })\n  .refine((c) => c.highlightColors.includes(c.defaultHighlightColor), {\n    message: \"defaultHighlightColor must be one of highlightColors\",\n    path: [\"defaultHighlightColor\"],\n  })\n  .refine((c) => c.themes.includes(c.defaultTheme), {\n    message: \"defaultTheme must be one of themes\",\n    path: [\"defaultTheme\"],\n  });\n\nfunction isSchemaLike(v: unknown): boolean {\n  return typeof v === \"object\" && v !== null && typeof (v as { safeParse?: unknown }).safeParse === \"function\";\n}\n\nconst contentSchema = z.object({\n  loader: z.object({\n    kind: z.literal(\"glob\"),\n    base: z.string().min(1),\n    pattern: z.union([z.string(), z.array(z.string()).min(1)]),\n    ignore: z.array(z.string()).optional(),\n  }),\n  schemas: z.object({\n    book: z.custom<z.ZodType>(isSchemaLike, \"must be a zod (or safeParse-compatible) schema\"),\n    chapter: z.custom<z.ZodType>(isSchemaLike, \"must be a zod (or safeParse-compatible) schema\"),\n  }),\n  remarkPlugins: z.array(z.any()),\n  rehypePlugins: z.array(z.any()),\n  sanitize: z.object({\n    allowIframes: z.array(z.string()).optional(),\n    allowTags: z.array(z.string()).optional(),\n    allowAttributes: z.array(z.string()).optional(),\n  }),\n  includeDrafts: z.boolean(),\n  cacheDir: z.string(),\n});\n\nexport class ReaderConfigError extends Error {\n  constructor(\n    message: string,\n    public readonly issues: { path: string; message: string }[] = [],\n  ) {\n    super(message);\n    this.name = \"ReaderConfigError\";\n  }\n}\n\nfunction formatIssues(source: string, section: string, error: z.ZodError) {\n  const issues = error.issues.map((i) => ({ path: [section, ...i.path.map(String)].join(\".\"), message: i.message }));\n  return new ReaderConfigError(\n    `Invalid reader config${source ? ` (${source})` : \"\"}:\\n` + issues.map((i) => `  - ${i.path}: ${i.message}`).join(\"\\n\"),\n    issues,\n  );\n}\n\n/**\n * Resolve the final config: package defaults ← reader.config.ts ← inline overrides.\n * Throws `ReaderConfigError` with readable messages.\n */\nexport function resolveConfig(\n  user?: ReaderUserConfig | null,\n  inline?: ReaderUserConfig | null,\n  opts: { root?: string; source?: string } = {},\n): ResolvedReaderConfig {\n  const root = opts.root ?? (typeof process !== \"undefined\" && process.cwd ? process.cwd() : \"/\");\n  const reader = mergeConfig<ReaderClientOptions>(\n    structuredClone(DEFAULT_CLIENT_OPTIONS),\n    user?.reader,\n    inline?.reader,\n  );\n  const content = mergeConfig<ContentConfig>(defaultContentConfig(), user?.content, inline?.content);\n\n  const r = clientSchema.safeParse(reader);\n  if (!r.success) throw formatIssues(opts.source ?? \"\", \"reader\", r.error);\n  const c = contentSchema.safeParse(content);\n  if (!c.success) throw formatIssues(opts.source ?? \"\", \"content\", c.error);\n\n  return { root, content, reader };\n}\n\n/** Only the serializable, client-safe half. */\nexport function clientOptions(config: ResolvedReaderConfig): ReaderClientOptions {\n  return config.reader;\n}\n\nexport const CONFIG_FILE_NAMES = [\"reader.config.ts\", \"reader.config.mts\", \"reader.config.mjs\", \"reader.config.js\"];\n"]}

package/dist/content/index.d.ts

@@ -0,0 +1,143 @@
+import { S as SanitizeOptions, a as ResolvedReaderConfig, R as ReaderUserConfig } from '../index-Bp5oIiZd.js';
+export { C as ContentConfig, G as GlobLoader, d as defineConfig, g as glob } from '../index-Bp5oIiZd.js';
+import { BookMeta, ChapterMeta, TocEntry } from '../core/index.js';
+import { PluggableList } from 'unified';
+import { ComponentType } from 'react';
+import { BlocksData, BlockInfo } from '../rehype/index.js';
+export { default as rehypeBlocks } from '../rehype/index.js';
+export { h as hashString } from '../blocks-DwR7l7pz.js';
+export { z } from 'zod/v4';
+import 'hast';
+import 'vfile';
+
+type ChapterFormat = "md" | "mdx" | "html";
+interface PipelineOptions {
+    sanitize?: SanitizeOptions;
+    remarkPlugins?: PluggableList;
+    rehypePlugins?: PluggableList;
+}
+interface HtmlResult extends BlocksData {
+    kind: "html";
+    html: string;
+}
+interface MdxCompiled extends BlocksData {
+    kind: "mdx";
+    /** Compiled function body; run with `runMdx`. Serializable (cacheable). */
+    code: string;
+}
+/** Add block ids / heading ids / TOC to already-sanitized HTML. */
+declare function annotateHtml(html: string): Promise<HtmlResult>;
+/** Untrusted HTML string → sanitized, annotated HTML. */
+declare function renderHtml(html: string, opts?: PipelineOptions): Promise<HtmlResult>;
+/**
+ * Markdown (GFM, inline HTML allowed) → sanitized, annotated HTML.
+ * Inline HTML is parsed, then the whole output goes through DOMPurify.
+ */
+declare function renderMarkdown(markdown: string, opts?: PipelineOptions): Promise<HtmlResult>;
+/**
+ * Trusted MDX → compiled function body. MDX is code: only compile files you
+ * author (e.g. from your repo), never user-supplied input.
+ */
+declare function compileMdx(source: string, opts?: PipelineOptions): Promise<MdxCompiled>;
+type MdxComponents = Record<string, ComponentType<Record<string, unknown>>>;
+type MdxContent = ComponentType<{
+    components?: MdxComponents;
+}>;
+declare function runMdx(code: string): Promise<MdxContent>;
+
+interface ChapterEntry extends ChapterMeta {
+    bookId: string;
+    file: string;
+    format: ChapterFormat;
+    /** Validated frontmatter. */
+    data: Record<string, unknown>;
+    body: string;
+    draft: boolean;
+    mtimeMs: number;
+}
+interface BookEntry extends BookMeta {
+    /** Validated book.json. */
+    data: Record<string, unknown>;
+    dir: string;
+    chapterEntries: ChapterEntry[];
+}
+declare class ContentError extends Error {
+    readonly file?: string | undefined;
+    constructor(message: string, file?: string | undefined);
+}
+/** Read every book + chapter frontmatter (bodies are compiled lazily). */
+declare function loadBooks(config: ResolvedReaderConfig): Promise<BookEntry[]>;
+declare function compileChapter(entry: ChapterEntry, config: ResolvedReaderConfig): Promise<HtmlResult | MdxCompiled>;
+
+/**
+ * Sanitize untrusted HTML with DOMPurify (html profile, no scripts, no event
+ * handlers, no javascript: URLs, no inline styles, no forms). Iframes are
+ * stripped unless their https host is in `allowIframes`. External links opened
+ * in a new tab get `rel="noopener noreferrer"`.
+ */
+declare function sanitizeHtml(html: string, options?: SanitizeOptions): string;
+
+/**
+ * `zreader/content` — Astro-style content layer (server/build only).
+ *
+ *   const books = await getBooks();
+ *   const { chapter } = await getChapter("my-book", "intro");
+ *   const rendered = await renderChapter(chapter);
+ */
+
+type RenderedChapter = {
+    kind: "html";
+    html: string;
+    toc: TocEntry[];
+    blocks: BlockInfo[];
+    contentHash: string;
+} | {
+    kind: "mdx";
+    Content: MdxContent;
+    toc: TocEntry[];
+    blocks: BlockInfo[];
+    contentHash: string;
+};
+interface ChapterLookup {
+    book: BookEntry;
+    chapter: ChapterEntry;
+    index: number;
+    prev: ChapterMeta | null;
+    next: ChapterMeta | null;
+}
+declare function globalConfig(): Promise<ResolvedReaderConfig>;
+declare function toBookMeta(book: BookEntry): BookMeta;
+declare const getBooks: () => Promise<BookEntry[]>;
+declare const getBookMetas: () => Promise<BookMeta[]>;
+declare const getBook: (bookId: string) => Promise<BookEntry | null>;
+declare const getChapter: (bookId: string, chapterId: string) => Promise<ChapterLookup | null>;
+declare const renderChapter: (entry: ChapterEntry) => Promise<RenderedChapter>;
+declare const getStaticParams: <B extends string = "book", C extends string = "chapter">(names?: {
+    book?: B;
+    chapter?: C;
+}) => Promise<Array<Record<B | C, string>>>;
+declare const getReaderConfig: typeof globalConfig;
+type InlineContent = ReaderUserConfig["content"];
+/**
+ * Inline form: merge content options on top of the global reader.config.ts.
+ *
+ *   export const handbook = defineBooks({ loader: glob({ base: "./content/handbook" }) });
+ *   await handbook.getBooks();
+ */
+declare function defineBooks(inline?: InlineContent | ResolvedReaderConfig): {
+    config: () => Promise<ResolvedReaderConfig>;
+    getBooks(): Promise<BookEntry[]>;
+    /** Plain, serializable book metadata (safe to pass to client components). */
+    getBookMetas(): Promise<BookMeta[]>;
+    getBook(bookId: string): Promise<BookEntry | null>;
+    getChapter(bookId: string, chapterId: string): Promise<ChapterLookup | null>;
+    renderChapter(entry: ChapterEntry): Promise<RenderedChapter>;
+    /** For `generateStaticParams`. Param names are configurable. */
+    getStaticParams<B extends string = "book", C extends string = "chapter">(names?: {
+        book?: B;
+        chapter?: C;
+    }): Promise<Array<Record<B | C, string>>>;
+};
+
+export { BlockInfo, BlocksData, ContentError, ReaderUserConfig, ResolvedReaderConfig, SanitizeOptions, annotateHtml, compileChapter, compileMdx, defineBooks, getBook, getBookMetas, getBooks, getChapter, getReaderConfig, getStaticParams, loadBooks, renderChapter, renderHtml, renderMarkdown, runMdx, sanitizeHtml, toBookMeta };
+export type { BookEntry, ChapterEntry, ChapterFormat, ChapterLookup, HtmlResult, MdxCompiled, MdxComponents, MdxContent, PipelineOptions, RenderedChapter };