@pikku/addon-console 0.12.42 → 0.12.44

package/dist/src/functions/update-email-template.function.js

@@ -1,6 +1,5 @@
-import { NotFoundError } from '@pikku/core';
-import { LocalEnvironmentOnlyError } from '@pikku/core/errors';
-import { pikkuFunc } from '#pikku';
+import { LocalEnvironmentOnlyError, NotFoundError } from '#pikku/addon/error';
+import { pikkuFunc } from '#pikku/addon/function';
 export const updateEmailTemplate = pikkuFunc({
     title: 'Update Email Template',
     description: 'Overwrites an email template HTML source file (templates/<name>.html) so small edits can be made from the console.',

package/dist/src/functions/update-email-template.function.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-email-template.function.js","sourceRoot":"","sources":["../../../src/functions/update-email-template.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAM1C;IACA,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,oHAAoH;IACtH,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,4BAA4B,CAAC;IACtC,IAAI,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,CAAA;QACnD,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CACrB,iEAAiE,CAClE,CAAA;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,aAAa,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,MAAM,eAAe,CAAC,mBAAmB,CACvC,UAAU,CAAC,GAAG,EACd,YAAY,EACZ,MAAM,CACP,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"update-email-template.function.js","sourceRoot":"","sources":["../../../src/functions/update-email-template.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAM1C;IACA,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,oHAAoH;IACtH,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,4BAA4B,CAAC;IACtC,IAAI,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE,CAAA;QACnD,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,aAAa,CACrB,iEAAiE,CAClE,CAAA;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,aAAa,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,MAAM,eAAe,CAAC,mBAAmB,CACvC,UAAU,CAAC,GAAG,EACd,YAAY,EACZ,MAAM,CACP,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/update-function-body.function.d.ts

@@ -1,20 +1,20 @@
-export declare const updateFunctionBody: import("#pikku").PikkuFunctionConfig<{
+export declare const updateFunctionBody: import("#pikku/addon/function").PikkuFunctionConfig<{
     sourceFile: string;
     exportedName: string;
     body: string;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").PikkuFunction<{
+}, "rpc" | "session", import("#pikku/addon/function").PikkuFunction<{
     sourceFile: string;
     exportedName: string;
     body: string;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").WiredServices> | import("#pikku").PikkuFunctionSessionless<{
+}, "rpc" | "session", import("#pikku/addon/function").WiredServices> | import("#pikku/addon/function").PikkuFunctionSessionless<{
     sourceFile: string;
     exportedName: string;
     body: string;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").WiredServices, unknown>, undefined, undefined>;
+}, "rpc" | "session", import("#pikku/addon/function").WiredServices, unknown>, undefined, undefined>;
 //# sourceMappingURL=update-function-body.function.d.ts.map

package/dist/src/functions/update-function-body.function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-function-body.function.d.ts","sourceRoot":"","sources":["../../../src/functions/update-function-body.function.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB;gBAEf,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;qFAgBlB,CAAA"}
+{"version":3,"file":"update-function-body.function.d.ts","sourceRoot":"","sources":["../../../src/functions/update-function-body.function.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB;gBAEf,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;UACd,MAAM;;aAEH,OAAO;oGAgBlB,CAAA"}

package/dist/src/functions/update-function-body.function.js

@@ -1,5 +1,5 @@
-import { LocalEnvironmentOnlyError } from '@pikku/core/errors';
-import { pikkuFunc } from '#pikku';
+import { LocalEnvironmentOnlyError } from '#pikku/addon/error';
+import { pikkuFunc } from '#pikku/addon/function';
 export const updateFunctionBody = pikkuFunc({
     title: 'Update Function Body',
     description: 'Replaces the function body of a pikku function definition in source code and triggers a rebuild.',

package/dist/src/functions/update-function-body.function.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-function-body.function.js","sourceRoot":"","sources":["../../../src/functions/update-function-body.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAOzC;IACA,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,kGAAkG;IACpG,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,0BAA0B,CAAC;IACpC,IAAI,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE;QACtE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,eAAe,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;QACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"update-function-body.function.js","sourceRoot":"","sources":["../../../src/functions/update-function-body.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAOzC;IACA,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,kGAAkG;IACpG,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,0BAA0B,CAAC;IACpC,IAAI,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE;QACtE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,eAAe,CAAC,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;QACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}

package/dist/src/functions/update-function-config.function.d.ts

@@ -1,21 +1,21 @@
 import type { FunctionConfigChanges } from '../services/code-edit.service.js';
-export declare const updateFunctionConfig: import("#pikku").PikkuFunctionConfig<{
+export declare const updateFunctionConfig: import("#pikku/addon/function").PikkuFunctionConfig<{
     sourceFile: string;
     exportedName: string;
     changes: FunctionConfigChanges;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").PikkuFunction<{
+}, "rpc" | "session", import("#pikku/addon/function").PikkuFunction<{
     sourceFile: string;
     exportedName: string;
     changes: FunctionConfigChanges;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").WiredServices> | import("#pikku").PikkuFunctionSessionless<{
+}, "rpc" | "session", import("#pikku/addon/function").WiredServices> | import("#pikku/addon/function").PikkuFunctionSessionless<{
     sourceFile: string;
     exportedName: string;
     changes: FunctionConfigChanges;
 }, {
     success: boolean;
-}, "rpc" | "session", import("#pikku").WiredServices, unknown>, undefined, undefined>;
+}, "rpc" | "session", import("#pikku/addon/function").WiredServices, unknown>, undefined, undefined>;
 //# sourceMappingURL=update-function-config.function.d.ts.map

package/dist/src/functions/update-function-config.function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-function-config.function.d.ts","sourceRoot":"","sources":["../../../src/functions/update-function-config.function.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAE7E,eAAO,MAAM,oBAAoB;gBAEjB,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;qFAoBlB,CAAA"}
+{"version":3,"file":"update-function-config.function.d.ts","sourceRoot":"","sources":["../../../src/functions/update-function-config.function.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAE7E,eAAO,MAAM,oBAAoB;gBAEjB,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;;gBAJJ,MAAM;kBACJ,MAAM;aACX,qBAAqB;;aAErB,OAAO;oGAoBlB,CAAA"}

package/dist/src/functions/update-function-config.function.js

@@ -1,5 +1,5 @@
-import { LocalEnvironmentOnlyError } from '@pikku/core/errors';
-import { pikkuFunc } from '#pikku';
+import { LocalEnvironmentOnlyError } from '#pikku/addon/error';
+import { pikkuFunc } from '#pikku/addon/function';
 export const updateFunctionConfig = pikkuFunc({
     title: 'Update Function Config',
     description: 'Updates the config properties of a pikku function definition in source code and triggers a rebuild.',

package/dist/src/functions/update-function-config.function.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-function-config.function.js","sourceRoot":"","sources":["../../../src/functions/update-function-config.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAGlC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAO3C;IACA,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,qGAAqG;IACvG,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,0BAA0B,CAAC;IACpC,IAAI,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,eAAe,CAAC,oBAAoB,CACxC,UAAU,EACV,YAAY,EACZ,OAAO,CACR,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"update-function-config.function.js","sourceRoot":"","sources":["../../../src/functions/update-function-config.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAO3C;IACA,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EACT,qGAAqG;IACvG,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,CAAC,0BAA0B,CAAC;IACpC,IAAI,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;QACzE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,MAAM,eAAe,CAAC,oBAAoB,CACxC,UAAU,EACV,YAAY,EACZ,OAAO,CACR,CAAA;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF,CAAC,CAAA"}

package/dist/src/lib/addon-readiness.test.js

@@ -99,7 +99,7 @@ test('a package with no declarations is ready', async () => {
 test('reads the override names out of the instance wiring file', async () => {
     await withRoot(async (root) => {
         const wiringFile = join(root, 'widget-promo.addon.ts');
-        await writeFile(wiringFile, `import { wireAddon } from '#pikku/pikku-types.gen.js'
+        await writeFile(wiringFile, `import { wireAddon } from '#pikku/addon'
 
 wireAddon({
   name: 'widget-promo',

package/dist/src/lib/audit-exec.d.ts

@@ -1,5 +1,5 @@
-import type { MetaService } from '@pikku/core/ecosystem/services';
-import type { SecurityAuditReport } from '@pikku/core/ecosystem/types';
+import type { MetaService } from '@pikku/core/services';
+import type { SecurityAuditReport } from '@pikku/core/types';
 export declare function findBin(name: string, searchFrom: string): string;
 export declare function readAuditReport(metaService: MetaService): Promise<SecurityAuditReport | null>;
 export declare function spawnProcess(command: string, args: string[], cwd: string, { failOnNonZero, timeoutMs, }?: {

package/dist/src/lib/audit-exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-exec.d.ts","sourceRoot":"","sources":["../../../src/lib/audit-exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAItE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUhE;AAID,wBAAsB,eAAe,CACnC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAQrC;AAQD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,EACE,aAAqB,EACrB,SAAsB,GACvB,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC,IAAI,CAAC,CAmCf;AAGD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrE"}
+{"version":3,"file":"audit-exec.d.ts","sourceRoot":"","sources":["../../../src/lib/audit-exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUhE;AAID,wBAAsB,eAAe,CACnC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAQrC;AAQD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,EACE,aAAqB,EACrB,SAAsB,GACvB,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC,IAAI,CAAC,CAmCf;AAGD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrE"}

package/dist/src/lib/audit-exec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-exec.test.d.ts.map

package/dist/src/lib/audit-exec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-exec.test.d.ts","sourceRoot":"","sources":["../../../src/lib/audit-exec.test.ts"],"names":[],"mappings":""}

package/dist/src/lib/audit-exec.test.js

@@ -0,0 +1,97 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert/strict';
+import { chmodSync, mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { findBin, readAuditReport, spawnProcess } from './audit-exec.js';
+const scratch = () => mkdtempSync(join(tmpdir(), 'pikku-audit-exec-'));
+const executable = (dir, name, body) => {
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, name);
+    writeFileSync(path, body);
+    chmodSync(path, 0o755);
+    return path;
+};
+describe('findBin', () => {
+    test('finds the binary in the nearest node_modules/.bin', () => {
+        const root = scratch();
+        const nested = join(root, 'packages', 'api');
+        mkdirSync(nested, { recursive: true });
+        const bin = executable(join(nested, 'node_modules', '.bin'), 'pikku', '');
+        assert.equal(findBin('pikku', nested), bin);
+    });
+    test('walks up to a hoisted binary in the workspace root', () => {
+        const root = scratch();
+        const nested = join(root, 'packages', 'api', 'src');
+        mkdirSync(nested, { recursive: true });
+        const bin = executable(join(root, 'node_modules', '.bin'), 'pikku', '');
+        assert.equal(findBin('pikku', nested), bin);
+    });
+    test('prefers the closest binary over the hoisted one', () => {
+        const root = scratch();
+        const nested = join(root, 'packages', 'api');
+        mkdirSync(nested, { recursive: true });
+        executable(join(root, 'node_modules', '.bin'), 'pikku', '');
+        const local = executable(join(nested, 'node_modules', '.bin'), 'pikku', '');
+        assert.equal(findBin('pikku', nested), local);
+    });
+    // Falling back to the bare name lets PATH resolve it — a globally installed
+    // CLI still works rather than the call failing outright.
+    test('falls back to the bare name when nothing is installed', () => {
+        assert.equal(findBin('pikku', scratch()), 'pikku');
+    });
+});
+describe('spawnProcess', () => {
+    const sh = (body) => {
+        const dir = scratch();
+        return executable(dir, 'script.sh', `#!/bin/sh\n${body}`);
+    };
+    test('resolves when the process succeeds', async () => {
+        await spawnProcess(sh('exit 0'), [], scratch());
+    });
+    // `pikku audit` exits non-zero precisely when it finds advisories, having
+    // written a perfectly valid report — rejecting there would hide findings.
+    test('is lenient about a non-zero exit by default', async () => {
+        await spawnProcess(sh('exit 3'), [], scratch());
+    });
+    test('rejects on a non-zero exit when asked to', async () => {
+        await assert.rejects(spawnProcess(sh('exit 3'), [], scratch(), { failOnNonZero: true }), /exit 3/);
+    });
+    test('includes stderr so the failure is diagnosable', async () => {
+        await assert.rejects(spawnProcess(sh('echo "no matching version" >&2; exit 1'), [], scratch(), {
+            failOnNonZero: true,
+        }), /no matching version/);
+    });
+    test('rejects when the command does not exist', async () => {
+        await assert.rejects(spawnProcess(join(scratch(), 'nope'), [], scratch()), /ENOENT/);
+    });
+    // A hung `bun install` must not hold the console request open forever.
+    test('kills and rejects a process that outruns its timeout', async () => {
+        const started = Date.now();
+        await assert.rejects(spawnProcess(sh('sleep 30'), [], scratch(), { timeoutMs: 250 }), /timed out after 250ms/);
+        assert.ok(Date.now() - started < 5_000);
+    });
+    test('does not fire the timeout for a process that finished in time', async () => {
+        await spawnProcess(sh('exit 0'), [], scratch(), { timeoutMs: 10_000 });
+    });
+});
+describe('readAuditReport', () => {
+    const metaService = (readFile) => ({ readFile });
+    test('parses the report', async () => {
+        const report = await readAuditReport(metaService(async () => JSON.stringify({ schemaVersion: 1, tool: 'bun' })));
+        assert.equal(report?.tool, 'bun');
+    });
+    test('is null when there is no report yet', async () => {
+        assert.equal(await readAuditReport(metaService(async () => null)), null);
+        assert.equal(await readAuditReport(metaService(async () => '')), null);
+    });
+    test('is null rather than throwing on a malformed report', async () => {
+        assert.equal(await readAuditReport(metaService(async () => '{ truncated')), null);
+    });
+    test('is null rather than throwing when the read itself fails', async () => {
+        assert.equal(await readAuditReport(metaService(async () => {
+            throw new Error('EACCES');
+        })), null);
+    });
+});
+//# sourceMappingURL=audit-exec.test.js.map

package/dist/src/lib/audit-exec.test.js.map

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

package/dist/src/lib/derive-instance-overrides.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join, resolve, sep } from 'node:path';
-import { BadRequestError } from '@pikku/core/errors';
+import { BadRequestError } from '#pikku/addon/error';
 /** Anchoring the first character on npm's no-leading-dot rule is what excludes
  *  `.` and `..`; a trailing `[a-z0-9._-]+` alone matches both. */
 const VALID_PACKAGE_NAME = /^(@[a-z0-9-]+\/)?[a-z0-9-][a-z0-9._-]*$/;

package/dist/src/lib/resolve-audit-users.d.ts

@@ -1,5 +1,5 @@
 import type { BetterAuthInstance } from '@pikku/better-auth';
-import type { CoreSingletonServices } from '@pikku/core';
+import type { CoreSingletonServices } from '@pikku/core/types';
 /** Who a user id belongs to. */
 export type AuditUserProfile = {
     name?: string;

package/dist/src/lib/resolve-audit-users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-audit-users.d.ts","sourceRoot":"","sources":["../../../src/lib/resolve-audit-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,CAAC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS,EACrD,SAAS,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAClC,SAAS,qBAAqB,CAAC,QAAQ,CAAC,KACvC,OAAO,CAAC,kBAAkB,CAsC5B,CAAA"}
+{"version":3,"file":"resolve-audit-users.d.ts","sourceRoot":"","sources":["../../../src/lib/resolve-audit-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAE9D,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,CAAC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS,EACrD,SAAS,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAClC,SAAS,qBAAqB,CAAC,QAAQ,CAAC,KACvC,OAAO,CAAC,kBAAkB,CAsC5B,CAAA"}

package/dist/src/lib/resolve-package-manager.d.ts

@@ -13,6 +13,17 @@ export declare const execPrefix: Record<PackageManager, [string, ...string[]]>;
  * lockfile exists, and a project can carry a stale lockfile from another tool.
  * Lockfiles are the fallback, then npm, which every Node install ships with.
  *
+ * The search walks up from `rootDir`, because `rootDir` is the pikku root (the
+ * directory holding pikku.config.json) and in a monorepo that is a package dir
+ * carrying neither signal — both live at the workspace root above it. Stopping
+ * at the pikku root would fall through to the npm default and run `npm install`
+ * inside a yarn workspace, which dies on `Unsupported URL Type "workspace:"`.
+ *
+ * A declared manager anywhere up the tree outranks any lockfile, for the same
+ * reason it does within one directory: lockfiles get copied around and go
+ * stale, so a stray package-lock.json in a sub-package must not override the
+ * workspace root's declared yarn.
+ *
  * Guessing wrong is not a soft failure: the install spawns a binary that isn't
  * on PATH and the caller sees `Executable not found in $PATH: "yarn"`.
  */

package/dist/src/lib/resolve-package-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-package-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAKzE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAKpE,CAAA;AAWD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAqBrE"}
+{"version":3,"file":"resolve-package-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAKzE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAKpE,CAAA;AA8BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAuBrE"}

package/dist/src/lib/resolve-package-manager.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 /** `<pm> <args...> <pkg>` for adding a dependency. */
 export const installArgs = {
     bun: (pkg) => ['add', pkg],
@@ -26,36 +26,65 @@ const LOCKFILES = [
     ['pnpm-lock.yaml', 'pnpm'],
     ['package-lock.json', 'npm'],
 ];
+/** The corepack field of `dir/package.json`, when it names a manager we run. */
+function declaredPackageManager(dir) {
+    const pkgJsonPath = join(dir, 'package.json');
+    if (!existsSync(pkgJsonPath))
+        return null;
+    try {
+        const declared = JSON.parse(readFileSync(pkgJsonPath, 'utf-8')).packageManager;
+        // e.g. "bun@1.3.14", "yarn@4.5.0+sha224.abc"
+        const name = typeof declared === 'string' ? declared.split('@')[0] : null;
+        if (name && name in installArgs)
+            return name;
+    }
+    catch (e) {
+        // A malformed package.json is the project's problem, not ours — fall
+        // through to lockfile detection rather than failing the install.
+        console.warn(`Could not read packageManager from ${pkgJsonPath}:`, e);
+    }
+    return null;
+}
 /**
  * Which package manager runs in this project. `packageManager` in package.json
  * (the corepack field) is authoritative — it states intent even before a
  * lockfile exists, and a project can carry a stale lockfile from another tool.
  * Lockfiles are the fallback, then npm, which every Node install ships with.
  *
+ * The search walks up from `rootDir`, because `rootDir` is the pikku root (the
+ * directory holding pikku.config.json) and in a monorepo that is a package dir
+ * carrying neither signal — both live at the workspace root above it. Stopping
+ * at the pikku root would fall through to the npm default and run `npm install`
+ * inside a yarn workspace, which dies on `Unsupported URL Type "workspace:"`.
+ *
+ * A declared manager anywhere up the tree outranks any lockfile, for the same
+ * reason it does within one directory: lockfiles get copied around and go
+ * stale, so a stray package-lock.json in a sub-package must not override the
+ * workspace root's declared yarn.
+ *
  * Guessing wrong is not a soft failure: the install spawns a binary that isn't
  * on PATH and the caller sees `Executable not found in $PATH: "yarn"`.
  */
 export function resolvePackageManager(rootDir) {
-    const pkgJsonPath = join(rootDir, 'package.json');
-    if (existsSync(pkgJsonPath)) {
-        try {
-            const declared = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'))
-                .packageManager;
-            // e.g. "bun@1.3.14", "yarn@4.5.0+sha224.abc"
-            const name = typeof declared === 'string' ? declared.split('@')[0] : null;
-            if (name && name in installArgs)
-                return name;
-        }
-        catch (e) {
-            // A malformed root package.json is the project's problem, not ours —
-            // fall through to lockfile detection rather than failing the install.
-            console.warn(`Could not read packageManager from ${pkgJsonPath}:`, e);
+    let nearestLockfile = null;
+    let dir = rootDir;
+    while (true) {
+        const declared = declaredPackageManager(dir);
+        if (declared)
+            return declared;
+        if (!nearestLockfile) {
+            for (const [lock, pm] of LOCKFILES) {
+                if (existsSync(join(dir, lock))) {
+                    nearestLockfile = pm;
+                    break;
+                }
+            }
         }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
     }
-    for (const [lock, pm] of LOCKFILES) {
-        if (existsSync(join(rootDir, lock)))
-            return pm;
-    }
-    return 'npm';
+    return nearestLockfile ?? 'npm';
 }
 //# sourceMappingURL=resolve-package-manager.js.map

package/dist/src/lib/resolve-package-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-package-manager.js","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAsD;IAC5E,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC;IAC1B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC;CAC/B,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkD;IACvE,GAAG,EAAE,CAAC,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,CAAC,KAAK,CAAC;CACb,CAAA;AAED,qEAAqE;AACrE,MAAM,SAAS,GAAoC;IACjD,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,WAAW,EAAE,MAAM,CAAC;IACrB,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAC7B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IACjD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;iBAC5D,cAAc,CAAA;YACjB,6CAA6C;YAC7C,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YACzE,IAAI,IAAI,IAAI,IAAI,IAAI,WAAW;gBAAE,OAAO,IAAsB,CAAA;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,qEAAqE;YACrE,sEAAsE;YACtE,OAAO,CAAC,IAAI,CAAC,sCAAsC,WAAW,GAAG,EAAE,CAAC,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAA;IAChD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"resolve-package-manager.js","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/resolve-package-manager.test.js

@@ -1,6 +1,6 @@
 import { strict as assert } from 'assert';
 import { describe, test, beforeEach, afterEach } from 'node:test';
-import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { resolvePackageManager } from './resolve-package-manager.js';
@@ -51,5 +51,43 @@ describe('resolvePackageManager', () => {
     test('defaults to npm with no signals', () => {
         assert.equal(resolvePackageManager(dir), 'npm');
     });
+    describe('in a monorepo, where the workspace root is above the pikku root', () => {
+        // The pikku root is wherever pikku.config.json sits, which in a monorepo is
+        // a package dir carrying neither packageManager nor a lockfile. Both live
+        // at the workspace root above it, so detection has to keep walking.
+        const nestPikkuRoot = () => {
+            const pikkuRoot = join(dir, 'packages', 'functions');
+            mkdirSync(pikkuRoot, { recursive: true });
+            writeFileSync(join(pikkuRoot, 'package.json'), JSON.stringify({ name: '@app/functions' }), 'utf-8');
+            return pikkuRoot;
+        };
+        test('reads packageManager from the workspace root', () => {
+            writePkg({ packageManager: 'yarn@4.10.3' });
+            assert.equal(resolvePackageManager(nestPikkuRoot()), 'yarn');
+        });
+        test('detects the workspace root lockfile', () => {
+            writePkg({});
+            writeFileSync(join(dir, 'yarn.lock'), '', 'utf-8');
+            assert.equal(resolvePackageManager(nestPikkuRoot()), 'yarn');
+        });
+        test('the nearest declaration wins over the workspace root', () => {
+            writePkg({ packageManager: 'yarn@4.10.3' });
+            const pikkuRoot = nestPikkuRoot();
+            writeFileSync(join(pikkuRoot, 'package.json'), JSON.stringify({ packageManager: 'pnpm@9.0.0' }), 'utf-8');
+            assert.equal(resolvePackageManager(pikkuRoot), 'pnpm');
+        });
+        test('a nearer lockfile still loses to a declared packageManager above it', () => {
+            // Lockfiles get copied around and go stale; the corepack field states
+            // intent, so it outranks a lockfile found lower down.
+            writePkg({ packageManager: 'yarn@4.10.3' });
+            const pikkuRoot = nestPikkuRoot();
+            writeFileSync(join(pikkuRoot, 'package-lock.json'), '', 'utf-8');
+            assert.equal(resolvePackageManager(pikkuRoot), 'yarn');
+        });
+        test('still defaults to npm when the whole tree is silent', () => {
+            writePkg({});
+            assert.equal(resolvePackageManager(nestPikkuRoot()), 'npm');
+        });
+    });
 });
 //# sourceMappingURL=resolve-package-manager.test.js.map

package/dist/src/lib/resolve-package-manager.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-package-manager.test.js","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-package-manager.test.js","sourceRoot":"","sources":["../../../src/lib/resolve-package-manager.test.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/surface.d.ts

@@ -0,0 +1,30 @@
+import type { SurfaceDoc, SurfaceResult, SurfaceUsage } from './surface.types.js';
+export type { SurfaceDoc, SurfaceResult, SurfaceUsage };
+/** The package that computes the doc when it is built, and ships it. */
+export declare const SURFACE_DOC_PACKAGE = "@pikku/cli";
+/**
+ * `@pikku/cli/surface.json`, expressed relative to the package's `.pikku` root
+ * because that is where `readPackageFile` starts from.
+ */
+export declare const SURFACE_DOC_PATH = "../surface.json";
+/** Relative to the project's outDir, where prebuild writes it. */
+export declare const SURFACE_USAGE_PATH = "surface-usage.gen.json";
+export declare const EMPTY_SURFACE_USAGE: SurfaceUsage;
+/**
+ * The two reads the surface is made of. Narrower than `MetaService` on purpose,
+ * so the reader is exercised without a project on disk.
+ */
+export type SurfaceReader = {
+    readFile(relativePath: string): Promise<string | null>;
+    readPackageFile?(packageName: string, relativePath: string): Promise<string | null>;
+};
+/**
+ * Reads the framework's surface doc and this project's measured usage.
+ *
+ * Both halves are optional and independently so: a project on an older CLI has
+ * no doc, one that has never run prebuild has no usage, and a website-like host
+ * has the doc alone. Every absence is an empty result rather than a throw,
+ * because the page teaches from the doc and only confirms from the usage.
+ */
+export declare const readSurface: (reader: SurfaceReader) => Promise<SurfaceResult>;
+//# sourceMappingURL=surface.d.ts.map

package/dist/src/lib/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../src/lib/surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,mBAAmB,EAAE,YAAkC,CAAA;AAEpE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACtD,eAAe,CAAC,CACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC1B,CAAA;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,aAAa,KACpB,OAAO,CAAC,aAAa,CAUvB,CAAA"}

package/dist/src/lib/surface.js

@@ -0,0 +1,47 @@
+/** The package that computes the doc when it is built, and ships it. */
+export const SURFACE_DOC_PACKAGE = '@pikku/cli';
+/**
+ * `@pikku/cli/surface.json`, expressed relative to the package's `.pikku` root
+ * because that is where `readPackageFile` starts from.
+ */
+export const SURFACE_DOC_PATH = '../surface.json';
+/** Relative to the project's outDir, where prebuild writes it. */
+export const SURFACE_USAGE_PATH = 'surface-usage.gen.json';
+export const EMPTY_SURFACE_USAGE = { bySpecifier: {} };
+const read = async (attempt) => {
+    try {
+        return (await attempt()) ?? null;
+    }
+    catch {
+        return null;
+    }
+};
+const parseJson = (content) => {
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Reads the framework's surface doc and this project's measured usage.
+ *
+ * Both halves are optional and independently so: a project on an older CLI has
+ * no doc, one that has never run prebuild has no usage, and a website-like host
+ * has the doc alone. Every absence is an empty result rather than a throw,
+ * because the page teaches from the doc and only confirms from the usage.
+ */
+export const readSurface = async (reader) => {
+    const [docContent, usageContent] = await Promise.all([
+        read(() => reader.readPackageFile?.(SURFACE_DOC_PACKAGE, SURFACE_DOC_PATH)),
+        read(() => reader.readFile(SURFACE_USAGE_PATH)),
+    ]);
+    return {
+        doc: parseJson(docContent),
+        usage: parseJson(usageContent) ?? EMPTY_SURFACE_USAGE,
+    };
+};
+//# sourceMappingURL=surface.js.map

package/dist/src/lib/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../../src/lib/surface.ts"],"names":[],"mappings":"AAQA,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAA;AAEjD,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;AAcpE,MAAM,IAAI,GAAG,KAAK,EAChB,OAAiD,EACzB,EAAE;IAC1B,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,OAAO,EAAE,CAAC,IAAI,IAAI,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAI,OAAsB,EAAY,EAAE;IACxD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,MAAqB,EACG,EAAE;IAC1B,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;QAC3E,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;KAChD,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,SAAS,CAAa,UAAU,CAAC;QACtC,KAAK,EAAE,SAAS,CAAe,YAAY,CAAC,IAAI,mBAAmB;KACpE,CAAA;AACH,CAAC,CAAA"}

package/dist/src/lib/surface.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surface.test.d.ts.map

package/dist/src/lib/surface.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.test.d.ts","sourceRoot":"","sources":["../../../src/lib/surface.test.ts"],"names":[],"mappings":""}