@_linked/cli 1.34.0 → 1.36.0

package/lib/esm/commands/{doctor.js → app-doctor.js}

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 /**
- * `linked doctor` — check an app's dev dependency setup for the problems that
+ * `linked app-doctor` — check an app's dev dependency setup for the problems that
  * otherwise only show up in the browser.
  *
  * It loads the app's Vite config the way the dev server does, runs the same
@@ -26,6 +26,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  * Hand-written include entries that the scan now generates are listed too, as
  * safe to delete.
  */
+import fs from 'node:fs';
 import path from 'node:path';
 import semver from 'semver';
 import { readInstalledPkg } from '../installed-packages.js';
@@ -147,10 +148,31 @@ function loadAppScan(cwd) {
         };
     });
 }
-export function runDoctor() {
+/** The config names `linked start` and `linked build-app` accept as "this is an app". */
+const APP_VITE_CONFIGS = ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'];
+/**
+ * Why `cwd` is not an app, or null when it is. Without this, Vite resolves an
+ * empty default config, the scan finds nothing, and the report says
+ * "0 warnings" — a clean bill of health for a directory that was never checked.
+ */
+export function notAnAppReason(cwd) {
+    if (APP_VITE_CONFIGS.some((f) => fs.existsSync(path.join(cwd, f)))) {
+        return null;
+    }
+    return (`linked app-doctor: ${cwd} is not an app — no vite.config.{ts,js,mjs} found. ` +
+        'Run it from the root of an app (the directory with its vite.config); ' +
+        'it checks how the app uses linked packages, so there is nothing to check in a package.');
+}
+export function runAppDoctor() {
     return __awaiter(this, arguments, void 0, function* (options = {}) {
         var _a;
         const cwd = path.resolve((_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd());
+        const notAnApp = notAnAppReason(cwd);
+        if (notAnApp) {
+            console.error(notAnApp);
+            process.exitCode = 1;
+            return;
+        }
         const started = performance.now();
         const { appInclude, scan } = yield loadAppScan(cwd);
         const findings = yield diagnose({ cwd, appInclude, scan });
@@ -158,10 +180,10 @@ export function runDoctor() {
             (f.level === 'warn' ? console.warn : console.log)(`${f.level === 'warn' ? 'warning' : 'note'}: ${f.message}`);
         }
         const warnings = findings.filter((f) => f.level === 'warn').length;
-        console.log(`linked doctor: ${warnings} warning${warnings === 1 ? '' : 's'}; ` +
+        console.log(`linked app-doctor: ${warnings} warning${warnings === 1 ? '' : 's'}; ` +
             `${scan.entries.length} client dependencies of ${scan.frameworkPackages.length} linked packages ` +
             `generated for optimizeDeps.include (${Math.round(performance.now() - started)}ms)`);
         process.exitCode = warnings ? 1 : 0;
     });
 }
-//# sourceMappingURL=doctor.js.map
+//# sourceMappingURL=app-doctor.js.map

package/lib/esm/commands/app-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-doctor.js","sourceRoot":"","sources":["../../../src/commands/app-doctor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `linked app-doctor` — check an app's dev dependency setup for the problems that\n * otherwise only show up in the browser.\n *\n * It loads the app's Vite config the way the dev server does, runs the same\n * client-dependency scan `createViteConfig` runs (./client-dep-includes.ts), and\n * warns about:\n *\n * - `optimizeDeps.include` entries that do not resolve. Vite only logs these,\n *   and the dependency then reaches the browser unoptimised — a CommonJS one\n *   fails on `require`. The usual cause is a package npm installed NESTED under\n *   a framework package, which needs the `'<pkg> > <dep>'` form.\n * - a framework package's dependency whose React peer range excludes the app's\n *   React. That is why npm nests it (vaul 0.9 under `@_linked/primitives` with\n *   React 19); the fix is a newer release of the dependency in that package.\n *\n * Hand-written include entries that the scan now generates are listed too, as\n * safe to delete.\n */\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport semver from 'semver';\nimport {readInstalledPkg} from '../installed-packages.js';\nimport {\n  lastClientDepScan,\n  packageNameOf,\n  resolvePackageFile,\n  scanLinkedClientDeps,\n  type ClientDepScan,\n} from '../client-dep-includes.js';\n\nexport interface AppDoctorFinding {\n  level: 'warn' | 'info';\n  message: string;\n}\n\nexport interface DiagnoseInput {\n  cwd: string;\n  /** The app's own `optimizeDeps.include` (hand-written, before generation). */\n  appInclude: string[];\n  scan: ClientDepScan;\n}\n\n/** Split a Vite include entry (`a > b > c/sub`) and resolve it hop by hop, like Vite's nested-dep syntax. */\nexport async function resolveIncludeEntry(\n  cwd: string,\n  entry: string,\n): Promise<string | null> {\n  const hops = entry\n    .split('>')\n    .map((s) => s.trim())\n    .filter(Boolean);\n  let fromDir = cwd;\n  for (let i = 0; i < hops.length; i++) {\n    const name = packageNameOf(hops[i]);\n    const installed = await readInstalledPkg(name, fromDir);\n    if (!installed) return null;\n    if (i === hops.length - 1) {\n      const subpath = hops[i] === name ? '.' : `.${hops[i].slice(name.length)}`;\n      return resolvePackageFile(installed.root, installed.json, subpath);\n    }\n    fromDir = installed.root;\n  }\n  return null;\n}\n\n/** The peer names whose ranges must admit the app's copy. */\nconst CHECKED_PEERS = ['react', 'react-dom'];\n\nexport async function diagnose({\n  cwd,\n  appInclude,\n  scan,\n}: DiagnoseInput): Promise<AppDoctorFinding[]> {\n  const findings: AppDoctorFinding[] = [];\n  const generated = new Map(scan.entries.map((e) => [e.entry, e]));\n\n  // 1. Include entries that do not resolve.\n  await Promise.all(\n    appInclude.map(async (entry) => {\n      if (await resolveIncludeEntry(cwd, entry)) return;\n      const nestedForm = scan.entries.find(\n        (e) => e.nested && (e.specifier === entry || e.depName === entry),\n      );\n      findings.push({\n        level: 'warn',\n        message:\n          `optimizeDeps.include entry '${entry}' does not resolve from ${cwd}` +\n          (nestedForm\n            ? ` — it is installed under ${nestedForm.from}; use '${nestedForm.entry}' (generated automatically, so the entry can simply be removed)`\n            : ' — remove it from vite.config, or install the package'),\n      });\n    }),\n  );\n\n  // 2. Dependencies of framework packages whose React peer range excludes the app's React.\n  const appVersions = new Map<string, string>();\n  for (const peer of CHECKED_PEERS) {\n    const installed = await readInstalledPkg(peer, cwd);\n    if (installed?.json?.version) appVersions.set(peer, installed.json.version);\n  }\n  const seen = new Set<string>();\n  for (const pkg of scan.frameworkPackages) {\n    for (const dep of Object.keys(pkg.json?.dependencies ?? {})) {\n      const installed = await readInstalledPkg(dep, pkg.root);\n      if (!installed || seen.has(`${pkg.name}\\0${dep}`)) continue;\n      const excluded = [...appVersions].filter(([peer, version]) => {\n        const range = installed.json.peerDependencies?.[peer];\n        return (\n          range && !semver.satisfies(version, range, {includePrerelease: true})\n        );\n      });\n      if (!excluded.length) continue;\n      seen.add(`${pkg.name}\\0${dep}`);\n      const [firstPeer, appVersion] = excluded[0];\n      const nested =\n        path\n          .relative(cwd, installed.root)\n          .split(path.sep)\n          .filter((s) => s === 'node_modules').length > 1;\n      findings.push({\n        level: 'warn',\n        message:\n          `${pkg.name} depends on ${dep}@${installed.json.version}, whose peer range ` +\n          excluded\n            .map(\n              ([peer]) => `${peer} '${installed.json.peerDependencies[peer]}'`,\n            )\n            .join(', ') +\n          ` excludes the app's ${excluded.map(([peer, v]) => `${peer} ${v}`).join(', ')}` +\n          (nested ? `, so npm installed it nested under ${pkg.name}` : '') +\n          `. Bump ${dep} in ${pkg.name} to a release that supports ${firstPeer} ${semver.major(appVersion)}.`,\n      });\n    }\n  }\n\n  // 3. Hand-written entries the scan generates anyway.\n  const redundant = appInclude.filter((e) => generated.has(e));\n  if (redundant.length) {\n    findings.push({\n      level: 'info',\n      message:\n        `${redundant.length} optimizeDeps.include entr${redundant.length === 1 ? 'y is' : 'ies are'} generated ` +\n        `automatically and can be removed from vite.config:\\n` +\n        redundant.map((e) => `    ${e}`).join('\\n'),\n    });\n  }\n  return findings;\n}\n\nexport interface AppDoctorOptions {\n  cwd?: string;\n}\n\n/** Load the app's dev config and return what the plugin scanned, running the scan itself if the plugin did not. */\nasync function loadAppScan(\n  cwd: string,\n): Promise<{appInclude: string[]; scan: ClientDepScan}> {\n  const {resolveConfig} = await import('vite');\n  lastClientDepScan.current = null;\n  const config = await resolveConfig(\n    {root: cwd, mode: 'development', logLevel: 'error'},\n    'serve',\n  );\n  const recorded = lastClientDepScan.current as\n    import('../client-dep-includes.js').RecordedClientDepScan | null;\n  if (recorded && path.resolve(recorded.cwd) === path.resolve(cwd)) {\n    return {appInclude: recorded.appInclude, scan: recorded.scan};\n  }\n  // The app does not use createViteConfig (or turned the generation off): scan\n  // what it excludes, with the workspaces the helper would have discovered.\n  const {discoverWorkspaces} = await import('../vite-config.js');\n  const optimizeDeps = config.optimizeDeps ?? {};\n  return {\n    appInclude: optimizeDeps.include ?? [],\n    scan: await scanLinkedClientDeps(optimizeDeps.exclude ?? [], {\n      cwd,\n      sourceWorkspaces: await discoverWorkspaces([], cwd),\n    }),\n  };\n}\n\n/** The config names `linked start` and `linked build-app` accept as \"this is an app\". */\nconst APP_VITE_CONFIGS = ['vite.config.ts', 'vite.config.js', 'vite.config.mjs'];\n\n/**\n * Why `cwd` is not an app, or null when it is. Without this, Vite resolves an\n * empty default config, the scan finds nothing, and the report says\n * \"0 warnings\" — a clean bill of health for a directory that was never checked.\n */\nexport function notAnAppReason(cwd: string): string | null {\n  if (APP_VITE_CONFIGS.some((f) => fs.existsSync(path.join(cwd, f)))) {\n    return null;\n  }\n  return (\n    `linked app-doctor: ${cwd} is not an app — no vite.config.{ts,js,mjs} found. ` +\n    'Run it from the root of an app (the directory with its vite.config); ' +\n    'it checks how the app uses linked packages, so there is nothing to check in a package.'\n  );\n}\n\nexport async function runAppDoctor(options: AppDoctorOptions = {}): Promise<void> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const notAnApp = notAnAppReason(cwd);\n  if (notAnApp) {\n    console.error(notAnApp);\n    process.exitCode = 1;\n    return;\n  }\n  const started = performance.now();\n  const {appInclude, scan} = await loadAppScan(cwd);\n  const findings = await diagnose({cwd, appInclude, scan});\n  for (const f of findings) {\n    (f.level === 'warn' ? console.warn : console.log)(\n      `${f.level === 'warn' ? 'warning' : 'note'}: ${f.message}`,\n    );\n  }\n  const warnings = findings.filter((f) => f.level === 'warn').length;\n  console.log(\n    `linked app-doctor: ${warnings} warning${warnings === 1 ? '' : 's'}; ` +\n      `${scan.entries.length} client dependencies of ${scan.frameworkPackages.length} linked packages ` +\n      `generated for optimizeDeps.include (${Math.round(performance.now() - started)}ms)`,\n  );\n  process.exitCode = warnings ? 1 : 0;\n}\n"]}

package/lib/esm/index.d.ts

@@ -3,7 +3,6 @@ export * from './utils.js';
 export { defineConfig } from './defineConfig.js';
 export type { LinkedConfig, LinkedServerConfig } from './interfaces.js';
 export { buildPackageByPath } from './commands/build-package.js';
-export { safeYarn } from './commands/safe-yarn.js';
 export { setupPublish } from './commands/setup-publish.js';
 export { resolveBuildTarget } from './app-release/resolve-build-target.js';
 export { buildReleasePrefix, createReleaseManifest, getCacheControl, releaseBaseURL, releaseObjectKey, releaseStaticAccessURL, resolveReleaseIdentity, resolveSourceRevision, serializeReleaseManifest, writeReleaseManifest, DEFAULT_RELEASE_PREFIX, ENTRY_CACHE_CONTROL, IMMUTABLE_CACHE_CONTROL, MANIFEST_SOURCE_PATH, VITE_OUTPUT_DIR, } from './app-release/create-release-manifest.js';

package/lib/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAE/D,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,WAAW,EACX,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,GAChB,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAE/D,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,WAAW,EACX,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,GAChB,MAAM,0CAA0C,CAAC"}

package/lib/esm/index.js

@@ -3,7 +3,6 @@ export { default as tailwindConfig } from './tailwind.config.js';
 export * from './utils.js';
 export { defineConfig } from './defineConfig.js';
 export { buildPackageByPath } from './commands/build-package.js';
-export { safeYarn } from './commands/safe-yarn.js';
 export { setupPublish } from './commands/setup-publish.js';
 export { resolveBuildTarget } from './app-release/resolve-build-target.js';
 export { buildReleasePrefix, createReleaseManifest, getCacheControl, releaseBaseURL, releaseObjectKey, releaseStaticAccessURL, resolveReleaseIdentity, resolveSourceRevision, serializeReleaseManifest, writeReleaseManifest, DEFAULT_RELEASE_PREFIX, ENTRY_CACHE_CONTROL, IMMUTABLE_CACHE_CONTROL, MANIFEST_SOURCE_PATH, VITE_OUTPUT_DIR, } from './app-release/create-release-manifest.js';

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAC/D,+CAA+C;AAC/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC","sourcesContent":["export {default as tailwindConfig} from './tailwind.config.js';\n// export {buildMetadata} from './metadata.js';\nexport * from './utils.js';\nexport {defineConfig} from './defineConfig.js';\nexport type {LinkedConfig, LinkedServerConfig} from './interfaces.js';\n\nexport {buildPackageByPath} from './commands/build-package.js';\nexport {safeYarn} from './commands/safe-yarn.js';\nexport {setupPublish} from './commands/setup-publish.js';\nexport {resolveBuildTarget} from './app-release/resolve-build-target.js';\nexport {\n  buildReleasePrefix,\n  createReleaseManifest,\n  getCacheControl,\n  releaseBaseURL,\n  releaseObjectKey,\n  releaseStaticAccessURL,\n  resolveReleaseIdentity,\n  resolveSourceRevision,\n  serializeReleaseManifest,\n  writeReleaseManifest,\n  DEFAULT_RELEASE_PREFIX,\n  ENTRY_CACHE_CONTROL,\n  IMMUTABLE_CACHE_CONTROL,\n  MANIFEST_SOURCE_PATH,\n  VITE_OUTPUT_DIR,\n} from './app-release/create-release-manifest.js';\nexport {resolveDeclaredStaticAssets} from './app-release/static-assets.js';\nexport {\n  loadReleaseManifest,\n  planReleasePublish,\n  publishRelease,\n} from './app-release/publisher.js';\nexport {\n  normalizeAccessURL,\n  resolveAppAssetsStore,\n} from './app-release/app-assets-store.js';\nexport {buildViteApp, hasViteConfig} from './commands/build-app.js';\nexport {publishApp} from './commands/publish-app.js';\nexport {\n  serveCompiledApp,\n  validateCompiledAppArtifacts,\n} from './commands/serve-app.js';\nexport {\n  joinObjectKey,\n  joinStaticAssetUrl,\n  normalizeReleasePath,\n  resolveExistingPathWithinRoot,\n} from './app-release/paths.js';\nexport type {\n  AppBuildTarget,\n  AppPublishConfig,\n  BuildAppOptions,\n  LinkedAppReleaseDestination,\n  LinkedAppReleaseFile,\n  LinkedAppReleaseManifest,\n  PublishPlan,\n  PublishResult,\n} from './app-release/types.js';\nexport type {\n  CreateReleaseManifestOptions,\n  ReleaseFileOrigin,\n  ReleaseIdentity,\n} from './app-release/create-release-manifest.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAC/D,+CAA+C;AAC/C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC","sourcesContent":["export {default as tailwindConfig} from './tailwind.config.js';\n// export {buildMetadata} from './metadata.js';\nexport * from './utils.js';\nexport {defineConfig} from './defineConfig.js';\nexport type {LinkedConfig, LinkedServerConfig} from './interfaces.js';\n\nexport {buildPackageByPath} from './commands/build-package.js';\nexport {setupPublish} from './commands/setup-publish.js';\nexport {resolveBuildTarget} from './app-release/resolve-build-target.js';\nexport {\n  buildReleasePrefix,\n  createReleaseManifest,\n  getCacheControl,\n  releaseBaseURL,\n  releaseObjectKey,\n  releaseStaticAccessURL,\n  resolveReleaseIdentity,\n  resolveSourceRevision,\n  serializeReleaseManifest,\n  writeReleaseManifest,\n  DEFAULT_RELEASE_PREFIX,\n  ENTRY_CACHE_CONTROL,\n  IMMUTABLE_CACHE_CONTROL,\n  MANIFEST_SOURCE_PATH,\n  VITE_OUTPUT_DIR,\n} from './app-release/create-release-manifest.js';\nexport {resolveDeclaredStaticAssets} from './app-release/static-assets.js';\nexport {\n  loadReleaseManifest,\n  planReleasePublish,\n  publishRelease,\n} from './app-release/publisher.js';\nexport {\n  normalizeAccessURL,\n  resolveAppAssetsStore,\n} from './app-release/app-assets-store.js';\nexport {buildViteApp, hasViteConfig} from './commands/build-app.js';\nexport {publishApp} from './commands/publish-app.js';\nexport {\n  serveCompiledApp,\n  validateCompiledAppArtifacts,\n} from './commands/serve-app.js';\nexport {\n  joinObjectKey,\n  joinStaticAssetUrl,\n  normalizeReleasePath,\n  resolveExistingPathWithinRoot,\n} from './app-release/paths.js';\nexport type {\n  AppBuildTarget,\n  AppPublishConfig,\n  BuildAppOptions,\n  LinkedAppReleaseDestination,\n  LinkedAppReleaseFile,\n  LinkedAppReleaseManifest,\n  PublishPlan,\n  PublishResult,\n} from './app-release/types.js';\nexport type {\n  CreateReleaseManifestOptions,\n  ReleaseFileOrigin,\n  ReleaseIdentity,\n} from './app-release/create-release-manifest.js';\n"]}

package/lib/esm/installed-packages.js

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 // Locating installed packages the way Node does, shared by the Vite config
-// helper and `linked doctor`.
+// helper and `linked app-doctor`.
 import fsExtra from 'fs-extra';
 import path from 'node:path';
 /**

package/lib/esm/installed-packages.js.map

@@ -1 +1 @@
-{"version":3,"file":"installed-packages.js","sourceRoot":"","sources":["../../src/installed-packages.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2EAA2E;AAC3E,8BAA8B;AAC9B,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE,CACtD,sBAAsB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAErD,6EAA6E;AAC7E,oEAAoE;AACpE,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,UAAgB,eAAe,CAAC,GAAW;;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3B,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CAAA;AAED,MAAM,UAAgB,gBAAgB,CACpC,IAAY,EACZ,OAAe;;QAEf,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAChD,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,OAAO,EAAC,IAAI,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAC,CAAC;gBACvD,CAAC;gBAAC,WAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;CAAA","sourcesContent":["// Locating installed packages the way Node does, shared by the Vite config\n// helper and `linked doctor`.\nimport fsExtra from 'fs-extra';\nimport path from 'node:path';\n\n/**\n * Framework packages that MUST be single-instance per runtime — they hold\n * module-level state (`@_linked/core`'s shape registry, `LinkedStorage`, the query\n * context) or register shapes into it. Two copies in one runtime split that state\n * and mangle shape identity (`Person`→`Person2`). This ONE list is the single source\n * of truth for the standalone `optimizeDeps.exclude` (`linkedDeps`). In workspace mode\n * `ssr.noExternal` is keyed on the discovered source workspaces instead (see\n * `ssrNoExternal`), so published framework packages stay external and single-instance\n * under Node.\n */\nexport const FRAMEWORK_PKG_PATTERNS: RegExp[] = [/^@_linked\\//, /^lincd-/];\nexport const isFrameworkPkg = (name: string): boolean =>\n  FRAMEWORK_PKG_PATTERNS.some((re) => re.test(name));\n\n// Resolve a dependency name to its installed package.json the way Node does:\n// look in `<dir>/node_modules/<name>`, then each parent directory's\n// node_modules, starting from the requiring package's directory. This finds\n// deps that npm/yarn workspaces HOISTED to the monorepo root (an app under\n// `services/api` whose dep lives in `<root>/node_modules`). The walk stops\n// after the nearest directory whose package.json declares `workspaces` (the\n// workspace root), or at the filesystem root. Returns null when the package\n// isn't installed (e.g. an optional dep) — we skip rather than throw.\nexport async function isWorkspaceRoot(dir: string): Promise<boolean> {\n  try {\n    const json = await fsExtra.readJson(path.join(dir, 'package.json'));\n    return !!json.workspaces;\n  } catch {\n    return false;\n  }\n}\n\nexport async function readInstalledPkg(\n  name: string,\n  fromDir: string,\n): Promise<{root: string; json: any} | null> {\n  let dir = path.resolve(fromDir);\n  while (true) {\n    const root = path.join(dir, 'node_modules', name);\n    const pkgJson = path.join(root, 'package.json');\n    if (await fsExtra.pathExists(pkgJson)) {\n      try {\n        return {root, json: await fsExtra.readJson(pkgJson)};\n      } catch {\n        return null;\n      }\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir || (await isWorkspaceRoot(dir))) return null;\n    dir = parent;\n  }\n}\n"]}
+{"version":3,"file":"installed-packages.js","sourceRoot":"","sources":["../../src/installed-packages.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2EAA2E;AAC3E,kCAAkC;AAClC,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAa,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE,CACtD,sBAAsB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAErD,6EAA6E;AAC7E,oEAAoE;AACpE,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,UAAgB,eAAe,CAAC,GAAW;;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3B,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CAAA;AAED,MAAM,UAAgB,gBAAgB,CACpC,IAAY,EACZ,OAAe;;QAEf,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAChD,IAAI,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,OAAO,EAAC,IAAI,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAC,CAAC;gBACvD,CAAC;gBAAC,WAAM,CAAC;oBACP,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;IACH,CAAC;CAAA","sourcesContent":["// Locating installed packages the way Node does, shared by the Vite config\n// helper and `linked app-doctor`.\nimport fsExtra from 'fs-extra';\nimport path from 'node:path';\n\n/**\n * Framework packages that MUST be single-instance per runtime — they hold\n * module-level state (`@_linked/core`'s shape registry, `LinkedStorage`, the query\n * context) or register shapes into it. Two copies in one runtime split that state\n * and mangle shape identity (`Person`→`Person2`). This ONE list is the single source\n * of truth for the standalone `optimizeDeps.exclude` (`linkedDeps`). In workspace mode\n * `ssr.noExternal` is keyed on the discovered source workspaces instead (see\n * `ssrNoExternal`), so published framework packages stay external and single-instance\n * under Node.\n */\nexport const FRAMEWORK_PKG_PATTERNS: RegExp[] = [/^@_linked\\//, /^lincd-/];\nexport const isFrameworkPkg = (name: string): boolean =>\n  FRAMEWORK_PKG_PATTERNS.some((re) => re.test(name));\n\n// Resolve a dependency name to its installed package.json the way Node does:\n// look in `<dir>/node_modules/<name>`, then each parent directory's\n// node_modules, starting from the requiring package's directory. This finds\n// deps that npm/yarn workspaces HOISTED to the monorepo root (an app under\n// `services/api` whose dep lives in `<root>/node_modules`). The walk stops\n// after the nearest directory whose package.json declares `workspaces` (the\n// workspace root), or at the filesystem root. Returns null when the package\n// isn't installed (e.g. an optional dep) — we skip rather than throw.\nexport async function isWorkspaceRoot(dir: string): Promise<boolean> {\n  try {\n    const json = await fsExtra.readJson(path.join(dir, 'package.json'));\n    return !!json.workspaces;\n  } catch {\n    return false;\n  }\n}\n\nexport async function readInstalledPkg(\n  name: string,\n  fromDir: string,\n): Promise<{root: string; json: any} | null> {\n  let dir = path.resolve(fromDir);\n  while (true) {\n    const root = path.join(dir, 'node_modules', name);\n    const pkgJson = path.join(root, 'package.json');\n    if (await fsExtra.pathExists(pkgJson)) {\n      try {\n        return {root, json: await fsExtra.readJson(pkgJson)};\n      } catch {\n        return null;\n      }\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir || (await isWorkspaceRoot(dir))) return null;\n    dir = parent;\n  }\n}\n"]}

package/lib/esm/plugins/colors.d.ts

@@ -0,0 +1,123 @@
+// Type definitions for Colors.js 0.6.0-1
+// Project: https://github.com/Marak/colors.js
+// Definitions by: Bart van der Schoor <https://github.com/Bartvds>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+declare module 'colors' {
+  interface Color {
+    black: Color;
+    red: Color;
+    green: Color;
+    yellow: Color;
+    blue: Color;
+    magenta: Color;
+    cyan: Color;
+    white: Color;
+    gray: Color;
+    grey: Color;
+    bgBlack: Color;
+    bgRed: Color;
+    bgGreen: Color;
+    bgYellow: Color;
+    bgBlue: Color;
+    bgMagenta: Color;
+    bgCyan: Color;
+    bgWhite: Color;
+    reset: Color;
+    bold: Color;
+    dim: Color;
+    italic: Color;
+    underline: Color;
+    inverse: Color;
+    hidden: Color;
+    strikethrough: Color;
+    rainbow: Color;
+    zebra: Color;
+    america: Color;
+    trap: Color;
+    random: Color;
+    zalgo: Color;
+
+    (text: string): string;
+  }
+
+  namespace e {
+    export function setTheme(theme: any): void;
+
+    export var black: Color;
+    export var red: Color;
+    export var green: Color;
+    export var yellow: Color;
+    export var blue: Color;
+    export var magenta: Color;
+    export var cyan: Color;
+    export var white: Color;
+    export var gray: Color;
+    export var grey: Color;
+
+    export var bgBlack: Color;
+    export var bgRed: Color;
+    export var bgGreen: Color;
+    export var bgYellow: Color;
+    export var bgBlue: Color;
+    export var bgMagenta: Color;
+    export var bgCyan: Color;
+    export var bgWhite: Color;
+
+    export var reset: Color;
+    export var bold: Color;
+    export var dim: Color;
+    export var italic: Color;
+    export var underline: Color;
+    export var inverse: Color;
+    export var hidden: Color;
+    export var strikethrough: Color;
+
+    export var rainbow: Color;
+    export var zebra: Color;
+    export var america: Color;
+    export var trap: Color;
+    export var random: Color;
+    export var zalgo: Color;
+  }
+
+  export = e;
+}
+
+interface String {
+  black: string;
+  red: string;
+  green: string;
+  yellow: string;
+  blue: string;
+  magenta: string;
+  cyan: string;
+  white: string;
+  gray: string;
+  grey: string;
+
+  bgBlack: string;
+  bgRed: string;
+  bgGreen: string;
+  bgYellow: string;
+  bgBlue: string;
+  bgMagenta: string;
+  bgCyan: string;
+  bgWhite: string;
+
+  reset: string;
+  // bold: string;
+  dim: string;
+  italic: string;
+  underline: string;
+  inverse: string;
+  hidden: string;
+  strikethrough: string;
+
+  rainbow: string;
+  zebra: string;
+  america: string;
+  trap: string;
+  random: string;
+  zalgo: string;
+}

package/lib/esm/vite-config.d.ts

@@ -99,7 +99,7 @@ export interface LinkedViteConfigOptions {
         deny?: (string | RegExp)[];
     };
 }
-interface WorkspaceEntry {
+export interface WorkspaceEntry {
     name: string;
     srcDir: string;
 }
@@ -163,6 +163,16 @@ export declare function discoverLinkedSourceDependencies(cwd?: string): Promise<
  * dependencies for.
  */
 export declare function discoverWorkspaces(extraGlobs?: string[], cwd?: string): Promise<WorkspaceEntry[]>;
+/**
+ * Resolve a bare specifier like `@_linked/foo/bar`, `lincd-rdfs/Foo`, or
+ * `pkg/utils/Bar.js` against the workspace lookup. Tries the file name first:
+ * .tsx, .ts, then the literal file (for files that already include an
+ * extension or for non-TS assets). When the name matches no file, falls back to
+ * the workspace's `exports` map (see `resolveViaWorkspaceExports`). Returns null
+ * when the specifier doesn't match any workspace package or no candidate exists
+ * on disk.
+ */
+export declare function resolveWorkspaceSpecifier(specifier: string, workspaces: WorkspaceEntry[]): Promise<string | null>;
 /**
  * Packages whose entry `linked start` hands to `vite.ssrLoadModule` by name
  * (`@_linked/server/shapes/LinkedServer`, see `commands/start.ts`).
@@ -199,5 +209,4 @@ export declare function ssrNoExternal(workspaces: {
  */
 export declare function clientDefine(opts?: Pick<LinkedViteConfigOptions, 'define' | 'port'>): Record<string, string>;
 export declare function createViteConfig(opts?: LinkedViteConfigOptions): ReturnType<typeof defineConfig>;
-export {};
 //# sourceMappingURL=vite-config.d.ts.map

package/lib/esm/vite-config.d.ts.map

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

package/lib/esm/vite-config.js

@@ -30,7 +30,7 @@ import { generateScopedNameProduction } from './css-module-names.js';
 import { parseWorkspacePatterns, isWorkspacePathNegated } from './workspace-globs.js';
 import { pinCompiledClassNames } from './plugins/pin-compiled-class-names.js';
 import { isFrameworkPkg, readInstalledPkg } from './installed-packages.js';
-import { linkedClientDepIncludesPlugin } from './client-dep-includes.js';
+import { linkedClientDepIncludesPlugin, resolveExportsSubpath, } from './client-dep-includes.js';
 /** Default dev server port, and Vite's default HMR websocket port. */
 const DEFAULT_DEV_PORT = 4040;
 const DEFAULT_HMR_PORT = 24678;
@@ -443,14 +443,68 @@ export function discoverWorkspaces() {
         return out;
     });
 }
+const isFile = (p) => __awaiter(void 0, void 0, void 0, function* () {
+    return fsExtra
+        .stat(p)
+        .then((st) => st.isFile())
+        .catch(() => false);
+});
+/**
+ * Map a `lib/esm` file back to its source under `srcDir`: `.js`/`.jsx` probe
+ * `.tsx` then `.ts`, anything else (css, json, ...) is taken literally.
+ */
+function libTargetToSource(srcDir, rel) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (/\.jsx?$/.test(rel)) {
+            const base = path.join(srcDir, rel.replace(/\.jsx?$/, ''));
+            for (const ext of ['.tsx', '.ts']) {
+                if (yield isFile(base + ext))
+                    return base + ext;
+            }
+            return null;
+        }
+        const literal = path.join(srcDir, rel);
+        return (yield isFile(literal)) ? literal : null;
+    });
+}
+/**
+ * The name-based lookup's fallback: resolve `subpath` (`.` or `./x/y`) through
+ * the workspace's own `exports` under `import`/`default`, and map a
+ * `./lib/esm/...` target to the same path under src. This is what reaches
+ * source for a subpath whose export key does not match a file name
+ * (`@_linked/translation/key-sync/node` -> `lib/esm/key-sync-node.js` ->
+ * `src/key-sync-node.ts`), a directory subpath (`./conformance` ->
+ * `lib/esm/conformance/index.js`), or a bare name whose src has no index.
+ * Without it such a specifier falls through to Vite, which picks the package's
+ * `lib/esm` copy while the rest of the package comes from src: two instances of
+ * every module-level registry. It must not depend on a `development` -> src
+ * condition, because src/ is not published and packages do not declare one.
+ */
+function resolveViaWorkspaceExports(ws, subpath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let json;
+        try {
+            json = yield fsExtra.readJson(path.join(path.dirname(ws.srcDir), 'package.json'));
+        }
+        catch (_a) {
+            return null;
+        }
+        const target = resolveExportsSubpath(json, subpath, ['import', 'default']);
+        if (!target || !target.startsWith('./lib/esm/'))
+            return null;
+        return libTargetToSource(ws.srcDir, target.slice('./lib/esm/'.length));
+    });
+}
 /**
  * Resolve a bare specifier like `@_linked/foo/bar`, `lincd-rdfs/Foo`, or
- * `pkg/utils/Bar.js` against the workspace lookup. Tries extensions in
- * order: .ts, .tsx, then the literal id (for files that already include
- * an extension or for non-TS assets). Returns null when the specifier
- * doesn't match any workspace package or no candidate exists on disk.
+ * `pkg/utils/Bar.js` against the workspace lookup. Tries the file name first:
+ * .tsx, .ts, then the literal file (for files that already include an
+ * extension or for non-TS assets). When the name matches no file, falls back to
+ * the workspace's `exports` map (see `resolveViaWorkspaceExports`). Returns null
+ * when the specifier doesn't match any workspace package or no candidate exists
+ * on disk.
  */
-function resolveWorkspaceSpecifier(specifier, workspaces) {
+export function resolveWorkspaceSpecifier(specifier, workspaces) {
     return __awaiter(this, void 0, void 0, function* () {
         for (const ws of workspaces) {
             if (specifier === ws.name) {
@@ -459,7 +513,7 @@ function resolveWorkspaceSpecifier(specifier, workspaces) {
                     if (yield fsExtra.pathExists(p))
                         return p;
                 }
-                return null;
+                return resolveViaWorkspaceExports(ws, '.');
             }
             if (specifier.startsWith(ws.name + '/')) {
                 const subpath = specifier.slice(ws.name.length + 1);
@@ -472,11 +526,12 @@ function resolveWorkspaceSpecifier(specifier, workspaces) {
                         return p;
                 }
                 // Files that already include an extension Vite handles (.css, .json,
-                // .svg, etc.) — return the literal path under src.
+                // .svg, etc.) — return the literal path under src. A FILE only: a
+                // directory of the same name is a directory subpath, left to `exports`.
                 const literal = path.join(ws.srcDir, subpath);
-                if (yield fsExtra.pathExists(literal))
+                if (yield isFile(literal))
                     return literal;
-                return null;
+                return resolveViaWorkspaceExports(ws, './' + subpath);
             }
         }
         return null;