@solid-stack/mason 1.0.16 → 1.0.18

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,sBAiMxB;AAWD,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,sBAqMxB;AAWD,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}

package/dist/commands/import.d.ts

@@ -5,7 +5,9 @@ export interface ImportFlags {
     yes?: boolean;
     registry?: string;
     skipInstall?: boolean;
-    alias?: Record<string, string>;
+    alias?: Record<string, string> | string | string[];
+    pointTo?: Record<string, string> | string | string[];
+    useExisting?: Record<string, string> | string | string[];
     [key: string]: any;
 }
 export declare const importPrompts: {
@@ -22,12 +24,20 @@ export declare function rewriteImports(content: string, aliasMap: Map<string, st
  */
 export declare function getModuleBaseDir(projectRoot: string, modType: "shared" | "feature"): string;
 /**
- * Resolves the existing directory path for a module in the project, checking both src/<folder>/<name> and <folder>/<name>.
+ * Resolves the existing directory path for a module in the project, checking configured dirs, src/<folder>/<name>, and <folder>/<name>.
  */
 export declare function getExistingModuleDir(projectRoot: string, modType: "shared" | "feature", modName: string): string | null;
 /**
  * Check whether a module already exists in the project (checking both src/<folder>/<name> and <folder>/<name>)
  */
 export declare function checkModuleExists(projectRoot: string, modType: "shared" | "feature", modName: string): boolean;
+/**
+ * List all available local module names for a given type (checking configured dir, src/<folder>, and <folder>)
+ */
+export declare function getAvailableLocalModules(projectRoot: string, modType: "shared" | "feature"): string[];
+/**
+ * Helper to parse mapping flags like { time: "mytime" } or "time:mytime" or ["time:mytime"]
+ */
+export declare function parseMappingFlags(raw: any): Record<string, string>;
 export declare function handleImport(typeArg?: string, nameArg?: string, flags?: ImportFlags): Promise<void>;
 //# sourceMappingURL=import.d.ts.map

package/dist/commands/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAiBpC,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,eAAO,MAAM,aAAa;IACxB,MAAM;IACN,IAAI;CACL,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAerF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAG3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAOf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAET;AAgBD,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAgbf"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAkBpC,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,eAAO,MAAM,aAAa;IACxB,MAAM;IACN,IAAI;CACL,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAerF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAS3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAYf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,SAAS,GAC5B,MAAM,EAAE,CAwBV;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBlE;AAgBD,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA0iBf"}

package/dist/index.cjs

@@ -176,7 +176,7 @@ function getEffectiveMode(projectRoot, flags) {
   if (flags?.registry) return "registry";
   const config = loadMasonConfig(projectRoot);
   if (config?.mode) return config.mode;
-  if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "index.json")) && (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "features")) || fs4__default.default.existsSync(path2__default.default.join(projectRoot, "shared"))) && !fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src"))) {
+  if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "index.json")) && (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "features")) || fs4__default.default.existsSync(path2__default.default.join(projectRoot, "shared")) || fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/features")) || fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/shared")))) {
     return "registry";
   }
   return "app";
@@ -190,6 +190,9 @@ function getConfiguredFeaturesDir(projectRoot, flags) {
   }
   const mode = getEffectiveMode(projectRoot, flags);
   if (mode === "registry") {
+    if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/features"))) {
+      return path2__default.default.join(projectRoot, "src/features");
+    }
     return path2__default.default.join(projectRoot, "features");
   }
   if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/features"))) {
@@ -206,6 +209,9 @@ function getConfiguredSharedDir(projectRoot, flags) {
   }
   const mode = getEffectiveMode(projectRoot, flags);
   if (mode === "registry") {
+    if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/shared"))) {
+      return path2__default.default.join(projectRoot, "src/shared");
+    }
     return path2__default.default.join(projectRoot, "shared");
   }
   if (fs4__default.default.existsSync(path2__default.default.join(projectRoot, "src/shared"))) {
@@ -512,7 +518,14 @@ async function fetchRegistryFile(registryBase, relPath) {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const res = await fetch(url, { headers });
+    let res = await fetch(url, { headers });
+    if (!res.ok && res.status === 404 && !cleanRelPath.startsWith("src/")) {
+      const srcUrl = `${registryBase.replace(/\/+$/, "")}/src/${cleanRelPath}`;
+      const srcRes = await fetch(srcUrl, { headers });
+      if (srcRes.ok) {
+        res = srcRes;
+      }
+    }
     if (!res.ok) {
       let extraHint = "";
       if (res.status === 404) {
@@ -532,9 +545,14 @@ async function fetchRegistryFile(registryBase, relPath) {
   if (baseDir.startsWith("file://")) {
     baseDir = url.fileURLToPath(baseDir);
   }
-  const filePath = path2__default.default.resolve(baseDir, cleanRelPath);
+  let filePath = path2__default.default.resolve(baseDir, cleanRelPath);
   if (!fs4__default.default.existsSync(filePath)) {
-    throw new Error(`Registry file not found at ${filePath}`);
+    const inSrcPath = path2__default.default.resolve(baseDir, "src", cleanRelPath);
+    if (fs4__default.default.existsSync(inSrcPath)) {
+      filePath = inSrcPath;
+    } else {
+      throw new Error(`Registry file not found at ${filePath}`);
+    }
   }
   return fs4__default.default.promises.readFile(filePath, "utf-8");
 }
@@ -3629,11 +3647,18 @@ function rewriteImports(content, aliasMap) {
   return rewritten;
 }
 function getModuleBaseDir(projectRoot, modType) {
+  const mode = getEffectiveMode(projectRoot);
+  if (mode === "registry") {
+    return modType === "shared" ? getConfiguredSharedDir(projectRoot) : getConfiguredFeaturesDir(projectRoot);
+  }
   const folder = modType === "shared" ? "shared" : "features";
   return path2__default.default.join(projectRoot, "src", folder);
 }
 function getExistingModuleDir(projectRoot, modType, modName) {
   const folder = modType === "shared" ? "shared" : "features";
+  const configuredDir = modType === "shared" ? getConfiguredSharedDir(projectRoot) : getConfiguredFeaturesDir(projectRoot);
+  const inConfigured = path2__default.default.join(configuredDir, modName);
+  if (fs4__default.default.existsSync(inConfigured)) return inConfigured;
   const inSrc = path2__default.default.join(projectRoot, "src", folder, modName);
   if (fs4__default.default.existsSync(inSrc)) return inSrc;
   const inRoot = path2__default.default.join(projectRoot, folder, modName);
@@ -3643,6 +3668,50 @@ function getExistingModuleDir(projectRoot, modType, modName) {
 function checkModuleExists(projectRoot, modType, modName) {
   return getExistingModuleDir(projectRoot, modType, modName) !== null;
 }
+function getAvailableLocalModules(projectRoot, modType) {
+  const folder = modType === "shared" ? "shared" : "features";
+  const configuredDir = modType === "shared" ? getConfiguredSharedDir(projectRoot) : getConfiguredFeaturesDir(projectRoot);
+  const dirs = [
+    configuredDir,
+    path2__default.default.join(projectRoot, "src", folder),
+    path2__default.default.join(projectRoot, folder)
+  ];
+  const set = /* @__PURE__ */ new Set();
+  for (const dir of dirs) {
+    if (fs4__default.default.existsSync(dir)) {
+      try {
+        const entries = fs4__default.default.readdirSync(dir, { withFileTypes: true });
+        for (const e of entries) {
+          if (e.isDirectory() && !e.name.startsWith(".")) {
+            set.add(e.name);
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  return Array.from(set).sort();
+}
+function parseMappingFlags(raw) {
+  if (!raw) return {};
+  if (typeof raw === "object" && !Array.isArray(raw)) return raw;
+  const result = {};
+  const entries = Array.isArray(raw) ? raw : [raw];
+  for (const entry of entries) {
+    if (typeof entry === "string") {
+      const idx = entry.indexOf(":");
+      if (idx !== -1) {
+        let key = entry.slice(0, idx).trim();
+        let val = entry.slice(idx + 1).trim();
+        val = val.replace(/^@\/(shared|features)\//, "").replace(/^(src\/)?(shared|features)\//, "").replace(/^\/+|\/+$/g, "").trim();
+        if (key && val) {
+          result[key] = val;
+        }
+      }
+    }
+  }
+  return result;
+}
 async function handleImport(typeArg, nameArg, flags = {}) {
   const projectRoot = findProjectRoot();
   let type = typeArg?.trim().toLowerCase();
@@ -3763,7 +3832,8 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     const { type: modType, name: registryName, manifest } = node;
     const folder = modType === "shared" ? "shared" : "features";
     if (key === rootKey) {
-      const programmaticAlias2 = flags.alias?.[registryName] || flags.alias?.[`${modType}/${registryName}`];
+      const aliasMap2 = parseMappingFlags(flags.alias);
+      const programmaticAlias2 = aliasMap2[registryName] || aliasMap2[`${modType}/${registryName}`];
       const targetName = programmaticAlias2 || registryName;
       if (targetName !== registryName) {
         globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${targetName}/`);
@@ -3778,7 +3848,36 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       });
       continue;
     }
-    const programmaticAlias = flags.alias?.[registryName] || flags.alias?.[`${modType}/${registryName}`];
+    const aliasMap = parseMappingFlags(flags.alias);
+    const pointToMap = {
+      ...parseMappingFlags(flags.pointTo),
+      ...parseMappingFlags(flags["point-to"]),
+      ...parseMappingFlags(flags.useExisting),
+      ...parseMappingFlags(flags["use-existing"])
+    };
+    const programmaticPointTo = pointToMap[registryName] || pointToMap[`${modType}/${registryName}`];
+    if (programmaticPointTo) {
+      if (!checkModuleExists(projectRoot, modType, programmaticPointTo)) {
+        p14__namespace.log.error(
+          pc14__default.default.red(
+            `Module '${programmaticPointTo}' specified in --point-to does not exist in ${folder}.`
+          )
+        );
+        process.exit(1);
+      }
+      globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${programmaticPointTo}/`);
+      globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${programmaticPointTo}`);
+      p14__namespace.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${programmaticPointTo}'`);
+      resolutions.set(key, {
+        type: modType,
+        registryName,
+        targetName: programmaticPointTo,
+        action: "reuse",
+        manifest
+      });
+      continue;
+    }
+    const programmaticAlias = aliasMap[registryName] || aliasMap[`${modType}/${registryName}`];
     if (programmaticAlias) {
       globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${programmaticAlias}/`);
       globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${programmaticAlias}`);
@@ -3852,6 +3951,10 @@ async function handleImport(typeArg, nameArg, flags = {}) {
             value: "keep_existing",
             label: `Keep existing local version (Recommended)`
           },
+          {
+            value: "point_existing",
+            label: `Point to another existing ${modType} module`
+          },
           {
             value: "rename",
             label: "Import fresh copy under a new name (alias)"
@@ -3874,6 +3977,78 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       });
       continue;
     }
+    if (choice === "point_existing" || choice === "point_to_existing") {
+      const candidates = getAvailableLocalModules(projectRoot, modType).filter(
+        (m) => m !== registryName
+      );
+      let chosenName;
+      if (candidates.length > 0) {
+        const selection = handleCancel(
+          await importPrompts.select({
+            message: `Select an existing ${modType} module to point to:`,
+            options: [
+              ...candidates.map((m) => ({
+                value: m,
+                label: m
+              })),
+              {
+                value: "__custom__",
+                label: "Enter name manually..."
+              }
+            ]
+          })
+        );
+        if (selection === "__custom__") {
+          chosenName = handleCancel(
+            await importPrompts.text({
+              message: `Enter the name of the existing ${modType} module:`,
+              placeholder: `my${registryName}`,
+              validate(val) {
+                const v = val?.trim();
+                if (!v) return "Name cannot be empty";
+                if (v === registryName) {
+                  return `Name must be different from '${registryName}' (or select 'Keep existing local version')`;
+                }
+                if (!checkModuleExists(projectRoot, modType, v)) {
+                  return `'${v}' does not exist in ${folder}`;
+                }
+              }
+            })
+          ).trim();
+        } else {
+          chosenName = selection;
+        }
+      } else {
+        chosenName = handleCancel(
+          await importPrompts.text({
+            message: `Enter the name of the existing ${modType} module:`,
+            placeholder: `my${registryName}`,
+            validate(val) {
+              const v = val?.trim();
+              if (!v) return "Name cannot be empty";
+              if (v === registryName) {
+                return `Name must be different from '${registryName}' (or select 'Keep existing local version')`;
+              }
+              if (!checkModuleExists(projectRoot, modType, v)) {
+                return `'${v}' does not exist in ${folder}`;
+              }
+            }
+          })
+        ).trim();
+      }
+      chosenName = chosenName.replace(/^@\/(shared|features)\//, "").replace(/^(src\/)?(shared|features)\//, "").replace(/^\/+|\/+$/g, "").trim();
+      globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${chosenName}/`);
+      globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${chosenName}`);
+      p14__namespace.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${chosenName}'`);
+      resolutions.set(key, {
+        type: modType,
+        registryName,
+        targetName: chosenName,
+        action: "reuse",
+        manifest
+      });
+      continue;
+    }
     if (choice === "rename") {
       const newName = handleCancel(
         await importPrompts.text({
@@ -4001,7 +4176,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
 // src/cli.ts
 function createCli() {
   const cli = cac.cac("mason");
-  cli.command("[...args]", "Interactive scaffolding and import wizard").option("-d, --dry-run", "Preview changes without writing to disk").option("-o, --overwrite", "Overwrite existing files").option("-y, --yes", "Accept defaults and skip interactive prompts").option("--registry", "Run in registry mode").action(async (args, flags) => {
+  cli.command("[...args]", "Interactive scaffolding and import wizard").option("-d, --dry-run", "Preview changes without writing to disk").option("-o, --overwrite", "Overwrite existing files").option("-y, --yes", "Accept defaults and skip interactive prompts").option("--registry", "Run in registry mode").option("--point-to <mapping>", "Point a dependency to an existing local module (e.g. --point-to time:mytime)").option("--alias <mapping>", "Import a dependency fresh under an alias name (e.g. --alias time:time-mason)").action(async (args, flags) => {
     if (args && args.length > 0) {
       p14__namespace.log.error(
         pc14__default.default.red(
@@ -4096,7 +4271,7 @@ function createCli() {
   cli.command(
     "import [type] [name]",
     "Import pre-built shared modules or features from the Solid Stack Registry"
-  ).option("-o, --overwrite", "Overwrite existing files").option("-d, --dry-run", "Preview changes without writing to disk").option("-y, --yes", "Accept defaults and skip interactive prompts").option("--registry <url>", "Registry base URL or local directory").option("--skip-install", "Skip automatic package manager dependency installation").example("mason import shared hasher").example("mason import feature authn").example("mason import shared").example("mason import feature").action(async (type, name, flags = {}) => {
+  ).option("-o, --overwrite", "Overwrite existing files").option("-d, --dry-run", "Preview changes without writing to disk").option("-y, --yes", "Accept defaults and skip interactive prompts").option("--registry <url>", "Registry base URL or local directory").option("--skip-install", "Skip automatic package manager dependency installation").option("--point-to <mapping>", "Point a dependency to an existing local module (e.g. --point-to time:mytime)").option("--alias <mapping>", "Import a dependency fresh under an alias name (e.g. --alias time:time-mason)").example("mason import shared hasher").example("mason import feature authn").example("mason import shared").example("mason import feature").action(async (type, name, flags = {}) => {
     try {
       await handleImport(type, name, flags);
     } catch (err) {
@@ -4126,7 +4301,7 @@ function createCli() {
     });
   }
   cli.help();
-  cli.version("1.0.16");
+  cli.version("1.0.18");
   return cli;
 }
 function handleCliError(err) {