@mxpicture/build-api 0.2.56 → 0.2.58

package/dist/types/types.run.d.ts

@@ -1,4 +1,8 @@
+/**
+ * Base parameters for operations that run against a repository root.
+ */
 export interface RunRepoRootParams {
+    /** Absolute path to the repository root directory. */
     repoRoot: string;
 }
 //# sourceMappingURL=types.run.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.run.d.ts","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.run.d.ts","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/types.run.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.run.js","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"","sourcesContent":["export interface RunRepoRootParams {\n  repoRoot: string;\n}\n"]}
+{"version":3,"file":"types.run.js","sourceRoot":"","sources":["../../src/types/types.run.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Base parameters for operations that run against a repository root.\n */\nexport interface RunRepoRootParams {\n  /** Absolute path to the repository root directory. */\n  repoRoot: string;\n}\n"]}

package/dist/types/types.vscode.d.ts

@@ -1,37 +1,83 @@
+/**
+ * A resolved VS Code user profile.
+ */
 export interface VSCodeProfile {
+    /** Unique location identifier for the profile. */
     location: string;
+    /** Human-readable display name of the profile. */
     name: string;
+    /** Absolute path to the profile's `settings.json` file. */
     settingsPath: string;
 }
+/**
+ * The persisted VS Code storage structure that tracks user-data profiles
+ * and their workspace associations.
+ *
+ * @remarks
+ * Mirrors the shape of VS Code's internal `storage.json` file.
+ */
 export interface VSCodeStorage {
+    /** Array of user-data profiles configured in VS Code. */
     userDataProfiles: {
+        /** Unique location identifier for the profile. */
         location: string;
+        /** Human-readable display name. */
         name: string;
+        /** Icon identifier for the profile. */
         icon: string;
+        /** Optional flags indicating which settings categories use the default profile. */
         useDefaultFlags?: {
+            /** Use default settings. */
             settings?: boolean;
+            /** Use default keybindings. */
             keybindings?: boolean;
+            /** Use default snippets. */
             snippets?: boolean;
+            /** Use default tasks. */
             tasks?: boolean;
+            /** Use default extensions. */
             extensions?: boolean;
         };
     }[];
+    /** Maps workspace identifiers to profile locations. */
     profileAssociations: {
+        /** Workspace-to-profile mapping. */
         workspaces: {
             [key: string]: string;
         };
     };
 }
+/**
+ * A VS Code `settings.json` object represented as a generic record.
+ */
 export type VSCodeSettings = Record<string, unknown>;
+/**
+ * A single folder entry within a VS Code multi-root workspace.
+ */
 export interface VSCodeWorkspaceFolder {
+    /** Relative or absolute path to the folder. */
     path: string;
+    /** Optional display name for the folder in the VS Code explorer. */
     name?: string;
+    /** Optional URI representation of the folder. */
     uri?: string;
 }
+/**
+ * A VS Code `.code-workspace` file structure.
+ *
+ * @remarks
+ * Represents the top-level shape of a multi-root workspace configuration
+ * including folders, settings, launch configurations, and extension
+ * recommendations.
+ */
 export interface VSCodeWorkspace {
+    /** The folders included in this multi-root workspace. */
     folders: VSCodeWorkspaceFolder[];
+    /** Workspace-level settings overrides. */
     settings?: Record<string, unknown>;
+    /** Workspace-level launch/debug configurations. */
     launch?: Record<string, unknown>;
+    /** Workspace-level extension recommendations. */
     extensions?: Record<string, unknown>;
 }
 //# sourceMappingURL=types.vscode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.vscode.d.ts","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE;YAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,UAAU,CAAC,EAAE,OAAO,CAAC;SACtB,CAAC;KACH,EAAE,CAAC;IACJ,mBAAmB,EAAE;QACnB,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACvC,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}
+{"version":3,"file":"types.vscode.d.ts","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,gBAAgB,EAAE;QAChB,kDAAkD;QAClD,QAAQ,EAAE,MAAM,CAAC;QACjB,mCAAmC;QACnC,IAAI,EAAE,MAAM,CAAC;QACb,uCAAuC;QACvC,IAAI,EAAE,MAAM,CAAC;QACb,mFAAmF;QACnF,eAAe,CAAC,EAAE;YAChB,4BAA4B;YAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,+BAA+B;YAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,4BAA4B;YAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,yBAAyB;YACzB,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,8BAA8B;YAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;SACtB,CAAC;KACH,EAAE,CAAC;IACJ,uDAAuD;IACvD,mBAAmB,EAAE;QACnB,oCAAoC;QACpC,UAAU,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}

package/dist/types/types.vscode.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.vscode.js","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"","sourcesContent":["export interface VSCodeProfile {\n  location: string;\n  name: string;\n  settingsPath: string;\n}\n\nexport interface VSCodeStorage {\n  userDataProfiles: {\n    location: string;\n    name: string;\n    icon: string;\n    useDefaultFlags?: {\n      settings?: boolean;\n      keybindings?: boolean;\n      snippets?: boolean;\n      tasks?: boolean;\n      extensions?: boolean;\n    };\n  }[];\n  profileAssociations: {\n    workspaces: { [key: string]: string };\n  };\n}\n\nexport type VSCodeSettings = Record<string, unknown>;\n\nexport interface VSCodeWorkspaceFolder {\n  path: string;\n  name?: string;\n  uri?: string;\n}\n\nexport interface VSCodeWorkspace {\n  folders: VSCodeWorkspaceFolder[];\n  settings?: Record<string, unknown>;\n  launch?: Record<string, unknown>;\n  extensions?: Record<string, unknown>;\n}\n"]}
+{"version":3,"file":"types.vscode.js","sourceRoot":"","sources":["../../src/types/types.vscode.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A resolved VS Code user profile.\n */\nexport interface VSCodeProfile {\n  /** Unique location identifier for the profile. */\n  location: string;\n  /** Human-readable display name of the profile. */\n  name: string;\n  /** Absolute path to the profile's `settings.json` file. */\n  settingsPath: string;\n}\n\n/**\n * The persisted VS Code storage structure that tracks user-data profiles\n * and their workspace associations.\n *\n * @remarks\n * Mirrors the shape of VS Code's internal `storage.json` file.\n */\nexport interface VSCodeStorage {\n  /** Array of user-data profiles configured in VS Code. */\n  userDataProfiles: {\n    /** Unique location identifier for the profile. */\n    location: string;\n    /** Human-readable display name. */\n    name: string;\n    /** Icon identifier for the profile. */\n    icon: string;\n    /** Optional flags indicating which settings categories use the default profile. */\n    useDefaultFlags?: {\n      /** Use default settings. */\n      settings?: boolean;\n      /** Use default keybindings. */\n      keybindings?: boolean;\n      /** Use default snippets. */\n      snippets?: boolean;\n      /** Use default tasks. */\n      tasks?: boolean;\n      /** Use default extensions. */\n      extensions?: boolean;\n    };\n  }[];\n  /** Maps workspace identifiers to profile locations. */\n  profileAssociations: {\n    /** Workspace-to-profile mapping. */\n    workspaces: { [key: string]: string };\n  };\n}\n\n/**\n * A VS Code `settings.json` object represented as a generic record.\n */\nexport type VSCodeSettings = Record<string, unknown>;\n\n/**\n * A single folder entry within a VS Code multi-root workspace.\n */\nexport interface VSCodeWorkspaceFolder {\n  /** Relative or absolute path to the folder. */\n  path: string;\n  /** Optional display name for the folder in the VS Code explorer. */\n  name?: string;\n  /** Optional URI representation of the folder. */\n  uri?: string;\n}\n\n/**\n * A VS Code `.code-workspace` file structure.\n *\n * @remarks\n * Represents the top-level shape of a multi-root workspace configuration\n * including folders, settings, launch configurations, and extension\n * recommendations.\n */\nexport interface VSCodeWorkspace {\n  /** The folders included in this multi-root workspace. */\n  folders: VSCodeWorkspaceFolder[];\n  /** Workspace-level settings overrides. */\n  settings?: Record<string, unknown>;\n  /** Workspace-level launch/debug configurations. */\n  launch?: Record<string, unknown>;\n  /** Workspace-level extension recommendations. */\n  extensions?: Record<string, unknown>;\n}\n"]}

package/dist/types/types.workspace.d.ts

@@ -1,16 +1,34 @@
+/**
+ * The structure of a `pnpm-workspace.yaml` file.
+ */
 export interface PnpmWorkspace {
+    /** Glob patterns identifying the packages in the workspace. */
     packages: string[];
 }
+/**
+ * Classification of files discovered within a workspace.
+ */
 export declare enum WorkspaceFileType {
+    /** A `package.json` file. */
     package = "package",
+    /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */
     workspace = "workspace",
+    /** Any other file type. */
     other = "other"
 }
+/**
+ * Metadata for a file discovered while scanning a workspace directory tree.
+ */
 export interface WorkspaceFile {
+    /** Absolute path to the file. */
     filePath: string;
+    /** Absolute path to the directory containing the file. */
     dirPath: string;
+    /** The base filename (e.g. `"package.json"`). */
     filename: string;
+    /** Nesting depth relative to the workspace root (0 = root). */
     level: number;
+    /** The classified type of this workspace file. */
     type: WorkspaceFileType;
 }
 //# sourceMappingURL=types.workspace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.workspace.d.ts","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,oBAAY,iBAAiB;IAC3B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;CACzB"}
+{"version":3,"file":"types.workspace.d.ts","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,6BAA6B;IAC7B,OAAO,YAAY;IACnB,mEAAmE;IACnE,SAAS,cAAc;IACvB,2BAA2B;IAC3B,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,IAAI,EAAE,iBAAiB,CAAC;CACzB"}

package/dist/types/types.workspace.js

@@ -1,7 +1,13 @@
+/**
+ * Classification of files discovered within a workspace.
+ */
 export var WorkspaceFileType;
 (function (WorkspaceFileType) {
+    /** A `package.json` file. */
     WorkspaceFileType["package"] = "package";
+    /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */
     WorkspaceFileType["workspace"] = "workspace";
+    /** Any other file type. */
     WorkspaceFileType["other"] = "other";
 })(WorkspaceFileType || (WorkspaceFileType = {}));
 //# sourceMappingURL=types.workspace.js.map

package/dist/types/types.workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.workspace.js","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,oCAAe,CAAA;AACjB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B","sourcesContent":["export interface PnpmWorkspace {\n  packages: string[];\n}\n\nexport enum WorkspaceFileType {\n  package = \"package\",\n  workspace = \"workspace\",\n  other = \"other\",\n}\n\nexport interface WorkspaceFile {\n  filePath: string;\n  dirPath: string;\n  filename: string;\n  level: number;\n  type: WorkspaceFileType;\n}\n"]}
+{"version":3,"file":"types.workspace.js","sourceRoot":"","sources":["../../src/types/types.workspace.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,6BAA6B;IAC7B,wCAAmB,CAAA;IACnB,mEAAmE;IACnE,4CAAuB,CAAA;IACvB,2BAA2B;IAC3B,oCAAe,CAAA;AACjB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B","sourcesContent":["/**\n * The structure of a `pnpm-workspace.yaml` file.\n */\nexport interface PnpmWorkspace {\n  /** Glob patterns identifying the packages in the workspace. */\n  packages: string[];\n}\n\n/**\n * Classification of files discovered within a workspace.\n */\nexport enum WorkspaceFileType {\n  /** A `package.json` file. */\n  package = \"package\",\n  /** A workspace configuration file (e.g. `pnpm-workspace.yaml`). */\n  workspace = \"workspace\",\n  /** Any other file type. */\n  other = \"other\",\n}\n\n/**\n * Metadata for a file discovered while scanning a workspace directory tree.\n */\nexport interface WorkspaceFile {\n  /** Absolute path to the file. */\n  filePath: string;\n  /** Absolute path to the directory containing the file. */\n  dirPath: string;\n  /** The base filename (e.g. `\"package.json\"`). */\n  filename: string;\n  /** Nesting depth relative to the workspace root (0 = root). */\n  level: number;\n  /** The classified type of this workspace file. */\n  type: WorkspaceFileType;\n}\n"]}

package/dist/vscode/vscode.config.d.ts

@@ -1,3 +1,21 @@
+/**
+ * Returns the absolute path to the VS Code configuration directory.
+ *
+ * @remarks
+ * The path is resolved by appending `"Code"` to the OS-specific
+ * configuration directory provided by {@link osInfo}.
+ *
+ * @returns The absolute path to the VS Code `Code` configuration directory.
+ */
 export declare const configPath: () => string;
+/**
+ * Returns the absolute path to the VS Code `User` configuration directory.
+ *
+ * @remarks
+ * This is the directory that contains per-user settings, keybindings,
+ * snippets, and profile data.
+ *
+ * @returns The absolute path to the `User` subdirectory inside {@link configPath}.
+ */
 export declare const configUserPath: () => string;
 //# sourceMappingURL=vscode.config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vscode.config.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAAO,MAA0C,CAAC;AACzE,eAAO,MAAM,cAAc,QAAO,MAAoC,CAAC"}
+{"version":3,"file":"vscode.config.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,QAAO,MAA0C,CAAC;AAEzE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,QAAO,MAAoC,CAAC"}

package/dist/vscode/vscode.config.js

@@ -1,5 +1,23 @@
 import { join } from "node:path";
 import { osInfo } from "../osInfo/osInfo.common.js";
+/**
+ * Returns the absolute path to the VS Code configuration directory.
+ *
+ * @remarks
+ * The path is resolved by appending `"Code"` to the OS-specific
+ * configuration directory provided by {@link osInfo}.
+ *
+ * @returns The absolute path to the VS Code `Code` configuration directory.
+ */
 export const configPath = () => join(osInfo().configDir, "Code");
+/**
+ * Returns the absolute path to the VS Code `User` configuration directory.
+ *
+ * @remarks
+ * This is the directory that contains per-user settings, keybindings,
+ * snippets, and profile data.
+ *
+ * @returns The absolute path to the `User` subdirectory inside {@link configPath}.
+ */
 export const configUserPath = () => join(configPath(), "User");
 //# sourceMappingURL=vscode.config.js.map

package/dist/vscode/vscode.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.config.js","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { osInfo } from \"../osInfo/osInfo.common.js\";\n\nexport const configPath = (): string => join(osInfo().configDir, \"Code\");\nexport const configUserPath = (): string => join(configPath(), \"User\");\n"]}
+{"version":3,"file":"vscode.config.js","sourceRoot":"","sources":["../../src/vscode/vscode.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { osInfo } from \"../osInfo/osInfo.common.js\";\n\n/**\n * Returns the absolute path to the VS Code configuration directory.\n *\n * @remarks\n * The path is resolved by appending `\"Code\"` to the OS-specific\n * configuration directory provided by {@link osInfo}.\n *\n * @returns The absolute path to the VS Code `Code` configuration directory.\n */\nexport const configPath = (): string => join(osInfo().configDir, \"Code\");\n\n/**\n * Returns the absolute path to the VS Code `User` configuration directory.\n *\n * @remarks\n * This is the directory that contains per-user settings, keybindings,\n * snippets, and profile data.\n *\n * @returns The absolute path to the `User` subdirectory inside {@link configPath}.\n */\nexport const configUserPath = (): string => join(configPath(), \"User\");\n"]}

package/dist/vscode/vscode.profiles.d.ts

@@ -1,6 +1,43 @@
 import { VSCodeProfile } from "../types/types.vscode.js";
+/**
+ * Returns all VS Code user-data profiles.
+ *
+ * @remarks
+ * Each profile is resolved from the persisted {@link storage} and enriched
+ * with the absolute path to its `settings.json` via {@link profileSettingsPath}.
+ *
+ * @returns An array of {@link VSCodeProfile} objects for every configured profile.
+ */
 export declare const profiles: () => VSCodeProfile[];
+/**
+ * Resolves the active VS Code profile for a given workspace directory.
+ *
+ * @remarks
+ * The workspace root is located via {@link findWorkspaceRoot}, then matched
+ * against the profile-to-workspace associations stored in VS Code's
+ * `storage.json`. Throws if no matching profile is found.
+ *
+ * @param dir - The directory to resolve the workspace from. Defaults to the
+ *   current working directory.
+ * @returns A promise that resolves to the active {@link VSCodeProfile}.
+ * @throws If no active profile is associated with the resolved workspace.
+ */
 export declare const activeProfile: (dir?: string) => Promise<VSCodeProfile>;
+/**
+ * Builds the absolute path to a profile's `settings.json` file.
+ *
+ * @param profile - The unique location identifier of the profile.
+ * @returns The absolute path to `settings.json` inside the profile's directory.
+ */
 export declare const profileSettingsPath: (profile: string) => string;
+/**
+ * Returns the absolute path to the default (global) `settings.json` file.
+ *
+ * @remarks
+ * This is the settings file used when no named profile is active.
+ *
+ * @returns The absolute path to the default `settings.json` in the VS Code
+ *   `User` directory.
+ */
 export declare const defaultSettingsPath: () => string;
 //# sourceMappingURL=vscode.profiles.d.ts.map

package/dist/vscode/vscode.profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.profiles.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.profiles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAMzD,eAAO,MAAM,QAAQ,QAAO,aAAa,EAOtC,CAAC;AAEJ,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,CAkBvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MACQ,CAAC;AAE/D,eAAO,MAAM,mBAAmB,QAAO,MACE,CAAC"}
+{"version":3,"file":"vscode.profiles.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.profiles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAMzD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,QAAO,aAAa,EAOtC,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,aAAa,CAkBvE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,KAAG,MACQ,CAAC;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,QAAO,MACE,CAAC"}

package/dist/vscode/vscode.profiles.js

@@ -3,11 +3,33 @@ import { storage } from "./vscode.storage.js";
 import { configUserPath } from "./vscode.config.js";
 import { findWorkspaceRoot } from "../workspace/workspace.common.js";
 import { cwd } from "node:process";
+/**
+ * Returns all VS Code user-data profiles.
+ *
+ * @remarks
+ * Each profile is resolved from the persisted {@link storage} and enriched
+ * with the absolute path to its `settings.json` via {@link profileSettingsPath}.
+ *
+ * @returns An array of {@link VSCodeProfile} objects for every configured profile.
+ */
 export const profiles = () => storage().userDataProfiles.map((prof) => ({
     name: prof.name,
     location: prof.location,
     settingsPath: profileSettingsPath(prof.location),
 }));
+/**
+ * Resolves the active VS Code profile for a given workspace directory.
+ *
+ * @remarks
+ * The workspace root is located via {@link findWorkspaceRoot}, then matched
+ * against the profile-to-workspace associations stored in VS Code's
+ * `storage.json`. Throws if no matching profile is found.
+ *
+ * @param dir - The directory to resolve the workspace from. Defaults to the
+ *   current working directory.
+ * @returns A promise that resolves to the active {@link VSCodeProfile}.
+ * @throws If no active profile is associated with the resolved workspace.
+ */
 export const activeProfile = async (dir) => {
     const foundWS = await findWorkspaceRoot(dir ?? cwd());
     const storageContent = storage();
@@ -26,6 +48,21 @@ export const activeProfile = async (dir) => {
         throw new Error("No active profile found");
     return foundProfile;
 };
+/**
+ * Builds the absolute path to a profile's `settings.json` file.
+ *
+ * @param profile - The unique location identifier of the profile.
+ * @returns The absolute path to `settings.json` inside the profile's directory.
+ */
 export const profileSettingsPath = (profile) => join(configUserPath(), "profiles", profile, "settings.json");
+/**
+ * Returns the absolute path to the default (global) `settings.json` file.
+ *
+ * @remarks
+ * This is the settings file used when no named profile is active.
+ *
+ * @returns The absolute path to the default `settings.json` in the VS Code
+ *   `User` directory.
+ */
 export const defaultSettingsPath = () => join(configUserPath(), "settings.json");
 //# sourceMappingURL=vscode.profiles.js.map

package/dist/vscode/vscode.profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.profiles.js","sourceRoot":"","sources":["../../src/vscode/vscode.profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAoB,EAAE,CAC5C,OAAO,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAC5B,CAAC,IAAI,EAAiB,EAAE,CAAC,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;CACjD,CAAC,CACH,CAAC;AAEJ,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,GAAY,EAA0B,EAAE;IAC1E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,YAAuC,CAAC;IAE5C,wCAAwC;IACxC,KAAK,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CACxC,cAAc,CAAC,mBAAmB,CAAC,UAAU,CAC9C,EAAE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAS;QACxC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QAC/D,IAAI,YAAY;YAAE,MAAM;IAC1B,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC7D,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAW,EAAE,CAC9C,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { VSCodeProfile } from \"../types/types.vscode.js\";\nimport { storage } from \"./vscode.storage.js\";\nimport { configUserPath } from \"./vscode.config.js\";\nimport { findWorkspaceRoot } from \"../workspace/workspace.common.js\";\nimport { cwd } from \"node:process\";\n\nexport const profiles = (): VSCodeProfile[] =>\n  storage().userDataProfiles.map(\n    (prof): VSCodeProfile => ({\n      name: prof.name,\n      location: prof.location,\n      settingsPath: profileSettingsPath(prof.location),\n    }),\n  );\n\nexport const activeProfile = async (dir?: string): Promise<VSCodeProfile> => {\n  const foundWS = await findWorkspaceRoot(dir ?? cwd());\n  const storageContent = storage();\n  const profs = profiles();\n  let foundProfile: VSCodeProfile | undefined;\n\n  // eslint-disable-next-line prefer-const\n  for (let [path, profile] of Object.entries(\n    storageContent.profileAssociations.workspaces,\n  )) {\n    path = path.replace(\"file://\", \"\");\n    if (foundWS.filePath !== path) continue;\n    foundProfile = profs.find((prof) => prof.location === profile);\n    if (foundProfile) break;\n  }\n\n  if (!foundProfile) throw new Error(\"No active profile found\");\n  return foundProfile;\n};\n\nexport const profileSettingsPath = (profile: string): string =>\n  join(configUserPath(), \"profiles\", profile, \"settings.json\");\n\nexport const defaultSettingsPath = (): string =>\n  join(configUserPath(), \"settings.json\");\n"]}
+{"version":3,"file":"vscode.profiles.js","sourceRoot":"","sources":["../../src/vscode/vscode.profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAoB,EAAE,CAC5C,OAAO,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAC5B,CAAC,IAAI,EAAiB,EAAE,CAAC,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC;CACjD,CAAC,CACH,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,GAAY,EAA0B,EAAE;IAC1E,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,YAAuC,CAAC;IAE5C,wCAAwC;IACxC,KAAK,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CACxC,cAAc,CAAC,mBAAmB,CAAC,UAAU,CAC9C,EAAE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAS;QACxC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QAC/D,IAAI,YAAY;YAAE,MAAM;IAC1B,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC7D,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAW,EAAE,CAC9C,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC","sourcesContent":["import { join } from \"node:path\";\nimport { VSCodeProfile } from \"../types/types.vscode.js\";\nimport { storage } from \"./vscode.storage.js\";\nimport { configUserPath } from \"./vscode.config.js\";\nimport { findWorkspaceRoot } from \"../workspace/workspace.common.js\";\nimport { cwd } from \"node:process\";\n\n/**\n * Returns all VS Code user-data profiles.\n *\n * @remarks\n * Each profile is resolved from the persisted {@link storage} and enriched\n * with the absolute path to its `settings.json` via {@link profileSettingsPath}.\n *\n * @returns An array of {@link VSCodeProfile} objects for every configured profile.\n */\nexport const profiles = (): VSCodeProfile[] =>\n  storage().userDataProfiles.map(\n    (prof): VSCodeProfile => ({\n      name: prof.name,\n      location: prof.location,\n      settingsPath: profileSettingsPath(prof.location),\n    }),\n  );\n\n/**\n * Resolves the active VS Code profile for a given workspace directory.\n *\n * @remarks\n * The workspace root is located via {@link findWorkspaceRoot}, then matched\n * against the profile-to-workspace associations stored in VS Code's\n * `storage.json`. Throws if no matching profile is found.\n *\n * @param dir - The directory to resolve the workspace from. Defaults to the\n *   current working directory.\n * @returns A promise that resolves to the active {@link VSCodeProfile}.\n * @throws If no active profile is associated with the resolved workspace.\n */\nexport const activeProfile = async (dir?: string): Promise<VSCodeProfile> => {\n  const foundWS = await findWorkspaceRoot(dir ?? cwd());\n  const storageContent = storage();\n  const profs = profiles();\n  let foundProfile: VSCodeProfile | undefined;\n\n  // eslint-disable-next-line prefer-const\n  for (let [path, profile] of Object.entries(\n    storageContent.profileAssociations.workspaces,\n  )) {\n    path = path.replace(\"file://\", \"\");\n    if (foundWS.filePath !== path) continue;\n    foundProfile = profs.find((prof) => prof.location === profile);\n    if (foundProfile) break;\n  }\n\n  if (!foundProfile) throw new Error(\"No active profile found\");\n  return foundProfile;\n};\n\n/**\n * Builds the absolute path to a profile's `settings.json` file.\n *\n * @param profile - The unique location identifier of the profile.\n * @returns The absolute path to `settings.json` inside the profile's directory.\n */\nexport const profileSettingsPath = (profile: string): string =>\n  join(configUserPath(), \"profiles\", profile, \"settings.json\");\n\n/**\n * Returns the absolute path to the default (global) `settings.json` file.\n *\n * @remarks\n * This is the settings file used when no named profile is active.\n *\n * @returns The absolute path to the default `settings.json` in the VS Code\n *   `User` directory.\n */\nexport const defaultSettingsPath = (): string =>\n  join(configUserPath(), \"settings.json\");\n"]}

package/dist/vscode/vscode.settings.d.ts

@@ -1,6 +1,31 @@
 import { VSCodeSettings } from "../types/types.vscode.js";
+/**
+ * Reads and returns the VS Code `settings.json` for the active profile.
+ *
+ * @remarks
+ * The result is cached after the first successful read. If no active profile
+ * can be resolved, the default (global) settings file is used as a fallback.
+ * A shallow copy is returned so that callers cannot mutate the cached object.
+ *
+ * @param dir - Optional directory used to resolve the active profile's
+ *   workspace. Defaults to the current working directory.
+ * @returns A promise that resolves to a shallow copy of the parsed
+ *   {@link VSCodeSettings}.
+ * @throws If the settings file cannot be read or parsed.
+ */
 export declare const vscodeSettings: (dir?: string) => Promise<VSCodeSettings>;
+/**
+ * Extracts the `C_Cpp.clang_format_style` value from the VS Code settings.
+ *
+ * @param cwd - The working directory used to locate the active profile's settings.
+ * @returns A promise that resolves to the clang-format style string.
+ * @throws If the `C_Cpp.clang_format_style` key is missing from the settings.
+ */
 export declare const clangFormatStyle: (cwd: string) => Promise<string>;
-/** @internal test-only */
+/**
+ * Resets the cached settings so they are re-read on the next call.
+ *
+ * @internal
+ */
 export declare const __resetSettings: () => void;
 //# sourceMappingURL=vscode.settings.d.ts.map

package/dist/vscode/vscode.settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.settings.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,cAAc,CAgBzE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,CAKlE,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,eAAe,YAE3B,CAAC"}
+{"version":3,"file":"vscode.settings.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,cAAc,CAgBzE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,CAKlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,YAE3B,CAAC"}

package/dist/vscode/vscode.settings.js

@@ -1,7 +1,21 @@
+import { jsonParse } from "../common/common.json.js";
 import { activeProfile, defaultSettingsPath } from "./vscode.profiles.js";
 import { readFile } from "node:fs/promises";
-import json5 from "json5";
 let __settings = null;
+/**
+ * Reads and returns the VS Code `settings.json` for the active profile.
+ *
+ * @remarks
+ * The result is cached after the first successful read. If no active profile
+ * can be resolved, the default (global) settings file is used as a fallback.
+ * A shallow copy is returned so that callers cannot mutate the cached object.
+ *
+ * @param dir - Optional directory used to resolve the active profile's
+ *   workspace. Defaults to the current working directory.
+ * @returns A promise that resolves to a shallow copy of the parsed
+ *   {@link VSCodeSettings}.
+ * @throws If the settings file cannot be read or parsed.
+ */
 export const vscodeSettings = async (dir) => {
     if (!__settings) {
         let settingsPath;
@@ -12,19 +26,30 @@ export const vscodeSettings = async (dir) => {
             settingsPath = defaultSettingsPath();
         }
         const raw = await readFile(settingsPath, "utf-8");
-        __settings = json5.parse(raw);
+        __settings = jsonParse(raw);
         if (!__settings)
             throw new Error("No settings found");
     }
     return { ...__settings };
 };
+/**
+ * Extracts the `C_Cpp.clang_format_style` value from the VS Code settings.
+ *
+ * @param cwd - The working directory used to locate the active profile's settings.
+ * @returns A promise that resolves to the clang-format style string.
+ * @throws If the `C_Cpp.clang_format_style` key is missing from the settings.
+ */
 export const clangFormatStyle = async (cwd) => {
     const settings = await vscodeSettings(cwd);
     if (!("C_Cpp.clang_format_style" in settings))
         throw new Error("C_Cpp.clang_format_style not found in settings.json");
     return settings["C_Cpp.clang_format_style"];
 };
-/** @internal test-only */
+/**
+ * Resets the cached settings so they are re-read on the next call.
+ *
+ * @internal
+ */
 export const __resetSettings = () => {
     __settings = null;
 };

package/dist/vscode/vscode.settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.settings.js","sourceRoot":"","sources":["../../src/vscode/vscode.settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,IAAI,UAAU,GAA0B,IAAI,CAAC;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,GAAY,EAA2B,EAAE;IAC5E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,YAAgC,CAAC;QAErC,IAAI,CAAC;YACH,YAAY,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,mBAAmB,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAmB,EAAE;IACrE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,0BAA0B,IAAI,QAAQ,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC,0BAA0B,CAAW,CAAC;AACxD,CAAC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC,CAAC","sourcesContent":["import { VSCodeSettings } from \"../types/types.vscode.js\";\nimport { activeProfile, defaultSettingsPath } from \"./vscode.profiles.js\";\nimport { readFile } from \"node:fs/promises\";\nimport json5 from \"json5\";\n\nlet __settings: VSCodeSettings | null = null;\n\nexport const vscodeSettings = async (dir?: string): Promise<VSCodeSettings> => {\n  if (!__settings) {\n    let settingsPath: string | undefined;\n\n    try {\n      settingsPath = (await activeProfile(dir)).settingsPath;\n    } catch {\n      settingsPath = defaultSettingsPath();\n    }\n\n    const raw = await readFile(settingsPath, \"utf-8\");\n    __settings = json5.parse(raw);\n    if (!__settings) throw new Error(\"No settings found\");\n  }\n\n  return { ...__settings };\n};\n\nexport const clangFormatStyle = async (cwd: string): Promise<string> => {\n  const settings = await vscodeSettings(cwd);\n  if (!(\"C_Cpp.clang_format_style\" in settings))\n    throw new Error(\"C_Cpp.clang_format_style not found in settings.json\");\n  return settings[\"C_Cpp.clang_format_style\"] as string;\n};\n\n/** @internal test-only */\nexport const __resetSettings = () => {\n  __settings = null;\n};\n"]}
+{"version":3,"file":"vscode.settings.js","sourceRoot":"","sources":["../../src/vscode/vscode.settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,IAAI,UAAU,GAA0B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,GAAY,EAA2B,EAAE;IAC5E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,YAAgC,CAAC;QAErC,IAAI,CAAC;YACH,YAAY,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,mBAAmB,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAmB,EAAE;IACrE,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,0BAA0B,IAAI,QAAQ,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,OAAO,QAAQ,CAAC,0BAA0B,CAAW,CAAC;AACxD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC,CAAC","sourcesContent":["import { jsonParse } from \"../common/common.json.js\";\nimport { VSCodeSettings } from \"../types/types.vscode.js\";\nimport { activeProfile, defaultSettingsPath } from \"./vscode.profiles.js\";\nimport { readFile } from \"node:fs/promises\";\n\nlet __settings: VSCodeSettings | null = null;\n\n/**\n * Reads and returns the VS Code `settings.json` for the active profile.\n *\n * @remarks\n * The result is cached after the first successful read. If no active profile\n * can be resolved, the default (global) settings file is used as a fallback.\n * A shallow copy is returned so that callers cannot mutate the cached object.\n *\n * @param dir - Optional directory used to resolve the active profile's\n *   workspace. Defaults to the current working directory.\n * @returns A promise that resolves to a shallow copy of the parsed\n *   {@link VSCodeSettings}.\n * @throws If the settings file cannot be read or parsed.\n */\nexport const vscodeSettings = async (dir?: string): Promise<VSCodeSettings> => {\n  if (!__settings) {\n    let settingsPath: string | undefined;\n\n    try {\n      settingsPath = (await activeProfile(dir)).settingsPath;\n    } catch {\n      settingsPath = defaultSettingsPath();\n    }\n\n    const raw = await readFile(settingsPath, \"utf-8\");\n    __settings = jsonParse(raw);\n    if (!__settings) throw new Error(\"No settings found\");\n  }\n\n  return { ...__settings };\n};\n\n/**\n * Extracts the `C_Cpp.clang_format_style` value from the VS Code settings.\n *\n * @param cwd - The working directory used to locate the active profile's settings.\n * @returns A promise that resolves to the clang-format style string.\n * @throws If the `C_Cpp.clang_format_style` key is missing from the settings.\n */\nexport const clangFormatStyle = async (cwd: string): Promise<string> => {\n  const settings = await vscodeSettings(cwd);\n  if (!(\"C_Cpp.clang_format_style\" in settings))\n    throw new Error(\"C_Cpp.clang_format_style not found in settings.json\");\n  return settings[\"C_Cpp.clang_format_style\"] as string;\n};\n\n/**\n * Resets the cached settings so they are re-read on the next call.\n *\n * @internal\n */\nexport const __resetSettings = () => {\n  __settings = null;\n};\n"]}

package/dist/vscode/vscode.storage.d.ts

@@ -1,6 +1,26 @@
 import { VSCodeStorage } from "../types/types.vscode.js";
+/**
+ * Returns the absolute path to the VS Code `storage.json` file.
+ *
+ * @returns The path to `storage.json` inside the `globalStorage` directory.
+ */
 export declare const storagePath: () => string;
+/**
+ * Reads and returns the parsed VS Code `storage.json`.
+ *
+ * @remarks
+ * The result is cached after the first successful read. Subsequent calls
+ * return the cached {@link VSCodeStorage} instance without re-reading
+ * the file from disk.
+ *
+ * @returns The parsed {@link VSCodeStorage} object.
+ * @throws If the file cannot be read or parsed.
+ */
 export declare const storage: () => VSCodeStorage;
-/** @internal test-only */
+/**
+ * Resets the cached storage so it is re-read on the next call.
+ *
+ * @internal
+ */
 export declare const __resetStorage: () => void;
 //# sourceMappingURL=vscode.storage.d.ts.map

package/dist/vscode/vscode.storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.storage.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,eAAO,MAAM,WAAW,QAAO,MAC0B,CAAC;AAG1D,eAAO,MAAM,OAAO,QAAO,aAM1B,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,cAAc,YAE1B,CAAC"}
+{"version":3,"file":"vscode.storage.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,MAC0B,CAAC;AAI1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,QAAO,aAM1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,YAE1B,CAAC"}

package/dist/vscode/vscode.storage.js

@@ -1,19 +1,39 @@
 import * as fs from "node:fs";
 import { join } from "node:path";
-import json5 from "json5";
 import { configUserPath } from "./vscode.config.js";
+import { jsonParse } from "../common/common.json.js";
+/**
+ * Returns the absolute path to the VS Code `storage.json` file.
+ *
+ * @returns The path to `storage.json` inside the `globalStorage` directory.
+ */
 export const storagePath = () => join(configUserPath(), "globalStorage", "storage.json");
 let __storage;
+/**
+ * Reads and returns the parsed VS Code `storage.json`.
+ *
+ * @remarks
+ * The result is cached after the first successful read. Subsequent calls
+ * return the cached {@link VSCodeStorage} instance without re-reading
+ * the file from disk.
+ *
+ * @returns The parsed {@link VSCodeStorage} object.
+ * @throws If the file cannot be read or parsed.
+ */
 export const storage = () => {
     if (__storage)
         return __storage;
     const content = fs.readFileSync(storagePath()).toString();
-    __storage = json5.parse(content);
+    __storage = jsonParse(content);
     if (!__storage)
         throw new Error("VS Code storage.json could not be loaded");
     return __storage;
 };
-/** @internal test-only */
+/**
+ * Resets the cached storage so it is re-read on the next call.
+ *
+ * @internal
+ */
 export const __resetStorage = () => {
     __storage = undefined;
 };

package/dist/vscode/vscode.storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.storage.js","sourceRoot":"","sources":["../../src/vscode/vscode.storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CACtC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAE1D,IAAI,SAAoC,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,GAAkB,EAAE;IACzC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1D,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC5E,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC,CAAC","sourcesContent":["import * as fs from \"node:fs\";\nimport { join } from \"node:path\";\nimport json5 from \"json5\";\nimport { VSCodeStorage } from \"../types/types.vscode.js\";\nimport { configUserPath } from \"./vscode.config.js\";\n\nexport const storagePath = (): string =>\n  join(configUserPath(), \"globalStorage\", \"storage.json\");\n\nlet __storage: VSCodeStorage | undefined;\nexport const storage = (): VSCodeStorage => {\n  if (__storage) return __storage;\n  const content = fs.readFileSync(storagePath()).toString();\n  __storage = json5.parse(content);\n  if (!__storage) throw new Error(\"VS Code storage.json could not be loaded\");\n  return __storage;\n};\n\n/** @internal test-only */\nexport const __resetStorage = () => {\n  __storage = undefined;\n};\n"]}
+{"version":3,"file":"vscode.storage.js","sourceRoot":"","sources":["../../src/vscode/vscode.storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CACtC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAE1D,IAAI,SAAoC,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAkB,EAAE;IACzC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC1D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC5E,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC,CAAC","sourcesContent":["import * as fs from \"node:fs\";\nimport { join } from \"node:path\";\nimport { VSCodeStorage } from \"../types/types.vscode.js\";\nimport { configUserPath } from \"./vscode.config.js\";\nimport { jsonParse } from \"../common/common.json.js\";\n\n/**\n * Returns the absolute path to the VS Code `storage.json` file.\n *\n * @returns The path to `storage.json` inside the `globalStorage` directory.\n */\nexport const storagePath = (): string =>\n  join(configUserPath(), \"globalStorage\", \"storage.json\");\n\nlet __storage: VSCodeStorage | undefined;\n\n/**\n * Reads and returns the parsed VS Code `storage.json`.\n *\n * @remarks\n * The result is cached after the first successful read. Subsequent calls\n * return the cached {@link VSCodeStorage} instance without re-reading\n * the file from disk.\n *\n * @returns The parsed {@link VSCodeStorage} object.\n * @throws If the file cannot be read or parsed.\n */\nexport const storage = (): VSCodeStorage => {\n  if (__storage) return __storage;\n  const content = fs.readFileSync(storagePath()).toString();\n  __storage = jsonParse(content);\n  if (!__storage) throw new Error(\"VS Code storage.json could not be loaded\");\n  return __storage;\n};\n\n/**\n * Resets the cached storage so it is re-read on the next call.\n *\n * @internal\n */\nexport const __resetStorage = () => {\n  __storage = undefined;\n};\n"]}

package/dist/vscode/vscode.workspace.d.ts

@@ -1,4 +1,21 @@
 import { VSCodeWorkspace } from "../types/types.vscode.js";
+/**
+ * Reads and returns a parsed VS Code `.code-workspace` file.
+ *
+ * @remarks
+ * The result is cached per `workspaceFile` path. A shallow copy is returned
+ * so that callers cannot mutate the cached object.
+ *
+ * @param workspaceFile - Absolute path to the `.code-workspace` file.
+ * @returns A promise that resolves to a shallow copy of the parsed
+ *   {@link VSCodeWorkspace}.
+ */
 export declare const vscodeWorkspace: (workspaceFile: string) => Promise<VSCodeWorkspace>;
+/**
+ * Returns the directory that contains the given workspace file.
+ *
+ * @param workspaceFile - Absolute path to the `.code-workspace` file.
+ * @returns The parent directory of the workspace file.
+ */
 export declare const vscodeWorkspaceRoot: (workspaceFile: string) => string;
 //# sourceMappingURL=vscode.workspace.d.ts.map

package/dist/vscode/vscode.workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vscode.workspace.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAM3D,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,KACpB,OAAO,CAAC,eAAe,CASzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,WACjC,CAAC"}
+{"version":3,"file":"vscode.workspace.d.ts","sourceRoot":"","sources":["../../src/vscode/vscode.workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAM3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,KACpB,OAAO,CAAC,eAAe,CASzB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,eAAe,MAAM,WACjC,CAAC"}