@kynetic-ai/spec 0.1.2 → 0.4.0

package/dist/lib/claude-plugin-registry.js

@@ -0,0 +1,318 @@
+/**
+ * Claude Code plugin marketplace registry library.
+ *
+ * Shared by setup.ts and skill-install.ts for registering the kspec core
+ * skills plugin with Claude Code's global state.
+ *
+ * AC: @core-skill-install ac-6, ac-7, ac-8
+ * AC: @enhanced-setup ac-7, ac-8
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+// ============================================================================
+// Path Resolution
+// ============================================================================
+/**
+ * Get the Claude Code plugins directory.
+ * Respects KSPEC_CLAUDE_HOME env override for test isolation.
+ */
+export function getClaudePluginsDir() {
+    const home = process.env.KSPEC_CLAUDE_HOME || path.join(os.homedir(), ".claude");
+    return path.join(home, "plugins");
+}
+/**
+ * Get the absolute path to the pre-built plugin directory in the npm package.
+ * Uses fs.realpath for symlink/pnpm stability.
+ */
+export async function getPackagePluginDir() {
+    // Resolve relative to this file: src/lib/ -> ../../plugin
+    const rawPath = path.resolve(import.meta.dirname || path.dirname(new URL(import.meta.url).pathname), "../../plugin");
+    try {
+        return await fs.realpath(rawPath);
+    }
+    catch {
+        return rawPath;
+    }
+}
+// ============================================================================
+// Atomic JSON Operations
+// ============================================================================
+/**
+ * Tolerant JSON read — returns default if missing, empty, or corrupt.
+ * Only use for files owned by this module (known_marketplaces.json).
+ */
+async function readJsonSafe(filePath, defaultValue) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        if (!content.trim())
+            return defaultValue;
+        return JSON.parse(content);
+    }
+    catch {
+        return defaultValue;
+    }
+}
+/**
+ * Strict JSON read — throws on corrupt JSON.
+ * Use for files with critical config (settings.json) to avoid silent data loss.
+ */
+async function readJsonStrict(filePath, defaultValue) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        if (!content.trim())
+            return defaultValue;
+        return JSON.parse(content);
+    }
+    catch (err) {
+        // ENOENT = file doesn't exist -> return default
+        if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+            return defaultValue;
+        }
+        // Parse errors or permission errors -> throw
+        throw err;
+    }
+}
+/**
+ * Atomic JSON write — temp file + rename in same directory.
+ * Creates parent directory if needed.
+ */
+async function writeJsonAtomic(filePath, data) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.${Date.now()}.tmp`;
+    const content = JSON.stringify(data, null, 2) + "\n";
+    await fs.writeFile(tmpPath, content, "utf-8");
+    await fs.rename(tmpPath, filePath);
+}
+/**
+ * Read-modify-write with optimistic retry (3 attempts).
+ * Best-effort concurrent safety, not lock-based.
+ */
+async function modifyJsonAtomic(filePath, defaultValue, mutator, options) {
+    const maxAttempts = 3;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const data = options?.strict
+            ? await readJsonStrict(filePath, defaultValue)
+            : await readJsonSafe(filePath, defaultValue);
+        const modified = mutator(data);
+        await writeJsonAtomic(filePath, modified);
+        // Verify write
+        try {
+            const readBack = options?.strict
+                ? await readJsonStrict(filePath, defaultValue)
+                : await readJsonSafe(filePath, defaultValue);
+            const expected = JSON.stringify(modified);
+            const actual = JSON.stringify(readBack);
+            if (expected === actual) {
+                return modified;
+            }
+        }
+        catch {
+            // Read-back failed, retry
+        }
+        if (attempt < maxAttempts - 1) {
+            // Brief delay before retry
+            await new Promise((r) => setTimeout(r, 50 * (attempt + 1)));
+        }
+    }
+    // Final attempt without verification
+    const data = options?.strict
+        ? await readJsonStrict(filePath, defaultValue)
+        : await readJsonSafe(filePath, defaultValue);
+    const modified = mutator(data);
+    await writeJsonAtomic(filePath, modified);
+    return modified;
+}
+// ============================================================================
+// Registration Functions
+// ============================================================================
+const MARKETPLACE_KEY = "kspec-plugins";
+/**
+ * Register the kspec core plugin marketplace in Claude Code's global state.
+ * Writes kspec-plugins entry to known_marketplaces.json.
+ * Only updates lastUpdated when path actually changes (idempotent).
+ * Validates plugin/.claude-plugin/plugin.json exists before registering.
+ *
+ * AC: @core-skill-install ac-6, ac-8
+ */
+export async function registerCorePluginMarketplace(opts) {
+    const dryRun = opts?.dryRun ?? false;
+    try {
+        const pluginDir = await getPackagePluginDir();
+        // Validate plugin directory has the manifest
+        const manifestPath = path.join(pluginDir, ".claude-plugin", "plugin.json");
+        try {
+            await fs.access(manifestPath);
+        }
+        catch {
+            return {
+                success: false,
+                action: "error",
+                message: `Plugin manifest not found at ${manifestPath}. Run 'npm run build' first.`,
+            };
+        }
+        if (dryRun) {
+            return {
+                success: true,
+                action: "skipped",
+                message: `Would register marketplace at ${pluginDir}`,
+                registeredPath: pluginDir,
+            };
+        }
+        const marketplacesPath = path.join(getClaudePluginsDir(), "known_marketplaces.json");
+        const existing = await readJsonSafe(marketplacesPath, {});
+        // Check if already registered with same path
+        const currentEntry = existing[MARKETPLACE_KEY];
+        if (currentEntry && currentEntry.installLocation === pluginDir) {
+            return {
+                success: true,
+                action: "unchanged",
+                message: "Marketplace already registered with correct path",
+                registeredPath: pluginDir,
+            };
+        }
+        // Register or update
+        const action = currentEntry ? "updated" : "registered";
+        await modifyJsonAtomic(marketplacesPath, {}, (data) => ({
+            ...data,
+            [MARKETPLACE_KEY]: {
+                ...data[MARKETPLACE_KEY],
+                source: { source: "directory", path: pluginDir },
+                installLocation: pluginDir,
+                lastUpdated: new Date().toISOString(),
+                autoUpdate: false,
+            },
+        }));
+        return {
+            success: true,
+            action,
+            message: `Marketplace ${action} at ${pluginDir}`,
+            registeredPath: pluginDir,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            action: "error",
+            message: `Registration failed: ${msg}`,
+        };
+    }
+}
+/**
+ * Enable the kspec plugin in a project's .claude/settings.json.
+ * Uses strict JSON read to avoid silently discarding hooks config.
+ *
+ * AC: @core-skill-install ac-7
+ */
+export async function enablePluginInProject(projectDir, opts) {
+    const dryRun = opts?.dryRun ?? false;
+    try {
+        const settingsPath = path.join(projectDir, ".claude", "settings.json");
+        if (dryRun) {
+            return {
+                success: true,
+                action: "unchanged",
+                message: "Would enable kspec@kspec-plugins in project settings",
+            };
+        }
+        const settings = await readJsonStrict(settingsPath, {});
+        const enabledPlugins = (settings.enabledPlugins || {});
+        if (enabledPlugins["kspec@kspec-plugins"] === true) {
+            return {
+                success: true,
+                action: "unchanged",
+                message: "Plugin already enabled in project",
+            };
+        }
+        await modifyJsonAtomic(settingsPath, {}, (data) => ({
+            ...data,
+            enabledPlugins: {
+                ...(data.enabledPlugins || {}),
+                "kspec@kspec-plugins": true,
+            },
+        }), { strict: true });
+        return {
+            success: true,
+            action: "enabled",
+            message: "Plugin enabled in project settings",
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            action: "error",
+            message: `Enablement failed: ${msg}`,
+        };
+    }
+}
+/**
+ * Check the health of the kspec marketplace registration.
+ * Returns status and details for setup --status reporting.
+ *
+ * AC: @enhanced-setup ac-7, ac-8
+ */
+export async function checkMarketplaceHealth() {
+    try {
+        const marketplacesPath = path.join(getClaudePluginsDir(), "known_marketplaces.json");
+        const marketplaces = await readJsonSafe(marketplacesPath, {});
+        const entry = marketplaces[MARKETPLACE_KEY];
+        if (!entry) {
+            return {
+                status: "missing",
+                message: "kspec-plugins marketplace not registered. Run 'kspec setup' to register.",
+            };
+        }
+        const registeredPath = entry.installLocation;
+        // Check if the path is valid
+        const manifestPath = path.join(registeredPath, ".claude-plugin", "plugin.json");
+        try {
+            const content = await fs.readFile(manifestPath, "utf-8");
+            const manifest = JSON.parse(content);
+            // Read current package version for comparison
+            let packageVersion;
+            try {
+                const pkgPath = path.resolve(import.meta.dirname || path.dirname(new URL(import.meta.url).pathname), "../../package.json");
+                const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+                packageVersion = pkg.version;
+            }
+            catch {
+                // Can't determine package version
+            }
+            const pluginVersion = manifest.version;
+            if (packageVersion && pluginVersion && pluginVersion !== packageVersion) {
+                return {
+                    status: "version-mismatch",
+                    registeredPath,
+                    pluginVersion,
+                    packageVersion,
+                    message: `Plugin version ${pluginVersion} doesn't match package version ${packageVersion}`,
+                };
+            }
+            return {
+                status: "healthy",
+                registeredPath,
+                pluginVersion,
+                packageVersion,
+                message: "Marketplace registered and healthy",
+            };
+        }
+        catch {
+            return {
+                status: "path-broken",
+                registeredPath,
+                message: `Registered path is invalid: ${registeredPath}. Run 'kspec setup' to re-register.`,
+            };
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            status: "error",
+            message: `Health check failed: ${msg}`,
+        };
+    }
+}
+//# sourceMappingURL=claude-plugin-registry.js.map

package/dist/lib/claude-plugin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-plugin-registry.js","sourceRoot":"","sources":["../../src/lib/claude-plugin-registry.ts"],"names":[],"mappings":"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"}

package/dist/merge/arrays.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Array merging algorithms for semantic YAML merge.
+ *
+ * Handles different types of arrays:
+ * - ULID-based entity arrays (tasks, notes, inbox items)
+ * - Set-like arrays (tags, depends_on)
+ * - Append-only arrays (notes, todos)
+ */
+import type { ReferenceIndex } from "../parser/refs.js";
+/**
+ * Merge arrays that contain entities with _ulid fields.
+ *
+ * AC: @yaml-merge-driver ac-2
+ * Union merge: both additions included, identified by ULID.
+ *
+ * AC: @yaml-merge-driver ac-5
+ * Append-only arrays (notes, todos) are union merged by ULID.
+ *
+ * Strategy:
+ * 1. Start with all items from base (common ancestor)
+ * 2. Add items from ours that aren't in base (new in our branch)
+ * 3. Add items from theirs that aren't in base (new in their branch)
+ * 4. For items in base that were modified, prefer the modified version
+ *
+ * @param base Array from common ancestor
+ * @param ours Array from current branch
+ * @param theirs Array from incoming branch
+ * @returns Merged array with all items
+ */
+export declare function mergeUlidArrays<T extends {
+    _ulid: string;
+}>(base: T[] | undefined, ours: T[] | undefined, theirs: T[] | undefined): T[];
+/**
+ * Normalize a kspec reference to its canonical ULID form if possible.
+ * Returns the original value if not a ref or resolution fails.
+ *
+ * AC: @merge-ref-normalization ac-2
+ * Graceful degradation: unresolvable refs kept as-is.
+ *
+ * @param value The value to potentially normalize
+ * @param refIndex Optional reference index for resolution
+ * @returns Canonical form (@ULID) or original value
+ */
+export declare function normalizeRef<T extends string | number>(value: T, refIndex?: ReferenceIndex): string | number;
+/**
+ * Merge set-like arrays (tags, depends_on, etc).
+ *
+ * AC: @yaml-merge-driver ac-6
+ * Set union: combine both arrays, remove duplicates.
+ *
+ * AC: @merge-ref-normalization ac-1
+ * For arrays containing kspec refs (depends_on, blocked_by, etc),
+ * normalizes refs to canonical ULID form before comparison to
+ * prevent duplicates when same item is referenced differently.
+ *
+ * Strategy:
+ * 1. Start with items from ours
+ * 2. Add items from theirs that aren't in ours
+ * 3. Remove duplicates (using normalized form for refs)
+ * 4. Preserve original representation (ours takes precedence)
+ *
+ * @param base Array from common ancestor (not used for set merge)
+ * @param ours Array from current branch
+ * @param theirs Array from incoming branch
+ * @param refIndex Optional reference index for normalizing refs
+ * @returns Merged array with unique items
+ */
+export declare function mergeSetArray<T extends string | number>(base: T[] | undefined, ours: T[] | undefined, theirs: T[] | undefined, refIndex?: ReferenceIndex): T[];
+/**
+ * Detect if an item was deleted in one branch.
+ *
+ * Helper for AC: @yaml-merge-driver ac-8
+ * Detect when one version deletes an item while other modifies it.
+ *
+ * @param ulid ULID to check
+ * @param base Base version map
+ * @param ours Ours version map
+ * @param theirs Theirs version map
+ * @returns Whether item was deleted in ours or theirs
+ */
+export declare function detectDeletion(ulid: string, base: Map<string, unknown>, ours: Map<string, unknown>, theirs: Map<string, unknown>): {
+    deletedInOurs: boolean;
+    deletedInTheirs: boolean;
+    modifiedInOurs: boolean;
+    modifiedInTheirs: boolean;
+};
+//# sourceMappingURL=arrays.d.ts.map

package/dist/merge/arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../src/merge/arrays.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,EACrB,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,EACrB,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,GACtB,CAAC,EAAE,CA4CL;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACpD,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,GAAG,MAAM,CAoBjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACrD,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,EACrB,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,EACrB,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EACvB,QAAQ,CAAC,EAAE,cAAc,GACxB,CAAC,EAAE,CA0BL;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B;IACD,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAWA"}

package/dist/merge/arrays.js

@@ -0,0 +1,164 @@
+/**
+ * Array merging algorithms for semantic YAML merge.
+ *
+ * Handles different types of arrays:
+ * - ULID-based entity arrays (tasks, notes, inbox items)
+ * - Set-like arrays (tags, depends_on)
+ * - Append-only arrays (notes, todos)
+ */
+/**
+ * Merge arrays that contain entities with _ulid fields.
+ *
+ * AC: @yaml-merge-driver ac-2
+ * Union merge: both additions included, identified by ULID.
+ *
+ * AC: @yaml-merge-driver ac-5
+ * Append-only arrays (notes, todos) are union merged by ULID.
+ *
+ * Strategy:
+ * 1. Start with all items from base (common ancestor)
+ * 2. Add items from ours that aren't in base (new in our branch)
+ * 3. Add items from theirs that aren't in base (new in their branch)
+ * 4. For items in base that were modified, prefer the modified version
+ *
+ * @param base Array from common ancestor
+ * @param ours Array from current branch
+ * @param theirs Array from incoming branch
+ * @returns Merged array with all items
+ */
+export function mergeUlidArrays(base, ours, theirs) {
+    const baseArr = base ?? [];
+    const oursArr = ours ?? [];
+    const theirsArr = theirs ?? [];
+    // Build lookup maps by ULID
+    const baseMap = new Map(baseArr.map((item) => [item._ulid, item]));
+    const oursMap = new Map(oursArr.map((item) => [item._ulid, item]));
+    const theirsMap = new Map(theirsArr.map((item) => [item._ulid, item]));
+    // Result map - track all unique ULIDs
+    const resultMap = new Map();
+    // Add all items from ours (includes base items that may be modified)
+    for (const item of oursArr) {
+        resultMap.set(item._ulid, item);
+    }
+    // Add items from theirs that aren't in ours
+    for (const item of theirsArr) {
+        if (!oursMap.has(item._ulid)) {
+            // Item was added in theirs - include it
+            resultMap.set(item._ulid, item);
+        }
+        // If item exists in both ours and theirs but differs, we have a conflict
+        // That will be handled by field-level merge (separate function)
+    }
+    // Convert back to array, preserving order (ours first, then theirs additions)
+    const result = [];
+    // Add all items from ours in original order
+    for (const item of oursArr) {
+        result.push(resultMap.get(item._ulid));
+    }
+    // Add new items from theirs that weren't in ours
+    for (const item of theirsArr) {
+        if (!oursMap.has(item._ulid)) {
+            result.push(resultMap.get(item._ulid));
+        }
+    }
+    return result;
+}
+/**
+ * Normalize a kspec reference to its canonical ULID form if possible.
+ * Returns the original value if not a ref or resolution fails.
+ *
+ * AC: @merge-ref-normalization ac-2
+ * Graceful degradation: unresolvable refs kept as-is.
+ *
+ * @param value The value to potentially normalize
+ * @param refIndex Optional reference index for resolution
+ * @returns Canonical form (@ULID) or original value
+ */
+export function normalizeRef(value, refIndex) {
+    // Only process strings that look like refs
+    if (typeof value !== "string" || !value.startsWith("@")) {
+        return value;
+    }
+    // No index available - keep as-is
+    if (!refIndex) {
+        return value;
+    }
+    // Try to resolve
+    const result = refIndex.resolve(value);
+    if (result.ok) {
+        // Return canonical ULID form with @ prefix
+        return `@${result.ulid}`;
+    }
+    // AC: @merge-ref-normalization ac-2 - Resolution failed, keep original
+    return value;
+}
+/**
+ * Merge set-like arrays (tags, depends_on, etc).
+ *
+ * AC: @yaml-merge-driver ac-6
+ * Set union: combine both arrays, remove duplicates.
+ *
+ * AC: @merge-ref-normalization ac-1
+ * For arrays containing kspec refs (depends_on, blocked_by, etc),
+ * normalizes refs to canonical ULID form before comparison to
+ * prevent duplicates when same item is referenced differently.
+ *
+ * Strategy:
+ * 1. Start with items from ours
+ * 2. Add items from theirs that aren't in ours
+ * 3. Remove duplicates (using normalized form for refs)
+ * 4. Preserve original representation (ours takes precedence)
+ *
+ * @param base Array from common ancestor (not used for set merge)
+ * @param ours Array from current branch
+ * @param theirs Array from incoming branch
+ * @param refIndex Optional reference index for normalizing refs
+ * @returns Merged array with unique items
+ */
+export function mergeSetArray(base, ours, theirs, refIndex) {
+    const oursArr = ours ?? [];
+    const theirsArr = theirs ?? [];
+    // Build a map from normalized form -> original value
+    // This preserves the original form while deduplicating by canonical meaning
+    // AC: @merge-ref-normalization ac-1
+    const normalizedToOriginal = new Map();
+    // Add ours first (ours takes precedence for representation)
+    for (const item of oursArr) {
+        const normalized = normalizeRef(item, refIndex);
+        if (!normalizedToOriginal.has(normalized)) {
+            normalizedToOriginal.set(normalized, item);
+        }
+    }
+    // Add theirs (only if not already present in normalized form)
+    for (const item of theirsArr) {
+        const normalized = normalizeRef(item, refIndex);
+        if (!normalizedToOriginal.has(normalized)) {
+            normalizedToOriginal.set(normalized, item);
+        }
+    }
+    return Array.from(normalizedToOriginal.values());
+}
+/**
+ * Detect if an item was deleted in one branch.
+ *
+ * Helper for AC: @yaml-merge-driver ac-8
+ * Detect when one version deletes an item while other modifies it.
+ *
+ * @param ulid ULID to check
+ * @param base Base version map
+ * @param ours Ours version map
+ * @param theirs Theirs version map
+ * @returns Whether item was deleted in ours or theirs
+ */
+export function detectDeletion(ulid, base, ours, theirs) {
+    const inBase = base.has(ulid);
+    const inOurs = ours.has(ulid);
+    const inTheirs = theirs.has(ulid);
+    return {
+        deletedInOurs: inBase && !inOurs && inTheirs,
+        deletedInTheirs: inBase && inOurs && !inTheirs,
+        modifiedInOurs: inBase && inOurs,
+        modifiedInTheirs: inBase && inTheirs,
+    };
+}
+//# sourceMappingURL=arrays.js.map

package/dist/merge/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../src/merge/arrays.ts"],"names":[],"mappings":"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"}

package/dist/merge/file-type.d.ts

@@ -0,0 +1,32 @@
+/**
+ * File type detection for kspec merge driver.
+ *
+ * Determines which merge strategy to apply based on file path patterns.
+ */
+/**
+ * Types of kspec files that require different merge strategies
+ */
+export declare enum FileType {
+    /** Task files: *.tasks.yaml */
+    Tasks = "tasks",
+    /** Inbox files: *.inbox.yaml */
+    Inbox = "inbox",
+    /** Spec module files: modules/*.yaml */
+    SpecModules = "spec_modules",
+    /** Manifest file: kynetic.yaml */
+    Manifest = "manifest",
+    /** Meta file: kynetic.meta.yaml */
+    Meta = "meta",
+    /** Unrecognized files (fallback to default behavior) */
+    Unknown = "unknown"
+}
+/**
+ * Detect the type of a kspec file based on its path.
+ *
+ * Supports both explicit names (kynetic.yaml) and slug-based names ({slug}.yaml).
+ *
+ * @param filePath - Path to the file (can be relative or absolute)
+ * @returns The detected file type
+ */
+export declare function detectFileType(filePath: string): FileType;
+//# sourceMappingURL=file-type.d.ts.map

package/dist/merge/file-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type.d.ts","sourceRoot":"","sources":["../../src/merge/file-type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,+BAA+B;IAC/B,KAAK,UAAU;IACf,gCAAgC;IAChC,KAAK,UAAU;IACf,wCAAwC;IACxC,WAAW,iBAAiB;IAC5B,kCAAkC;IAClC,QAAQ,aAAa;IACrB,mCAAmC;IACnC,IAAI,SAAS;IACb,wDAAwD;IACxD,OAAO,YAAY;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CA+CzD"}