@lsst/pik 0.0.1

package/README.md

@@ -0,0 +1,71 @@
+# @lsst/pik
+
+CLI tool for switching config options in source files using `@pik` markers.
+
+## Installation
+
+```bash
+npm install -g @lsst/pik
+```
+
+## Usage
+
+### 1. Add markers to your files
+
+```typescript
+// @pik:select Environment
+// const env = 'DEV';     // @pik:option DEV
+const env = 'LOCAL';      // @pik:option LOCAL
+```
+
+### 2. Create a config file
+
+Create `pik.config.ts` in your project root:
+
+```typescript
+import { defineConfig } from '@lsst/pik';
+
+export default defineConfig({
+  include: ['src/**/*.ts', '.env'],
+});
+```
+
+### 3. Run commands
+
+```bash
+# List all selectors and their current state
+pik list
+
+# Set a specific option
+pik set Environment DEV
+
+# Interactive mode
+pik switch
+```
+
+## Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `pik list` | `ls` | Show all selectors and their current state |
+| `pik set <selector> <option>` | - | Set an option directly |
+| `pik switch` | `sw` | Interactive selection mode |
+| `pik` | - | Same as `pik switch` |
+
+## Marker Syntax
+
+- `@pik:select <name>` - Defines a selector group
+- `@pik:option <name>` - Marks an option within a selector
+
+Commented lines are inactive, uncommented lines are active.
+
+## Supported Comment Styles
+
+| Extensions | Comment Style |
+|------------|---------------|
+| `.ts`, `.js`, `.tsx`, `.jsx` | `//` |
+| `.sh`, `.bash`, `.zsh`, `.py`, `.yaml`, `.yml`, `.env` | `#` |
+
+## License
+
+MIT

package/dist/bin/pik.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=pik.d.ts.map

package/dist/bin/pik.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pik.d.ts","sourceRoot":"","sources":["../../src/bin/pik.ts"],"names":[],"mappings":""}

package/dist/bin/pik.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { program } from '../lib/program.js';
+program.parse();

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { defineConfig, type PikConfig } from './lib/config.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,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+// Config helper for pik.config.ts
+export { defineConfig } from './lib/config.js';

package/dist/lib/commands/list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const listCommand: Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/lib/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,WAAW,SAuCpB,CAAC"}

package/dist/lib/commands/list.js

@@ -0,0 +1,37 @@
+import { Command } from 'commander';
+import pc from 'picocolors';
+import { relative } from 'path';
+import { loadConfig } from '../config.js';
+import { Scanner } from '../scanner.js';
+export const listCommand = new Command('list')
+    .alias('ls')
+    .description('List all selectors and their current state')
+    .action(async () => {
+    const config = await loadConfig();
+    if (!config) {
+        console.error(pc.red('No pik.config.ts found'));
+        process.exit(1);
+    }
+    const scanner = new Scanner(config);
+    const results = await scanner.scan();
+    if (results.length === 0) {
+        console.log(pc.yellow('No selectors found'));
+        return;
+    }
+    for (const file of results) {
+        const relativePath = relative(process.cwd(), file.path);
+        console.log(pc.cyan(relativePath));
+        for (const selector of file.selectors) {
+            const activeOption = selector.options.find((o) => o.isActive);
+            const activeLabel = activeOption
+                ? pc.green(activeOption.name)
+                : pc.yellow('none');
+            console.log(`  ${pc.bold(selector.name)}: ${activeLabel}`);
+            for (const option of selector.options) {
+                const marker = option.isActive ? pc.green('●') : pc.dim('○');
+                console.log(`    ${marker} ${option.name}`);
+            }
+        }
+        console.log();
+    }
+});

package/dist/lib/commands/set.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const setCommand: Command;
+//# sourceMappingURL=set.d.ts.map

package/dist/lib/commands/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,UAAU,SA8CnB,CAAC"}

package/dist/lib/commands/set.js

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import { writeFile } from 'fs/promises';
+import { extname, relative } from 'path';
+import pc from 'picocolors';
+import { SingleSwitcher } from '@lsst/pik-core';
+import { loadConfig } from '../config.js';
+import { Scanner } from '../scanner.js';
+export const setCommand = new Command('set')
+    .description('Set a specific option for a selector')
+    .argument('<selector>', 'Selector name')
+    .argument('<option>', 'Option to activate')
+    .action(async (selectorName, optionName) => {
+    const config = await loadConfig();
+    if (!config) {
+        console.error(pc.red('No pik.config.ts found'));
+        process.exit(1);
+    }
+    const scanner = new Scanner(config);
+    const results = await scanner.scan();
+    let found = false;
+    for (const file of results) {
+        const selector = file.selectors.find((s) => s.name === selectorName);
+        if (selector) {
+            found = true;
+            const extension = extname(file.path);
+            const switcher = SingleSwitcher.forExtension(extension);
+            try {
+                const newContent = switcher.switch(file.content, selector, optionName);
+                await writeFile(file.path, newContent);
+                const relativePath = relative(process.cwd(), file.path);
+                console.log(pc.green(`✓ Set ${pc.bold(selectorName)} to ${pc.bold(optionName)} in ${relativePath}`));
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    console.error(pc.red(error.message));
+                }
+                process.exit(1);
+            }
+        }
+    }
+    if (!found) {
+        console.error(pc.red(`Selector "${selectorName}" not found`));
+        process.exit(1);
+    }
+});

package/dist/lib/commands/switch.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const switchCommand: Command;
+//# sourceMappingURL=switch.d.ts.map

package/dist/lib/commands/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/lib/commands/switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,aAAa,SAoEtB,CAAC"}

package/dist/lib/commands/switch.js

@@ -0,0 +1,59 @@
+import { Command } from 'commander';
+import { writeFile } from 'fs/promises';
+import { extname, relative } from 'path';
+import { select } from '@inquirer/prompts';
+import pc from 'picocolors';
+import { SingleSwitcher } from '@lsst/pik-core';
+import { loadConfig } from '../config.js';
+import { Scanner } from '../scanner.js';
+export const switchCommand = new Command('switch')
+    .alias('sw')
+    .description('Interactively switch options')
+    .action(async () => {
+    const config = await loadConfig();
+    if (!config) {
+        console.error(pc.red('No pik.config.ts found'));
+        process.exit(1);
+    }
+    const scanner = new Scanner(config);
+    const results = await scanner.scan();
+    if (results.length === 0) {
+        console.log(pc.yellow('No selectors found'));
+        return;
+    }
+    // Flatten all selectors with their file info
+    const choices = [];
+    for (const file of results) {
+        for (const selector of file.selectors) {
+            choices.push({ file, selector });
+        }
+    }
+    // Select which selector to switch
+    const selectedChoice = await select({
+        message: 'Select a selector to switch',
+        choices: choices.map((choice) => {
+            const relativePath = relative(process.cwd(), choice.file.path);
+            const activeOption = choice.selector.options.find((o) => o.isActive);
+            const current = activeOption ? pc.dim(` (${activeOption.name})`) : '';
+            return {
+                name: `${choice.selector.name}${current} ${pc.dim(`- ${relativePath}`)}`,
+                value: choice,
+            };
+        }),
+    });
+    // Select which option to activate
+    const selectedOption = await select({
+        message: `Select option for ${pc.bold(selectedChoice.selector.name)}`,
+        choices: selectedChoice.selector.options.map((option) => ({
+            name: option.isActive ? `${option.name} ${pc.green('(current)')}` : option.name,
+            value: option.name,
+        })),
+    });
+    // Apply the change
+    const extension = extname(selectedChoice.file.path);
+    const switcher = SingleSwitcher.forExtension(extension);
+    const newContent = switcher.switch(selectedChoice.file.content, selectedChoice.selector, selectedOption);
+    await writeFile(selectedChoice.file.path, newContent);
+    const relativePath = relative(process.cwd(), selectedChoice.file.path);
+    console.log(pc.green(`✓ Set ${pc.bold(selectedChoice.selector.name)} to ${pc.bold(selectedOption)} in ${relativePath}`));
+});

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+export interface PikConfig {
+    /** File patterns to scan for @pik markers */
+    include: string[];
+}
+export declare function defineConfig(config: PikConfig): PikConfig;
+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,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAEzD;AAID,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAWvF"}

package/dist/lib/config.js

@@ -0,0 +1,16 @@
+import { pathToFileURL } from 'url';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+export function defineConfig(config) {
+    return config;
+}
+const CONFIG_FILE = 'pik.config.ts';
+export async function loadConfig(cwd = process.cwd()) {
+    const configPath = resolve(cwd, CONFIG_FILE);
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    const configUrl = pathToFileURL(configPath).href;
+    const module = await import(configUrl);
+    return module.default;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.spec.d.ts","sourceRoot":"","sources":["../../src/lib/config.spec.ts"],"names":[],"mappings":""}

package/dist/lib/config.spec.js

@@ -0,0 +1,35 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { writeFile, mkdir, rm } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { loadConfig, defineConfig } from './config.js';
+describe('config', () => {
+    let testDir;
+    beforeEach(async () => {
+        testDir = join(tmpdir(), `pik-test-${Date.now()}`);
+        await mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(testDir, { recursive: true, force: true });
+    });
+    describe('defineConfig', () => {
+        it('should return the config as-is', () => {
+            const config = defineConfig({ include: ['*.ts'] });
+            expect(config).toEqual({ include: ['*.ts'] });
+        });
+    });
+    describe('loadConfig', () => {
+        it('should return null when no config file exists', async () => {
+            const config = await loadConfig(testDir);
+            expect(config).toBeNull();
+        });
+        it('should load config from pik.config.ts', async () => {
+            const configContent = `
+        export default { include: ['src/**/*.ts'] };
+      `;
+            await writeFile(join(testDir, 'pik.config.ts'), configContent);
+            const config = await loadConfig(testDir);
+            expect(config).toEqual({ include: ['src/**/*.ts'] });
+        });
+    });
+});

package/dist/lib/program.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const program: Command;
+//# sourceMappingURL=program.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/lib/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,OAAO,SAGG,CAAC"}

package/dist/lib/program.js

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+import pkg from '../../package.json' with { type: 'json' };
+import { listCommand } from './commands/list.js';
+import { setCommand } from './commands/set.js';
+import { switchCommand } from './commands/switch.js';
+export const program = new Command()
+    .name(pkg.name)
+    .description(pkg.description)
+    .version(pkg.version);
+program.addCommand(listCommand);
+program.addCommand(setCommand);
+program.addCommand(switchCommand);
+// Default command: interactive switch
+program.action(async () => {
+    await switchCommand.parseAsync([]);
+});

package/dist/lib/scanner.d.ts

@@ -0,0 +1,13 @@
+import { type Selector } from '@lsst/pik-core';
+import type { PikConfig } from './config.js';
+export interface FileResult {
+    path: string;
+    selectors: Selector[];
+    content: string;
+}
+export declare class Scanner {
+    private readonly config;
+    constructor(config: PikConfig);
+    scan(cwd?: string): Promise<FileResult[]>;
+}
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/lib/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAExC,IAAI,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAsB/D"}

package/dist/lib/scanner.js

@@ -0,0 +1,28 @@
+import { readFile } from 'fs/promises';
+import { glob } from 'glob';
+import { extname } from 'path';
+import { Parser } from '@lsst/pik-core';
+export class Scanner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async scan(cwd = process.cwd()) {
+        const files = await glob(this.config.include, {
+            cwd,
+            absolute: true,
+            nodir: true,
+        });
+        const results = [];
+        for (const filePath of files) {
+            const content = await readFile(filePath, 'utf-8');
+            const extension = extname(filePath);
+            const parser = Parser.forExtension(extension);
+            const { selectors } = parser.parse(content);
+            if (selectors.length > 0) {
+                results.push({ path: filePath, selectors, content });
+            }
+        }
+        return results;
+    }
+}

package/dist/lib/scanner.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.spec.d.ts.map

package/dist/lib/scanner.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.spec.d.ts","sourceRoot":"","sources":["../../src/lib/scanner.spec.ts"],"names":[],"mappings":""}

package/dist/lib/scanner.spec.js

@@ -0,0 +1,57 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { writeFile, mkdir, rm } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { Scanner } from './scanner.js';
+describe('Scanner', () => {
+    let testDir;
+    beforeEach(async () => {
+        testDir = join(tmpdir(), `pik-scanner-test-${Date.now()}`);
+        await mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(testDir, { recursive: true, force: true });
+    });
+    it('should find files with pik selectors', async () => {
+        const fileContent = `
+// @pik:select Environment
+const env = 'DEV'; // @pik:option DEV
+// const env = 'LOCAL'; // @pik:option LOCAL
+    `.trim();
+        await writeFile(join(testDir, 'config.ts'), fileContent);
+        const scanner = new Scanner({ include: ['*.ts'] });
+        const results = await scanner.scan(testDir);
+        expect(results).toHaveLength(1);
+        expect(results[0].selectors).toHaveLength(1);
+        expect(results[0].selectors[0].name).toBe('Environment');
+    });
+    it('should return empty array when no selectors found', async () => {
+        await writeFile(join(testDir, 'empty.ts'), 'const x = 1;');
+        const scanner = new Scanner({ include: ['*.ts'] });
+        const results = await scanner.scan(testDir);
+        expect(results).toHaveLength(0);
+    });
+    it('should scan multiple files', async () => {
+        const file1 = `
+// @pik:select Theme
+const theme = 'dark'; // @pik:option dark
+    `.trim();
+        const file2 = `
+// @pik:select Mode
+const mode = 'dev'; // @pik:option dev
+    `.trim();
+        await writeFile(join(testDir, 'theme.ts'), file1);
+        await writeFile(join(testDir, 'mode.ts'), file2);
+        const scanner = new Scanner({ include: ['*.ts'] });
+        const results = await scanner.scan(testDir);
+        expect(results).toHaveLength(2);
+    });
+    it('should respect include patterns', async () => {
+        await writeFile(join(testDir, 'included.ts'), '// @pik:select A\nconst a = 1; // @pik:option a');
+        await writeFile(join(testDir, 'excluded.js'), '// @pik:select B\nconst b = 1; // @pik:option b');
+        const scanner = new Scanner({ include: ['*.ts'] });
+        const results = await scanner.scan(testDir);
+        expect(results).toHaveLength(1);
+        expect(results[0].selectors[0].name).toBe('A');
+    });
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@lsst/pik",
+  "version": "0.0.1",
+  "description": "CLI tool for switching config options in source files",
+  "type": "module",
+  "license": "MIT",
+  "author": "Yurii Tatar <lsst25@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lsst25/pik.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "cli",
+    "config",
+    "configuration",
+    "switch",
+    "toggle",
+    "environment",
+    "env"
+  ],
+  "bin": {
+    "pik": "./dist/bin/pik.js"
+  },
+  "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": {
+    "@inquirer/prompts": "^8.1.0",
+    "@lsst/pik-core": "^0.0.1",
+    "commander": "^14.0.2",
+    "glob": "^10.5.0",
+    "picocolors": "^1.1.1",
+    "tslib": "^2.3.0"
+  }
+}