apotheke 0.0.1 → 0.1.1

package/dist/index.js

@@ -1,64 +1,74 @@
 // index.ts
-import path3 from "path";
 import { existsSync as existsSync2 } from "fs";
+import { createRequire } from "module";
+import path3 from "path";
 
-// src/parser.ts
-import { parseSync } from "oxc-parser";
-function parseImports(source) {
-  const result = parseSync("file.tsx", source);
-  const comments = result.comments;
-  const nodes = [];
-  for (const node of result.program.body) {
-    if (node.type !== "ImportDeclaration") continue;
-    const specifier = node.source.value;
-    let defaultImport;
-    const namedImports = [];
-    let namespaceImport;
-    for (const s of node.specifiers) {
-      if (s.type === "ImportDefaultSpecifier") {
-        defaultImport = s.local.name;
-      } else if (s.type === "ImportNamespaceSpecifier") {
-        namespaceImport = s.local.name;
-      } else if (s.type === "ImportSpecifier") {
-        const imported = s.imported;
-        const name = imported.type === "Identifier" ? imported.name : imported.value;
-        const localName = s.local.name;
-        const kind = s.importKind === "type" ? "type" : "value";
-        const named = { name, kind };
-        if (localName !== name) named.alias = localName;
-        namedImports.push(named);
-      }
+// src/config.ts
+import { existsSync, readFileSync } from "fs";
+import path from "path";
+function mergeConfigs(parent, child) {
+  const mergedGroups = [...parent.groups];
+  for (const childGroup of child.groups ?? []) {
+    const existingIdx = mergedGroups.findIndex((g) => g.name === childGroup.name);
+    if (existingIdx >= 0) {
+      mergedGroups[existingIdx] = childGroup;
+    } else {
+      mergedGroups.push(childGroup);
     }
-    const importKind = node.importKind === "type" ? "type" : "value";
-    const isSideEffect = node.specifiers.length === 0 && importKind === "value";
-    const importNode = {
-      specifier,
-      namedImports,
-      isSideEffect,
-      importKind,
-      start: node.start,
-      end: node.end
-    };
-    if (defaultImport) importNode.defaultImport = defaultImport;
-    if (namespaceImport) importNode.namespaceImport = namespaceImport;
-    const attached = findAttachedComment(source, node.start, comments);
-    if (attached) importNode.attachedComment = attached;
-    nodes.push(importNode);
   }
-  return nodes;
+  return {
+    ...parent,
+    ...child,
+    groups: mergedGroups,
+    aliases: { ...parent.aliases ?? {}, ...child.aliases ?? {} }
+  };
 }
-function findAttachedComment(source, importStart, comments) {
-  const linesBefore = source.slice(0, importStart).split("\n");
-  const importLine = linesBefore.length - 1;
-  for (const comment of comments) {
-    if (comment.type !== "Line") continue;
-    const commentLines = source.slice(0, comment.end).split("\n");
-    const commentLine = commentLines.length - 1;
-    if (commentLine === importLine - 1) {
-      return `//${comment.value}`;
+async function loadConfig(configPath) {
+  const mod = await import(configPath);
+  const userConfig = mod.default ?? mod;
+  const configDir = path.dirname(configPath);
+  const config = { ...userConfig };
+  const tsconfig = loadTsConfig(configDir);
+  if (tsconfig) {
+    const opts = tsconfig.compilerOptions ?? {};
+    if (opts.baseUrl && !config.baseUrl) {
+      config.baseUrl = opts.baseUrl;
+    }
+    if (opts.paths) {
+      const aliases = { ...config.aliases ?? {} };
+      for (const [aliasPattern, targets] of Object.entries(
+        opts.paths
+      )) {
+        const alias = aliasPattern.replace(/\/\*$/, "");
+        const target = (targets[0] ?? "").replace(/\/\*$/, "");
+        if (!aliases[alias]) aliases[alias] = target;
+      }
+      config.aliases = aliases;
     }
   }
-  return void 0;
+  if (userConfig.extends) {
+    const parentPath = path.resolve(configDir, userConfig.extends);
+    if (!existsSync(parentPath)) {
+      throw new Error(
+        `apotheke: extended config not found: ${parentPath}
+  (referenced from ${configPath} via "extends": "${userConfig.extends}")`
+      );
+    }
+    const parent = await loadConfig(parentPath);
+    return mergeConfigs(parent, config);
+  }
+  return config;
+}
+function loadTsConfig(dir) {
+  const tsconfigPath = path.join(dir, "tsconfig.json");
+  if (!existsSync(tsconfigPath)) return null;
+  try {
+    const text = readFileSync(tsconfigPath, "utf8");
+    const cleaned = text.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    return JSON.parse(cleaned);
+  } catch {
+    return null;
+  }
 }
 
 // src/deduplicator.ts
@@ -88,7 +98,9 @@ function deduplicateImports(imports) {
 }
 
 // src/grouper.ts
-import path from "path";
+import path2 from "path";
+var SIDE_EFFECTS_GROUP = "SideEffects";
+var OTHERS_GROUP = "Others";
 function groupImports(imports, config, options = {}) {
   const buckets = /* @__PURE__ */ new Map();
   for (const node of imports) {
@@ -97,21 +109,21 @@ function groupImports(imports, config, options = {}) {
     buckets.get(groupName).push(node);
   }
   const result = [];
-  if (buckets.has("SideEffects")) {
-    result.push({ name: "SideEffects", imports: buckets.get("SideEffects") });
+  if (buckets.has(SIDE_EFFECTS_GROUP)) {
+    result.push({ name: SIDE_EFFECTS_GROUP, imports: buckets.get(SIDE_EFFECTS_GROUP) });
   }
   for (const group of config.groups) {
     if (buckets.has(group.name)) {
       result.push({ name: group.name, imports: buckets.get(group.name) });
     }
   }
-  if (buckets.has("Others")) {
-    result.push({ name: "Others", imports: buckets.get("Others") });
+  if (buckets.has(OTHERS_GROUP)) {
+    result.push({ name: OTHERS_GROUP, imports: buckets.get(OTHERS_GROUP) });
   }
   return result;
 }
 function assignGroup(node, config, options) {
-  if (node.isSideEffect) return "SideEffects";
+  if (node.isSideEffect) return SIDE_EFFECTS_GROUP;
   const canonicalPath = resolveCanonicalPath(node.specifier, config, options);
   for (const group of config.groups) {
     for (const pattern of group.match) {
@@ -119,12 +131,12 @@ function assignGroup(node, config, options) {
       if (canonicalPath && matches(canonicalPath, pattern)) return group.name;
     }
   }
-  return "Others";
+  return OTHERS_GROUP;
 }
 function resolveCanonicalPath(specifier, config, options) {
   if (specifier.startsWith(".") || specifier.startsWith("/")) {
     const base = options.fileDir ?? process.cwd();
-    return path.resolve(base, specifier);
+    return path2.resolve(base, specifier);
   }
   const aliases = config.aliases ?? {};
   for (const [alias, target] of Object.entries(aliases)) {
@@ -132,7 +144,7 @@ function resolveCanonicalPath(specifier, config, options) {
     if (specifier === alias || specifier.startsWith(prefix)) {
       const rest = specifier.slice(prefix.length);
       const root = options.rootDir ?? process.cwd();
-      const resolved = path.resolve(root, target, rest);
+      const resolved = path2.resolve(root, target, rest);
       return resolved;
     }
   }
@@ -169,21 +181,63 @@ function globToRegex(pattern) {
   return new RegExp(re + "$");
 }
 
-// src/sorter.ts
-function sortGroup(imports) {
-  return [...imports].sort((a, b) => {
-    if (a.importKind === "type" && b.importKind !== "type") return -1;
-    if (a.importKind !== "type" && b.importKind === "type") return 1;
-    return a.specifier.localeCompare(b.specifier);
-  });
+// src/parser.ts
+import { parseSync } from "oxc-parser";
+function parseImports(source) {
+  const result = parseSync("file.tsx", source);
+  const comments = result.comments;
+  const nodes = [];
+  for (const node of result.program.body) {
+    if (node.type !== "ImportDeclaration") continue;
+    const specifier = node.source.value;
+    let defaultImport;
+    const namedImports = [];
+    let namespaceImport;
+    for (const s of node.specifiers) {
+      if (s.type === "ImportDefaultSpecifier") {
+        defaultImport = s.local.name;
+      } else if (s.type === "ImportNamespaceSpecifier") {
+        namespaceImport = s.local.name;
+      } else if (s.type === "ImportSpecifier") {
+        const imported = s.imported;
+        const name = imported.type === "Identifier" ? imported.name : imported.value;
+        const localName = s.local.name;
+        const kind = s.importKind === "type" ? "type" : "value";
+        const named = { name, kind };
+        if (localName !== name) named.alias = localName;
+        namedImports.push(named);
+      }
+    }
+    const importKind = node.importKind === "type" ? "type" : "value";
+    const isSideEffect = node.specifiers.length === 0 && importKind === "value";
+    const importNode = {
+      specifier,
+      namedImports,
+      isSideEffect,
+      importKind,
+      start: node.start,
+      end: node.end
+    };
+    if (defaultImport) importNode.defaultImport = defaultImport;
+    if (namespaceImport) importNode.namespaceImport = namespaceImport;
+    const attached = findAttachedComment(source, node.start, comments);
+    if (attached) importNode.attachedComment = attached;
+    nodes.push(importNode);
+  }
+  return nodes;
 }
-function sortNamedImports(node) {
-  const sorted = [...node.namedImports].sort((a, b) => {
-    if (a.kind === "type" && b.kind !== "type") return -1;
-    if (a.kind !== "type" && b.kind === "type") return 1;
-    return a.name.localeCompare(b.name);
-  });
-  return { ...node, namedImports: sorted };
+function findAttachedComment(source, importStart, comments) {
+  const linesBefore = source.slice(0, importStart).split("\n");
+  const importLine = linesBefore.length - 1;
+  for (const comment of comments) {
+    if (comment.type !== "Line") continue;
+    const commentLines = source.slice(0, comment.end).split("\n");
+    const commentLine = commentLines.length - 1;
+    if (commentLine === importLine - 1) {
+      return `//${comment.value}`;
+    }
+  }
+  return void 0;
 }
 
 // src/printer.ts
@@ -235,6 +289,23 @@ function buildImportStatement(node, q) {
   return `import ${typePrefix}${parts.join(", ")} from ${q}${node.specifier}${q};`;
 }
 
+// src/sorter.ts
+function sortGroup(imports) {
+  return [...imports].sort((a, b) => {
+    if (a.importKind === "type" && b.importKind !== "type") return -1;
+    if (a.importKind !== "type" && b.importKind === "type") return 1;
+    return a.specifier.localeCompare(b.specifier);
+  });
+}
+function sortNamedImports(node) {
+  const sorted = [...node.namedImports].sort((a, b) => {
+    if (a.kind === "type" && b.kind !== "type") return -1;
+    if (a.kind !== "type" && b.kind === "type") return 1;
+    return a.name.localeCompare(b.name);
+  });
+  return { ...node, namedImports: sorted };
+}
+
 // src/format.ts
 function collectOrphanSegments(source, imports) {
   const orphans = [];
@@ -263,7 +334,9 @@ function formatImports(source, config, options = {}) {
   const deduped = deduplicateImports(clean);
   const sorted = deduped.map(sortNamedImports);
   const grouped = groupImports(sorted, config, options);
-  const sortedGroups = grouped.map((g) => ({ ...g, imports: sortGroup(g.imports) }));
+  const sortedGroups = grouped.map(
+    (g) => g.name === SIDE_EFFECTS_GROUP ? g : { ...g, imports: sortGroup(g.imports) }
+  );
   const q = detectQuoteChar(source);
   const newImportBlock = printGroups(sortedGroups, config, q);
   const firstImport = imports[0];
@@ -282,76 +355,7 @@ function formatImports(source, config, options = {}) {
   return before + newImportBlock + "\n" + orphanSuffix + after;
 }
 
-// src/config.ts
-import path2 from "path";
-import { existsSync, readFileSync } from "fs";
-function mergeConfigs(parent, child) {
-  const mergedGroups = [...parent.groups];
-  for (const childGroup of child.groups ?? []) {
-    const existingIdx = mergedGroups.findIndex((g) => g.name === childGroup.name);
-    if (existingIdx >= 0) {
-      mergedGroups[existingIdx] = childGroup;
-    } else {
-      mergedGroups.push(childGroup);
-    }
-  }
-  return {
-    ...parent,
-    ...child,
-    groups: mergedGroups,
-    aliases: { ...parent.aliases ?? {}, ...child.aliases ?? {} }
-  };
-}
-async function loadConfig(configPath) {
-  const mod = await import(configPath);
-  const userConfig = mod.default ?? mod;
-  const configDir = path2.dirname(configPath);
-  const config = { ...userConfig };
-  const tsconfig = loadTsConfig(configDir);
-  if (tsconfig) {
-    const opts = tsconfig.compilerOptions ?? {};
-    if (opts.baseUrl && !config.baseUrl) {
-      config.baseUrl = opts.baseUrl;
-    }
-    if (opts.paths) {
-      const aliases = { ...config.aliases ?? {} };
-      for (const [aliasPattern, targets] of Object.entries(
-        opts.paths
-      )) {
-        const alias = aliasPattern.replace(/\/\*$/, "");
-        const target = (targets[0] ?? "").replace(/\/\*$/, "");
-        if (!aliases[alias]) aliases[alias] = target;
-      }
-      config.aliases = aliases;
-    }
-  }
-  if (userConfig.extends) {
-    const parentPath = path2.resolve(configDir, userConfig.extends);
-    if (!existsSync(parentPath)) {
-      throw new Error(
-        `apotheke: extended config not found: ${parentPath}
-  (referenced from ${configPath} via "extends": "${userConfig.extends}")`
-      );
-    }
-    const parent = await loadConfig(parentPath);
-    return mergeConfigs(parent, config);
-  }
-  return config;
-}
-function loadTsConfig(dir) {
-  const tsconfigPath = path2.join(dir, "tsconfig.json");
-  if (!existsSync(tsconfigPath)) return null;
-  try {
-    const text = readFileSync(tsconfigPath, "utf8");
-    const cleaned = text.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
-    return JSON.parse(cleaned);
-  } catch {
-    return null;
-  }
-}
-
 // index.ts
-import { createRequire } from "module";
 async function resolveConfig(filePath) {
   const candidates = ["apotheke.config.mjs", "apotheke.config.js"];
   let dir = path3.dirname(path3.resolve(filePath));
@@ -368,7 +372,12 @@ async function resolveConfig(filePath) {
     `apotheke: no config found for ${filePath}. Create an apotheke.config.mjs in your project root.`
   );
 }
+var DOCUMENT_PARSERS = /* @__PURE__ */ new Set(["markdown", "mdx"]);
+function isDocumentSnippet(parentParser) {
+  return typeof parentParser === "string" && DOCUMENT_PARSERS.has(parentParser);
+}
 async function preprocess(text, options) {
+  if (isDocumentSnippet(options.parentParser)) return text;
   try {
     const config = await resolveConfig(options.filepath ?? process.cwd());
     const fileDir = options.filepath ? path3.dirname(path3.resolve(options.filepath)) : void 0;
@@ -436,7 +445,10 @@ function makeParser(pluginPath, parserName) {
     async preprocess(text, opts) {
       const base = getBase(opts?.filepath);
       const basePreprocess = base?.preprocess;
-      const after = basePreprocess ? await basePreprocess(text, opts) : text;
+      const after = basePreprocess ? await basePreprocess(
+        text,
+        opts
+      ) : text;
       return preprocess(after, opts);
     }
   };
@@ -449,5 +461,6 @@ var parsers = {
 };
 export {
   formatImports,
+  isDocumentSnippet,
   parsers
 };

package/package.json

@@ -1,48 +1,67 @@
 {
-  "name": "apotheke",
-  "version": "0.0.1",
-  "description": "JavaScript/TypeScript import organizer — prettier plugin + CLI",
-  "type": "module",
-  "repository": {
-    "url": "https://github.com/mRaffaello/apotheke"
-  },
-  "exports": {
-    ".": "./dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "apotheke": "./dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "devDependencies": {
-    "@commitlint/cli": "^20.5.3",
-    "@commitlint/config-conventional": "^20.5.3",
-    "@types/node": "^25.6.0",
-    "husky": "^9.1.7",
-    "prettier": "^3.8.3",
-    "tsup": "^8.5.1",
-    "vitest": "^4.1.5"
-  },
-  "peerDependencies": {
-    "prettier": ">=3"
-  },
-  "peerDependenciesMeta": {
-    "prettier": {
-      "optional": true
+    "name": "apotheke",
+    "version": "0.1.1",
+    "description": "Prettier for imports — deterministic import organization as a Prettier plugin or CLI",
+    "type": "module",
+    "license": "MIT",
+    "author": "Marco Raffaello",
+    "homepage": "https://marcoraffaello.com/apotheke",
+    "keywords": [
+        "imports",
+        "import-sorter",
+        "organize-imports",
+        "prettier",
+        "prettier-plugin",
+        "typescript",
+        "javascript",
+        "codemod",
+        "monorepo"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/mRaffaello/apotheke",
+        "directory": "packages/apotheke"
+    },
+    "bugs": {
+        "url": "https://github.com/mRaffaello/apotheke/issues"
+    },
+    "exports": {
+        ".": "./dist/index.js"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "bin": {
+        "apotheke": "./dist/cli.js"
+    },
+    "files": [
+        "dist",
+        "SKILL.md"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "lint": "eslint .",
+        "lint:fix": "eslint . --fix",
+        "typecheck": "tsc --noEmit",
+        "test": "vitest run",
+        "test:unit": "vitest run tests/unit",
+        "test:e2e": "vitest run tests/e2e/e2e.test.ts"
+    },
+    "devDependencies": {
+        "@types/node": "^25.6.0",
+        "tsup": "^8.5.1",
+        "typescript": "~5.9.3",
+        "vitest": "^4.1.5"
+    },
+    "peerDependencies": {
+        "prettier": ">=3"
+    },
+    "peerDependenciesMeta": {
+        "prettier": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "fast-glob": "^3.3.3",
+        "oxc-parser": "^0.129.0"
     }
-  },
-  "dependencies": {
-    "fast-glob": "^3.3.3",
-    "oxc-parser": "^0.129.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:unit": "vitest run tests/unit",
-    "test:e2e": "vitest run tests/e2e/e2e.test.ts"
-  }
-}
+}