@lsst/pik-core 0.4.1 → 0.5.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export type { Option, Selector, ParseResult } from './lib/types/index.js';
+export type { Option, Selector, ParseResult, PikPlugin } from './lib/types/index.js';
 export { CommentStyle } from './lib/types/index.js';
+export { defineConfig, loadConfig, type PikConfig } from './lib/config.js';
 export { Parser } from './lib/parser.js';
 export { Switcher } from './lib/switcher.js';
 export { SingleSwitcher } from './lib/single-switcher.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG3E,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -1,160 +1,204 @@
-class n {
-  constructor(t) {
-    this.lineComment = t;
+import { pathToFileURL } from "url";
+import { existsSync } from "fs";
+import { resolve } from "path";
+class CommentStyle {
+  constructor(lineComment) {
+    this.lineComment = lineComment;
   }
   static styles = {
     // JavaScript/TypeScript
-    js: new n("//"),
-    ts: new n("//"),
-    jsx: new n("//"),
-    tsx: new n("//"),
-    mjs: new n("//"),
-    mts: new n("//"),
+    js: new CommentStyle("//"),
+    ts: new CommentStyle("//"),
+    jsx: new CommentStyle("//"),
+    tsx: new CommentStyle("//"),
+    mjs: new CommentStyle("//"),
+    mts: new CommentStyle("//"),
     // HTML (for script tags)
-    html: new n("//"),
-    htm: new n("//"),
+    html: new CommentStyle("//"),
+    htm: new CommentStyle("//"),
     // Config files
-    yaml: new n("#"),
-    yml: new n("#"),
+    yaml: new CommentStyle("#"),
+    yml: new CommentStyle("#"),
     // Shell
-    sh: new n("#"),
-    bash: new n("#"),
-    zsh: new n("#"),
+    sh: new CommentStyle("#"),
+    bash: new CommentStyle("#"),
+    zsh: new CommentStyle("#"),
     // Python
-    py: new n("#"),
+    py: new CommentStyle("#"),
     // Env files
-    env: new n("#")
+    env: new CommentStyle("#")
   };
-  static defaultStyle = new n("//");
+  static defaultStyle = new CommentStyle("//");
   /**
    * Get comment style for a file extension
    */
-  static fromExtension(t) {
-    const s = t.replace(/^\./, "").toLowerCase();
-    return n.styles[s] ?? n.defaultStyle;
+  static fromExtension(extension) {
+    const ext = extension.replace(/^\./, "").toLowerCase();
+    return CommentStyle.styles[ext] ?? CommentStyle.defaultStyle;
   }
   /**
    * Register a custom comment style for an extension
    */
-  static register(t, s) {
-    const i = t.replace(/^\./, "").toLowerCase();
-    n.styles[i] = s;
+  static register(extension, style) {
+    const ext = extension.replace(/^\./, "").toLowerCase();
+    CommentStyle.styles[ext] = style;
   }
 }
-class a {
-  constructor(t) {
-    this.commentStyle = t;
+function defineConfig(config) {
+  return config;
+}
+const CONFIG_FILES = [
+  "pik.config.mts",
+  "pik.config.ts",
+  "pik.config.mjs",
+  "pik.config.js",
+  ".pik.config.mts",
+  ".pik.config.ts",
+  ".pik.config.mjs",
+  ".pik.config.js"
+];
+async function loadConfig(cwd = process.cwd()) {
+  for (const configFile of CONFIG_FILES) {
+    const configPath = resolve(cwd, configFile);
+    if (existsSync(configPath)) {
+      const configUrl = pathToFileURL(configPath).href;
+      const module = await import(configUrl);
+      return module.default;
+    }
+  }
+  return null;
+}
+class Parser {
+  constructor(commentStyle) {
+    this.commentStyle = commentStyle;
   }
   static SELECT_REGEX = /@pik:select\s+(\S+)/;
   static OPTION_REGEX = /@pik:option\s+(\S+)/;
   /**
    * Create a parser for a specific file extension
    */
-  static forExtension(t) {
-    return new a(n.fromExtension(t));
+  static forExtension(extension) {
+    return new Parser(CommentStyle.fromExtension(extension));
   }
   /**
    * Parse content string for pik selectors and options
    */
-  parse(t) {
-    const s = t.split(`
-`), i = [];
-    let e = null;
-    for (let o = 0; o < s.length; o++) {
-      const c = s[o], r = o + 1, l = c.match(a.SELECT_REGEX);
-      if (l) {
-        e = {
-          name: l[1],
-          line: r,
+  parse(content) {
+    const lines = content.split("\n");
+    const selectors = [];
+    let currentSelector = null;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      const selectMatch = line.match(Parser.SELECT_REGEX);
+      if (selectMatch) {
+        currentSelector = {
+          name: selectMatch[1],
+          line: lineNumber,
           options: []
-        }, i.push(e);
+        };
+        selectors.push(currentSelector);
         continue;
       }
-      const h = c.match(a.OPTION_REGEX);
-      if (h && e) {
-        const w = {
-          name: h[1],
-          line: r,
-          content: c,
-          isActive: !this.isLineCommented(c)
+      const optionMatch = line.match(Parser.OPTION_REGEX);
+      if (optionMatch && currentSelector) {
+        const option = {
+          name: optionMatch[1],
+          line: lineNumber,
+          content: line,
+          isActive: !this.isLineCommented(line)
         };
-        e.options.push(w);
+        currentSelector.options.push(option);
       }
     }
-    return { selectors: i, content: t };
+    return { selectors, content };
   }
   /**
    * Check if a line is commented out
    */
-  isLineCommented(t) {
-    return t.trimStart().startsWith(this.commentStyle.lineComment);
+  isLineCommented(line) {
+    return line.trimStart().startsWith(this.commentStyle.lineComment);
   }
 }
-class p {
-  constructor(t) {
-    this.commentStyle = t;
+class CommentManipulator {
+  constructor(commentStyle) {
+    this.commentStyle = commentStyle;
   }
   /**
    * Check if a line is commented out
    */
-  isLineCommented(t) {
-    return t.trimStart().startsWith(this.commentStyle.lineComment);
+  isLineCommented(line) {
+    return line.trimStart().startsWith(this.commentStyle.lineComment);
   }
   /**
    * Comment out a line if not already commented
    */
-  commentLine(t) {
-    const s = t.trimStart();
-    return s.startsWith(this.commentStyle.lineComment) ? t : `${t.slice(0, t.length - s.length)}${this.commentStyle.lineComment} ${s}`;
+  commentLine(line) {
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith(this.commentStyle.lineComment)) {
+      return line;
+    }
+    const indent = line.slice(0, line.length - trimmed.length);
+    return `${indent}${this.commentStyle.lineComment} ${trimmed}`;
   }
   /**
    * Uncomment a line if commented
    */
-  uncommentLine(t) {
-    const s = t.trimStart();
-    if (!s.startsWith(this.commentStyle.lineComment))
-      return t;
-    const i = t.slice(0, t.length - s.length), e = s.slice(this.commentStyle.lineComment.length), o = e.startsWith(" ") ? e.slice(1) : e;
-    return `${i}${o}`;
+  uncommentLine(line) {
+    const trimmed = line.trimStart();
+    if (!trimmed.startsWith(this.commentStyle.lineComment)) {
+      return line;
+    }
+    const indent = line.slice(0, line.length - trimmed.length);
+    const withoutComment = trimmed.slice(this.commentStyle.lineComment.length);
+    const content = withoutComment.startsWith(" ") ? withoutComment.slice(1) : withoutComment;
+    return `${indent}${content}`;
   }
 }
-class f extends p {
+class Switcher extends CommentManipulator {
   /**
    * Validate that the option exists in the selector
    */
-  validateOption(t, s) {
-    if (!t.options.find((e) => e.name === s))
+  validateOption(selector, optionName) {
+    const option = selector.options.find((o) => o.name === optionName);
+    if (!option) {
       throw new Error(
-        `Option "${s}" not found in selector "${t.name}"`
+        `Option "${optionName}" not found in selector "${selector.name}"`
       );
+    }
   }
 }
-class m extends f {
+class SingleSwitcher extends Switcher {
   /**
    * Create a switcher for a specific file extension
    */
-  static forExtension(t) {
-    return new m(n.fromExtension(t));
+  static forExtension(extension) {
+    return new SingleSwitcher(CommentStyle.fromExtension(extension));
   }
   /**
    * Switch to a specific option, deactivating all others
    */
-  switch(t, s, i) {
-    this.validateOption(s, i);
-    const e = t.split(`
-`);
-    for (const o of s.options) {
-      const c = o.line - 1, r = e[c];
-      o.name === i ? e[c] = this.uncommentLine(r) : e[c] = this.commentLine(r);
+  switch(content, selector, optionName) {
+    this.validateOption(selector, optionName);
+    const lines = content.split("\n");
+    for (const option of selector.options) {
+      const lineIndex = option.line - 1;
+      const line = lines[lineIndex];
+      if (option.name === optionName) {
+        lines[lineIndex] = this.uncommentLine(line);
+      } else {
+        lines[lineIndex] = this.commentLine(line);
+      }
     }
-    return e.join(`
-`);
+    return lines.join("\n");
   }
 }
 export {
-  p as CommentManipulator,
-  n as CommentStyle,
-  a as Parser,
-  m as SingleSwitcher,
-  f as Switcher
+  CommentManipulator,
+  CommentStyle,
+  Parser,
+  SingleSwitcher,
+  Switcher,
+  defineConfig,
+  loadConfig
 };

package/dist/lib/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Base config interface - plugins extend this via declaration merging
+ */
+export interface PikConfig {
+    [pluginName: string]: unknown;
+}
+/**
+ * Helper function for type-safe config definition
+ */
+export declare function defineConfig<T extends PikConfig>(config: T): T;
+/**
+ * Load pik config from the current directory
+ */
+export declare function loadConfig(cwd?: string): Promise<PikConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAE9D;AAaD;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAYvF"}

package/dist/lib/types/index.d.ts

@@ -2,4 +2,5 @@ export type { Option } from './option.js';
 export type { Selector } from './selector.js';
 export type { ParseResult } from './parse-result.js';
 export { CommentStyle } from './comment-style.js';
+export type { PikPlugin } from './plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/types/plugin.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+/**
+ * Plugin interface for pik CLI plugins.
+ */
+export interface PikPlugin {
+    /** Display name of the plugin */
+    name: string;
+    /** Short description shown in help and menu */
+    description: string;
+    /** Command name used to invoke the plugin (e.g., "select", "worktree") */
+    command: string;
+    /** Alternative command names */
+    aliases?: string[];
+    /**
+     * Register the plugin's commands with the CLI.
+     * @param program - The commander program or command to attach to
+     */
+    register: (program: Command) => void;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/lib/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/lib/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lsst/pik-core",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Core library for parsing and switching @pik config markers",
   "type": "module",
   "license": "MIT",
@@ -33,5 +33,7 @@
     "dist",
     "!**/*.tsbuildinfo"
   ],
-  "dependencies": {}
+  "dependencies": {
+    "commander": "^14.0.0"
+  }
 }