@lsst/pik-core 0.0.1

package/README.md

@@ -0,0 +1,86 @@
+# @lsst/pik-core
+
+Core library for parsing and switching `@pik` config markers in source files.
+
+## Installation
+
+```bash
+npm install @lsst/pik-core
+```
+
+## Usage
+
+```typescript
+import { Parser, SingleSwitcher } from '@lsst25/pik-core';
+
+const content = `
+// @pik:select Environment
+// const env = 'DEV';    // @pik:option DEV
+const env = 'LOCAL';     // @pik:option LOCAL
+`;
+
+// Parse content
+const parser = Parser.forExtension('ts');
+const { selectors } = parser.parse(content);
+
+// Switch option
+const switcher = SingleSwitcher.forExtension('ts');
+const newContent = switcher.switch(content, selectors[0], 'DEV');
+```
+
+## API
+
+### Parser
+
+```typescript
+// Create parser for file extension
+const parser = Parser.forExtension('ts');
+
+// Parse content
+const result = parser.parse(content);
+// result.selectors: Selector[]
+// result.content: string
+```
+
+### SingleSwitcher
+
+```typescript
+// Create switcher for file extension
+const switcher = SingleSwitcher.forExtension('ts');
+
+// Switch to option (deactivates all others)
+const newContent = switcher.switch(content, selector, 'optionName');
+```
+
+### CommentStyle
+
+```typescript
+import { CommentStyle } from '@lsst25/pik-core';
+
+// Get comment style for extension
+const style = CommentStyle.fromExtension('py'); // { lineComment: '#' }
+
+// Register custom style
+CommentStyle.register('custom', new CommentStyle(';;'));
+```
+
+## Types
+
+```typescript
+interface Selector {
+  name: string;
+  line: number;
+  options: Option[];
+}
+
+interface Option {
+  name: string;
+  line: number;
+  content: string;
+  isActive: boolean;
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { Option, Selector, ParseResult } from './lib/types/index.js';
+export { CommentStyle } from './lib/types/index.js';
+export { Parser } from './lib/parser.js';
+export { Switcher } from './lib/switcher.js';
+export { SingleSwitcher } from './lib/single-switcher.js';
+export { CommentManipulator } from './lib/comment-manipulator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,157 @@
+class e {
+  constructor(t) {
+    this.lineComment = t;
+  }
+  static styles = {
+    // JavaScript/TypeScript
+    js: new e("//"),
+    ts: new e("//"),
+    jsx: new e("//"),
+    tsx: new e("//"),
+    mjs: new e("//"),
+    mts: new e("//"),
+    // Config files
+    yaml: new e("#"),
+    yml: new e("#"),
+    // Shell
+    sh: new e("#"),
+    bash: new e("#"),
+    zsh: new e("#"),
+    // Python
+    py: new e("#"),
+    // Env files
+    env: new e("#")
+  };
+  static defaultStyle = new e("//");
+  /**
+   * Get comment style for a file extension
+   */
+  static fromExtension(t) {
+    const n = t.replace(/^\./, "").toLowerCase();
+    return e.styles[n] ?? e.defaultStyle;
+  }
+  /**
+   * Register a custom comment style for an extension
+   */
+  static register(t, n) {
+    const i = t.replace(/^\./, "").toLowerCase();
+    e.styles[i] = n;
+  }
+}
+class a {
+  constructor(t) {
+    this.commentStyle = t;
+  }
+  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(e.fromExtension(t));
+  }
+  /**
+   * Parse content string for pik selectors and options
+   */
+  parse(t) {
+    const n = t.split(`
+`), i = [];
+    let s = null;
+    for (let o = 0; o < n.length; o++) {
+      const c = n[o], r = o + 1, l = c.match(a.SELECT_REGEX);
+      if (l) {
+        s = {
+          name: l[1],
+          line: r,
+          options: []
+        }, i.push(s);
+        continue;
+      }
+      const h = c.match(a.OPTION_REGEX);
+      if (h && s) {
+        const p = {
+          name: h[1],
+          line: r,
+          content: c,
+          isActive: !this.isLineCommented(c)
+        };
+        s.options.push(p);
+      }
+    }
+    return { selectors: i, content: t };
+  }
+  /**
+   * Check if a line is commented out
+   */
+  isLineCommented(t) {
+    return t.trimStart().startsWith(this.commentStyle.lineComment);
+  }
+}
+class w {
+  constructor(t) {
+    this.commentStyle = t;
+  }
+  /**
+   * Check if a line is commented out
+   */
+  isLineCommented(t) {
+    return t.trimStart().startsWith(this.commentStyle.lineComment);
+  }
+  /**
+   * Comment out a line if not already commented
+   */
+  commentLine(t) {
+    const n = t.trimStart();
+    return n.startsWith(this.commentStyle.lineComment) ? t : `${t.slice(0, t.length - n.length)}${this.commentStyle.lineComment} ${n}`;
+  }
+  /**
+   * Uncomment a line if commented
+   */
+  uncommentLine(t) {
+    const n = t.trimStart();
+    if (!n.startsWith(this.commentStyle.lineComment))
+      return t;
+    const i = t.slice(0, t.length - n.length), s = n.slice(this.commentStyle.lineComment.length), o = s.startsWith(" ") ? s.slice(1) : s;
+    return `${i}${o}`;
+  }
+}
+class f extends w {
+  /**
+   * Validate that the option exists in the selector
+   */
+  validateOption(t, n) {
+    if (!t.options.find((s) => s.name === n))
+      throw new Error(
+        `Option "${n}" not found in selector "${t.name}"`
+      );
+  }
+}
+class m extends f {
+  /**
+   * Create a switcher for a specific file extension
+   */
+  static forExtension(t) {
+    return new m(e.fromExtension(t));
+  }
+  /**
+   * Switch to a specific option, deactivating all others
+   */
+  switch(t, n, i) {
+    this.validateOption(n, i);
+    const s = t.split(`
+`);
+    for (const o of n.options) {
+      const c = o.line - 1, r = s[c];
+      o.name === i ? s[c] = this.uncommentLine(r) : s[c] = this.commentLine(r);
+    }
+    return s.join(`
+`);
+  }
+}
+export {
+  w as CommentManipulator,
+  e as CommentStyle,
+  a as Parser,
+  m as SingleSwitcher,
+  f as Switcher
+};

package/dist/lib/comment-manipulator.d.ts

@@ -0,0 +1,21 @@
+import { CommentStyle } from './types/index.js';
+/**
+ * Base class for manipulating comments in source files
+ */
+export declare abstract class CommentManipulator {
+    protected readonly commentStyle: CommentStyle;
+    constructor(commentStyle: CommentStyle);
+    /**
+     * Check if a line is commented out
+     */
+    protected isLineCommented(line: string): boolean;
+    /**
+     * Comment out a line if not already commented
+     */
+    protected commentLine(line: string): string;
+    /**
+     * Uncomment a line if commented
+     */
+    protected uncommentLine(line: string): string;
+}
+//# sourceMappingURL=comment-manipulator.d.ts.map

package/dist/lib/comment-manipulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-manipulator.d.ts","sourceRoot":"","sources":["../../src/lib/comment-manipulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,8BAAsB,kBAAkB;IAC1B,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;gBAA1B,YAAY,EAAE,YAAY;IAEzD;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU3C;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAe9C"}

package/dist/lib/parser.d.ts

@@ -0,0 +1,24 @@
+import type { ParseResult } from './types/index.js';
+import { CommentStyle } from './types/index.js';
+/**
+ * Parser for pik selectors and options in source files
+ */
+export declare class Parser {
+    private readonly commentStyle;
+    private static readonly SELECT_REGEX;
+    private static readonly OPTION_REGEX;
+    constructor(commentStyle: CommentStyle);
+    /**
+     * Create a parser for a specific file extension
+     */
+    static forExtension(extension: string): Parser;
+    /**
+     * Parse content string for pik selectors and options
+     */
+    parse(content: string): ParseResult;
+    /**
+     * Check if a line is commented out
+     */
+    private isLineCommented;
+}
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,WAAW,EAAY,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,qBAAa,MAAM;IAIL,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAyB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEhC,YAAY,EAAE,YAAY;IAEvD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAqCnC;;OAEG;IACH,OAAO,CAAC,eAAe;CAGxB"}

package/dist/lib/single-switcher.d.ts

@@ -0,0 +1,16 @@
+import type { Selector } from './types/index.js';
+import { Switcher } from './switcher.js';
+/**
+ * Switcher that allows only one option to be active at a time
+ */
+export declare class SingleSwitcher extends Switcher {
+    /**
+     * Create a switcher for a specific file extension
+     */
+    static forExtension(extension: string): SingleSwitcher;
+    /**
+     * Switch to a specific option, deactivating all others
+     */
+    switch(content: string, selector: Selector, optionName: string): string;
+}
+//# sourceMappingURL=single-switcher.d.ts.map

package/dist/lib/single-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-switcher.d.ts","sourceRoot":"","sources":["../../src/lib/single-switcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IAItD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;CAkBxE"}

package/dist/lib/switcher.d.ts

@@ -0,0 +1,17 @@
+import type { Selector } from './types/index.js';
+import { CommentManipulator } from './comment-manipulator.js';
+/**
+ * Abstract base class for switching pik options
+ */
+export declare abstract class Switcher extends CommentManipulator {
+    /**
+     * Switch options within a selector
+     * Returns the modified content
+     */
+    abstract switch(content: string, selector: Selector, optionName: string): string;
+    /**
+     * Validate that the option exists in the selector
+     */
+    protected validateOption(selector: Selector, optionName: string): void;
+}
+//# sourceMappingURL=switcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"switcher.d.ts","sourceRoot":"","sources":["../../src/lib/switcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;GAEG;AACH,8BAAsB,QAAS,SAAQ,kBAAkB;IACvD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM;IAET;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAQvE"}

package/dist/lib/types/comment-style.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Comment style configuration for different file types
+ */
+export declare class CommentStyle {
+    /** Line comment prefix (e.g., "//", "#") */
+    readonly lineComment: string;
+    private static readonly styles;
+    private static readonly defaultStyle;
+    constructor(
+    /** Line comment prefix (e.g., "//", "#") */
+    lineComment: string);
+    /**
+     * Get comment style for a file extension
+     */
+    static fromExtension(extension: string): CommentStyle;
+    /**
+     * Register a custom comment style for an extension
+     */
+    static register(extension: string, style: CommentStyle): void;
+}
+//# sourceMappingURL=comment-style.d.ts.map

package/dist/lib/types/comment-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-style.d.ts","sourceRoot":"","sources":["../../../src/lib/types/comment-style.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY;IAyBrB,4CAA4C;aAC5B,WAAW,EAAE,MAAM;IAzBrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAmB5B;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA0B;;IAG5D,4CAA4C;IAC5B,WAAW,EAAE,MAAM;IAGrC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAKrD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;CAI9D"}

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

@@ -0,0 +1,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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+/**
+ * Represents a single option within a selector
+ */
+export interface Option {
+    /** Option name (e.g., "DEV", "LOCAL") */
+    name: string;
+    /** Line number (1-based) */
+    line: number;
+    /** Full content of the line */
+    content: string;
+    /** Whether this option is currently active (not commented out) */
+    isActive: boolean;
+}
+//# sourceMappingURL=option.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../../../src/lib/types/option.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/lib/types/parse-result.d.ts

@@ -0,0 +1,11 @@
+import type { Selector } from './selector.js';
+/**
+ * Result of parsing a file or content string
+ */
+export interface ParseResult {
+    /** All selectors found in the content */
+    selectors: Selector[];
+    /** Original content that was parsed */
+    content: string;
+}
+//# sourceMappingURL=parse-result.d.ts.map

package/dist/lib/types/parse-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-result.d.ts","sourceRoot":"","sources":["../../../src/lib/types/parse-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,13 @@
+import type { Option } from './option.js';
+/**
+ * Represents a selector with its options
+ */
+export interface Selector {
+    /** Selector name (e.g., "Environment") */
+    name: string;
+    /** Line number where the selector is defined (1-based) */
+    line: number;
+    /** All options belonging to this selector */
+    options: Option[];
+}
+//# sourceMappingURL=selector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/lib/types/selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@lsst/pik-core",
+  "version": "0.0.1",
+  "description": "Core library for parsing and switching @pik config markers",
+  "type": "module",
+  "license": "MIT",
+  "author": "Yurii Tatar <lsst25@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lsst25/pik.git",
+    "directory": "packages/pik-core"
+  },
+  "keywords": [
+    "config",
+    "configuration",
+    "switch",
+    "toggle",
+    "environment"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@pik/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {}
+}