@pretextbook/pretext-html 0.1.1 → 0.2.0

package/dist/internal/posix-path.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A posix-only stand-in for `node:path`, substituted for it when this package
+ * is built for the browser (see vite.config.ts).
+ *
+ * This is safe because none of the paths this package computes ever reach a
+ * real filesystem: libxslt-wasm is compiled with FILESYSTEM=0, so every path
+ * ends up as either a key in the mount table or a segment of a
+ * `*.ptx.invalid` URL (see mounts.ts). They are virtual paths, and virtual
+ * paths are posix paths — a browser caller passes `sourcePath: "/main.ptx"`
+ * and means exactly what it says.
+ *
+ * Only the handful of functions this package actually uses are implemented.
+ */
+export declare const sep = "/";
+/**
+ * Collapse `.` and `..` segments. An absolute path clamps at the root
+ * (`/a/../../b` → `/b`), which is what makes the containment checks in
+ * mounts.ts and xinclude.ts safe against `..` traversal.
+ */
+export declare function normalize(p: string): string;
+/**
+ * Resolve right-to-left until an absolute path is found. With no absolute
+ * segment the result is rooted at `/` rather than at a process cwd — there is
+ * no cwd in a browser, and a virtual path is meaningless relative to one.
+ */
+export declare function resolve(...segments: string[]): string;
+export declare function join(...segments: string[]): string;
+export declare function dirname(p: string): string;
+export declare function relative(from: string, to: string): string;
+/**
+ * `path.posix` self-reference: on posix, `path` and `path.posix` are the same
+ * thing, and call sites that reach for `path.posix.normalize` to be explicit
+ * should keep working.
+ */
+export declare const posix: {
+    sep: string;
+    normalize: typeof normalize;
+    resolve: typeof resolve;
+    join: typeof join;
+    dirname: typeof dirname;
+    relative: typeof relative;
+};
+declare const _default: {
+    sep: string;
+    normalize: typeof normalize;
+    resolve: typeof resolve;
+    join: typeof join;
+    dirname: typeof dirname;
+    relative: typeof relative;
+    posix: {
+        sep: string;
+        normalize: typeof normalize;
+        resolve: typeof resolve;
+        join: typeof join;
+        dirname: typeof dirname;
+        relative: typeof relative;
+    };
+};
+export default _default;

package/dist/mounts.d.ts

@@ -10,11 +10,29 @@
  * reserved `.invalid` TLD and serve them from local directories or in-memory
  * strings. No HTTP server, no real network traffic.
  */
+/**
+ * Reads `relPath` (posix, leading "/") beneath mount root `root`, or resolves
+ * `undefined` when it is missing or escapes the mount. `root` is opaque: a
+ * directory under Node, a base URL in a browser, whatever an embedder's own
+ * reader wants.
+ */
+export type MountReader = (root: string, relPath: string) => Promise<Uint8Array | string | undefined>;
+/**
+ * Replace how mounted files are read. Lets an embedder serve the stylesheets
+ * from somewhere the platform seam does not cover — an in-memory map, a zip,
+ * a VS Code webview resource URI — without patching `globalThis.fetch`.
+ * Also how scripts/build-xsl-bundle.mjs records which files a render touches.
+ */
+export declare function setMountReader(reader: MountReader): void;
 /** Install the shim (idempotent). Must run before libxslt-wasm loads anything. */
 export declare function installFetchShim(): void;
 /**
  * Serve `dir` under a unique fake origin. Returns the base URL
  * (e.g. `http://mnt1.ptx.invalid`); resource paths append to it.
+ *
+ * `dir` is stored verbatim and handed back to the {@link MountReader}, which
+ * owns its interpretation — under Node a directory path, in a browser a base
+ * URL.
  */
 export declare function mountDirectory(dir: string): string;
 export declare function unmountDirectory(baseUrl: string): void;

package/dist/renderer.d.ts

@@ -78,7 +78,10 @@ export interface RenderResult {
     /** Present when RenderOptions.sourceMap was set. */
     sourceMap?: PtxSourceMap;
 }
-/** Vendored stylesheets shipped with this package. */
+/**
+ * Vendored stylesheets shipped with this package. A directory under Node, a
+ * base URL in the browser build — either way, a mount root (see host.ts).
+ */
 export declare function defaultXslDir(): string;
 export declare function isJspiAvailable(): boolean;
 /** Quote a string as an XPath 1.0 string literal. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/pretext-html",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Convert PreTeXt documents to HTML in pure JavaScript using the official PreTeXt XSLT stylesheets via libxslt-wasm. No Python or PreTeXt installation required.",
   "author": "Oscar Levin",
   "license": "MIT",
@@ -28,6 +28,10 @@
   },
   "exports": {
     ".": {
+      "browser": {
+        "types": "./dist/index.browser.d.ts",
+        "default": "./dist/index.browser.js"
+      },
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
@@ -46,9 +50,11 @@
     "cli.mjs"
   ],
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && npm run build:browser && npm run build-xsl-bundle",
+    "build:browser": "vite build --mode browser",
     "test": "vitest run",
-    "refresh-xsl": "node scripts/refresh-xsl.mjs"
+    "refresh-xsl": "node scripts/refresh-xsl.mjs",
+    "build-xsl-bundle": "node --experimental-wasm-jspi scripts/build-xsl-bundle.mjs"
   },
   "dependencies": {
     "@pretextbook/libxslt-wasm": "^0.1.1",