@selvakumaresra/specship 0.1.3 → 0.3.0

package/dist/types.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * SpecShip Type Definitions
+ *
+ * Core types for the semantic knowledge graph system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPEC_FORMATS = exports.SPEC_KINDS = exports.LANGUAGES = exports.NODE_KINDS = void 0;
+// =============================================================================
+// Union Types
+// =============================================================================
+/**
+ * Types of nodes in the knowledge graph.
+ *
+ * Defined as a runtime-iterable `as const` array so the same source
+ * of truth backs both the TS type and any runtime validation
+ * (e.g. the search query parser).
+ */
+exports.NODE_KINDS = [
+    'file',
+    'module',
+    'class',
+    'struct',
+    'interface',
+    'trait',
+    'protocol',
+    'function',
+    'method',
+    'property',
+    'field',
+    'variable',
+    'constant',
+    'enum',
+    'enum_member',
+    'type_alias',
+    'namespace',
+    'parameter',
+    'import',
+    'export',
+    'route',
+    'component',
+    // Spec-layer virtual node projection (v5). The heavy spec content lives in
+    // the `specs` table; a thin row in `nodes` with kind='spec' lets the
+    // existing traversal machinery (specship_explore, edges) cross from spec
+    // to code transparently.
+    'spec',
+];
+/**
+ * Supported programming languages. See NODE_KINDS for why this is a
+ * runtime-iterable const array.
+ */
+exports.LANGUAGES = [
+    'typescript',
+    'javascript',
+    'tsx',
+    'jsx',
+    'python',
+    'go',
+    'rust',
+    'java',
+    'c',
+    'cpp',
+    'csharp',
+    'php',
+    'ruby',
+    'swift',
+    'kotlin',
+    'dart',
+    'svelte',
+    'vue',
+    'liquid',
+    'pascal',
+    'scala',
+    'lua',
+    'luau',
+    'objc',
+    'yaml',
+    'twig',
+    'xml',
+    'properties',
+    'unknown',
+];
+// =============================================================================
+// Spec Layer (schema v5)
+// =============================================================================
+/**
+ * Kind of spec entity. Specs are stored in their own table but project a
+ * thin row into `nodes` with kind='spec' so graph traversal works transparently.
+ *
+ * - `document`: the spec file's top-level container
+ * - `requirement`: a specific requirement under a document
+ * - `acceptance`: an acceptance criterion under a requirement
+ * - `contract`: an API/data contract (OpenAPI, AsyncAPI, etc.)
+ * - `data_schema`: a data shape definition
+ */
+exports.SPEC_KINDS = [
+    'document',
+    'requirement',
+    'acceptance',
+    'contract',
+    'data_schema',
+];
+/**
+ * Spec source format. Each format has its own extractor under
+ * `src/extraction/specs/`.
+ */
+exports.SPEC_FORMATS = ['markdown', 'yaml', 'gherkin', 'openapi'];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;GAMG;AACU,QAAA,UAAU,GAAG;IACxB,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,WAAW;IACX,OAAO;IACP,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,WAAW;IACX,2EAA2E;IAC3E,qEAAqE;IACrE,yEAAyE;IACzE,yBAAyB;IACzB,MAAM;CACE,CAAC;AAuBX;;;GAGG;AACU,QAAA,SAAS,GAAG;IACvB,YAAY;IACZ,YAAY;IACZ,KAAK;IACL,KAAK;IACL,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,MAAM;IACN,GAAG;IACH,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,YAAY;IACZ,SAAS;CACD,CAAC;AA0eX,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;;GASG;AACU,QAAA,UAAU,GAAG;IACxB,UAAU;IACV,aAAa;IACb,YAAY;IACZ,UAAU;IACV,aAAa;CACL,CAAC;AAIX;;;GAGG;AACU,QAAA,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC"}

package/dist/ui/glyphs.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Glyph selection for CLI output.
+ *
+ * On Windows, console output is interpreted via the active output
+ * codepage. PowerShell 5.1 and cmd.exe default to OEM codepages
+ * (CP437, CP936, ...), so UTF-8 bytes written to the console render
+ * as mojibake (see #168). The shimmer worker is hit hardest because
+ * it uses `fs.writeSync(1, ...)` (raw bytes, no TTY-aware encoding
+ * conversion) to keep animation smooth while the main thread is
+ * blocked in SQLite. To stay readable everywhere, we fall back to
+ * ASCII glyphs whenever the terminal is not known to handle UTF-8.
+ *
+ * Detection is intentionally simple:
+ *   - `SPECSHIP_ASCII=1`  -> ASCII (escape hatch for any terminal)
+ *   - `SPECSHIP_UNICODE=1` -> Unicode (opt-in on Windows)
+ *   - Windows              -> ASCII by default
+ *   - Linux kernel console (`TERM=linux`) -> ASCII
+ *   - Everything else      -> Unicode
+ */
+export declare function supportsUnicode(): boolean;
+export interface Glyphs {
+    ok: string;
+    err: string;
+    info: string;
+    warn: string;
+    spinner: string[];
+    barFilled: string;
+    barEmpty: string;
+    rail: string;
+    phaseDone: string;
+    dash: string;
+    hLine: string;
+    treeBranch: string;
+    treeLast: string;
+    treePipe: string;
+}
+export declare const UNICODE_GLYPHS: Glyphs;
+export declare const ASCII_GLYPHS: Glyphs;
+export declare function getGlyphs(): Glyphs;
+/** Reset the cached glyph set. Test-only; production code should call `getGlyphs()`. */
+export declare function _resetGlyphsCache(): void;
+//# sourceMappingURL=glyphs.d.ts.map

package/dist/ui/glyphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.d.ts","sourceRoot":"","sources":["../../src/ui/glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,MAe5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAe1B,CAAC;AAIF,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/ui/glyphs.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Glyph selection for CLI output.
+ *
+ * On Windows, console output is interpreted via the active output
+ * codepage. PowerShell 5.1 and cmd.exe default to OEM codepages
+ * (CP437, CP936, ...), so UTF-8 bytes written to the console render
+ * as mojibake (see #168). The shimmer worker is hit hardest because
+ * it uses `fs.writeSync(1, ...)` (raw bytes, no TTY-aware encoding
+ * conversion) to keep animation smooth while the main thread is
+ * blocked in SQLite. To stay readable everywhere, we fall back to
+ * ASCII glyphs whenever the terminal is not known to handle UTF-8.
+ *
+ * Detection is intentionally simple:
+ *   - `SPECSHIP_ASCII=1`  -> ASCII (escape hatch for any terminal)
+ *   - `SPECSHIP_UNICODE=1` -> Unicode (opt-in on Windows)
+ *   - Windows              -> ASCII by default
+ *   - Linux kernel console (`TERM=linux`) -> ASCII
+ *   - Everything else      -> Unicode
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASCII_GLYPHS = exports.UNICODE_GLYPHS = void 0;
+exports.supportsUnicode = supportsUnicode;
+exports.getGlyphs = getGlyphs;
+exports._resetGlyphsCache = _resetGlyphsCache;
+function supportsUnicode() {
+    if (process.env.SPECSHIP_ASCII === '1')
+        return false;
+    if (process.env.SPECSHIP_UNICODE === '1')
+        return true;
+    if (process.platform === 'win32')
+        return false;
+    return process.env.TERM !== 'linux';
+}
+exports.UNICODE_GLYPHS = {
+    ok: '✓',
+    err: '✗',
+    info: 'ℹ',
+    warn: '⚠',
+    spinner: ['·', '✢', '✳', '✶', '✻', '✽'],
+    barFilled: '█',
+    barEmpty: '░',
+    rail: '│',
+    phaseDone: '◆',
+    dash: '—',
+    hLine: '─',
+    treeBranch: '├── ',
+    treeLast: '└── ',
+    treePipe: '│   ',
+};
+exports.ASCII_GLYPHS = {
+    ok: '[OK]',
+    err: '[ERR]',
+    info: '[i]',
+    warn: '[!]',
+    spinner: ['.', '*', '+', 'x', 'o', 'O'],
+    barFilled: '#',
+    barEmpty: '-',
+    rail: '|',
+    phaseDone: '*',
+    dash: '-',
+    hLine: '-',
+    treeBranch: '|-- ',
+    treeLast: '`-- ',
+    treePipe: '|   ',
+};
+let cached = null;
+function getGlyphs() {
+    if (cached === null) {
+        cached = supportsUnicode() ? exports.UNICODE_GLYPHS : exports.ASCII_GLYPHS;
+    }
+    return cached;
+}
+/** Reset the cached glyph set. Test-only; production code should call `getGlyphs()`. */
+function _resetGlyphsCache() {
+    cached = null;
+}
+//# sourceMappingURL=glyphs.js.map

package/dist/ui/glyphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.js","sourceRoot":"","sources":["../../src/ui/glyphs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,0CAKC;AAuDD,8BAKC;AAGD,8CAEC;AAtED,SAAgB,eAAe;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AACtC,CAAC;AAmBY,QAAA,cAAc,GAAW;IACpC,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACvC,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,GAAG;IACd,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEW,QAAA,YAAY,GAAW;IAClC,EAAE,EAAE,MAAM;IACV,GAAG,EAAE,OAAO;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACvC,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,GAAG;IACd,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEF,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAgB,SAAS;IACvB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC,sBAAc,CAAC,CAAC,CAAC,oBAAY,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,SAAgB,iBAAiB;IAC/B,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/ui/shimmer-progress.d.ts

@@ -0,0 +1,11 @@
+export interface IndexProgress {
+    phase: string;
+    current: number;
+    total: number;
+}
+export interface ShimmerProgress {
+    onProgress: (progress: IndexProgress) => void;
+    stop: () => Promise<void>;
+}
+export declare function createShimmerProgress(): ShimmerProgress;
+//# sourceMappingURL=shimmer-progress.d.ts.map

package/dist/ui/shimmer-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer-progress.d.ts","sourceRoot":"","sources":["../../src/ui/shimmer-progress.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC9C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAmDvD"}

package/dist/ui/shimmer-progress.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createShimmerProgress = createShimmerProgress;
+const worker_threads_1 = require("worker_threads");
+const path = __importStar(require("path"));
+const PHASE_NAMES = {
+    scanning: 'Scanning files',
+    parsing: 'Parsing code',
+    storing: 'Storing data',
+    resolving: 'Resolving refs',
+};
+function createShimmerProgress() {
+    let lastPhase = '';
+    const workerPath = path.join(__dirname, 'shimmer-worker.js');
+    const worker = new worker_threads_1.Worker(workerPath, {
+        workerData: { startTime: Date.now() },
+    });
+    return {
+        onProgress(progress) {
+            const phaseName = PHASE_NAMES[progress.phase] || progress.phase;
+            if (progress.phase !== lastPhase && lastPhase) {
+                worker.postMessage({ type: 'finish-phase' });
+            }
+            lastPhase = progress.phase;
+            let percent = -1;
+            let count = 0;
+            if (progress.total > 0) {
+                percent = Math.round((progress.current / progress.total) * 100);
+            }
+            else if (progress.current > 0) {
+                count = progress.current;
+            }
+            worker.postMessage({
+                type: 'update',
+                phase: progress.phase,
+                phaseName,
+                percent,
+                count,
+            });
+        },
+        stop() {
+            return new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    worker.terminate().then(() => resolve());
+                }, 2000);
+                worker.on('message', (msg) => {
+                    if (msg.type === 'stopped') {
+                        clearTimeout(timeout);
+                        worker.terminate().then(() => resolve());
+                    }
+                });
+                worker.postMessage({ type: 'stop' });
+            });
+        },
+    };
+}
+//# sourceMappingURL=shimmer-progress.js.map

package/dist/ui/shimmer-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer-progress.js","sourceRoot":"","sources":["../../src/ui/shimmer-progress.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,sDAmDC;AAxED,mDAAwC;AACxC,2CAA6B;AAE7B,MAAM,WAAW,GAA2B;IAC1C,QAAQ,EAAE,gBAAgB;IAC1B,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;CAC5B,CAAC;AAaF,SAAgB,qBAAqB;IACnC,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,uBAAM,CAAC,UAAU,EAAE;QACpC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,CAAC,QAAuB;YAChC,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC;YAEhE,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC9C,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC;YAE3B,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;YACjB,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;YAClE,CAAC;iBAAM,IAAI,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;YAC3B,CAAC;YAED,MAAM,CAAC,WAAW,CAAC;gBACjB,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS;gBACT,OAAO;gBACP,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,IAAI;YACF,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3C,CAAC,EAAE,IAAI,CAAC,CAAC;gBAET,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAqB,EAAE,EAAE;oBAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;wBACtB,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ui/shimmer-worker.d.ts

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

package/dist/ui/shimmer-worker.d.ts.map

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

package/dist/ui/shimmer-worker.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const fs_1 = require("fs");
+const glyphs_1 = require("./glyphs");
+// Write directly to fd 1 (stdout) instead of writeStdout().
+// In Node.js worker threads, process.stdout is proxied through the main
+// thread's event loop — so if the main thread is blocked (e.g. SQLite),
+// stdout writes from the worker queue up and the animation freezes.
+// fs.writeSync(1, ...) is a direct kernel syscall that bypasses this.
+//
+// Side effect: bypasses Node's TTY-aware encoding conversion on Windows,
+// so UTF-8 bytes hit the console raw and mojibake on OEM codepages.
+// `getGlyphs()` returns ASCII fallbacks on Windows to avoid this (#168).
+function writeStdout(s) {
+    (0, fs_1.writeSync)(1, s);
+}
+const G = (0, glyphs_1.getGlyphs)();
+const SPINNER_GLYPHS = G.spinner;
+const ANIM_INTERVAL = 150;
+const FRAMES_PER_GLYPH = 3;
+const RST = '\x1b[0m';
+const DM = '\x1b[2m';
+const GRN = '\x1b[32m';
+const BOLD = '\x1b[1m';
+const startTime = worker_threads_1.workerData.startTime;
+function animFrame() {
+    return Math.floor((Date.now() - startTime) / ANIM_INTERVAL);
+}
+function lerp(a, b, t) {
+    return Math.round(a + (b - a) * t);
+}
+function shimmerColor(frame) {
+    const t = (Math.sin(frame * 2 * Math.PI / 13) + 1) / 2;
+    const r = lerp(160, 251, t);
+    const g = lerp(100, 191, t);
+    const b = lerp(9, 36, t);
+    return `\x1b[38;2;${r};${g};${b}m${BOLD}`;
+}
+function formatNumber(n) {
+    return n.toLocaleString();
+}
+function renderBar(frame, filled, empty) {
+    if (filled === 0)
+        return `${DM}${G.barEmpty.repeat(empty)}${RST}`;
+    const cycleFrames = 24;
+    const shimmerPos = ((frame % cycleFrames) / cycleFrames) * (filled + 6) - 3;
+    const shimmerWidth = 3;
+    let bar = '';
+    for (let i = 0; i < filled; i++) {
+        const dist = Math.abs(i - shimmerPos);
+        const t = Math.max(0, 1 - dist / shimmerWidth);
+        const r = lerp(160, 251, t);
+        const g = lerp(100, 191, t);
+        const b = lerp(9, 36, t);
+        bar += `\x1b[38;2;${r};${g};${b}m${BOLD}${G.barFilled}`;
+    }
+    bar += `${RST}${DM}${G.barEmpty.repeat(empty)}${RST}`;
+    return bar;
+}
+// Mutable state
+let currentMessage = '';
+let currentPercent = -1;
+let currentCount = 0;
+function render() {
+    if (!currentMessage)
+        return;
+    const frame = animFrame();
+    const glyphIdx = Math.floor(frame / FRAMES_PER_GLYPH) % SPINNER_GLYPHS.length;
+    const glyph = SPINNER_GLYPHS[glyphIdx] ?? SPINNER_GLYPHS[0] ?? '.';
+    const color = shimmerColor(frame);
+    let line;
+    if (currentPercent >= 0) {
+        const barWidth = 25;
+        const filled = Math.round(barWidth * currentPercent / 100);
+        const empty = barWidth - filled;
+        line = `${DM}${G.rail}${RST}  ${color}${glyph}${RST} ${currentMessage}  ${renderBar(frame, filled, empty)}  ${currentPercent}%`;
+    }
+    else if (currentCount > 0) {
+        line = `${DM}${G.rail}${RST}  ${color}${glyph}${RST} ${currentMessage}... ${formatNumber(currentCount)} found`;
+    }
+    else {
+        line = `${DM}${G.rail}${RST}  ${color}${glyph}${RST} ${currentMessage}...`;
+    }
+    writeStdout(`\r\x1b[K${line}`);
+}
+function finishPhase() {
+    if (!currentMessage)
+        return;
+    writeStdout(`\r\x1b[K`);
+    let detail = '';
+    if (currentPercent >= 0)
+        detail = ` ${G.dash} done`;
+    else if (currentCount > 0)
+        detail = ` ${G.dash} ${formatNumber(currentCount)} found`;
+    writeStdout(`${DM}${G.rail}${RST}  ${GRN}${G.phaseDone}${RST} ${currentMessage}${detail}\n`);
+    currentMessage = '';
+    currentPercent = -1;
+    currentCount = 0;
+}
+// Render loop — independent of main thread
+const tickInterval = setInterval(render, 50);
+worker_threads_1.parentPort.on('message', (msg) => {
+    if (msg.type === 'update') {
+        currentMessage = msg.phaseName;
+        currentPercent = msg.percent;
+        currentCount = msg.count;
+    }
+    else if (msg.type === 'finish-phase') {
+        finishPhase();
+    }
+    else if (msg.type === 'stop') {
+        clearInterval(tickInterval);
+        finishPhase();
+        worker_threads_1.parentPort.postMessage({ type: 'stopped' });
+    }
+});
+//# sourceMappingURL=shimmer-worker.js.map

package/dist/ui/shimmer-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer-worker.js","sourceRoot":"","sources":["../../src/ui/shimmer-worker.ts"],"names":[],"mappings":";;AAAA,mDAAwD;AACxD,2BAA+B;AAC/B,qCAAqC;AAGrC,4DAA4D;AAC5D,wEAAwE;AACxE,wEAAwE;AACxE,oEAAoE;AACpE,sEAAsE;AACtE,EAAE;AACF,yEAAyE;AACzE,oEAAoE;AACpE,yEAAyE;AACzE,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAA,cAAS,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,GAAG,IAAA,kBAAS,GAAE,CAAC;AACtB,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC;AACjC,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,EAAE,GAAG,SAAS,CAAC;AACrB,MAAM,GAAG,GAAG,UAAU,CAAC;AACvB,MAAM,IAAI,GAAG,SAAS,CAAC;AAEvB,MAAM,SAAS,GAAW,2BAAU,CAAC,SAAS,CAAC;AAE/C,SAAS,SAAS;IAChB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,MAAc,EAAE,KAAa;IAC7D,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;IAClE,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,CAAC,CAAC;IACvB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACzB,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;IAC1D,CAAC;IACD,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gBAAgB;AAChB,IAAI,cAAc,GAAG,EAAE,CAAC;AACxB,IAAI,cAAc,GAAG,CAAC,CAAC,CAAC;AACxB,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,SAAS,MAAM;IACb,IAAI,CAAC,cAAc;QAAE,OAAO;IAC5B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC;IAC9E,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAElC,IAAI,IAAY,CAAC;IACjB,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,cAAc,GAAG,GAAG,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QAChC,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,KAAK,GAAG,KAAK,GAAG,GAAG,IAAI,cAAc,KAAK,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,cAAc,GAAG,CAAC;IAClI,CAAC;SAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,KAAK,GAAG,KAAK,GAAG,GAAG,IAAI,cAAc,OAAO,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC;IACjH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,KAAK,GAAG,KAAK,GAAG,GAAG,IAAI,cAAc,KAAK,CAAC;IAC7E,CAAC;IAED,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC,cAAc;QAAE,OAAO;IAC5B,WAAW,CAAC,UAAU,CAAC,CAAC;IACxB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,cAAc,IAAI,CAAC;QAAE,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC;SAC/C,IAAI,YAAY,GAAG,CAAC;QAAE,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC;IACrF,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,IAAI,cAAc,GAAG,MAAM,IAAI,CAAC,CAAC;IAC7F,cAAc,GAAG,EAAE,CAAC;IACpB,cAAc,GAAG,CAAC,CAAC,CAAC;IACpB,YAAY,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,2CAA2C;AAC3C,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE7C,2BAAW,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAyB,EAAE,EAAE;IACtD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,cAAc,GAAG,GAAG,CAAC,SAAS,CAAC;QAC/B,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;QAC7B,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC;IAC3B,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACvC,WAAW,EAAE,CAAC;IAChB,CAAC;SAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5B,WAAW,EAAE,CAAC;QACd,2BAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/ui/types.d.ts

@@ -0,0 +1,17 @@
+/** Messages from main thread to worker */
+export type ShimmerWorkerMessage = {
+    type: 'update';
+    phase: string;
+    phaseName: string;
+    percent: number;
+    count: number;
+} | {
+    type: 'finish-phase';
+} | {
+    type: 'stop';
+};
+/** Messages from worker to main thread */
+export type ShimmerMainMessage = {
+    type: 'stopped';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ui/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,0CAA0C;AAC1C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC"}

package/dist/ui/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ui/types.ts"],"names":[],"mappings":""}