@quillmark/registry 0.1.0 → 0.1.10

package/README.md

@@ -0,0 +1,133 @@
+# @quillmark/registry
+
+Unified API for discovering, loading, and registering Quills with the Quillmark WASM engine. Works in both browser and Node.js environments.
+
+## Install
+
+```bash
+npm install @quillmark/registry
+```
+
+**Peer dependency:** Requires `@quillmark/wasm@^0.36.0` — you provide the engine instance.
+
+## Quick Start
+
+### Browser (HTTP source)
+
+```ts
+import { Quillmark } from '@quillmark/wasm';
+import { QuillRegistry, HttpSource } from '@quillmark/registry';
+
+const engine = new Quillmark();
+const source = new HttpSource({ baseUrl: 'https://cdn.example.com/quills/' });
+const registry = new QuillRegistry({ source, engine });
+
+// Resolve a quill — fetches, caches, and registers with the engine
+const bundle = await registry.resolve('usaf_memo');
+
+// Engine is now ready to render
+const parsed = Quillmark.parseMarkdown(myMarkdown);
+const result = engine.render(parsed, { quill: 'usaf_memo' });
+```
+
+### Node.js (filesystem source)
+
+```ts
+import { Quillmark } from '@quillmark/wasm';
+import { QuillRegistry, FileSystemSource } from '@quillmark/registry';
+
+const engine = new Quillmark();
+const source = new FileSystemSource('/path/to/quills');
+const registry = new QuillRegistry({ source, engine });
+
+const bundle = await registry.resolve('usaf_memo');
+```
+
+## API
+
+### `QuillRegistry`
+
+Orchestrates sources, resolves versions, caches loaded quills, and registers them with the engine. Loading is lazy — quills are fetched on first `resolve()` call, not at construction time.
+
+```ts
+const registry = new QuillRegistry({ source, engine });
+```
+
+| Method | Description |
+|---|---|
+| `resolve(name, version?)` | Resolves a quill by name. Fetches from source, caches, and registers with the engine. Returns a `QuillBundle`. |
+| `preload(names)` | Resolves multiple quills in parallel. Fail-fast — rejects immediately if any quill fails. |
+| `getManifest()` | Returns the full `QuillManifest` from the source. |
+| `getAvailableQuills()` | Returns `QuillMetadata[]` for all quills in the source. |
+| `isLoaded(name)` | Returns `true` if the quill is registered in the engine. |
+
+### `HttpSource`
+
+Fetches quill zips and manifest from any HTTP endpoint. Works in browser and Node.js.
+
+```ts
+const source = new HttpSource({
+  baseUrl: 'https://cdn.example.com/quills/',
+  manifest: preloadedManifest, // optional — skip initial manifest fetch (useful for SSR)
+  fetch: customFetch,          // optional — custom fetch function
+});
+```
+
+Zip URLs use the format `{baseUrl}{name}@{version}.zip?v={version}` for cache-busting.
+
+### `FileSystemSource`
+
+Node.js-only source that reads quill directories from disk. Each subdirectory must contain a `Quill.yaml` with `name` and `version` fields.
+
+```ts
+const source = new FileSystemSource('/path/to/quills');
+```
+
+#### Packaging for static hosting
+
+```ts
+await source.packageForHttp('/path/to/output');
+// Writes: output/manifest.json, output/usaf_memo@1.0.0.zip, ...
+```
+
+### `QuillSource` interface
+
+Implement this to create custom sources:
+
+```ts
+interface QuillSource {
+  getManifest(): Promise<QuillManifest>;
+  loadQuill(name: string, version?: string): Promise<QuillBundle>;
+}
+```
+
+## Error Handling
+
+All errors are thrown as `RegistryError` with a typed `code`:
+
+| Code | Meaning |
+|---|---|
+| `quill_not_found` | No quill with that name exists in the source |
+| `version_not_found` | Quill exists but the requested version doesn't |
+| `load_error` | Source failed to fetch or parse quill data |
+| `source_unavailable` | Network failure, filesystem error, etc. |
+
+```ts
+import { RegistryError } from '@quillmark/registry';
+
+try {
+  await registry.resolve('nonexistent');
+} catch (err) {
+  if (err instanceof RegistryError) {
+    console.error(err.code, err.quillName);
+  }
+}
+```
+
+## Version Resolution
+
+When a version is provided, the registry resolves an exact match. When omitted, it resolves to the latest available. The registry checks the engine first (via `resolveQuill()`) to avoid redundant fetches, then checks its in-memory cache, and only hits the source if needed.
+
+## License
+
+Apache-2.0

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export type RegistryErrorCode = 'quill_not_found' | 'version_not_found' | 'load_error' | 'source_unavailable';
+export declare class RegistryError extends Error {
+    code: RegistryErrorCode;
+    quillName?: string;
+    version?: string;
+    constructor(code: RegistryErrorCode, message: string, options?: {
+        quillName?: string;
+        version?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAC1B,iBAAiB,GACjB,mBAAmB,GACnB,YAAY,GACZ,oBAAoB,CAAC;AAExB,qBAAa,aAAc,SAAQ,KAAK;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAGhB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQpE"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class RegistryError extends Error {
+    code;
+    quillName;
+    version;
+    constructor(code, message, options) {
+        super(message, options?.cause ? { cause: options.cause } : undefined);
+        this.name = 'RegistryError';
+        this.code = code;
+        this.quillName = options?.quillName;
+        this.version = options?.version;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC,IAAI,CAAoB;IACxB,SAAS,CAAU;IACnB,OAAO,CAAU;IAEjB,YACC,IAAuB,EACvB,OAAe,EACf,OAAmE;QAEnE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { QuillData, QuillMetadata, QuillManifest, QuillBundle, QuillSource, QuillInfo, QuillmarkEngine, } from './types.js';
+export { RegistryError } from './errors.js';
+export type { RegistryErrorCode } from './errors.js';
+export { FileSystemSource } from './sources/file-system-source.js';
+export { HttpSource } from './sources/http-source.js';
+export type { HttpSourceOptions } from './sources/http-source.js';
+export { QuillRegistry } from './registry.js';
+export type { QuillRegistryOptions } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Errors
+export { RegistryError } from './errors.js';
+// Sources
+export { FileSystemSource } from './sources/file-system-source.js';
+export { HttpSource } from './sources/http-source.js';
+// Registry
+export { QuillRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+import type { QuillBundle, QuillManifest, QuillmarkEngine, QuillMetadata, QuillSource } from './types.js';
+export interface QuillRegistryOptions {
+    source: QuillSource;
+    engine: QuillmarkEngine;
+}
+/**
+ * Orchestrates quill sources, resolves versions, caches loaded quills,
+ * and registers them with the engine.
+ *
+ * The registry is scoped to a specific engine instance. On resolve(), it
+ * fetches quill data from the source and registers it with that engine.
+ * Loading is lazy — quills are fetched and pushed to the engine on first
+ * resolve() call, not at construction time.
+ */
+export declare class QuillRegistry {
+    private source;
+    private engine;
+    /** In-memory cache of resolved QuillBundle objects, keyed by `name@version`. */
+    private cache;
+    constructor(options: QuillRegistryOptions);
+    /** Returns the manifest from the underlying source. */
+    getManifest(): Promise<QuillManifest>;
+    /** Returns metadata for all available quills from the source manifest. */
+    getAvailableQuills(): Promise<QuillMetadata[]>;
+    /**
+     * Resolves a quill by name and optional version.
+     *
+     * Resolution flow:
+     * 1. Check engine via resolveQuill() — return immediately if already registered
+     * 2. Check registry cache — return if cached
+     * 3. Ask source for the bundle (or throw version_not_found / quill_not_found)
+     * 4. Register with engine via registerQuill()
+     *
+     * When no version is specified, resolves to latest available.
+     */
+    resolve(name: string, version?: string): Promise<QuillBundle>;
+    /**
+     * Preloads multiple quills. Fail-fast: if any quill fails to load,
+     * rejects immediately. Callers who want best-effort can call resolve()
+     * individually and catch per-quill.
+     */
+    preload(names: string[]): Promise<void>;
+    /**
+     * Checks whether a quill is currently loaded in the engine.
+     * Delegates to engine.resolveQuill().
+     */
+    isLoaded(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,gFAAgF;IAChF,OAAO,CAAC,KAAK,CAAuC;gBAExC,OAAO,EAAE,oBAAoB;IAKzC,uDAAuD;IACjD,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAI3C,0EAA0E;IACpE,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKpD;;;;;;;;;;OAUG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCnE;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG/B"}

package/dist/registry.js

@@ -0,0 +1,83 @@
+/**
+ * Orchestrates quill sources, resolves versions, caches loaded quills,
+ * and registers them with the engine.
+ *
+ * The registry is scoped to a specific engine instance. On resolve(), it
+ * fetches quill data from the source and registers it with that engine.
+ * Loading is lazy — quills are fetched and pushed to the engine on first
+ * resolve() call, not at construction time.
+ */
+export class QuillRegistry {
+    source;
+    engine;
+    /** In-memory cache of resolved QuillBundle objects, keyed by `name@version`. */
+    cache = new Map();
+    constructor(options) {
+        this.source = options.source;
+        this.engine = options.engine;
+    }
+    /** Returns the manifest from the underlying source. */
+    async getManifest() {
+        return this.source.getManifest();
+    }
+    /** Returns metadata for all available quills from the source manifest. */
+    async getAvailableQuills() {
+        const manifest = await this.source.getManifest();
+        return manifest.quills;
+    }
+    /**
+     * Resolves a quill by name and optional version.
+     *
+     * Resolution flow:
+     * 1. Check engine via resolveQuill() — return immediately if already registered
+     * 2. Check registry cache — return if cached
+     * 3. Ask source for the bundle (or throw version_not_found / quill_not_found)
+     * 4. Register with engine via registerQuill()
+     *
+     * When no version is specified, resolves to latest available.
+     */
+    async resolve(name, version) {
+        // 1. Check engine — return immediately if already registered
+        const quillRef = version ? `${name}@${version}` : name;
+        const engineInfo = this.engine.resolveQuill(quillRef);
+        if (engineInfo) {
+            const cacheKey = `${engineInfo.name}@${engineInfo.version}`;
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                return cached;
+            }
+        }
+        // 2. Check registry cache
+        if (version) {
+            const cacheKey = `${name}@${version}`;
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                return cached;
+            }
+        }
+        // 3. Ask source for the bundle
+        const bundle = await this.source.loadQuill(name, version);
+        // 4. Register with engine
+        this.engine.registerQuill(bundle.data);
+        // Cache the resolved bundle
+        const cacheKey = `${bundle.name}@${bundle.version}`;
+        this.cache.set(cacheKey, bundle);
+        return bundle;
+    }
+    /**
+     * Preloads multiple quills. Fail-fast: if any quill fails to load,
+     * rejects immediately. Callers who want best-effort can call resolve()
+     * individually and catch per-quill.
+     */
+    async preload(names) {
+        await Promise.all(names.map((name) => this.resolve(name)));
+    }
+    /**
+     * Checks whether a quill is currently loaded in the engine.
+     * Delegates to engine.resolveQuill().
+     */
+    isLoaded(name) {
+        return this.engine.resolveQuill(name) !== null;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IACjB,MAAM,CAAc;IACpB,MAAM,CAAkB;IAChC,gFAAgF;IACxE,KAAK,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEpD,YAAY,OAA6B;QACxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,kBAAkB;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,QAAQ,CAAC,MAAM,CAAC;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAgB;QAC3C,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACZ,OAAO,MAAM,CAAC;YACf,CAAC;QACF,CAAC;QAED,0BAA0B;QAC1B,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACZ,OAAO,MAAM,CAAC;YACf,CAAC;QACF,CAAC;QAED,+BAA+B;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,0BAA0B;QAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEvC,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEjC,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,KAAe;QAC5B,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAChD,CAAC;CACD"}

package/dist/sources/file-system-source.d.ts

@@ -0,0 +1,24 @@
+import type { QuillBundle, QuillManifest, QuillSource } from '../types.js';
+/**
+ * Node.js-only QuillSource that reads Quill directories from the local filesystem.
+ *
+ * Each subdirectory of the provided `quillsDir` is treated as a quill.
+ * Each must contain a `Quill.yaml` with at least `name` and `version` fields.
+ *
+ * Also exposes `packageForHttp(outputDir)` to zip quills and write a manifest
+ * for static hosting.
+ */
+export declare class FileSystemSource implements QuillSource {
+    private quillsDir;
+    constructor(quillsDir: string);
+    getManifest(): Promise<QuillManifest>;
+    loadQuill(name: string, version?: string): Promise<QuillBundle>;
+    /**
+     * Packages all quills for HTTP static hosting.
+     * Zips each quill directory and writes the zips plus a `manifest.json` to `outputDir`.
+     */
+    packageForHttp(outputDir: string): Promise<void>;
+    /** Finds the directory for a quill by scanning subdirectories and matching metadata. */
+    private findQuillDir;
+}
+//# sourceMappingURL=file-system-source.d.ts.map

package/dist/sources/file-system-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-source.d.ts","sourceRoot":"","sources":["../../src/sources/file-system-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAuD1F;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IACnD,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM;IAIvB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAuBrC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAwCrE;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtD,wFAAwF;YAC1E,YAAY;CAqB1B"}

package/dist/sources/file-system-source.js

@@ -0,0 +1,149 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { parse as parseYaml } from 'yaml';
+import { RegistryError } from '../errors.js';
+/** Reads files from a directory recursively, returning a map of relative paths to contents. */
+async function readDirRecursive(dirPath, basePath = dirPath) {
+    const files = {};
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        const relativePath = path.relative(basePath, fullPath);
+        if (entry.isDirectory()) {
+            const subFiles = await readDirRecursive(fullPath, basePath);
+            Object.assign(files, subFiles);
+        }
+        else if (entry.isFile()) {
+            files[relativePath] = new Uint8Array(await fs.readFile(fullPath));
+        }
+    }
+    return files;
+}
+/** Extracts metadata from a Quill.yaml file within a quill directory. */
+async function readQuillMetadata(quillDir) {
+    const yamlPath = path.join(quillDir, 'Quill.yaml');
+    let content;
+    try {
+        content = await fs.readFile(yamlPath, 'utf-8');
+    }
+    catch (err) {
+        throw new RegistryError('load_error', `Failed to read Quill.yaml in ${quillDir}`, {
+            cause: err,
+        });
+    }
+    const parsed = parseYaml(content);
+    if (!parsed || typeof parsed.name !== 'string' || typeof parsed.version !== 'string') {
+        throw new RegistryError('load_error', `Invalid Quill.yaml in ${quillDir}: missing name or version`);
+    }
+    return {
+        name: parsed.name,
+        version: parsed.version,
+        ...(typeof parsed.description === 'string' ? { description: parsed.description } : {}),
+    };
+}
+/**
+ * Node.js-only QuillSource that reads Quill directories from the local filesystem.
+ *
+ * Each subdirectory of the provided `quillsDir` is treated as a quill.
+ * Each must contain a `Quill.yaml` with at least `name` and `version` fields.
+ *
+ * Also exposes `packageForHttp(outputDir)` to zip quills and write a manifest
+ * for static hosting.
+ */
+export class FileSystemSource {
+    quillsDir;
+    constructor(quillsDir) {
+        this.quillsDir = quillsDir;
+    }
+    async getManifest() {
+        let entries;
+        try {
+            const dirEntries = await fs.readdir(this.quillsDir, { withFileTypes: true });
+            entries = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch (err) {
+            throw new RegistryError('source_unavailable', `Failed to read quills directory: ${this.quillsDir}`, { cause: err });
+        }
+        const quills = [];
+        for (const dirName of entries) {
+            const quillDir = path.join(this.quillsDir, dirName);
+            const metadata = await readQuillMetadata(quillDir);
+            quills.push(metadata);
+        }
+        return { quills };
+    }
+    async loadQuill(name, version) {
+        const manifest = await this.getManifest();
+        const entry = manifest.quills.find((q) => q.name === name && (version === undefined || q.version === version));
+        if (!entry) {
+            if (version && manifest.quills.some((q) => q.name === name)) {
+                throw new RegistryError('version_not_found', `Quill "${name}" exists but version "${version}" was not found`, { quillName: name, version });
+            }
+            throw new RegistryError('quill_not_found', `Quill "${name}" not found in source`, {
+                quillName: name,
+                version,
+            });
+        }
+        const quillDir = await this.findQuillDir(entry.name, entry.version);
+        let files;
+        try {
+            files = await readDirRecursive(quillDir);
+        }
+        catch (err) {
+            throw new RegistryError('load_error', `Failed to read quill directory: ${quillDir}`, {
+                quillName: name,
+                version: entry.version,
+                cause: err,
+            });
+        }
+        return {
+            name: entry.name,
+            version: entry.version,
+            data: files,
+            metadata: entry,
+        };
+    }
+    /**
+     * Packages all quills for HTTP static hosting.
+     * Zips each quill directory and writes the zips plus a `manifest.json` to `outputDir`.
+     */
+    async packageForHttp(outputDir) {
+        await fs.mkdir(outputDir, { recursive: true });
+        const manifest = await this.getManifest();
+        for (const entry of manifest.quills) {
+            const quillDir = await this.findQuillDir(entry.name, entry.version);
+            const files = await readDirRecursive(quillDir);
+            const zip = new JSZip();
+            for (const [relativePath, content] of Object.entries(files)) {
+                zip.file(relativePath, content);
+            }
+            const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
+            const zipFileName = `${entry.name}@${entry.version}.zip`;
+            await fs.writeFile(path.join(outputDir, zipFileName), zipBuffer);
+        }
+        await fs.writeFile(path.join(outputDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    }
+    /** Finds the directory for a quill by scanning subdirectories and matching metadata. */
+    async findQuillDir(name, version) {
+        const dirEntries = await fs.readdir(this.quillsDir, { withFileTypes: true });
+        const dirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+        for (const dirName of dirs) {
+            const quillDir = path.join(this.quillsDir, dirName);
+            try {
+                const metadata = await readQuillMetadata(quillDir);
+                if (metadata.name === name && metadata.version === version) {
+                    return quillDir;
+                }
+            }
+            catch {
+                // Skip directories that don't have valid Quill.yaml
+            }
+        }
+        throw new RegistryError('quill_not_found', `Quill directory for "${name}@${version}" not found`, {
+            quillName: name,
+            version,
+        });
+    }
+}
+//# sourceMappingURL=file-system-source.js.map

package/dist/sources/file-system-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-source.js","sourceRoot":"","sources":["../../src/sources/file-system-source.ts"],"names":[],"mappings":"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"}

package/dist/sources/http-source.d.ts

@@ -0,0 +1,27 @@
+import type { QuillBundle, QuillManifest, QuillSource } from '../types.js';
+export interface HttpSourceOptions {
+    /** Base URL serving zips + manifest (e.g., "https://cdn.example.com/quills/"). */
+    baseUrl: string;
+    /** Optional pre-loaded manifest to skip the initial fetch (for SSR bootstrap). */
+    manifest?: QuillManifest;
+    /** Optional custom fetch function (for testing or non-browser environments). */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * QuillSource that fetches quill zips and manifest from any HTTP endpoint.
+ *
+ * Supports local static serving, CDN hosting, and remote quill registries
+ * with the same interface. Appends `?v={version}` to zip URLs for cache-busting.
+ *
+ * Works in both browser and Node.js environments.
+ */
+export declare class HttpSource implements QuillSource {
+    private baseUrl;
+    private preloadedManifest?;
+    private cachedManifest?;
+    private fetchFn;
+    constructor(options: HttpSourceOptions);
+    getManifest(): Promise<QuillManifest>;
+    loadQuill(name: string, version?: string): Promise<QuillBundle>;
+}
+//# sourceMappingURL=http-source.d.ts.map

package/dist/sources/http-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-source.d.ts","sourceRoot":"","sources":["../../src/sources/http-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG3E,MAAM,WAAW,iBAAiB;IACjC,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC7C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAC,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,iBAAiB;IAOhC,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAuCrC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA4ErE"}

package/dist/sources/http-source.js

@@ -0,0 +1,113 @@
+import JSZip from 'jszip';
+import { RegistryError } from '../errors.js';
+/**
+ * QuillSource that fetches quill zips and manifest from any HTTP endpoint.
+ *
+ * Supports local static serving, CDN hosting, and remote quill registries
+ * with the same interface. Appends `?v={version}` to zip URLs for cache-busting.
+ *
+ * Works in both browser and Node.js environments.
+ */
+export class HttpSource {
+    baseUrl;
+    preloadedManifest;
+    cachedManifest;
+    fetchFn;
+    constructor(options) {
+        // Ensure baseUrl ends with a slash for consistent URL construction
+        this.baseUrl = options.baseUrl.endsWith('/') ? options.baseUrl : options.baseUrl + '/';
+        this.preloadedManifest = options.manifest;
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async getManifest() {
+        if (this.preloadedManifest) {
+            return this.preloadedManifest;
+        }
+        if (this.cachedManifest) {
+            return this.cachedManifest;
+        }
+        const url = `${this.baseUrl}manifest.json`;
+        let response;
+        try {
+            response = await this.fetchFn(url);
+        }
+        catch (err) {
+            throw new RegistryError('source_unavailable', `Failed to fetch manifest from ${url}`, {
+                cause: err,
+            });
+        }
+        if (!response.ok) {
+            throw new RegistryError('source_unavailable', `Failed to fetch manifest: ${response.status} ${response.statusText}`);
+        }
+        let manifest;
+        try {
+            manifest = (await response.json());
+        }
+        catch (err) {
+            throw new RegistryError('source_unavailable', 'Failed to parse manifest JSON', {
+                cause: err,
+            });
+        }
+        this.cachedManifest = manifest;
+        return manifest;
+    }
+    async loadQuill(name, version) {
+        const manifest = await this.getManifest();
+        const entry = manifest.quills.find((q) => q.name === name && (version === undefined || q.version === version));
+        if (!entry) {
+            if (version && manifest.quills.some((q) => q.name === name)) {
+                throw new RegistryError('version_not_found', `Quill "${name}" exists but version "${version}" was not found`, { quillName: name, version });
+            }
+            throw new RegistryError('quill_not_found', `Quill "${name}" not found in source`, {
+                quillName: name,
+                version,
+            });
+        }
+        const resolvedVersion = entry.version;
+        const zipFileName = `${name}@${resolvedVersion}.zip`;
+        const zipUrl = `${this.baseUrl}${zipFileName}?v=${resolvedVersion}`;
+        let response;
+        try {
+            response = await this.fetchFn(zipUrl);
+        }
+        catch (err) {
+            throw new RegistryError('load_error', `Failed to fetch quill zip from ${zipUrl}`, {
+                quillName: name,
+                version: resolvedVersion,
+                cause: err,
+            });
+        }
+        if (!response.ok) {
+            throw new RegistryError('load_error', `Failed to fetch quill zip: ${response.status} ${response.statusText}`, { quillName: name, version: resolvedVersion });
+        }
+        let files;
+        try {
+            const zipData = await response.arrayBuffer();
+            const zip = await JSZip.loadAsync(zipData);
+            files = {};
+            const zipEntries = [];
+            zip.forEach((relativePath, zipEntry) => {
+                if (!zipEntry.dir) {
+                    zipEntries.push(zipEntry.async('uint8array').then((content) => {
+                        files[relativePath] = content;
+                    }));
+                }
+            });
+            await Promise.all(zipEntries);
+        }
+        catch (err) {
+            throw new RegistryError('load_error', `Failed to unzip quill "${name}"`, {
+                quillName: name,
+                version: resolvedVersion,
+                cause: err,
+            });
+        }
+        return {
+            name: entry.name,
+            version: resolvedVersion,
+            data: files,
+            metadata: entry,
+        };
+    }
+}
+//# sourceMappingURL=http-source.js.map

package/dist/sources/http-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-source.js","sourceRoot":"","sources":["../../src/sources/http-source.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Opaque to the registry. Defined and validated by @quillmark/wasm.
+ * Currently: the JSON structure returned by loaders.fromZip() or equivalent
+ * filesystem read (template files, assets, fonts, Typst packages).
+ */
+export type QuillData = unknown;
+/** Metadata about a quill, extracted from Quill.yaml or manifest. */
+export interface QuillMetadata {
+    name: string;
+    version: string;
+    description?: string;
+}
+/** Manifest listing all available quills from a source. */
+export interface QuillManifest {
+    quills: QuillMetadata[];
+}
+/** A resolved quill bundle ready for engine registration. */
+export interface QuillBundle {
+    name: string;
+    version: string;
+    /** Opaque payload passed to engine.registerQuill().
+     *  Shape is defined by @quillmark/wasm — the registry passes it through untouched.
+     *  Currently: the JSON structure returned by loaders.fromZip() or equivalent
+     *  filesystem read (template files, assets, fonts, Typst packages). */
+    data: QuillData;
+    metadata: QuillMetadata;
+}
+/** Pluggable backend that knows how to list and fetch Quills from a specific location. */
+export interface QuillSource {
+    getManifest(): Promise<QuillManifest>;
+    loadQuill(name: string, version?: string): Promise<QuillBundle>;
+}
+/** Info returned by the engine after registering or resolving a quill. */
+export interface QuillInfo {
+    name: string;
+    version: string;
+}
+/**
+ * Minimal interface for the @quillmark/wasm engine instance.
+ * The registry only calls these methods — it never imports or instantiates the engine.
+ */
+export interface QuillmarkEngine {
+    registerQuill(quill_json: unknown): QuillInfo;
+    resolveQuill(quill_ref: string): QuillInfo | null;
+    listQuills(): string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;AAEhC,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;2EAGuE;IACvE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC3B,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChE;AAED,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClD,UAAU,IAAI,MAAM,EAAE,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@quillmark/registry",
-  "version": "0.1.0",
+  "version": "0.1.10",
   "description": "Unified API for discovering, loading, packaging, and registering Quills with the WASM engine",
   "main": "./dist/index.js",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
     "build": "tsc",
@@ -62,4 +63,4 @@
       "optional": false
     }
   }
-}
+}