zreader 0.0.0-stage → 0.1.0

package/dist/next/client/index.d.ts

@@ -0,0 +1,8 @@
+import * as react from 'react';
+import { ReaderProviderProps } from 'zreader/react';
+
+type NextReaderProviderProps = Omit<ReaderProviderProps, "Link">;
+declare function NextReaderProvider(props: NextReaderProviderProps): react.JSX.Element;
+
+export { NextReaderProvider };
+export type { NextReaderProviderProps };

package/dist/next/client/index.js

@@ -0,0 +1,13 @@
+"use client";
+import Link from 'next/link';
+import { ReaderProvider } from 'zreader/react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/next/client/index.tsx
+function NextReaderProvider(props) {
+  return /* @__PURE__ */ jsx(ReaderProvider, { ...props, Link });
+}
+
+export { NextReaderProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/next/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/client/index.tsx"],"names":[],"mappings":";;;;;AAWO,SAAS,mBAAmB,KAAA,EAAgC;AACjE,EAAA,uBAAO,GAAA,CAAC,cAAA,EAAA,EAAgB,GAAG,KAAA,EAAO,IAAA,EAAwC,CAAA;AAC5E","file":"index.js","sourcesContent":["/**\n * `zreader/next/client` — <ReaderProvider> pre-wired to next/link (optional Next.js adapter).\n *\n * Exists because a Server Component can't pass the `Link` function to a client\n * provider; binding it here, in a client module, removes that boilerplate.\n */\nimport Link from \"next/link\";\nimport { ReaderProvider, type LinkComponent, type ReaderProviderProps } from \"zreader/react\";\n\nexport type NextReaderProviderProps = Omit<ReaderProviderProps, \"Link\">;\n\nexport function NextReaderProvider(props: NextReaderProviderProps) {\n  return <ReaderProvider {...props} Link={Link as unknown as LinkComponent} />;\n}\n"]}

package/dist/next/index.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+var path = require('path');
+var v4 = require('zod/v4');
+var fs = require('fs');
+
+// src/next/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 = v4.z.looseObject({
+  title: v4.z.string(),
+  subtitle: v4.z.string().optional(),
+  authors: v4.z.array(v4.z.string()).default([]),
+  description: v4.z.string().optional(),
+  cover: v4.z.string().optional(),
+  /** Optional explicit chapter order (chapter slugs). */
+  chapters: v4.z.array(v4.z.string()).optional()
+});
+var defaultChapterSchema = v4.z.looseObject({
+  title: v4.z.string(),
+  order: v4.z.number().optional(),
+  description: v4.z.string().optional(),
+  part: v4.z.string().optional(),
+  label: v4.z.string().optional(),
+  number: v4.z.union([v4.z.string(), v4.z.number()]).transform(String).optional(),
+  draft: v4.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 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 = v4.z.enum(THEMES);
+var highlightColor = v4.z.enum(HIGHLIGHT_COLORS);
+var clientSchema = v4.z.object({
+  storagePrefix: v4.z.string().regex(/^[a-z0-9_-]+$/i, "use letters, digits, '-' or '_'"),
+  highlightColors: v4.z.array(highlightColor).min(1, "must be non-empty"),
+  defaultHighlightColor: highlightColor,
+  scratchpad: v4.z.object({
+    enabled: v4.z.boolean(),
+    scopes: v4.z.array(v4.z.enum(["global", "book", "chapter"])).min(1, "must be non-empty")
+  }),
+  themes: v4.z.array(themeName).min(1),
+  defaultTheme: themeName,
+  defaultSettings: v4.z.object({
+    textSize: v4.z.enum(TEXT_SIZES),
+    leading: v4.z.enum(LEADINGS),
+    measure: v4.z.enum(MEASURES),
+    fontFamily: v4.z.enum(FONT_FAMILIES),
+    highlightMode: v4.z.boolean()
+  }),
+  progress: v4.z.object({ completeAt: v4.z.number().gt(0).max(1), saveIntervalMs: v4.z.number().min(100) }),
+  backupReminder: v4.z.boolean(),
+  basePath: v4.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 = v4.z.object({
+  loader: v4.z.object({
+    kind: v4.z.literal("glob"),
+    base: v4.z.string().min(1),
+    pattern: v4.z.union([v4.z.string(), v4.z.array(v4.z.string()).min(1)]),
+    ignore: v4.z.array(v4.z.string()).optional()
+  }),
+  schemas: v4.z.object({
+    book: v4.z.custom(isSchemaLike, "must be a zod (or safeParse-compatible) schema"),
+    chapter: v4.z.custom(isSchemaLike, "must be a zod (or safeParse-compatible) schema")
+  }),
+  remarkPlugins: v4.z.array(v4.z.any()),
+  rehypePlugins: v4.z.array(v4.z.any()),
+  sanitize: v4.z.object({
+    allowIframes: v4.z.array(v4.z.string()).optional(),
+    allowTags: v4.z.array(v4.z.string()).optional(),
+    allowAttributes: v4.z.array(v4.z.string()).optional()
+  }),
+  includeDrafts: v4.z.boolean(),
+  cacheDir: v4.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 };
+}
+var CONFIG_FILE_NAMES = ["reader.config.ts", "reader.config.mts", "reader.config.mjs", "reader.config.js"];
+function findConfigFile(from = process.cwd()) {
+  let dir = path.resolve(from);
+  for (; ; ) {
+    for (const name of CONFIG_FILE_NAMES) {
+      const p = path.join(dir, name);
+      if (fs.existsSync(p)) return p;
+    }
+    if (fs.existsSync(path.join(dir, "package.json")) || fs.existsSync(path.join(dir, ".git"))) return null;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+async function loadConfigFile(file) {
+  const { createJiti } = await import('jiti');
+  const jiti = createJiti(file, { interopDefault: true, moduleCache: false });
+  const mod = await jiti.import(file);
+  const cfg = mod && typeof mod === "object" && "default" in mod ? mod.default : mod;
+  return cfg ?? {};
+}
+
+// src/next/index.ts
+var USER_CONFIG_SPECIFIER = "zreader/user-config";
+var EMPTY_CONFIG_SPECIFIER = "zreader/empty-config";
+var SERVER_EXTERNALS = ["jsdom", "isomorphic-dompurify"];
+function toPosix(p) {
+  return p.split(path.sep).join("/");
+}
+function relativeImport(root, file) {
+  const rel = toPosix(path.relative(root, file));
+  return rel.startsWith(".") ? rel : `./${rel}`;
+}
+function applyReaderConfig(base, setup, root) {
+  const { configFile, resolved } = setup;
+  const turboTarget = configFile ? relativeImport(root, configFile) : EMPTY_CONFIG_SPECIFIER;
+  const webpackTarget = configFile ?? EMPTY_CONFIG_SPECIFIER;
+  const prevWebpack = base.webpack;
+  const webpack = (config, ctx) => {
+    const cfg = prevWebpack ? prevWebpack(config, ctx) : config;
+    cfg.resolve ??= {};
+    const alias = cfg.resolve.alias ??= {};
+    alias[`${USER_CONFIG_SPECIFIER}$`] = webpackTarget;
+    return cfg;
+  };
+  const contentGlob = toPosix(path.join(resolved.content.loader.base, "**/*"));
+  const tracing = { ...base.outputFileTracingIncludes ?? {} };
+  const allRoutes = "/**";
+  tracing[allRoutes] = Array.from(/* @__PURE__ */ new Set([...tracing[allRoutes] ?? [], contentGlob]));
+  const externals = Array.from(/* @__PURE__ */ new Set([...base.serverExternalPackages ?? [], ...SERVER_EXTERNALS]));
+  return {
+    ...base,
+    serverExternalPackages: externals,
+    outputFileTracingIncludes: tracing,
+    turbopack: {
+      ...base.turbopack,
+      resolveAlias: {
+        ...base.turbopack?.resolveAlias,
+        [USER_CONFIG_SPECIFIER]: turboTarget
+      }
+    },
+    webpack
+  };
+}
+async function setupReader(options = {}) {
+  const root = path.resolve(options.root ?? process.cwd());
+  const configFile = options.configPath ? path.resolve(root, options.configPath) : findConfigFile(root);
+  const user = configFile ? await loadConfigFile(configFile) : {};
+  const resolved = resolveConfig(user, options.config, {
+    root,
+    source: configFile ? path.relative(root, configFile) : "defaults"
+  });
+  return { configFile, resolved };
+}
+function withReader(nextConfig = {}, options = {}) {
+  return async (phase, ctx) => {
+    const root = path.resolve(options.root ?? process.cwd());
+    process.env.ZREADER_CACHE_DIR ??= path.join(root, ".next", "cache", "zreader");
+    const base = typeof nextConfig === "function" ? await nextConfig(phase, ctx) : nextConfig;
+    const setup = await setupReader({ ...options, root });
+    if (options.verbose) {
+      console.log(`[zreader] config: ${setup.configFile ?? "(defaults)"}`);
+    }
+    return applyReaderConfig(base, setup, root);
+  };
+}
+
+exports.EMPTY_CONFIG_SPECIFIER = EMPTY_CONFIG_SPECIFIER;
+exports.SERVER_EXTERNALS = SERVER_EXTERNALS;
+exports.USER_CONFIG_SPECIFIER = USER_CONFIG_SPECIFIER;
+exports.applyReaderConfig = applyReaderConfig;
+exports.findConfigFile = findConfigFile;
+exports.loadConfigFile = loadConfigFile;
+exports.resolveConfig = resolveConfig;
+exports.setupReader = setupReader;
+exports.withReader = withReader;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/next/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/defaults.ts","../../src/core/types.ts","../../src/config/index.ts","../../src/config/load.ts","../../src/next/index.ts"],"names":["z","resolve","join","existsSync","dirname","sep","relative"],"mappings":"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","file":"index.cjs","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","/** Node-only helpers for locating and loading reader.config.* (via jiti). */\nimport { existsSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { CONFIG_FILE_NAMES, type ReaderUserConfig } from \"./index\";\n\n/** Search `from` and its parents (up to the filesystem root or a `.git` dir) for reader.config.*. */\nexport function findConfigFile(from: string = process.cwd()): string | null {\n  let dir = resolve(from);\n  for (;;) {\n    for (const name of CONFIG_FILE_NAMES) {\n      const p = join(dir, name);\n      if (existsSync(p)) return p;\n    }\n    if (existsSync(join(dir, \"package.json\")) || existsSync(join(dir, \".git\"))) return null;\n    const parent = dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\nexport async function loadConfigFile(file: string): Promise<ReaderUserConfig> {\n  const { createJiti } = await import(\"jiti\");\n  const jiti = createJiti(file, { interopDefault: true, moduleCache: false });\n  const mod = (await jiti.import(file)) as { default?: ReaderUserConfig } | ReaderUserConfig;\n  const cfg = (mod && typeof mod === \"object\" && \"default\" in mod ? mod.default : mod) as ReaderUserConfig | undefined;\n  return cfg ?? {};\n}\n","/**\n * Next.js integration.\n *\n *   // next.config.ts\n *   import { withReader } from \"zreader/next\";\n *   export default withReader({ reactStrictMode: true });\n */\nimport { join, relative, resolve, sep } from \"node:path\";\nimport type { NextConfig } from \"next\";\nimport { resolveConfig, type ResolvedReaderConfig, type ReaderUserConfig } from \"../config/index\";\nimport { findConfigFile, loadConfigFile } from \"../config/load\";\n\nexport const USER_CONFIG_SPECIFIER = \"zreader/user-config\";\nexport const EMPTY_CONFIG_SPECIFIER = \"zreader/empty-config\";\n\n/** Packages that must stay external on the server (dynamic requires / native-ish). */\nexport const SERVER_EXTERNALS = [\"jsdom\", \"isomorphic-dompurify\"];\n\nexport interface WithReaderOptions {\n  /** Path to the config file. Defaults to discovering reader.config.{ts,mts,mjs,js}. */\n  configPath?: string;\n  /** Project root. Defaults to process.cwd() (the directory containing next.config). */\n  root?: string;\n  /** Inline overrides merged on top of reader.config.ts. */\n  config?: ReaderUserConfig;\n  /** Log the resolved config file path at startup. */\n  verbose?: boolean;\n}\n\ntype NextConfigFn = (phase: string, ctx: { defaultConfig: NextConfig }) => NextConfig | Promise<NextConfig>;\nexport type NextConfigInput = NextConfig | NextConfigFn;\n\ntype WebpackFn = NonNullable<NextConfig[\"webpack\"]>;\n\nfunction toPosix(p: string) {\n  return p.split(sep).join(\"/\");\n}\n\n/** Alias target relative to the project root, as Turbopack expects (`./reader.config.ts`). */\nfunction relativeImport(root: string, file: string) {\n  const rel = toPosix(relative(root, file));\n  return rel.startsWith(\".\") ? rel : `./${rel}`;\n}\n\nexport interface ReaderNextSetup {\n  configFile: string | null;\n  resolved: ResolvedReaderConfig;\n}\n\n/** Pure transform (exported for testing): apply reader wiring to a resolved Next config. */\nexport function applyReaderConfig(base: NextConfig, setup: ReaderNextSetup, root: string): NextConfig {\n  const { configFile, resolved } = setup;\n  const turboTarget = configFile ? relativeImport(root, configFile) : EMPTY_CONFIG_SPECIFIER;\n  const webpackTarget = configFile ?? EMPTY_CONFIG_SPECIFIER;\n\n  const prevWebpack = base.webpack as WebpackFn | undefined;\n  const webpack: WebpackFn = (config, ctx) => {\n    const cfg = (prevWebpack ? prevWebpack(config, ctx) : config) as { resolve?: { alias?: Record<string, unknown> } };\n    cfg.resolve ??= {};\n    const alias = (cfg.resolve.alias ??= {}) as Record<string, unknown>;\n    alias[`${USER_CONFIG_SPECIFIER}$`] = webpackTarget;\n    return cfg;\n  };\n\n  const contentGlob = toPosix(join(resolved.content.loader.base, \"**/*\"));\n  const tracing = { ...(base.outputFileTracingIncludes ?? {}) };\n  const allRoutes = \"/**\";\n  tracing[allRoutes] = Array.from(new Set([...(tracing[allRoutes] ?? []), contentGlob]));\n\n  const externals = Array.from(new Set([...(base.serverExternalPackages ?? []), ...SERVER_EXTERNALS]));\n\n  return {\n    ...base,\n    serverExternalPackages: externals,\n    outputFileTracingIncludes: tracing,\n    turbopack: {\n      ...base.turbopack,\n      resolveAlias: {\n        ...base.turbopack?.resolveAlias,\n        [USER_CONFIG_SPECIFIER]: turboTarget,\n      },\n    },\n    webpack,\n  };\n}\n\nexport async function setupReader(options: WithReaderOptions = {}): Promise<ReaderNextSetup> {\n  const root = resolve(options.root ?? process.cwd());\n  const configFile = options.configPath ? resolve(root, options.configPath) : findConfigFile(root);\n  const user = configFile ? await loadConfigFile(configFile) : {};\n  // Validate eagerly so `next dev` / `next build` fail fast with a readable error.\n  const resolved = resolveConfig(user, options.config, {\n    root,\n    source: configFile ? relative(root, configFile) : \"defaults\",\n  });\n  return { configFile, resolved };\n}\n\n/**\n * Wire zreader into Next.js:\n * - validates reader.config.* at startup;\n * - aliases `zreader/user-config` to it (Turbopack + webpack), so\n *   `zreader/virtual-config` is the resolved config everywhere on the server;\n * - keeps jsdom/DOMPurify external on the server;\n * - traces the content directory into the server output (Vercel);\n * - points the compiled-chapter cache at `.next/cache/zreader`.\n */\nexport function withReader(nextConfig: NextConfigInput = {}, options: WithReaderOptions = {}): NextConfigFn {\n  return async (phase, ctx) => {\n    const root = resolve(options.root ?? process.cwd());\n    process.env.ZREADER_CACHE_DIR ??= join(root, \".next\", \"cache\", \"zreader\");\n    const base = typeof nextConfig === \"function\" ? await nextConfig(phase, ctx) : nextConfig;\n    const setup = await setupReader({ ...options, root });\n    if (options.verbose) {\n      console.log(`[zreader] config: ${setup.configFile ?? \"(defaults)\"}`);\n    }\n    return applyReaderConfig(base, setup, root);\n  };\n}\n\nexport { resolveConfig, findConfigFile, loadConfigFile };\nexport type { ResolvedReaderConfig, ReaderUserConfig };\n"]}

package/dist/next/index.d.cts

@@ -0,0 +1,47 @@
+import { NextConfig } from 'next';
+import { ReaderUserConfig, ResolvedReaderConfig } from '../config/index.cjs';
+export { resolveConfig } from '../config/index.cjs';
+import 'zod/v4';
+
+/** Search `from` and its parents (up to the filesystem root or a `.git` dir) for reader.config.*. */
+declare function findConfigFile(from?: string): string | null;
+declare function loadConfigFile(file: string): Promise<ReaderUserConfig>;
+
+declare const USER_CONFIG_SPECIFIER = "zreader/user-config";
+declare const EMPTY_CONFIG_SPECIFIER = "zreader/empty-config";
+/** Packages that must stay external on the server (dynamic requires / native-ish). */
+declare const SERVER_EXTERNALS: string[];
+interface WithReaderOptions {
+    /** Path to the config file. Defaults to discovering reader.config.{ts,mts,mjs,js}. */
+    configPath?: string;
+    /** Project root. Defaults to process.cwd() (the directory containing next.config). */
+    root?: string;
+    /** Inline overrides merged on top of reader.config.ts. */
+    config?: ReaderUserConfig;
+    /** Log the resolved config file path at startup. */
+    verbose?: boolean;
+}
+type NextConfigFn = (phase: string, ctx: {
+    defaultConfig: NextConfig;
+}) => NextConfig | Promise<NextConfig>;
+type NextConfigInput = NextConfig | NextConfigFn;
+interface ReaderNextSetup {
+    configFile: string | null;
+    resolved: ResolvedReaderConfig;
+}
+/** Pure transform (exported for testing): apply reader wiring to a resolved Next config. */
+declare function applyReaderConfig(base: NextConfig, setup: ReaderNextSetup, root: string): NextConfig;
+declare function setupReader(options?: WithReaderOptions): Promise<ReaderNextSetup>;
+/**
+ * Wire zreader into Next.js:
+ * - validates reader.config.* at startup;
+ * - aliases `zreader/user-config` to it (Turbopack + webpack), so
+ *   `zreader/virtual-config` is the resolved config everywhere on the server;
+ * - keeps jsdom/DOMPurify external on the server;
+ * - traces the content directory into the server output (Vercel);
+ * - points the compiled-chapter cache at `.next/cache/zreader`.
+ */
+declare function withReader(nextConfig?: NextConfigInput, options?: WithReaderOptions): NextConfigFn;
+
+export { EMPTY_CONFIG_SPECIFIER, ReaderUserConfig, ResolvedReaderConfig, SERVER_EXTERNALS, USER_CONFIG_SPECIFIER, applyReaderConfig, findConfigFile, loadConfigFile, setupReader, withReader };
+export type { NextConfigInput, ReaderNextSetup, WithReaderOptions };

package/dist/next/index.d.ts

@@ -0,0 +1,47 @@
+import { NextConfig } from 'next';
+import { ReaderUserConfig, ResolvedReaderConfig } from '../config/index.js';
+export { resolveConfig } from '../config/index.js';
+import 'zod/v4';
+
+/** Search `from` and its parents (up to the filesystem root or a `.git` dir) for reader.config.*. */
+declare function findConfigFile(from?: string): string | null;
+declare function loadConfigFile(file: string): Promise<ReaderUserConfig>;
+
+declare const USER_CONFIG_SPECIFIER = "zreader/user-config";
+declare const EMPTY_CONFIG_SPECIFIER = "zreader/empty-config";
+/** Packages that must stay external on the server (dynamic requires / native-ish). */
+declare const SERVER_EXTERNALS: string[];
+interface WithReaderOptions {
+    /** Path to the config file. Defaults to discovering reader.config.{ts,mts,mjs,js}. */
+    configPath?: string;
+    /** Project root. Defaults to process.cwd() (the directory containing next.config). */
+    root?: string;
+    /** Inline overrides merged on top of reader.config.ts. */
+    config?: ReaderUserConfig;
+    /** Log the resolved config file path at startup. */
+    verbose?: boolean;
+}
+type NextConfigFn = (phase: string, ctx: {
+    defaultConfig: NextConfig;
+}) => NextConfig | Promise<NextConfig>;
+type NextConfigInput = NextConfig | NextConfigFn;
+interface ReaderNextSetup {
+    configFile: string | null;
+    resolved: ResolvedReaderConfig;
+}
+/** Pure transform (exported for testing): apply reader wiring to a resolved Next config. */
+declare function applyReaderConfig(base: NextConfig, setup: ReaderNextSetup, root: string): NextConfig;
+declare function setupReader(options?: WithReaderOptions): Promise<ReaderNextSetup>;
+/**
+ * Wire zreader into Next.js:
+ * - validates reader.config.* at startup;
+ * - aliases `zreader/user-config` to it (Turbopack + webpack), so
+ *   `zreader/virtual-config` is the resolved config everywhere on the server;
+ * - keeps jsdom/DOMPurify external on the server;
+ * - traces the content directory into the server output (Vercel);
+ * - points the compiled-chapter cache at `.next/cache/zreader`.
+ */
+declare function withReader(nextConfig?: NextConfigInput, options?: WithReaderOptions): NextConfigFn;
+
+export { EMPTY_CONFIG_SPECIFIER, ReaderUserConfig, ResolvedReaderConfig, SERVER_EXTERNALS, USER_CONFIG_SPECIFIER, applyReaderConfig, findConfigFile, loadConfigFile, setupReader, withReader };
+export type { NextConfigInput, ReaderNextSetup, WithReaderOptions };