@quillmark/quiver 0.6.0 → 0.7.0

package/dist/node.d.ts

@@ -4,7 +4,7 @@
  * Importing this module is the consumer's explicit declaration of intent:
  * "I am running in Node and want the Node-only Quiver factories." It exposes
  * the same `Quiver` class as the main entry, augmented with `fromDir`,
- * `fromPackage`, `fromBuiltDir`, and `build` static methods.
+ * `fromPackage`, `fromBuiltDir`, `build`, and `buildPackage` static methods.
  *
  * Side effect: at module evaluation time, the Node-only static methods are
  * installed on the shared `Quiver` constructor. Any other module that already
@@ -63,6 +63,16 @@ type NodeQuiverStatics = {
      * on I/O failures.
      */
     build(sourceDir: string, outDir: string, opts?: BuildOptions): Promise<void>;
+    /**
+     * Resolves an npm specifier against `node_modules` and builds the source
+     * layout at the package root. The resolved package must have `Quiver.yaml`
+     * at its root. Symmetric to `fromPackage` but writes a runtime build
+     * artifact to outDir instead of loading.
+     *
+     * Throws `transport_error` on resolution/I/O failure, `quiver_invalid` on
+     * source validation failures.
+     */
+    buildPackage(specifier: string, outDir: string, opts?: BuildOptions): Promise<void>;
 };
 export type Quiver = Base;
 export declare const Quiver: typeof Base & NodeQuiverStatics;

package/dist/node.js

@@ -4,7 +4,7 @@
  * Importing this module is the consumer's explicit declaration of intent:
  * "I am running in Node and want the Node-only Quiver factories." It exposes
  * the same `Quiver` class as the main entry, augmented with `fromDir`,
- * `fromPackage`, `fromBuiltDir`, and `build` static methods.
+ * `fromPackage`, `fromBuiltDir`, `build`, and `buildPackage` static methods.
  *
  * Side effect: at module evaluation time, the Node-only static methods are
  * installed on the shared `Quiver` constructor. Any other module that already
@@ -55,6 +55,17 @@ Quiver.fromPackage = async function fromPackage(specifier) {
 Quiver.build = async function build(sourceDir, outDir, opts) {
     return buildQuiver(sourceDir, outDir, opts);
 };
+Quiver.buildPackage = async function buildPackage(specifier, outDir, opts) {
+    const req = createRequire(import.meta.url);
+    let yamlPath;
+    try {
+        yamlPath = req.resolve(`${specifier}/Quiver.yaml`);
+    }
+    catch (err) {
+        throw new QuiverError("transport_error", `Failed to resolve quiver package "${specifier}": ${err.message}`, { cause: err });
+    }
+    return buildQuiver(dirname(yamlPath), outDir, opts);
+};
 // ---------------------------------------------------------------------------
 // 3. Re-export the rest of the public surface so consumers get one import.
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/quiver",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Quiver registry and build tooling for Quillmark",
   "type": "module",
   "license": "MIT",