@w5s/dev 1.3.2 → 1.4.0

package/dist/block.d.ts

@@ -0,0 +1,45 @@
+export interface BlockOptions {
+    /**
+     * The marker builder function that will take either `markerBegin` or `markerEnd`
+     *
+     * @default '# ${mark} MANAGED BLOCK'
+     */
+    marker?: (mark: 'Begin' | 'End') => string;
+    /**
+     * File path
+     */
+    path: string;
+    /**
+     * Block content to insert
+     */
+    block: string;
+    /**
+     * Insert position
+     */
+    insertPosition?: ['before', 'BeginningOfFile'] | ['after', 'EndOfFile'];
+    /**
+     * Block target state
+     */
+    state?: 'present' | 'absent';
+}
+/**
+ * Replace asynchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+export declare function block(options: BlockOptions): Promise<void>;
+/**
+ * Replace synchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+export declare function blockSync(options: BlockOptions): void;
+//# sourceMappingURL=block.d.ts.map

package/dist/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../src/block.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC;IAC3C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACxE;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AA0ED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,iBAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,QAE9C"}

package/dist/block.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockSync = exports.block = void 0;
+const file_js_1 = require("./file.js");
+const EOF = 'EndOfFile';
+const BOF = 'BeginningOfFile';
+function toFileOptions(options) {
+    const { marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`, path, block: blockName, insertPosition = ['after', EOF], state = 'present', } = options;
+    const EOL = '\n';
+    const beginBlock = marker('Begin');
+    const endBlock = marker('End');
+    /**
+     * @param content
+     */
+    function findBlock(content) {
+        const startIndex = content.indexOf(beginBlock);
+        const endIndex = content.indexOf(endBlock) + endBlock.length;
+        return {
+            endIndex,
+            exists: startIndex >= 0 && endIndex >= 0,
+            startIndex,
+        };
+    }
+    function apply(fullContent, blockContent) {
+        const found = findBlock(fullContent);
+        const remove = state === 'absent';
+        const replaceBlock = remove ? '' : beginBlock + EOL + blockContent + EOL + endBlock;
+        const [positionDirection, positionAnchor] = insertPosition;
+        if (found.exists) {
+            return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);
+        }
+        if (remove) {
+            return fullContent;
+        }
+        switch (positionDirection) {
+            case 'after': {
+                // insert
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                if (positionAnchor === EOF) {
+                    return fullContent + EOL + replaceBlock;
+                }
+                return fullContent;
+            }
+            case 'before': {
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                if (positionAnchor === BOF) {
+                    return replaceBlock + EOL + fullContent;
+                }
+                return fullContent;
+            }
+            default: {
+                throw new Error(`Unsupported position ${String(positionDirection)}`);
+            }
+        }
+    }
+    return {
+        path,
+        state: 'present',
+        update: (sourceContent) => apply(sourceContent, blockName),
+    };
+}
+/**
+ * Replace asynchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+function block(options) {
+    return (0, file_js_1.file)(toFileOptions(options));
+}
+exports.block = block;
+/**
+ * Replace synchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+function blockSync(options) {
+    return (0, file_js_1.fileSync)(toFileOptions(options));
+}
+exports.blockSync = blockSync;
+//# sourceMappingURL=block.js.map

package/dist/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../src/block.ts"],"names":[],"mappings":";;;AAAA,uCAA6D;AA2B7D,MAAM,GAAG,GAAG,WAAW,CAAC;AACxB,MAAM,GAAG,GAAG,iBAAiB,CAAC;AAE9B,SAAS,aAAa,CAAC,OAAqB;IAC1C,MAAM,EACJ,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAC1D,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,cAAc,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAG,SAAS,GAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,SAAS,CAAC,OAAe;QAChC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE7D,OAAO;YACL,QAAQ;YACR,MAAM,EAAE,UAAU,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC;YACxC,UAAU;SACX,CAAC;IACJ,CAAC;IAED,SAAS,KAAK,CAAC,WAAmB,EAAE,YAAoB;QACtD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC;QAClC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,GAAG,YAAY,GAAG,GAAG,GAAG,QAAQ,CAAC;QACpF,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,cAAc,CAAC;QAE3D,IAAI,KAAK,CAAC,MAAM,EAAE;YAChB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;SAClG;QACD,IAAI,MAAM,EAAE;YACV,OAAO,WAAW,CAAC;SACpB;QACD,QAAQ,iBAAiB,EAAE;YACzB,KAAK,OAAO,CAAC,CAAC;gBACZ,SAAS;gBACT,uEAAuE;gBACvE,IAAI,cAAc,KAAK,GAAG,EAAE;oBAC1B,OAAO,WAAW,GAAG,GAAG,GAAG,YAAY,CAAC;iBACzC;gBAED,OAAO,WAAW,CAAC;aACpB;YACD,KAAK,QAAQ,CAAC,CAAC;gBACb,uEAAuE;gBACvE,IAAI,cAAc,KAAK,GAAG,EAAE;oBAC1B,OAAO,YAAY,GAAG,GAAG,GAAG,WAAW,CAAC;iBACzC;gBACD,OAAO,WAAW,CAAC;aACpB;YACD,OAAO,CAAC,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;aACtE;SACF;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,KAAK,CAAC,OAAqB;IACzC,OAAO,IAAA,cAAI,EAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AACtC,CAAC;AAFD,sBAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,OAAqB;IAC7C,OAAO,IAAA,kBAAQ,EAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAFD,8BAEC"}

package/dist/file.d.ts

@@ -0,0 +1,52 @@
+/// <reference types="node" />
+export interface FileOptions {
+    /**
+     * File path
+     */
+    readonly path: string;
+    /**
+     * File target state
+     */
+    readonly state: 'present' | 'absent';
+    /**
+     * File content mapping function
+     *
+     * @param content
+     */
+    readonly update?: (content: string) => string | undefined;
+    /**
+     * File encoding
+     */
+    readonly encoding?: BufferEncoding;
+}
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * await file({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+export declare function file(options: FileOptions): Promise<void>;
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * fileSync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+export declare function fileSync(options: FileOptions): void;
+//# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":";AAqBA,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAYnD"}

package/dist/file.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileSync = exports.file = void 0;
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+async function exists(path) {
+    try {
+        await (0, promises_1.access)(path, node_fs_1.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function existsSync(path) {
+    try {
+        (0, node_fs_1.accessSync)(path, node_fs_1.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * await file({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+async function file(options) {
+    const { path, state, update, encoding = 'utf8' } = options;
+    if (state === 'present') {
+        const isPresent = await exists(path);
+        const previousContent = isPresent ? await (0, promises_1.readFile)(path, encoding) : '';
+        const newContent = update == null ? '' : update(previousContent);
+        if (newContent != null) {
+            await (0, promises_1.writeFile)(path, newContent, encoding);
+        }
+    }
+    else {
+        await (0, promises_1.rm)(path);
+    }
+}
+exports.file = file;
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * fileSync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+function fileSync(options) {
+    const { path, state, update, encoding = 'utf8' } = options;
+    if (state === 'present') {
+        const isPresent = existsSync(path);
+        const previousContent = isPresent ? (0, node_fs_1.readFileSync)(path, encoding) : '';
+        const newContent = update == null ? '' : update(previousContent);
+        if (newContent != null) {
+            (0, node_fs_1.writeFileSync)(path, newContent, encoding);
+        }
+    }
+    else {
+        (0, node_fs_1.rmSync)(path);
+    }
+}
+exports.fileSync = fileSync;
+//# sourceMappingURL=file.js.map

package/dist/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":";;;AAAA,+CAAmE;AACnE,qCAAqF;AAErF,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI;QACF,MAAM,IAAA,iBAAM,EAAC,IAAI,EAAE,mBAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;KACb;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI;QACF,IAAA,oBAAU,EAAC,IAAI,EAAE,mBAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;KACb;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAuBD;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,IAAI,CAAC,OAAoB;IAC7C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,UAAU,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,IAAI,UAAU,IAAI,IAAI,EAAE;YACtB,MAAM,IAAA,oBAAS,EAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SAC7C;KACF;SAAM;QACL,MAAM,IAAA,aAAE,EAAC,IAAI,CAAC,CAAC;KAChB;AACH,CAAC;AAZD,oBAYC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,QAAQ,CAAC,OAAoB;IAC3C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,UAAU,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,IAAI,UAAU,IAAI,IAAI,EAAE;YACtB,IAAA,uBAAa,EAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SAC3C;KACF;SAAM;QACL,IAAA,gBAAM,EAAC,IAAI,CAAC,CAAC;KACd;AACH,CAAC;AAZD,4BAYC"}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
 export * from './eslint.js';
+export * from './block.js';
+export * from './file.js';
+export * from './json.js';
 export * from './project.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -15,5 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./eslint.js"), exports);
+__exportStar(require("./block.js"), exports);
+__exportStar(require("./file.js"), exports);
+__exportStar(require("./json.js"), exports);
 __exportStar(require("./project.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,4CAA0B;AAC1B,+CAA6B"}

package/dist/json.d.ts

@@ -0,0 +1,37 @@
+/// <reference types="node" />
+export type JSONValue = null | number | string | boolean | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export interface JSONOption<V = JSONValue> {
+    /**
+     * File path
+     */
+    readonly path: string;
+    /**
+     * File target state
+     */
+    readonly state: 'present' | 'absent';
+    /**
+     * File content mapping function
+     *
+     * @param content
+     */
+    readonly update?: (content: V | undefined) => V | undefined;
+    /**
+     * File encoding
+     */
+    readonly encoding?: BufferEncoding;
+}
+/**
+ * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+export declare function json<Value>(options: JSONOption<Value>): Promise<void>;
+/**
+ * Ensure file is present/absent synchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+export declare function jsonSync<Value>(options: JSONOption<Value>): void;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":";AAEA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtG,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,SAAS;IACvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,CAAC;IAC5D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AAiBD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAEhE"}

package/dist/json.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSync = exports.json = void 0;
+const file_js_1 = require("./file.js");
+function toFileOption({ update, ...otherOptions }) {
+    return {
+        ...otherOptions,
+        update: update == null
+            ? update
+            : (content) => {
+                const jsonValue = content === '' ? undefined : JSON.parse(content);
+                return JSON.stringify(update(jsonValue));
+            },
+    };
+}
+/**
+ * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+async function json(options) {
+    return (0, file_js_1.file)(toFileOption(options));
+}
+exports.json = json;
+/**
+ * Ensure file is present/absent synchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+function jsonSync(options) {
+    return (0, file_js_1.fileSync)(toFileOption(options));
+}
+exports.jsonSync = jsonSync;
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":";;;AAAA,uCAA6D;AAyB7D,SAAS,YAAY,CAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAqB;IACzE,OAAO;QACL,GAAG,YAAY;QAEf,MAAM,EACJ,MAAM,IAAI,IAAI;YACZ,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE;gBACV,MAAM,SAAS,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC;gBAE9E,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAC3C,CAAC;KACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,IAAI,CAAQ,OAA0B;IAC1D,OAAO,IAAA,cAAI,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,oBAEC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAQ,OAA0B;IACxD,OAAO,IAAA,kBAAQ,EAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AACzC,CAAC;AAFD,4BAEC"}

package/dist/project.d.ts

@@ -1,5 +1,21 @@
 export declare namespace Project {
+    /**
+     * A type of a file extension
+     */
     type Extension = `.${string}`;
+    /**
+     * Object hash of all well-known file extension category to file extensions mapping
+     */
+    interface ExtensionRegistry {
+        javascript: readonly Extension[];
+        javascriptreact: readonly Extension[];
+        typescript: readonly Extension[];
+        typescriptreact: readonly Extension[];
+    }
+    /**
+     * A list of "vscode-like" language identifiers (i.e. "javascript", "javascriptreact")
+     */
+    type LanguageId = keyof ExtensionRegistry;
     /**
      * Supported ECMA version
      *
@@ -9,6 +25,18 @@ export declare namespace Project {
      * ```
      */
     function ecmaVersion(): 2022;
+    /**
+     * Return a list of extensions
+     *
+     * @example
+     * ```ts
+     * Project.queryExtensions(['javascript']); // ['.js', '.cjs', ...]
+     * Project.queryExtensions(['typescript', 'typescriptreact']); // ['.ts', '.mts', ..., '.tsx']
+     * ```
+     *
+     * @param languages
+     */
+    function queryExtensions(languages: LanguageId[]): readonly Extension[];
     /**
      * Supported file extensions
      *

package/dist/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,yBAAiB,OAAO,CAAC;IACvB,KAAY,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;IAErC;;;;;;;OAOG;IACH,SAAgB,WAAW,SAE1B;IAaD;;;;;;;OAOG;IACH,SAAgB,gBAAgB,4BAE/B;IAkBD;;;;;;;OAOG;IACH,SAAgB,kBAAkB,4BAEjC;IAeD;;;;;;;OAOG;IACH,SAAgB,OAAO,sBAEtB;IAED;;;;;;;OAOG;IACH,SAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAE5E;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAEzE;CACF"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,yBAAiB,OAAO,CAAC;IACvB;;OAEG;IACH,KAAY,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;IAErC;;OAEG;IACH,UAAiB,iBAAiB;QAChC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;QACjC,eAAe,EAAE,SAAS,SAAS,EAAE,CAAC;QACtC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;QACjC,eAAe,EAAE,SAAS,SAAS,EAAE,CAAC;KACvC;IAED;;OAEG;IACH,KAAY,UAAU,GAAG,MAAM,iBAAiB,CAAC;IAEjD;;;;;;;OAOG;IACH,SAAgB,WAAW,SAE1B;IASD;;;;;;;;;;OAUG;IACH,SAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,SAAS,SAAS,EAAE,CAO7E;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB,4BAE/B;IAkBD;;;;;;;OAOG;IACH,SAAgB,kBAAkB,4BAEjC;IAeD;;;;;;;OAOG;IACH,SAAgB,OAAO,sBAEtB;IAED;;;;;;;OAOG;IACH,SAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAE5E;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAEzE;CACF"}

package/dist/project.js

@@ -18,16 +18,29 @@ var Project;
         return 2022;
     }
     Project.ecmaVersion = ecmaVersion;
-    const SOURCE_EXTENSIONS = Object.freeze([
-        '.ts',
-        '.tsx',
-        '.cts',
-        '.mts',
-        '.js',
-        '.jsx',
-        '.cjs',
-        '.mjs',
-    ]);
+    const registry = {
+        javascript: ['.js', '.cjs', '.mjs'],
+        javascriptreact: ['.jsx'],
+        typescript: ['.ts', '.cts', '.mts'],
+        typescriptreact: ['.tsx'],
+    };
+    /**
+     * Return a list of extensions
+     *
+     * @example
+     * ```ts
+     * Project.queryExtensions(['javascript']); // ['.js', '.cjs', ...]
+     * Project.queryExtensions(['typescript', 'typescriptreact']); // ['.ts', '.mts', ..., '.tsx']
+     * ```
+     *
+     * @param languages
+     */
+    function queryExtensions(languages) {
+        return languages
+            .reduce((previousValue, currentValue) => previousValue.concat(registry[currentValue] ?? []), [])
+            .sort();
+    }
+    Project.queryExtensions = queryExtensions;
     /**
      * Supported file extensions
      *
@@ -37,7 +50,7 @@ var Project;
      * ```
      */
     function sourceExtensions() {
-        return SOURCE_EXTENSIONS;
+        return queryExtensions(['javascript', 'javascriptreact', 'typescript', 'typescriptreact']);
     }
     Project.sourceExtensions = sourceExtensions;
     const RESOURCE_EXTENSIONS = Object.freeze([

package/dist/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":";;;AAAA,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,oCAAoC;AAC9F,CAAC;AAED,IAAiB,OAAO,CAkHvB;AAlHD,WAAiB,OAAO;IAGtB;;;;;;;OAOG;IACH,SAAgB,WAAW;QACzB,OAAO,IAAa,CAAC;IACvB,CAAC;IAFe,mBAAW,cAE1B,CAAA;IAED,MAAM,iBAAiB,GAAyB,MAAM,CAAC,MAAM,CAAC;QAC5D,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,SAAgB,gBAAgB;QAC9B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAFe,wBAAgB,mBAE/B,CAAA;IAED,MAAM,mBAAmB,GAAyB,MAAM,CAAC,MAAM,CAAC;QAC9D,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;QACN,UAAU;QACV,MAAM;QACN,OAAO;KACR,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,SAAgB,kBAAkB;QAChC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAFe,0BAAkB,qBAEjC,CAAA;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,eAAe;QACf,QAAQ;QACR,MAAM;QACN,WAAW;QACX,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,SAAgB,OAAO;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAFe,eAAO,UAEtB,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,mBAAmB,CAAC,UAAgC;QAClE,OAAO,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAFe,2BAAmB,sBAElC,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB,CAAC,UAAgC;QAC/D,OAAO,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACzE,CAAC;IAFe,wBAAgB,mBAE/B,CAAA;AACH,CAAC,EAlHgB,OAAO,uBAAP,OAAO,QAkHvB"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":";;;AAAA,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,oCAAoC;AAC9F,CAAC;AAED,IAAiB,OAAO,CAoJvB;AApJD,WAAiB,OAAO;IAqBtB;;;;;;;OAOG;IACH,SAAgB,WAAW;QACzB,OAAO,IAAa,CAAC;IACvB,CAAC;IAFe,mBAAW,cAE1B,CAAA;IAED,MAAM,QAAQ,GAA4C;QACxD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QACnC,eAAe,EAAE,CAAC,MAAM,CAAC;QACzB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QACnC,eAAe,EAAE,CAAC,MAAM,CAAC;KAC1B,CAAC;IAEF;;;;;;;;;;OAUG;IACH,SAAgB,eAAe,CAAC,SAAuB;QACrD,OAAO,SAAS;aACb,MAAM,CACL,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAK,EAAkB,CAAC,EACpG,EAAE,CACH;aACA,IAAI,EAAE,CAAC;IACZ,CAAC;IAPe,uBAAe,kBAO9B,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB;QAC9B,OAAO,eAAe,CAAC,CAAC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7F,CAAC;IAFe,wBAAgB,mBAE/B,CAAA;IAED,MAAM,mBAAmB,GAAyB,MAAM,CAAC,MAAM,CAAC;QAC9D,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;QACN,UAAU;QACV,MAAM;QACN,OAAO;KACR,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,SAAgB,kBAAkB;QAChC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAFe,0BAAkB,qBAEjC,CAAA;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,eAAe;QACf,QAAQ;QACR,MAAM;QACN,WAAW;QACX,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,SAAgB,OAAO;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAFe,eAAO,UAEtB,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,mBAAmB,CAAC,UAAgC;QAClE,OAAO,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAFe,2BAAmB,sBAElC,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,gBAAgB,CAAC,UAAgC;QAC/D,OAAO,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACzE,CAAC;IAFe,wBAAgB,mBAE/B,CAAA;AACH,CAAC,EApJgB,OAAO,uBAAP,OAAO,QAoJvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w5s/dev",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "Shared development constants and functions",
   "keywords": [
     "config",
@@ -43,5 +43,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "7c7006522408a5ab144f8def71edab7fface1e18"
+  "gitHead": "40aa9e728c83ee50a5a381817c59df91458cf6a0"
 }

package/src/block.ts

@@ -0,0 +1,124 @@
+import { type FileOptions, file, fileSync } from './file.js';
+
+export interface BlockOptions {
+  /**
+   * The marker builder function that will take either `markerBegin` or `markerEnd`
+   *
+   * @default '# ${mark} MANAGED BLOCK'
+   */
+  marker?: (mark: 'Begin' | 'End') => string;
+  /**
+   * File path
+   */
+  path: string;
+  /**
+   * Block content to insert
+   */
+  block: string;
+  /**
+   * Insert position
+   */
+  insertPosition?: ['before', 'BeginningOfFile'] | ['after', 'EndOfFile'];
+  /**
+   * Block target state
+   */
+  state?: 'present' | 'absent';
+}
+
+const EOF = 'EndOfFile';
+const BOF = 'BeginningOfFile';
+
+function toFileOptions(options: BlockOptions): FileOptions {
+  const {
+    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,
+    path,
+    block: blockName,
+    insertPosition = ['after', EOF],
+    state = 'present',
+  } = options;
+
+  const EOL = '\n';
+  const beginBlock = marker('Begin');
+  const endBlock = marker('End');
+
+  /**
+   * @param content
+   */
+  function findBlock(content: string) {
+    const startIndex = content.indexOf(beginBlock);
+    const endIndex = content.indexOf(endBlock) + endBlock.length;
+
+    return {
+      endIndex,
+      exists: startIndex >= 0 && endIndex >= 0,
+      startIndex,
+    };
+  }
+
+  function apply(fullContent: string, blockContent: string) {
+    const found = findBlock(fullContent);
+    const remove = state === 'absent';
+    const replaceBlock = remove ? '' : beginBlock + EOL + blockContent + EOL + endBlock;
+    const [positionDirection, positionAnchor] = insertPosition;
+
+    if (found.exists) {
+      return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);
+    }
+    if (remove) {
+      return fullContent;
+    }
+    switch (positionDirection) {
+      case 'after': {
+        // insert
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (positionAnchor === EOF) {
+          return fullContent + EOL + replaceBlock;
+        }
+
+        return fullContent;
+      }
+      case 'before': {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (positionAnchor === BOF) {
+          return replaceBlock + EOL + fullContent;
+        }
+        return fullContent;
+      }
+      default: {
+        throw new Error(`Unsupported position ${String(positionDirection)}`);
+      }
+    }
+  }
+
+  return {
+    path,
+    state: 'present',
+    update: (sourceContent) => apply(sourceContent, blockName),
+  };
+}
+
+/**
+ * Replace asynchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+export function block(options: BlockOptions) {
+  return file(toFileOptions(options));
+}
+
+/**
+ * Replace synchronously a block in file that follows pattern :
+ *
+ * marker(markerBegin)
+ * ...
+ * marker(markerEnd)
+ *
+ * @param options
+ */
+export function blockSync(options: BlockOptions) {
+  return fileSync(toFileOptions(options));
+}

package/src/file.ts

@@ -0,0 +1,97 @@
+import { readFile, rm, writeFile, access } from 'node:fs/promises';
+import { accessSync, constants, readFileSync, rmSync, writeFileSync } from 'node:fs';
+
+async function exists(path: string) {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function existsSync(path: string) {
+  try {
+    accessSync(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export interface FileOptions {
+  /**
+   * File path
+   */
+  readonly path: string;
+  /**
+   * File target state
+   */
+  readonly state: 'present' | 'absent';
+  /**
+   * File content mapping function
+   *
+   * @param content
+   */
+  readonly update?: (content: string) => string | undefined;
+  /**
+   * File encoding
+   */
+  readonly encoding?: BufferEncoding;
+}
+
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * await file({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+export async function file(options: FileOptions): Promise<void> {
+  const { path, state, update, encoding = 'utf8' } = options;
+  if (state === 'present') {
+    const isPresent = await exists(path);
+    const previousContent = isPresent ? await readFile(path, encoding) : '';
+    const newContent = update == null ? '' : update(previousContent);
+    if (newContent != null) {
+      await writeFile(path, newContent, encoding);
+    }
+  } else {
+    await rm(path);
+  }
+}
+
+/**
+ * Ensure file is present/absent with content initialized or modified with `update
+ *
+ * @example
+ * ```ts
+ * fileSync({
+ *   path: 'foo/bar',
+ *   state: 'present',
+ *   update: (content) => content + '_test', // This will append '_test' after current content
+ * })
+ * ```
+ *
+ * @param options
+ */
+export function fileSync(options: FileOptions): void {
+  const { path, state, update, encoding = 'utf8' } = options;
+  if (state === 'present') {
+    const isPresent = existsSync(path);
+    const previousContent = isPresent ? readFileSync(path, encoding) : '';
+    const newContent = update == null ? '' : update(previousContent);
+    if (newContent != null) {
+      writeFileSync(path, newContent, encoding);
+    }
+  } else {
+    rmSync(path);
+  }
+}

package/src/index.ts

@@ -1,2 +1,5 @@
 export * from './eslint.js';
+export * from './block.js';
+export * from './file.js';
+export * from './json.js';
 export * from './project.js';

package/src/json.ts

@@ -0,0 +1,57 @@
+import { type FileOptions, file, fileSync } from './file.js';
+
+export type JSONValue = null | number | string | boolean | JSONValue[] | { [key: string]: JSONValue };
+
+export interface JSONOption<V = JSONValue> {
+  /**
+   * File path
+   */
+  readonly path: string;
+  /**
+   * File target state
+   */
+  readonly state: 'present' | 'absent';
+  /**
+   * File content mapping function
+   *
+   * @param content
+   */
+  readonly update?: (content: V | undefined) => V | undefined;
+  /**
+   * File encoding
+   */
+  readonly encoding?: BufferEncoding;
+}
+
+function toFileOption<Value>({ update, ...otherOptions }: JSONOption<Value>): FileOptions {
+  return {
+    ...otherOptions,
+
+    update:
+      update == null
+        ? update
+        : (content) => {
+            const jsonValue = content === '' ? undefined : (JSON.parse(content) as Value);
+
+            return JSON.stringify(update(jsonValue));
+          },
+  };
+}
+
+/**
+ * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+export async function json<Value>(options: JSONOption<Value>): Promise<void> {
+  return file(toFileOption(options));
+}
+
+/**
+ * Ensure file is present/absent synchronously with content value initialized or modified with `update`
+ *
+ * @param options
+ */
+export function jsonSync<Value>(options: JSONOption<Value>): void {
+  return fileSync(toFileOption(options));
+}

package/src/project.ts

@@ -3,8 +3,26 @@ function escapeRegExp(value: string) {
 }
 
 export namespace Project {
+  /**
+   * A type of a file extension
+   */
   export type Extension = `.${string}`;
 
+  /**
+   * Object hash of all well-known file extension category to file extensions mapping
+   */
+  export interface ExtensionRegistry {
+    javascript: readonly Extension[];
+    javascriptreact: readonly Extension[];
+    typescript: readonly Extension[];
+    typescriptreact: readonly Extension[];
+  }
+
+  /**
+   * A list of "vscode-like" language identifiers (i.e. "javascript", "javascriptreact")
+   */
+  export type LanguageId = keyof ExtensionRegistry;
+
   /**
    * Supported ECMA version
    *
@@ -17,16 +35,32 @@ export namespace Project {
     return 2022 as const;
   }
 
-  const SOURCE_EXTENSIONS: readonly Extension[] = Object.freeze([
-    '.ts',
-    '.tsx',
-    '.cts',
-    '.mts',
-    '.js',
-    '.jsx',
-    '.cjs',
-    '.mjs',
-  ]);
+  const registry: { [key: string]: readonly Extension[] } = {
+    javascript: ['.js', '.cjs', '.mjs'],
+    javascriptreact: ['.jsx'],
+    typescript: ['.ts', '.cts', '.mts'],
+    typescriptreact: ['.tsx'],
+  };
+
+  /**
+   * Return a list of extensions
+   *
+   * @example
+   * ```ts
+   * Project.queryExtensions(['javascript']); // ['.js', '.cjs', ...]
+   * Project.queryExtensions(['typescript', 'typescriptreact']); // ['.ts', '.mts', ..., '.tsx']
+   * ```
+   *
+   * @param languages
+   */
+  export function queryExtensions(languages: LanguageId[]): readonly Extension[] {
+    return languages
+      .reduce<Extension[]>(
+        (previousValue, currentValue) => previousValue.concat(registry[currentValue] ?? ([] as Extension[])),
+        []
+      )
+      .sort();
+  }
 
   /**
    * Supported file extensions
@@ -37,7 +71,7 @@ export namespace Project {
    * ```
    */
   export function sourceExtensions() {
-    return SOURCE_EXTENSIONS;
+    return queryExtensions(['javascript', 'javascriptreact', 'typescript', 'typescriptreact']);
   }
 
   const RESOURCE_EXTENSIONS: readonly Extension[] = Object.freeze([