plgg-bundle 0.0.1

package/dist/domain/usecase/isExternal.spec.d.ts

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

package/dist/domain/usecase/isExternal.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isExternal.spec.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/isExternal.spec.ts"],"names":[],"mappings":""}

package/dist/domain/usecase/isExternal.spec.js

@@ -0,0 +1,16 @@
+import { test, check, all, toBe, } from "plgg-test";
+import { isExternal } from "plgg-bundle/domain/usecase/isExternal";
+test("isExternal handles a string-array external", () => all([
+    check(isExternal(["plgg", "node:fs"], "plgg"), toBe(true)),
+    check(isExternal(["plgg"], "plgg-server"), toBe(false)),
+    check(isExternal([], "anything"), toBe(false)),
+]));
+test("isExternal handles a RegExp external", () => all([
+    check(isExternal(/^node:/, "node:stream"), toBe(true)),
+    check(isExternal(/^node:/, "plgg/index"), toBe(false)),
+]));
+test("isExternal handles a predicate external", () => all([
+    check(isExternal((id) => id.startsWith("plgg"), "plgg-server/node"), toBe(true)),
+    check(isExternal((id) => id.startsWith("plgg"), "./relative"), toBe(false)),
+]));
+//# sourceMappingURL=isExternal.spec.js.map

package/dist/domain/usecase/isExternal.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isExternal.spec.js","sourceRoot":"","sources":["../../../src/domain/usecase/isExternal.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE,CACtD,GAAG,CAAC;IACF,KAAK,CACH,UAAU,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,EACvC,IAAI,CAAC,IAAI,CAAC,CACX;IACD,KAAK,CACH,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,EACnC,IAAI,CAAC,KAAK,CAAC,CACZ;IACD,KAAK,CACH,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,EAC1B,IAAI,CAAC,KAAK,CAAC,CACZ;CACF,CAAC,CAAC,CAAC;AAEN,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE,CAChD,GAAG,CAAC;IACF,KAAK,CACH,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,EACnC,IAAI,CAAC,IAAI,CAAC,CACX;IACD,KAAK,CACH,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,EAClC,IAAI,CAAC,KAAK,CAAC,CACZ;CACF,CAAC,CAAC,CAAC;AAEN,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE,CACnD,GAAG,CAAC;IACF,KAAK,CACH,UAAU,CACR,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAC7B,kBAAkB,CACnB,EACD,IAAI,CAAC,IAAI,CAAC,CACX;IACD,KAAK,CACH,UAAU,CACR,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAC7B,YAAY,CACb,EACD,IAAI,CAAC,KAAK,CAAC,CACZ;CACF,CAAC,CAAC,CAAC"}

package/dist/domain/usecase/resolveSpecifier.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Resolve a bare import specifier to an absolute source
+ * file path, given the importing file and the
+ * package-self-alias mapping. Pure resolution logic —
+ * it only consults the filesystem to pick between
+ * `X.ts` and `X/index.ts`, mirroring how the alias +
+ * relative imports across the plgg packages resolve
+ * under `tsc`.
+ *
+ * Returns `undefined` when the specifier is external
+ * (not the self-alias and not relative) or cannot be
+ * found on disk — the caller decides whether that means
+ * "external, leave it" or "broken import, fail".
+ */
+export declare const resolveSpecifier: (args: {
+    specifier: string;
+    fromFile: string;
+    aliasPrefix: string;
+    aliasSrcRoot: string;
+}) => string | undefined;
+/**
+ * Whether the specifier is a relative path (`./` or
+ * `../`). Exported for the app-mode workspace resolver,
+ * which shares this relative-import handling.
+ */
+export declare const isRelative: (specifier: string) => boolean;
+/**
+ * Given a base path with no extension, pick the
+ * existing source file: the path as-is, then `base.ts`,
+ * then `base/index.ts`. Exported so the app-mode
+ * workspace resolver picks sibling source files the same
+ * way.
+ */
+export declare const pickExisting: (base: string) => string | undefined;
+//# sourceMappingURL=resolveSpecifier.d.ts.map

package/dist/domain/usecase/resolveSpecifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSpecifier.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/resolveSpecifier.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,MAAM,GAAG,SAaZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,MAAM,KAChB,OAE0B,CAAC;AA0B9B;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,KACX,MAAM,GAAG,SACmB,CAAC"}

package/dist/domain/usecase/resolveSpecifier.js

@@ -0,0 +1,83 @@
+import { existsSync, statSync } from "node:fs";
+import { dirname, resolve, join, } from "node:path";
+/**
+ * Resolve a bare import specifier to an absolute source
+ * file path, given the importing file and the
+ * package-self-alias mapping. Pure resolution logic —
+ * it only consults the filesystem to pick between
+ * `X.ts` and `X/index.ts`, mirroring how the alias +
+ * relative imports across the plgg packages resolve
+ * under `tsc`.
+ *
+ * Returns `undefined` when the specifier is external
+ * (not the self-alias and not relative) or cannot be
+ * found on disk — the caller decides whether that means
+ * "external, leave it" or "broken import, fail".
+ */
+export const resolveSpecifier = (args) => {
+    if (isRelative(args.specifier)) {
+        return pickExisting(resolve(dirname(args.fromFile), args.specifier));
+    }
+    const base = aliasTarget(args);
+    return base === undefined
+        ? undefined
+        : pickExisting(base);
+};
+/**
+ * Whether the specifier is a relative path (`./` or
+ * `../`). Exported for the app-mode workspace resolver,
+ * which shares this relative-import handling.
+ */
+export const isRelative = (specifier) => specifier.startsWith("./") ||
+    specifier.startsWith("../");
+/**
+ * Map a self-alias specifier (`<prefix>` or
+ * `<prefix>/sub/path`) to its base path under the
+ * source root. A non-alias specifier yields `undefined`
+ * (it is external).
+ */
+const aliasTarget = (args) => args.specifier === args.aliasPrefix
+    ? args.aliasSrcRoot
+    : args.specifier.startsWith(`${args.aliasPrefix}/`)
+        ? join(args.aliasSrcRoot, args.specifier.slice(args.aliasPrefix.length + 1))
+        : undefined;
+/**
+ * Given a base path with no extension, pick the
+ * existing source file: the path as-is, then `base.ts`,
+ * then `base/index.ts`. Exported so the app-mode
+ * workspace resolver picks sibling source files the same
+ * way.
+ */
+export const pickExisting = (base) => candidates(base).find(isFile);
+/**
+ * Whether a path exists and is a regular file (not a
+ * directory). A bare `plgg/Abstracts` base resolves to
+ * the `Abstracts/` directory, which must be skipped in
+ * favor of `Abstracts/index.ts`.
+ */
+const isFile = (p) => existsSync(p) && statSync(p).isFile();
+/**
+ * The ordered candidate file paths for a base path. A
+ * `.js`/`.mjs`/`.jsx` specifier is the NodeNext/ESM way
+ * to reference a TypeScript sibling (`./X.js` → `X.ts`),
+ * so its `.ts`/`.mts`/`.tsx` form is tried first.
+ */
+const candidates = (base) => [
+    ...tsForJs(base),
+    base,
+    `${base}.ts`,
+    join(base, "index.ts"),
+];
+/**
+ * The TypeScript-source path implied by a JS-extension
+ * specifier, or nothing if `base` carries no such
+ * extension.
+ */
+const tsForJs = (base) => base.endsWith(".js")
+    ? [`${base.slice(0, -3)}.ts`]
+    : base.endsWith(".mjs")
+        ? [`${base.slice(0, -4)}.mts`]
+        : base.endsWith(".jsx")
+            ? [`${base.slice(0, -4)}.tsx`]
+            : [];
+//# sourceMappingURL=resolveSpecifier.js.map

package/dist/domain/usecase/resolveSpecifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSpecifier.js","sourceRoot":"","sources":["../../../src/domain/usecase/resolveSpecifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,OAAO,EACP,IAAI,GACL,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAKhC,EAAsB,EAAE;IACvB,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,YAAY,CACjB,OAAO,CACL,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EACtB,IAAI,CAAC,SAAS,CACf,CACF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,SAAiB,EACR,EAAE,CACX,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;IAC1B,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,IAIpB,EAAsB,EAAE,CACvB,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,WAAW;IACjC,CAAC,CAAC,IAAI,CAAC,YAAY;IACnB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CACrB,GAAG,IAAI,CAAC,WAAW,GAAG,CACvB;QACH,CAAC,CAAC,IAAI,CACF,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,SAAS,CAAC,KAAK,CAClB,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAC5B,CACF;QACH,CAAC,CAAC,SAAS,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAY,EACQ,EAAE,CACtB,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,GAAG,CAAC,CAAS,EAAW,EAAE,CACpC,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CACjB,IAAY,EACW,EAAE,CAAC;IAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;IAChB,IAAI;IACJ,GAAG,IAAI,KAAK;IACZ,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,GAAG,CACd,IAAY,EACW,EAAE,CACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAClB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9B,CAAC,CAAC,EAAE,CAAC"}

package/dist/domain/usecase/resolveSpecifier.spec.d.ts

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

package/dist/domain/usecase/resolveSpecifier.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSpecifier.spec.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/resolveSpecifier.spec.ts"],"names":[],"mappings":""}

package/dist/domain/usecase/resolveSpecifier.spec.js

@@ -0,0 +1,44 @@
+import { test, check, all, toBe, } from "plgg-test";
+import { join } from "node:path";
+import { resolveSpecifier } from "plgg-bundle/domain/usecase/resolveSpecifier";
+// Resolve against this package's own src tree on disk.
+const srcRoot = join(import.meta.dirname, "..", "..");
+const aliasArgs = {
+    aliasPrefix: "plgg-bundle",
+    aliasSrcRoot: srcRoot,
+};
+test("resolveSpecifier resolves an alias to a file", () => check(resolveSpecifier({
+    specifier: "plgg-bundle/domain/usecase/isExternal",
+    fromFile: join(srcRoot, "index.ts"),
+    ...aliasArgs,
+}), toBe(join(srcRoot, "domain", "usecase", "isExternal.ts"))));
+test("resolveSpecifier returns undefined for an alias dir with no index", () => 
+// domain/model has no index.ts → unresolvable.
+check(resolveSpecifier({
+    specifier: "plgg-bundle/domain/model",
+    fromFile: join(srcRoot, "index.ts"),
+    ...aliasArgs,
+}), toBe(undefined)));
+test("resolveSpecifier resolves a relative path", () => check(resolveSpecifier({
+    specifier: "./isExternal",
+    fromFile: join(srcRoot, "domain", "usecase", "collectModules.ts"),
+    ...aliasArgs,
+}), toBe(join(srcRoot, "domain", "usecase", "isExternal.ts"))));
+test("resolveSpecifier maps a .js specifier to its .ts source (NodeNext)", () => check(resolveSpecifier({
+    specifier: "./isExternal.js",
+    fromFile: join(srcRoot, "domain", "usecase", "collectModules.ts"),
+    ...aliasArgs,
+}), toBe(join(srcRoot, "domain", "usecase", "isExternal.ts"))));
+test("resolveSpecifier returns undefined for an external specifier", () => all([
+    check(resolveSpecifier({
+        specifier: "plgg",
+        fromFile: join(srcRoot, "index.ts"),
+        ...aliasArgs,
+    }), toBe(undefined)),
+    check(resolveSpecifier({
+        specifier: "node:fs",
+        fromFile: join(srcRoot, "index.ts"),
+        ...aliasArgs,
+    }), toBe(undefined)),
+]));
+//# sourceMappingURL=resolveSpecifier.spec.js.map

package/dist/domain/usecase/resolveSpecifier.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSpecifier.spec.js","sourceRoot":"","sources":["../../../src/domain/usecase/resolveSpecifier.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E,uDAAuD;AACvD,MAAM,OAAO,GAAG,IAAI,CAClB,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,IAAI,EACJ,IAAI,CACL,CAAC;AACF,MAAM,SAAS,GAAG;IAChB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE,CACxD,KAAK,CACH,gBAAgB,CAAC;IACf,SAAS,EACP,uCAAuC;IACzC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;IACnC,GAAG,SAAS;CACb,CAAC,EACF,IAAI,CACF,IAAI,CACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,CAChB,CACF,CACF,CAAC,CAAC;AAEL,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;AAC7E,+CAA+C;AAC/C,KAAK,CACH,gBAAgB,CAAC;IACf,SAAS,EAAE,0BAA0B;IACrC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;IACnC,GAAG,SAAS;CACb,CAAC,EACF,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC,CAAC;AAEL,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE,CACrD,KAAK,CACH,gBAAgB,CAAC;IACf,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,IAAI,CACZ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,mBAAmB,CACpB;IACD,GAAG,SAAS;CACb,CAAC,EACF,IAAI,CACF,IAAI,CACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,CAChB,CACF,CACF,CAAC,CAAC;AAEL,IAAI,CAAC,oEAAoE,EAAE,GAAG,EAAE,CAC9E,KAAK,CACH,gBAAgB,CAAC;IACf,SAAS,EAAE,iBAAiB;IAC5B,QAAQ,EAAE,IAAI,CACZ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,mBAAmB,CACpB;IACD,GAAG,SAAS;CACb,CAAC,EACF,IAAI,CACF,IAAI,CACF,OAAO,EACP,QAAQ,EACR,SAAS,EACT,eAAe,CAChB,CACF,CACF,CAAC,CAAC;AAEL,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE,CACxE,GAAG,CAAC;IACF,KAAK,CACH,gBAAgB,CAAC;QACf,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QACnC,GAAG,SAAS;KACb,CAAC,EACF,IAAI,CAAC,SAAS,CAAC,CAChB;IACD,KAAK,CACH,gBAAgB,CAAC;QACf,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QACnC,GAAG,SAAS;KACb,CAAC,EACF,IAAI,CAAC,SAAS,CAAC,CAChB;CACF,CAAC,CAAC,CAAC"}

package/dist/domain/usecase/resolveWorkspaceSpecifier.d.ts

@@ -0,0 +1,29 @@
+import { type WorkspacePackage } from "plgg-bundle/domain/usecase/discoverWorkspace";
+/**
+ * App-mode resolver: resolve an import specifier to an
+ * absolute SOURCE file, inlining workspace siblings
+ * (`plgg`, `plgg-view/client`, …) by walking their `src`
+ * instead of leaving them external. This is the mirror of
+ * the library externalization — the leaf app is where
+ * bundling deps is correct.
+ *
+ * Order:
+ * 1. relative (`./x`) → resolve against the importer,
+ * 2. a workspace package's PUBLIC export subpath
+ *    (`plgg-view/style`) → reverse its declared
+ *    `exports` dist path to the entry source (honours the
+ *    `styleEntry` rename),
+ * 3. a workspace package's INTERNAL self-alias path
+ *    (`plgg-view/Html/x`, and `plgg` → its `src/index`)
+ *    → `src/<path>`.
+ *
+ * Returns `undefined` when the specifier is neither
+ * relative nor a known workspace package (the caller
+ * treats that as external or a hard error).
+ */
+export declare const resolveWorkspaceSpecifier: (args: {
+    specifier: string;
+    fromFile: string;
+    packages: ReadonlyArray<WorkspacePackage>;
+}) => string | undefined;
+//# sourceMappingURL=resolveWorkspaceSpecifier.d.ts.map

package/dist/domain/usecase/resolveWorkspaceSpecifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceSpecifier.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/resolveWorkspaceSpecifier.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC3C,KAAG,MAAM,GAAG,SAgBZ,CAAC"}

package/dist/domain/usecase/resolveWorkspaceSpecifier.js

@@ -0,0 +1,89 @@
+import { basename, join } from "node:path";
+import { resolveSpecifier, isRelative, pickExisting, } from "plgg-bundle/domain/usecase/resolveSpecifier";
+import {} from "plgg-bundle/domain/usecase/discoverWorkspace";
+/**
+ * App-mode resolver: resolve an import specifier to an
+ * absolute SOURCE file, inlining workspace siblings
+ * (`plgg`, `plgg-view/client`, …) by walking their `src`
+ * instead of leaving them external. This is the mirror of
+ * the library externalization — the leaf app is where
+ * bundling deps is correct.
+ *
+ * Order:
+ * 1. relative (`./x`) → resolve against the importer,
+ * 2. a workspace package's PUBLIC export subpath
+ *    (`plgg-view/style`) → reverse its declared
+ *    `exports` dist path to the entry source (honours the
+ *    `styleEntry` rename),
+ * 3. a workspace package's INTERNAL self-alias path
+ *    (`plgg-view/Html/x`, and `plgg` → its `src/index`)
+ *    → `src/<path>`.
+ *
+ * Returns `undefined` when the specifier is neither
+ * relative nor a known workspace package (the caller
+ * treats that as external or a hard error).
+ */
+export const resolveWorkspaceSpecifier = (args) => {
+    if (isRelative(args.specifier)) {
+        return resolveSpecifier({
+            specifier: args.specifier,
+            fromFile: args.fromFile,
+            aliasPrefix: NO_ALIAS,
+            aliasSrcRoot: "",
+        });
+    }
+    const pkg = matchPackage(args.packages, args.specifier);
+    return pkg === undefined
+        ? undefined
+        : resolveInPackage(pkg, args.specifier);
+};
+/**
+ * A sentinel alias prefix no specifier equals, so the
+ * shared `resolveSpecifier` handles only the relative
+ * branch when reused for relative imports.
+ */
+const NO_ALIAS = "\0";
+/**
+ * The workspace package whose name is the specifier or a
+ * leading `name/` segment. The package list is sorted
+ * longest-name-first, so the first match is the most
+ * specific (`plgg-view` before `plgg`).
+ */
+const matchPackage = (packages, specifier) => packages.find((p) => specifier === p.name ||
+    specifier.startsWith(`${p.name}/`));
+/**
+ * Resolve a specifier already known to belong to `pkg`:
+ * a declared export subpath via the exports reversal,
+ * else the internal self-alias path.
+ */
+const resolveInPackage = (pkg, specifier) => {
+    const subpath = specifier === pkg.name
+        ? "."
+        : `./${specifier.slice(pkg.name.length + 1)}`;
+    const dist = pkg.exports.get(subpath);
+    return dist === undefined
+        ? resolveSpecifier({
+            specifier,
+            fromFile: pkg.dir,
+            aliasPrefix: pkg.name,
+            aliasSrcRoot: join(pkg.dir, "src"),
+        })
+        : pickExisting(join(pkg.dir, "src", srcStem(dist)));
+};
+/**
+ * The source stem implied by an export's dist default —
+ * `"./dist/styleEntry.es.js"` → `"styleEntry"`. The entry
+ * output basename equals the entry name, which equals the
+ * source file stem under `src/`, so stripping the dual
+ * `.es.js`/`.cjs.js` (or bare `.js`) suffix recovers it.
+ *
+ * ASSUMES top-level entry stems: `basename` drops any
+ * directory, so an export pointing at a NESTED dist path
+ * (`./dist/sub/foo.es.js`) would reverse to `src/foo` and
+ * lose `sub/`. No package nests an export entry today, so
+ * this is correct now; revisit if one ever does.
+ */
+const srcStem = (distDefault) => basename(distDefault)
+    .replace(/\.(es|cjs)\.js$/, "")
+    .replace(/\.js$/, "");
+//# sourceMappingURL=resolveWorkspaceSpecifier.js.map

package/dist/domain/usecase/resolveWorkspaceSpecifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceSpecifier.js","sourceRoot":"","sources":["../../../src/domain/usecase/resolveWorkspaceSpecifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAyB,MAAM,8CAA8C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAIzC,EAAsB,EAAE;IACvB,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC;YACtB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,QAAQ;YACrB,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CACtB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACf,CAAC;IACF,OAAO,GAAG,KAAK,SAAS;QACtB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CACnB,QAAyC,EACzC,SAAiB,EACa,EAAE,CAChC,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,EAAE,CACJ,SAAS,KAAK,CAAC,CAAC,IAAI;IACpB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CACrC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CACvB,GAAqB,EACrB,SAAiB,EACG,EAAE;IACtB,MAAM,OAAO,GACX,SAAS,KAAK,GAAG,CAAC,IAAI;QACpB,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAClB,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CACpB,EAAE,CAAC;IACV,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,gBAAgB,CAAC;YACf,SAAS;YACT,QAAQ,EAAE,GAAG,CAAC,GAAG;YACjB,WAAW,EAAE,GAAG,CAAC,IAAI;YACrB,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;SACnC,CAAC;QACJ,CAAC,CAAC,YAAY,CACV,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CACpC,CAAC;AACR,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC9C,QAAQ,CAAC,WAAW,CAAC;KAClB,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;KAC9B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC"}

package/dist/domain/usecase/resolveWorkspaceSpecifier.spec.d.ts

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

package/dist/domain/usecase/resolveWorkspaceSpecifier.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceSpecifier.spec.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/resolveWorkspaceSpecifier.spec.ts"],"names":[],"mappings":""}

package/dist/domain/usecase/resolveWorkspaceSpecifier.spec.js

@@ -0,0 +1,27 @@
+import { test, check, all, toBe, } from "plgg-test";
+import { join } from "node:path";
+import { discoverWorkspace } from "plgg-bundle/domain/usecase/discoverWorkspace";
+import { resolveWorkspaceSpecifier } from "plgg-bundle/domain/usecase/resolveWorkspaceSpecifier";
+const bundleRoot = join(import.meta.dirname, "..", "..", "..");
+const packagesDir = join(bundleRoot, "..");
+const packages = discoverWorkspace(bundleRoot);
+// Any file standing in for the importer.
+const fromFile = join(packagesDir, "example", "src", "app.ts");
+const resolve = (specifier) => resolveWorkspaceSpecifier({
+    specifier,
+    fromFile,
+    packages,
+});
+const pkgSrc = (name, ...rest) => join(packagesDir, name, "src", ...rest);
+test("resolves a bare workspace package to its src index", () => check(resolve("plgg"), toBe(pkgSrc("plgg", "index.ts"))));
+test("resolves a public export subpath, honouring the styleEntry rename", () => all([
+    check(resolve("plgg-view/client"), toBe(pkgSrc("plgg-view", "client.ts"))),
+    check(resolve("plgg-view/style"), toBe(pkgSrc("plgg-view", "styleEntry.ts"))),
+]));
+test("resolves an internal self-alias path (not a declared export)", () => check(resolve("plgg/Atomics/Num"), toBe(pkgSrc("plgg", "Atomics", "Num.ts"))));
+test("resolves a relative import against the importer", () => check(resolve("./Todo.ts"), toBe(join(packagesDir, "example", "src", "Todo.ts"))));
+test("returns undefined for a non-workspace specifier", () => all([
+    check(resolve("react"), toBe(undefined)),
+    check(resolve("node:fs"), toBe(undefined)),
+]));
+//# sourceMappingURL=resolveWorkspaceSpecifier.spec.js.map

package/dist/domain/usecase/resolveWorkspaceSpecifier.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceSpecifier.spec.js","sourceRoot":"","sources":["../../../src/domain/usecase/resolveWorkspaceSpecifier.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AAEjG,MAAM,UAAU,GAAG,IAAI,CACrB,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,IAAI,EACJ,IAAI,EACJ,IAAI,CACL,CAAC;AACF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;AAE/C,yCAAyC;AACzC,MAAM,QAAQ,GAAG,IAAI,CACnB,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,CACT,CAAC;AACF,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAE,EAAE,CACpC,yBAAyB,CAAC;IACxB,SAAS;IACT,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AACL,MAAM,MAAM,GAAG,CACb,IAAY,EACZ,GAAG,IAA2B,EAC9B,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;AAE7C,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE,CAC9D,KAAK,CACH,OAAO,CAAC,MAAM,CAAC,EACf,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CACjC,CAAC,CAAC;AAEL,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE,CAC7E,GAAG,CAAC;IACF,KAAK,CACH,OAAO,CAAC,kBAAkB,CAAC,EAC3B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CACvC;IACD,KAAK,CACH,OAAO,CAAC,iBAAiB,CAAC,EAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAC3C;CACF,CAAC,CAAC,CAAC;AAEN,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE,CACxE,KAAK,CACH,OAAO,CAAC,kBAAkB,CAAC,EAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAC1C,CAAC,CAAC;AAEL,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE,CAC3D,KAAK,CACH,OAAO,CAAC,WAAW,CAAC,EACpB,IAAI,CACF,IAAI,CACF,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,CACV,CACF,CACF,CAAC,CAAC;AAEL,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE,CAC3D,GAAG,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;CAC3C,CAAC,CAAC,CAAC"}

package/dist/domain/usecase/rewriteDtsAliases.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rewrite the package self-alias (`<prefix>/<sub>`) in
+ * every emitted `.d.ts` under `distDir` to a path
+ * relative to the importing declaration file — the same
+ * transform vite-plugin-dts applied. `tsc` leaves
+ * `tsconfig` `paths` aliases verbatim in declaration
+ * output, so without this pass a consumer (who has no
+ * `plgg/*` alias) cannot resolve `from "plgg/Atomics"`.
+ *
+ * Because `dist` mirrors `src` and the alias maps
+ * `<prefix>/*` → `src/*`, `<prefix>/<sub>` from
+ * `dist/A/B.d.ts` resolves to `dist/<sub>`, i.e. the
+ * relative path from `dist/A` to `dist/<sub>`.
+ */
+export declare const rewriteDtsAliases: (distDir: string, aliasPrefix: string) => void;
+/**
+ * Rewrite a single declaration file's alias specifiers
+ * (pure string transform, exposed for unit testing). The
+ * match is ANCHORED to import/export specifier positions
+ * — preceded by `from ` or `import(` — so a literal
+ * string-type value like `type T = "plgg/x"` in a
+ * `.d.ts` is left untouched (gap #7).
+ */
+export declare const rewriteDtsContent: (file: string, content: string, distDir: string, aliasPrefix: string) => string;
+//# sourceMappingURL=rewriteDtsAliases.d.ts.map

package/dist/domain/usecase/rewriteDtsAliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteDtsAliases.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/rewriteDtsAliases.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,aAAa,MAAM,KAClB,IAYF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,SAAS,MAAM,EACf,aAAa,MAAM,KAClB,MAcA,CAAC"}

package/dist/domain/usecase/rewriteDtsAliases.js

@@ -0,0 +1,71 @@
+import { readdirSync, statSync, readFileSync, writeFileSync, } from "node:fs";
+import { join, dirname, relative, } from "node:path";
+/**
+ * Rewrite the package self-alias (`<prefix>/<sub>`) in
+ * every emitted `.d.ts` under `distDir` to a path
+ * relative to the importing declaration file — the same
+ * transform vite-plugin-dts applied. `tsc` leaves
+ * `tsconfig` `paths` aliases verbatim in declaration
+ * output, so without this pass a consumer (who has no
+ * `plgg/*` alias) cannot resolve `from "plgg/Atomics"`.
+ *
+ * Because `dist` mirrors `src` and the alias maps
+ * `<prefix>/*` → `src/*`, `<prefix>/<sub>` from
+ * `dist/A/B.d.ts` resolves to `dist/<sub>`, i.e. the
+ * relative path from `dist/A` to `dist/<sub>`.
+ */
+export const rewriteDtsAliases = (distDir, aliasPrefix) => {
+    // fs walk seam: visit every emitted declaration and
+    // relativize its alias imports in place.
+    for (const file of dtsFiles(distDir)) {
+        const rewritten = rewriteDtsContent(file, readFileSync(file, "utf8"), distDir, aliasPrefix);
+        writeFileSync(file, rewritten, "utf8");
+    }
+};
+/**
+ * Rewrite a single declaration file's alias specifiers
+ * (pure string transform, exposed for unit testing). The
+ * match is ANCHORED to import/export specifier positions
+ * — preceded by `from ` or `import(` — so a literal
+ * string-type value like `type T = "plgg/x"` in a
+ * `.d.ts` is left untouched (gap #7).
+ */
+export const rewriteDtsContent = (file, content, distDir, aliasPrefix) => content.replace(aliasPattern(aliasPrefix), (_match, lead, quote, sub) => `${lead}${quote}${toRelative(file, distDir, sub)}${quote}`);
+/**
+ * A specifier-matching regex for `<prefix>/<sub>` only
+ * in an import/export specifier position: immediately
+ * after `from ` or `import(`. Captures the lead, the
+ * quote, and the sub-path. The prefix is escaped so a
+ * regex-special character in a package name is literal.
+ */
+const aliasPattern = (aliasPrefix) => new RegExp(`(from\\s+|import\\s*\\()(["'])${escapeRegExp(aliasPrefix)}\\/([^"']+)\\2`, "g");
+/**
+ * The relative specifier from a declaration file to the
+ * aliased sub-module's location in `dist`, POSIX-style
+ * and `./`-prefixed when in the same/!-parent dir.
+ */
+const toRelative = (file, distDir, sub) => dotted(relative(dirname(file), join(distDir, sub))
+    .split("\\")
+    .join("/"));
+/**
+ * Ensure a relative path is import-specifier shaped:
+ * a same-or-child path gets a leading `./`; a `../`
+ * path already is.
+ */
+const dotted = (rel) => rel.startsWith(".") ? rel : `./${rel}`;
+/**
+ * Escape regex metacharacters in a literal string.
+ */
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * All `.d.ts` files under a directory, recursively.
+ */
+const dtsFiles = (dir) => readdirSync(dir).flatMap((name) => {
+    const p = join(dir, name);
+    return statSync(p).isDirectory()
+        ? dtsFiles(p)
+        : p.endsWith(".d.ts")
+            ? [p]
+            : [];
+});
+//# sourceMappingURL=rewriteDtsAliases.js.map

package/dist/domain/usecase/rewriteDtsAliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteDtsAliases.js","sourceRoot":"","sources":["../../../src/domain/usecase/rewriteDtsAliases.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,IAAI,EACJ,OAAO,EACP,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAAe,EACf,WAAmB,EACb,EAAE;IACR,oDAAoD;IACpD,yCAAyC;IACzC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,iBAAiB,CACjC,IAAI,EACJ,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAC1B,OAAO,EACP,WAAW,CACZ,CAAC;QACF,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,OAAe,EACf,OAAe,EACf,WAAmB,EACX,EAAE,CACV,OAAO,CAAC,OAAO,CACb,YAAY,CAAC,WAAW,CAAC,EACzB,CACE,MAAM,EACN,IAAY,EACZ,KAAa,EACb,GAAW,EACX,EAAE,CACF,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAC1B,IAAI,EACJ,OAAO,EACP,GAAG,CACJ,GAAG,KAAK,EAAE,CACd,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,CACnB,WAAmB,EACX,EAAE,CACV,IAAI,MAAM,CACR,iCAAiC,YAAY,CAC3C,WAAW,CACZ,gBAAgB,EACjB,GAAG,CACJ,CAAC;AAEJ;;;;GAIG;AACH,MAAM,UAAU,GAAG,CACjB,IAAY,EACZ,OAAe,EACf,GAAW,EACH,EAAE,CACV,MAAM,CACJ,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;KACxC,KAAK,CAAC,IAAI,CAAC;KACX,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE,CACrC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,CAAS,EAAU,EAAE,CACzC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,QAAQ,GAAG,CACf,GAAW,EACY,EAAE,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnB,CAAC,CAAC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;AACX,CAAC,CAAC,CAAC"}

package/dist/domain/usecase/rewriteDtsAliases.spec.d.ts

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

package/dist/domain/usecase/rewriteDtsAliases.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteDtsAliases.spec.d.ts","sourceRoot":"","sources":["../../../src/domain/usecase/rewriteDtsAliases.spec.ts"],"names":[],"mappings":""}

package/dist/domain/usecase/rewriteDtsAliases.spec.js

@@ -0,0 +1,35 @@
+import { test, check, all, toBe, } from "plgg-test";
+import { join } from "node:path";
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { rewriteDtsAliases, rewriteDtsContent, } from "plgg-bundle/domain/usecase/rewriteDtsAliases";
+const distDir = "/pkg/dist";
+// A declaration two levels deep, so a rewrite to a
+// top-level sibling is a `../../` path.
+const file = join(distDir, "Disjunctives", "Result.d.ts");
+test("rewriteDtsContent relativizes an alias in `from` position", () => check(rewriteDtsContent(file, `import { Ok } from "plgg/index";`, distDir, "plgg"), toBe(`import { Ok } from "../index";`)));
+test("rewriteDtsContent relativizes a re-export and an inline import()", () => all([
+    check(rewriteDtsContent(join(distDir, "index.d.ts"), `export * from "plgg/Atomics";`, distDir, "plgg"), toBe(`export * from "./Atomics";`)),
+    check(rewriteDtsContent(join(distDir, "index.d.ts"), `export type T = import("plgg/Atomics/Num").Num;`, distDir, "plgg"), toBe(`export type T = import("./Atomics/Num").Num;`)),
+]));
+test("rewriteDtsContent leaves a literal-type string untouched (gap #7)", () => 
+// A string-literal type that merely looks like an
+// alias must NOT be rewritten — it is not an
+// import/export specifier position.
+check(rewriteDtsContent(join(distDir, "index.d.ts"), `export type Tag = "plgg/not-a-module";`, distDir, "plgg"), toBe(`export type Tag = "plgg/not-a-module";`)));
+test("rewriteDtsAliases rewrites aliases across a nested dist tree in place", () => {
+    const dist = mkdtempSync(join(tmpdir(), "plgg-dts-"));
+    mkdirSync(join(dist, "Sub"));
+    writeFileSync(join(dist, "index.d.ts"), `export * from "plgg/Sub/x";`);
+    writeFileSync(join(dist, "Sub", "x.d.ts"), `import { Y } from "plgg/index";`);
+    // A non-.d.ts sibling must be skipped by the walk.
+    writeFileSync(join(dist, "notes.txt"), `plgg/index (not a declaration)`);
+    rewriteDtsAliases(dist, "plgg");
+    return all([
+        check(readFileSync(join(dist, "index.d.ts"), "utf8"), toBe(`export * from "./Sub/x";`)),
+        check(readFileSync(join(dist, "Sub", "x.d.ts"), "utf8"), toBe(`import { Y } from "../index";`)),
+        // Untouched: not a declaration file.
+        check(readFileSync(join(dist, "notes.txt"), "utf8"), toBe(`plgg/index (not a declaration)`)),
+    ]);
+});
+//# sourceMappingURL=rewriteDtsAliases.spec.js.map

package/dist/domain/usecase/rewriteDtsAliases.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteDtsAliases.spec.js","sourceRoot":"","sources":["../../../src/domain/usecase/rewriteDtsAliases.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,8CAA8C,CAAC;AAEtD,MAAM,OAAO,GAAG,WAAW,CAAC;AAC5B,mDAAmD;AACnD,wCAAwC;AACxC,MAAM,IAAI,GAAG,IAAI,CACf,OAAO,EACP,cAAc,EACd,aAAa,CACd,CAAC;AAEF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE,CACrE,KAAK,CACH,iBAAiB,CACf,IAAI,EACJ,kCAAkC,EAClC,OAAO,EACP,MAAM,CACP,EACD,IAAI,CAAC,gCAAgC,CAAC,CACvC,CAAC,CAAC;AAEL,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE,CAC5E,GAAG,CAAC;IACF,KAAK,CACH,iBAAiB,CACf,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAC3B,+BAA+B,EAC/B,OAAO,EACP,MAAM,CACP,EACD,IAAI,CAAC,4BAA4B,CAAC,CACnC;IACD,KAAK,CACH,iBAAiB,CACf,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAC3B,iDAAiD,EACjD,OAAO,EACP,MAAM,CACP,EACD,IAAI,CACF,8CAA8C,CAC/C,CACF;CACF,CAAC,CAAC,CAAC;AAEN,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;AAC7E,kDAAkD;AAClD,6CAA6C;AAC7C,oCAAoC;AACpC,KAAK,CACH,iBAAiB,CACf,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAC3B,wCAAwC,EACxC,OAAO,EACP,MAAM,CACP,EACD,IAAI,CACF,wCAAwC,CACzC,CACF,CAAC,CAAC;AAEL,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;IACjF,MAAM,IAAI,GAAG,WAAW,CACtB,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAC5B,CAAC;IACF,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7B,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EACxB,6BAA6B,CAC9B,CAAC;IACF,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAC3B,iCAAiC,CAClC,CAAC;IACF,mDAAmD;IACnD,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EACvB,gCAAgC,CACjC,CAAC;IACF,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;QACT,KAAK,CACH,YAAY,CACV,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EACxB,MAAM,CACP,EACD,IAAI,CAAC,0BAA0B,CAAC,CACjC;QACD,KAAK,CACH,YAAY,CACV,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAC3B,MAAM,CACP,EACD,IAAI,CAAC,+BAA+B,CAAC,CACtC;QACD,qCAAqC;QACrC,KAAK,CACH,YAAY,CACV,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EACvB,MAAM,CACP,EACD,IAAI,CAAC,gCAAgC,CAAC,CACvC;KACF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/entrypoints/cli.d.ts

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

package/dist/entrypoints/cli.d.ts.map

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

package/dist/entrypoints/cli.js

@@ -0,0 +1,79 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
+import {} from "plgg-bundle/domain/model/BundleConfig";
+import { asBundleConfig } from "plgg-bundle/domain/usecase/asBundleConfig";
+import { build } from "plgg-bundle/domain/usecase/build";
+import { runDevServer } from "plgg-bundle/Dev/node/devServer";
+/**
+ * CLI entry with two modes:
+ *
+ *  - `plgg-bundle [config]` — the one-shot build (default):
+ *    validate the config and emit the bundle.
+ *  - `plgg-bundle dev [config]` — the dev server: serve the
+ *    config's dev entry over node:http, watch its source,
+ *    and hot-reload the browser on a code edit.
+ *
+ * The shell stays thin and is the single place a thrown
+ * error becomes a non-zero exit — the plain-TS counterpart
+ * to a `Result` edge. The `dev` server itself runs for the
+ * process lifetime (it never resolves).
+ */
+const main = async () => process.argv[2] === "dev"
+    ? runDev(process.argv[3])
+    : runBuild(process.argv[2]);
+/** The one-shot build mode. */
+const runBuild = async (arg) => {
+    const config = await loadConfig(arg);
+    if (config === null) {
+        return;
+    }
+    const files = build(config);
+    process.stdout.write(`plgg-bundle: wrote ${files.length} file(s) to ${config.outDir}\n`);
+};
+/** The dev-server mode. */
+const runDev = async (arg) => {
+    const config = await loadConfig(arg);
+    if (config === null) {
+        return;
+    }
+    const server = await runDevServer(config);
+    process.stdout.write(`plgg-bundle: dev server at ${server.url}\n`);
+};
+/**
+ * Resolve, import (Node strips its types), and validate
+ * the bundle config, or set a non-zero exit and return
+ * null when it is missing. Shared by both modes.
+ */
+const loadConfig = async (arg) => {
+    const configPath = resolve(process.cwd(), arg ?? "bundle.config.ts");
+    if (!existsSync(configPath)) {
+        fail(`config not found: ${configPath}`);
+        return null;
+    }
+    const mod = await import(pathToFileURL(configPath).href);
+    return asBundleConfig(pickDefault(mod));
+};
+/**
+ * Extract a module's `default` export as `unknown`,
+ * tolerating a module that is itself the config.
+ */
+const pickDefault = (mod) => typeof mod === "object" &&
+    mod !== null &&
+    "default" in mod
+    ? mod.default
+    : mod;
+/**
+ * Print an error and set a non-zero exit code.
+ */
+const fail = (message) => {
+    process.stderr.write(`plgg-bundle: ${message}\n`);
+    process.exitCode = 1;
+};
+try {
+    await main();
+}
+catch (e) {
+    fail(e instanceof Error ? e.message : String(e));
+}
+//# sourceMappingURL=cli.js.map