@halospv3/hce.shared-config 3.4.6-develop.1 → 3.4.6-develop.2

package/mjs/utils/Exact.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exact.d.mts","names":[],"sources":["../../src/utils/Exact.ts"],"mappings":";;AASA;;;;;;;;KAAY,KAAA,gBAAqB,CAAA,iBAAkB,CAAA,KAC9C,CAAA,WAAY,CAAA,kBAAmB,CAAA,GAAI,CAAA,CAAE,CAAA,MAAO,CAAA,iBAC/B,CAAA,IAAK,CAAA,eAAgB,CAAA,WAAY,CAAA,GAAI,SAAA,aAAsB,MAAA,CAAO,CAAA;AAAA,UA2B1E,SAAA;EAAA,CAAsB,YAAA,GAAe,OAAA;AAAA;AAAA,KAG1C,MAAA,SAAe,CAAA"}

package/mjs/utils/Exact.mjs

@@ -1,75 +1,2 @@
-/**
- * ### `Exact<T, S>`
- *
- * [issue](https://github.com/microsoft/TypeScript/issues/12936#issuecomment-2816928183)\
- * [author](https://github.com/ahrjarrett)\
- * license: unlicensed[!]
- * @see
- * - {@link https://tsplay.dev/NnGG6m}
- */
-
-// eslint-disable-next-line jsdoc/require-jsdoc, @typescript-eslint/no-unused-vars
-function exact(x, _y) {
-  return x;
-}
-;
-
-// should succeed
-exact({
-  a: 1
-}, {
-  a: 1
-});
-exact({
-  a: 1,
-  b: 'two'
-}, {
-  a: 1,
-  b: 'two'
-});
-
-// should raise a TypeError
-try {
-  // @ts-expect-error Type 'boolean' is not assignable to type 'TypeError<"Excess: 'c'">'.ts(2322)
-  exact({
-    a: 1
-  }, {
-    a: 1,
-    b: 'two',
-    c: false
-  });
-} catch {/* empty */}
-try {
-  // @ts-expect-error Type 'number' is not assignable to type 'TypeError<"Excess: 'c'">'.ts(2322)
-  exact({
-    a: 1,
-    b: 2
-  }, {
-    a: 1,
-    b: 2,
-    c: 3
-  });
-} catch {/* empty */}
-try {
-  // @ts-expect-error Argument of type '{ a: number; }' is not assignable to parameter of type '{ a: number; b: number; }'. Property 'b' is missing in type '{ a: number; }' but required in type '{ a: number; b: number; }'.ts(2345)
-  exact({
-    a: 1,
-    b: 2
-  }, {
-    a: 1
-  });
-} catch {/* empty */}
-
-// prior art: use arktype's ^^^ leading whitespace trick to avoid collisions
-
-try {
-  // @ts-expect-error Should error
-  exact({
-    a: 1
-  }, {
-    a: 1,
-    b: 2
-  });
-  //                           ^ 🚫 raises a TypeError here
-} catch {/* empty */}
-//# sourceMappingURL=Exact.mjs.map
+export{};
+//# sourceMappingURL=Exact.mjs.map

package/mjs/utils/Exact.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Exact.mjs","sources":["../../src/utils/Exact.ts"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,SAAS,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE;AACtB,EAAE,OAAO,CAAC;AACV;AACA;;AAEA;AACA,KAAK,CAAC;AACN,EAAE,CAAC,EAAE;AACL,CAAC,EAAE;AACH,EAAE,CAAC,EAAE;AACL,CAAC,CAAC;AACF,KAAK,CAAC;AACN,EAAE,CAAC,EAAE,CAAC;AACN,EAAE,CAAC,EAAE;AACL,CAAC,EAAE;AACH,EAAE,CAAC,EAAE,CAAC;AACN,EAAE,CAAC,EAAE;AACL,CAAC,CAAC;;AAEF;AACA,IAAI;AACJ;AACA,EAAE,KAAK,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,EAAE;AACL,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE,KAAK;AACZ,IAAI,CAAC,EAAE;AACP,GAAG,CAAC;AACJ,CAAC,CAAC,MAAM,YAAY;AACpB,IAAI;AACJ;AACA,EAAE,KAAK,CAAC;AACR,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,EAAE;AACL,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,CAAC;AACJ,CAAC,CAAC,MAAM,YAAY;AACpB,IAAI;AACJ;AACA,EAAE,KAAK,CAAC;AACR,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,EAAE;AACL,IAAI,CAAC,EAAE;AACP,GAAG,CAAC;AACJ,CAAC,CAAC,MAAM,YAAY;;AAEpB;;AAEA,IAAI;AACJ;AACA,EAAE,KAAK,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,EAAE;AACL,IAAI,CAAC,EAAE,CAAC;AACR,IAAI,CAAC,EAAE;AACP,GAAG,CAAC;AACJ;AACA,CAAC,CAAC,MAAM,YAAY"}
+{"version":3,"file":"Exact.mjs","names":[],"sources":["../../src/utils/Exact.ts"],"sourcesContent":["/**\n * ### `Exact<T, S>`\n *\n * [issue](https://github.com/microsoft/TypeScript/issues/12936#issuecomment-2816928183)\\\n * [author](https://github.com/ahrjarrett)\\\n * license: unlicensed[!]\n * @see\n * - {@link https://tsplay.dev/NnGG6m}\n */\nexport type Exact<T, S> = [keyof T] extends [keyof S]\n  ? [T] extends [S] ? { [K in keyof T]: T[K] } : S\n  : { [K in keyof T as K extends keyof S ? never : K]: TypeError<`Excess: '${Coerce<K>}'`> };\n\n// eslint-disable-next-line jsdoc/require-jsdoc, @typescript-eslint/no-unused-vars\nfunction exact<S, T extends Exact<T, S>>(x: S, _y: T): T {\n  return x as unknown as T;\n};\n\n// should succeed\nexact({ a: 1 }, { a: 1 });\nexact({ a: 1, b: 'two' }, { a: 1, b: 'two' });\n\n// should raise a TypeError\ntry {\n  // @ts-expect-error Type 'boolean' is not assignable to type 'TypeError<\"Excess: 'c'\">'.ts(2322)\n  exact({ a: 1 }, { a: 1, b: 'two', c: false });\n}\ncatch { /* empty */ }\ntry {\n  // @ts-expect-error Type 'number' is not assignable to type 'TypeError<\"Excess: 'c'\">'.ts(2322)\n  exact({ a: 1, b: 2 }, { a: 1, b: 2, c: 3 });\n}\ncatch { /* empty */ }\ntry {\n  // @ts-expect-error Argument of type '{ a: number; }' is not assignable to parameter of type '{ a: number; b: number; }'. Property 'b' is missing in type '{ a: number; }' but required in type '{ a: number; b: number; }'.ts(2345)\n  exact({ a: 1, b: 2 }, { a: 1 });\n}\ncatch { /* empty */ }\ninterface TypeError<Message> { [' TypeError']: Message }\n// prior art: use arktype's ^^^ leading whitespace trick to avoid collisions\n\ntype Coerce<T> = `${T & (string | number)}`;\n\ntry {\n  // @ts-expect-error Should error\n  exact({ a: 1 }, { a: 1, b: 2 });\n  //                           ^ 🚫 raises a TypeError here\n}\ncatch { /* empty */ }\n"],"mappings":""}

package/mjs/utils/GracefulRecursion.d.mts

@@ -0,0 +1,14 @@
+//#region src/utils/GracefulRecursion.d.ts
+// #region https://dev.to/adrien2p/mastering-recursive-types-in-typescript-handling-depth-limitations-gracefully-5f4o#a-more-robust-solution-tuplebased-increment-and-decrement-types
+type Length<T extends unknown[]> = (T extends {
+  length: number;
+} ? T['length'] : never) & number;
+type TupleOf<N extends number, T extends unknown[] = []> = Length<T> extends N ? T : TupleOf<N, [...T, unknown]>;
+type Pop<T extends unknown[]> = T extends [...infer U, unknown] ? U : never;
+// Increment adds an element to a tuple, effectively creating N + 1
+type Increment<N extends number> = Length<[1, ...TupleOf<N>]>;
+// Decrement removes an element from a tuple, effectively creating N - 1
+type Decrement<N extends number> = Length<Pop<TupleOf<N>>>;
+//#endregion
+export { Decrement, Increment, Length, Pop, TupleOf };
+//# sourceMappingURL=GracefulRecursion.d.mts.map

package/mjs/utils/GracefulRecursion.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GracefulRecursion.d.mts","names":["Length","T","length","TupleOf","N","Pop","U","Increment","Decrement"],"sources":["../../src/utils/GracefulRecursion.d.ts"],"mappings":";;KACYA,MAAAA,yBAA+BC,CAAAA;EAAYC,MAAAA;AAAAA,IAAmBD,CAAAA;AAAAA,KAC9DE,OAAAA,+CAAsDH,MAAAA,CAAOC,CAAAA,UAAWG,CAAAA,GAChFH,CAAAA,GACAE,OAAAA,CAAQC,CAAAA,MAAOH,CAAAA;AAAAA,KACPI,GAAAA,wBAA2BJ,CAAAA,iCAAkCK,CAAAA;AAAAA;AAAAA,KAE7DC,SAAAA,qBAA8BP,MAAAA,QAAcG,OAAAA,CAAQC,CAAAA;AAAAA;AAAAA,KAEpDI,SAAAA,qBAA8BR,MAAAA,CAAOK,GAAAA,CAAIF,OAAAA,CAAQC,CAAAA"}

package/mjs/utils/env.d.mts

@@ -0,0 +1,28 @@
+import { DotenvConfigOptions, GetOptions } from "@dotenvx/dotenvx";
+
+//#region src/utils/env.d.ts
+/**
+* A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.
+* @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.
+* @param [overrides] If provided, this {@link NodeJS.ProcessEnv} object is merged into the return value, overriding existing properties where overlap occurs.
+* @returns A {@link NodeJS.ProcessEnv} object whose properties are variables loaded from the
+* process environment, the nearest .env file, and {@link overrides} (if provided). Where
+* overlap occurs, the later source takes priority.
+*/
+declare function getEnv(dotenvOptions?: DotenvConfigOptions, overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+* Get the value from the given env var in the current process or nearby .env file.
+* If found in process environment, its value is returned.
+* Else, try to get it from the nearest .env file.
+* If NOT found, return `undefined`
+* @param envVar The environment variable to lookup.
+* @param [options] Options to pass to {@link get}
+* @returns The string value of the environment variable or `undefined`.
+* `undefined` may be returned when the variable is undefined or its string is
+* empty, whitespace, or appears to have been converted from `null` or
+* `undefined`.
+*/
+declare function getEnvVarValue(envVar: string, options?: GetOptions): string | undefined;
+//#endregion
+export { getEnv, getEnvVarValue };
+//# sourceMappingURL=env.d.mts.map

package/mjs/utils/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/utils/env.ts"],"mappings":";;;;;AAuBA;;;;;;iBAAgB,MAAA,CAAO,aAAA,GAAgB,mBAAA,EAAqB,SAAA,GAAY,MAAA,CAAO,UAAA,GAAa,MAAA,CAAO,UAAA;;;;;;;;;;;AAqBnG;;iBAAgB,cAAA,CAAe,MAAA,UAAgB,OAAA,GAAU,UAAA"}

package/mjs/utils/env.mjs

@@ -1,47 +1,2 @@
-import dotenvx from '@dotenvx/dotenvx';
-import { env } from 'node:process';
-
-// I hate importing CommonJS modules with their broken default exports
-const get = dotenvx.get,
-  loadDotenv = dotenvx.config;
-
-/** `get` can return `undefined`. It can also return a `Record`, but that's internal. */
-
-/**
- * A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.
- * @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.
- * @param [overrides] If provided, this {@link NodeJS.ProcessEnv} object is merged into the return value, overriding existing properties where overlap occurs.
- * @returns A {@link NodeJS.ProcessEnv} object whose properties are variables loaded from the
- * process environment, the nearest .env file, and {@link overrides} (if provided). Where
- * overlap occurs, the later source takes priority.
- */
-function getEnv(dotenvOptions, overrides) {
-  loadDotenv(dotenvOptions);
-  if (overrides) Object.assign(env, overrides);
-  return env;
-}
-
-/**
- * Get the value from the given env var in the current process or nearby .env file.
- * If found in process environment, its value is returned.
- * Else, try to get it from the nearest .env file.
- * If NOT found, return `undefined`
- * @param envVar The environment variable to lookup.
- * @param [options] Options to pass to {@link get}
- * @returns The string value of the environment variable or `undefined`.
- * `undefined` may be returned when the variable is undefined or its string is
- * empty, whitespace, or appears to have been converted from `null` or
- * `undefined`.
- */
-function getEnvVarValue(envVar, options) {
-  options ??= {
-    ignore: ['MISSING_KEY', 'MISSING_ENV_FILE']
-  };
-  let value = env[envVar];
-  const x = get(envVar, options);
-  if (typeof x === 'string') value = x;
-  // I hate this. Why is undefined converted to a string?
-  return value === '' || value === 'undefined' ? undefined : value;
-}
-export { getEnv, getEnvVarValue };
-//# sourceMappingURL=env.mjs.map
+import{env as e}from"node:process";import t from"@dotenvx/dotenvx";const{get:n,config:r}=t;function i(t,n){return r(t),n&&Object.assign(e,n),e}function a(t,r){r??={ignore:[`MISSING_KEY`,`MISSING_ENV_FILE`]};let i=e[t],a=n(t,r);return typeof a==`string`&&(i=a),i===``||i===`undefined`?void 0:i}export{i as getEnv,a as getEnvVarValue};
+//# sourceMappingURL=env.mjs.map

package/mjs/utils/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sources":["../../src/utils/env.ts"],"names":[],"mappings":";;;AAGA;AACA,MAAM;AACN,EAAE,GAAG;AACL,EAAE,MAAM,EAAE;AACV,CAAC,GAAG,OAAO;;AAEX;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE;AACjD,EAAE,UAAU,CAAC,aAAa,CAAC;AAC3B,EAAE,IAAI,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;AAC9C,EAAE,OAAO,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE;AAChD,EAAE,OAAO,KAAK;AACd,IAAI,MAAM,EAAE,CAAC,aAAa,EAAE,kBAAkB;AAC9C,GAAG;AACH,EAAE,IAAI,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;AACzB,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AAChC,EAAE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,KAAK,GAAG,CAAC;AACtC;AACA,EAAE,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,WAAW,GAAG,SAAS,GAAG,KAAK;AAClE;;;;"}
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/utils/env.ts"],"sourcesContent":["import dotenvx, {\n  type DotenvConfigOptions,\n  type GetOptions,\n} from '@dotenvx/dotenvx';\nimport { env } from 'node:process';\n\n// I hate importing CommonJS modules with their broken default exports\nconst {\n  get,\n  config: loadDotenv,\n} = dotenvx;\n\n/** `get` can return `undefined`. It can also return a `Record`, but that's internal. */\ntype Get = (key: string, options?: GetOptions) => string | undefined;\n\n/**\n * A thin wrapper for {@link loadDotenv}. Loads a .env file from {@link process.cwd()} with the given options (or defaults), returns the new value of {@link process.env} with optional overrides.\n * @param [dotenvOptions] An optional {@link DotenvConfigOptions} object to pass to {@link loadDotenv}.\n * @param [overrides] If provided, this {@link NodeJS.ProcessEnv} object is merged into the return value, overriding existing properties where overlap occurs.\n * @returns A {@link NodeJS.ProcessEnv} object whose properties are variables loaded from the\n * process environment, the nearest .env file, and {@link overrides} (if provided). Where\n * overlap occurs, the later source takes priority.\n */\nexport function getEnv(dotenvOptions?: DotenvConfigOptions, overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv {\n  loadDotenv(dotenvOptions);\n\n  if (overrides)\n    Object.assign(env, overrides);\n\n  return env;\n}\n\n/**\n * Get the value from the given env var in the current process or nearby .env file.\n * If found in process environment, its value is returned.\n * Else, try to get it from the nearest .env file.\n * If NOT found, return `undefined`\n * @param envVar The environment variable to lookup.\n * @param [options] Options to pass to {@link get}\n * @returns The string value of the environment variable or `undefined`.\n * `undefined` may be returned when the variable is undefined or its string is\n * empty, whitespace, or appears to have been converted from `null` or\n * `undefined`.\n */\nexport function getEnvVarValue(envVar: string, options?: GetOptions): string | undefined {\n  options ??= { ignore: ['MISSING_KEY', 'MISSING_ENV_FILE'] };\n  let value = env[envVar];\n  const x = (get as Get)(envVar, options);\n  if (typeof x === 'string')\n    value = x;\n  // I hate this. Why is undefined converted to a string?\n  return value === '' || value === 'undefined'\n    ? undefined\n    : value;\n}\n"],"mappings":"mEAOA,KAAM,CACJ,MACA,OAAQ,GACN,EAaJ,SAAgB,EAAO,EAAqC,EAAkD,CAM5G,OALA,EAAW,EAAc,CAErB,GACF,OAAO,OAAO,EAAK,EAAU,CAExB,EAeT,SAAgB,EAAe,EAAgB,EAA0C,CACvF,IAAY,CAAE,OAAQ,CAAC,cAAe,mBAAmB,CAAE,CAC3D,IAAI,EAAQ,EAAI,GACV,EAAK,EAAY,EAAQ,EAAQ,CAIvC,OAHI,OAAO,GAAM,WACf,EAAQ,GAEH,IAAU,IAAM,IAAU,YAC7B,IAAA,GACA"}

package/mjs/utils/execAsync.d.mts

@@ -0,0 +1,40 @@
+import { Type } from "arktype";
+
+//#region src/utils/execAsync.d.ts
+/**
+* A `promisify(exec)` wrapper to optionally assign the child process's STDERR as the {@link Error.prototype.cause}.
+* @see {@link promisify}, {@link exec}
+* @param command The command to run, with space-separated arguments.
+* @param [setStderrAsCause=false] If true and the child process's stderr is available, the thrown Error's {@link Error.prototype.cause} is assigned the stderr string.
+* @returns A promise of the child process's STDOUT and STDERR streams as strings
+* @throws {Error | ChildProcessSpawnException}
+*/
+declare function execAsync(command: string, setStderrAsCause?: boolean): Promise<{
+  stdout: string;
+  stderr: string;
+}>;
+declare const T_ExecException: Type<{
+  name: string;
+  message: string;
+  stack?: string | undefined;
+  cause?: unknown;
+  cmd?: string | null | undefined;
+  killed?: boolean | null | undefined;
+  code?: number | null | undefined;
+  signal?: "SIGABRT" | "SIGALRM" | "SIGBUS" | "SIGCHLD" | "SIGCONT" | "SIGFPE" | "SIGHUP" | "SIGILL" | "SIGINT" | "SIGIO" | "SIGIOT" | "SIGKILL" | "SIGPIPE" | "SIGPOLL" | "SIGPROF" | "SIGPWR" | "SIGQUIT" | "SIGSEGV" | "SIGSTKFLT" | "SIGSTOP" | "SIGSYS" | "SIGTERM" | "SIGTRAP" | "SIGTSTP" | "SIGTTIN" | "SIGTTOU" | "SIGUNUSED" | "SIGURG" | "SIGUSR1" | "SIGUSR2" | "SIGVTALRM" | "SIGWINCH" | "SIGXCPU" | "SIGXFSZ" | "SIGBREAK" | "SIGLOST" | "SIGINFO" | null | undefined;
+  stdout?: string | undefined;
+  stderr?: string | undefined;
+}>;
+type _ExecException = typeof T_ExecException.inferOut;
+declare class ChildProcessSpawnException extends Error implements _ExecException {
+  constructor(message: Parameters<typeof Error>[0], options: typeof T_ExecException.inferIn);
+  cmd: typeof T_ExecException.inferOut.cmd;
+  code: typeof T_ExecException.inferOut.code;
+  killed: typeof T_ExecException.inferOut.killed;
+  signal: typeof T_ExecException.inferOut.signal;
+  stderr: typeof T_ExecException.inferOut.stderr;
+  stdout: typeof T_ExecException.inferOut.stdout;
+}
+//#endregion
+export { ChildProcessSpawnException, execAsync };
+//# sourceMappingURL=execAsync.d.mts.map

package/mjs/utils/execAsync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execAsync.d.mts","names":[],"sources":["../../src/utils/execAsync.ts"],"mappings":";;;;;AAeA;;;;;;iBAAsB,SAAA,CAAU,OAAA,UAAiB,gBAAA,aAA2B,OAAA;EAC1E,MAAA;EACA,MAAA;AAAA;AAAA,cAwBI,eAAA,EAAiB,IAAA;EACrB,IAAA;EACA,OAAA;EACA,KAAA;EACA,KAAA;EACA,GAAA;EACA,MAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA;EACA,MAAA;AAAA;AAAA,KAaG,cAAA,UAAwB,eAAA,CAAgB,QAAA;AAAA,cAEhC,0BAAA,SAAmC,KAAA,YAAiB,cAAA;EAC/D,WAAA,CACE,OAAA,EAAS,UAAA,QAAkB,KAAA,MAC3B,OAAA,SAAgB,eAAA,CAAgB,OAAA;EAYlC,GAAA,SAAY,eAAA,CAAgB,QAAA,CAAS,GAAA;EACrC,IAAA,SAAa,eAAA,CAAgB,QAAA,CAAS,IAAA;EACtC,MAAA,SAAe,eAAA,CAAgB,QAAA,CAAS,MAAA;EACxC,MAAA,SAAe,eAAA,CAAgB,QAAA,CAAS,MAAA;EACxC,MAAA,SAAe,eAAA,CAAgB,QAAA,CAAS,MAAA;EACxC,MAAA,SAAe,eAAA,CAAgB,QAAA,CAAS,MAAA;AAAA"}

package/mjs/utils/execAsync.mjs

@@ -1,59 +1,10 @@
-import { type } from 'arktype';
-import { exec } from 'node:child_process';
-import { constants } from 'node:os';
-import { promisify } from 'node:util';
-import { isError } from './isError.mjs';
-
-/* eslint-disable jsdoc/no-defaults */
-
-/**
- * A `promisify(exec)` wrapper to optionally assign the child process's STDERR as the {@link Error.prototype.cause}.
- * @see {@link promisify}, {@link exec}
- * @param command The command to run, with space-separated arguments.
- * @param [setStderrAsCause=false] If true and the child process's stderr is available, the thrown Error's {@link Error.prototype.cause} is assigned the stderr string.
- * @returns A promise of the child process's STDOUT and STDERR streams as strings
- * @throws {Error | ChildProcessSpawnException}
- */
-async function execAsync(command, setStderrAsCause = false) {
-  return await promisify(exec)(command).catch(error => {
-    if (!isError(error)) throw new Error(JSON.stringify(error));
-    if (setStderrAsCause && 'stderr' in error && typeof error.stderr === 'string' && error.stderr !== '') error.cause ??= error.stderr;
-    if ('stdout' in error && typeof error.stdout === 'string') {
-      error.message += '\nSTDOUT:\n' + `  ${error.stdout.replaceAll('\n', '\n  ')}`;
-    }
-    if ('stderr' in error && typeof error.stderr === 'string') {
-      error.message += '\nSTDERR:\n' + `  ${error.stderr.replaceAll('\n', '\n  ')}`;
-    }
-    throw new ChildProcessSpawnException(error.message, error);
-  });
-}
-const T_ExecException = type('Error').and({
-  'cmd?': 'string | null',
-  'killed?': 'boolean | null',
-  'code?': 'number | null',
-  'signal?': type.null.or(Object.keys(constants.signals).map(v => type(`'${v}'`))
-  // eslint-disable-next-line unicorn/no-array-reduce
-  .reduce((previous, current) => previous.or(current))),
-  'stdout?': 'string',
-  'stderr?': 'string'
-});
-class ChildProcessSpawnException extends Error {
-  constructor(message, options) {
-    options = T_ExecException.from(options);
-    super(message, options);
-    this.cmd = options.cmd;
-    this.code = options.code;
-    this.killed = options.killed;
-    this.signal = options.signal;
-    this.stderr = options.stderr;
-    this.stdout = options.stdout;
-  }
-  cmd;
-  code;
-  killed;
-  signal;
-  stderr;
-  stdout;
-}
-export { ChildProcessSpawnException, execAsync };
-//# sourceMappingURL=execAsync.mjs.map
+import{isError as e}from"./isError.mjs";import{promisify as t}from"node:util";import{type as n}from"arktype";import{exec as r}from"node:child_process";import{constants as i}from"node:os";async function a(n,i=!1){return await t(r)(n).catch(t=>{throw e(t)?(i&&`stderr`in t&&typeof t.stderr==`string`&&t.stderr!==``&&(t.cause??=t.stderr),`stdout`in t&&typeof t.stdout==`string`&&(t.message+=`
+STDOUT:
+  ${t.stdout.replaceAll(`
+`,`
+  `)}`),`stderr`in t&&typeof t.stderr==`string`&&(t.message+=`
+STDERR:
+  ${t.stderr.replaceAll(`
+`,`
+  `)}`),new s(t.message,t)):Error(JSON.stringify(t))})}const o=n(`Error`).and({"cmd?":`string | null`,"killed?":`boolean | null`,"code?":`number | null`,"signal?":n.null.or(Object.keys(i.signals).map(e=>n(`'${e}'`)).reduce((e,t)=>e.or(t))),"stdout?":`string`,"stderr?":`string`});var s=class extends Error{constructor(e,t){t=o.from(t),super(e,t),this.cmd=t.cmd,this.code=t.code,this.killed=t.killed,this.signal=t.signal,this.stderr=t.stderr,this.stdout=t.stdout}cmd;code;killed;signal;stderr;stdout};export{s as ChildProcessSpawnException,a as execAsync};
+//# sourceMappingURL=execAsync.mjs.map

package/mjs/utils/execAsync.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execAsync.mjs","sources":["../../src/utils/execAsync.ts"],"names":[],"mappings":";;;;;;AAAA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,EAAE;AACnE,EAAE,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI;AACvD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/D,IAAI,IAAI,gBAAgB,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM;AACtI,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF,IAAI;AACJ,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF,IAAI;AACJ,IAAI,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;AAC9D,EAAE,CAAC,CAAC;AACJ;AACA,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC;AAC1C,EAAE,MAAM,EAAE,eAAe;AACzB,EAAE,SAAS,EAAE,gBAAgB;AAC7B,EAAE,OAAO,EAAE,eAAe;AAC1B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF;AACA,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,EAAE,SAAS,EAAE,QAAQ;AACrB,EAAE,SAAS,EAAE;AACb,CAAC,CAAC;AACK,MAAM,0BAA0B,SAAS,KAAK,CAAC;AACtD,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE;AAChC,IAAI,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;AAC3C,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;AAC3B,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;AAC1B,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;AAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,EAAE;AACF,EAAE,GAAG;AACL,EAAE,IAAI;AACN,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR;;;;"}
+{"version":3,"file":"execAsync.mjs","names":[],"sources":["../../src/utils/execAsync.ts"],"sourcesContent":["/* eslint-disable jsdoc/no-defaults */\nimport { type, type Type } from 'arktype';\nimport { exec } from 'node:child_process';\nimport { constants } from 'node:os';\nimport { promisify } from 'node:util';\nimport { isError } from './isError.ts';\n\n/**\n * A `promisify(exec)` wrapper to optionally assign the child process's STDERR as the {@link Error.prototype.cause}.\n * @see {@link promisify}, {@link exec}\n * @param command The command to run, with space-separated arguments.\n * @param [setStderrAsCause=false] If true and the child process's stderr is available, the thrown Error's {@link Error.prototype.cause} is assigned the stderr string.\n * @returns A promise of the child process's STDOUT and STDERR streams as strings\n * @throws {Error | ChildProcessSpawnException}\n */\nexport async function execAsync(command: string, setStderrAsCause = false): Promise<{\n  stdout: string;\n  stderr: string;\n}> {\n  return await promisify(exec)(command).catch((error: unknown): never => {\n    if (!isError(error))\n      throw new Error(JSON.stringify(error));\n\n    if (setStderrAsCause && 'stderr' in error && typeof error.stderr === 'string' && error.stderr !== '')\n      error.cause ??= error.stderr;\n\n    if ('stdout' in error && typeof error.stdout === 'string') {\n      error.message\n        += '\\nSTDOUT:\\n'\n          + `  ${error.stdout.replaceAll('\\n', '\\n  ')}`;\n    }\n    if ('stderr' in error && typeof error.stderr === 'string') {\n      error.message\n        += '\\nSTDERR:\\n'\n          + `  ${error.stderr.replaceAll('\\n', '\\n  ')}`;\n    }\n\n    throw new ChildProcessSpawnException(error.message, error);\n  });\n}\n\nconst T_ExecException: Type<{\n  name: string;\n  message: string;\n  stack?: string | undefined;\n  cause?: unknown;\n  cmd?: string | null | undefined;\n  killed?: boolean | null | undefined;\n  code?: number | null | undefined;\n  signal?: 'SIGABRT' | 'SIGALRM' | 'SIGBUS' | 'SIGCHLD' | 'SIGCONT' | 'SIGFPE' | 'SIGHUP' | 'SIGILL' | 'SIGINT' | 'SIGIO' | 'SIGIOT' | 'SIGKILL' | 'SIGPIPE' | 'SIGPOLL' | 'SIGPROF' | 'SIGPWR' | 'SIGQUIT' | 'SIGSEGV' | 'SIGSTKFLT' | 'SIGSTOP' | 'SIGSYS' | 'SIGTERM' | 'SIGTRAP' | 'SIGTSTP' | 'SIGTTIN' | 'SIGTTOU' | 'SIGUNUSED' | 'SIGURG' | 'SIGUSR1' | 'SIGUSR2' | 'SIGVTALRM' | 'SIGWINCH' | 'SIGXCPU' | 'SIGXFSZ' | 'SIGBREAK' | 'SIGLOST' | 'SIGINFO' | null | undefined;\n  stdout?: string | undefined;\n  stderr?: string | undefined;\n}> = type('Error').and({\n  'cmd?': 'string | null',\n  'killed?': 'boolean | null',\n  'code?': 'number | null',\n  'signal?': type.null.or((Object.keys(constants.signals) as NodeJS.Signals[])\n    .map(v => type(`'${v}'`))\n    // eslint-disable-next-line unicorn/no-array-reduce\n    .reduce((previous, current) => previous.or(current))),\n  'stdout?': 'string',\n  'stderr?': 'string',\n});\n\ntype _ExecException = typeof T_ExecException.inferOut;\n\nexport class ChildProcessSpawnException extends Error implements _ExecException {\n  constructor(\n    message: Parameters<typeof Error>[0],\n    options: typeof T_ExecException.inferIn,\n  ) {\n    options = T_ExecException.from(options);\n    super(message, options);\n    this.cmd = options.cmd;\n    this.code = options.code;\n    this.killed = options.killed;\n    this.signal = options.signal;\n    this.stderr = options.stderr;\n    this.stdout = options.stdout;\n  }\n\n  cmd: typeof T_ExecException.inferOut.cmd;\n  code: typeof T_ExecException.inferOut.code;\n  killed: typeof T_ExecException.inferOut.killed;\n  signal: typeof T_ExecException.inferOut.signal;\n  stderr: typeof T_ExecException.inferOut.stderr;\n  stdout: typeof T_ExecException.inferOut.stdout;\n}\n"],"mappings":"2LAeA,eAAsB,EAAU,EAAiB,EAAmB,GAGjE,CACD,OAAO,MAAM,EAAU,EAAK,CAAC,EAAQ,CAAC,MAAO,GAA0B,CAkBrE,MAjBK,EAAQ,EAAM,EAGf,GAAoB,WAAY,GAAS,OAAO,EAAM,QAAW,UAAY,EAAM,SAAW,KAChG,EAAM,QAAU,EAAM,QAEpB,WAAY,GAAS,OAAO,EAAM,QAAW,WAC/C,EAAM,SACD;;IACM,EAAM,OAAO,WAAW;EAAM;IAAO,IAE9C,WAAY,GAAS,OAAO,EAAM,QAAW,WAC/C,EAAM,SACD;;IACM,EAAM,OAAO,WAAW;EAAM;IAAO,IAG5C,IAAI,EAA2B,EAAM,QAAS,EAAM,EAhB9C,MAAM,KAAK,UAAU,EAAM,CAAC,EAiBxC,CAGJ,MAAM,EAWD,EAAK,QAAQ,CAAC,IAAI,CACrB,OAAQ,gBACR,UAAW,iBACX,QAAS,gBACT,UAAW,EAAK,KAAK,GAAI,OAAO,KAAK,EAAU,QAAQ,CACpD,IAAI,GAAK,EAAK,IAAI,EAAE,GAAG,CAAC,CAExB,QAAQ,EAAU,IAAY,EAAS,GAAG,EAAQ,CAAC,CAAC,CACvD,UAAW,SACX,UAAW,SACZ,CAAC,CAIF,IAAa,EAAb,cAAgD,KAAgC,CAC9E,YACE,EACA,EACA,CACA,EAAU,EAAgB,KAAK,EAAQ,CACvC,MAAM,EAAS,EAAQ,CACvB,KAAK,IAAM,EAAQ,IACnB,KAAK,KAAO,EAAQ,KACpB,KAAK,OAAS,EAAQ,OACtB,KAAK,OAAS,EAAQ,OACtB,KAAK,OAAS,EAAQ,OACtB,KAAK,OAAS,EAAQ,OAGxB,IACA,KACA,OACA,OACA,OACA"}

package/mjs/utils/isError.d.mts

@@ -0,0 +1,14 @@
+//#region src/utils/isError.d.ts
+/** @import 'typescript/lib/lib.esnext.error.d.ts' */
+/**
+* Compatibility wrapper for ES2026 (Node.js 25)
+* {@link Error.isError Error.isError}
+* with failover to the deprecated {@link isNativeError utils.types.isNativeError}.
+* @param error A parameter which may be an Error.
+* @returns `true` if {@link error} is derived from or is sufficiently similar to {@link Error}. Else, `false`.
+* Note: DOMExceptions will result in `false`
+*/
+declare function isError(error: unknown): error is Error;
+//#endregion
+export { isError };
+//# sourceMappingURL=isError.d.mts.map

package/mjs/utils/isError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isError.d.mts","names":[],"sources":["../../src/utils/isError.ts"],"mappings":";;AAYA;;;;;;;;AAAA,iBAAgB,OAAA,CAAQ,KAAA,YAAiB,KAAA,IAAS,KAAA"}

package/mjs/utils/isError.mjs

@@ -1,19 +1,2 @@
-import { isNativeError } from 'node:util/types';
-
-/** @import 'typescript/lib/lib.esnext.error.d.ts' */
-
-/**
- * Compatibility wrapper for ES2026 (Node.js 25)
- * {@link Error.isError Error.isError}
- * with failover to the deprecated {@link isNativeError utils.types.isNativeError}.
- * @param error A parameter which may be an Error.
- * @returns `true` if {@link error} is derived from or is sufficiently similar to {@link Error}. Else, `false`.
- * Note: DOMExceptions will result in `false`
- */
-function isError(error) {
-  return 'isError' in Error && typeof Error.isError === 'function' && Error.isError.length > 0 ? Error.isError(error)
-  // eslint-disable-next-line @typescript-eslint/no-deprecated
-  : isNativeError(error);
-}
-export { isError };
-//# sourceMappingURL=isError.mjs.map
+import{isNativeError as e}from"node:util/types";function t(t){return`isError`in Error&&typeof Error.isError==`function`&&Error.isError.length>0?Error.isError(t):e(t)}export{t as isError};
+//# sourceMappingURL=isError.mjs.map

package/mjs/utils/isError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"isError.mjs","sources":["../../src/utils/isError.ts"],"names":[],"mappings":";;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,OAAO,CAAC,KAAK,EAAE;AAC/B,EAAE,OAAO,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK;AACpH;AACA,IAAI,aAAa,CAAC,KAAK,CAAC;AACxB;;;;"}
+{"version":3,"file":"isError.mjs","names":[],"sources":["../../src/utils/isError.ts"],"sourcesContent":["import { isNativeError } from 'node:util/types';\n\n/** @import 'typescript/lib/lib.esnext.error.d.ts' */\n\n/**\n * Compatibility wrapper for ES2026 (Node.js 25)\n * {@link Error.isError Error.isError}\n * with failover to the deprecated {@link isNativeError utils.types.isNativeError}.\n * @param error A parameter which may be an Error.\n * @returns `true` if {@link error} is derived from or is sufficiently similar to {@link Error}. Else, `false`.\n * Note: DOMExceptions will result in `false`\n */\nexport function isError(error: unknown): error is Error {\n  return 'isError' in Error && typeof Error.isError === 'function' && Error.isError.length > 0\n    ? (Error.isError as typeof isError)(error)\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    : isNativeError(error);\n}\n"],"mappings":"gDAYA,SAAgB,EAAQ,EAAgC,CACtD,MAAO,YAAa,OAAS,OAAO,MAAM,SAAY,YAAc,MAAM,QAAQ,OAAS,EACtF,MAAM,QAA2B,EAAM,CAExC,EAAc,EAAM"}

package/mjs/utils/miscTypes.d.mts

@@ -0,0 +1,16 @@
+import { Type } from "arktype";
+
+//#region src/utils/miscTypes.d.ts
+declare const tBooleanString: Type<"false" | "true">;
+type BooleanString = typeof tBooleanString.infer;
+declare const tEmptyOrBooleanString: Type<"" | "false" | "true">;
+type EmptyOrBooleanString = typeof tEmptyOrBooleanString.infer;
+type Integer<N extends number> = `${N}` extends `${number}.${number}` ? never : N;
+/**
+* @see https://stackoverflow.com/a/73920140/14894786
+*/
+type TupleIndices<T extends readonly unknown[]> = Extract<keyof T, `${number}`> extends `${infer N extends number}` ? N : never;
+type InstanceOrStatic = "Instance" | "Static";
+//#endregion
+export { BooleanString, EmptyOrBooleanString, InstanceOrStatic, Integer, TupleIndices, tBooleanString, tEmptyOrBooleanString };
+//# sourceMappingURL=miscTypes.d.mts.map

package/mjs/utils/miscTypes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miscTypes.d.mts","names":[],"sources":["../../src/utils/miscTypes.ts"],"mappings":";;;cAEa,cAAA,EAAgB,IAAA;AAAA,KACjB,aAAA,UAAuB,cAAA,CAAe,KAAA;AAAA,cAErC,qBAAA,EAAuB,IAAA;AAAA,KACxB,oBAAA,UAA8B,qBAAA,CAAsB,KAAA;AAAA,KAEpD,OAAA,wBAA+B,CAAA,2CAA4C,CAAA;;;AALvF;KAUY,YAAA,iCACR,OAAA,OAAc,CAAA,qDAAsD,CAAA;AAAA,KAE5D,gBAAA"}

package/mjs/utils/miscTypes.mjs

@@ -1,10 +1,2 @@
-import { type } from 'arktype';
-const tBooleanString = type('"true" | "false"');
-const tEmptyOrBooleanString = type(tBooleanString.or('""'));
-
-/**
- * @see https://stackoverflow.com/a/73920140/14894786
- */
-
-export { tBooleanString, tEmptyOrBooleanString };
-//# sourceMappingURL=miscTypes.mjs.map
+import{type as e}from"arktype";const t=e(`"true" | "false"`),n=e(t.or(`""`));export{t as tBooleanString,n as tEmptyOrBooleanString};
+//# sourceMappingURL=miscTypes.mjs.map

package/mjs/utils/miscTypes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"miscTypes.mjs","sources":["../../src/utils/miscTypes.ts"],"names":[],"mappings":";;AACY,MAAC,cAAc,GAAG,IAAI,CAAC,kBAAkB;AACzC,MAAC,qBAAqB,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC;;AAEjE;AACA;AACA;;;;"}
+{"version":3,"file":"miscTypes.mjs","names":[],"sources":["../../src/utils/miscTypes.ts"],"sourcesContent":["import { type, type Type } from 'arktype';\n\nexport const tBooleanString: Type<'false' | 'true'> = type('\"true\" | \"false\"');\nexport type BooleanString = typeof tBooleanString.infer;\n\nexport const tEmptyOrBooleanString: Type<'' | 'false' | 'true'> = type(tBooleanString.or('\"\"'));\nexport type EmptyOrBooleanString = typeof tEmptyOrBooleanString.infer;\n\nexport type Integer<N extends number> = `${N}` extends `${number}.${number}` ? never : N;\n\n/**\n * @see https://stackoverflow.com/a/73920140/14894786\n */\nexport type TupleIndices<T extends readonly unknown[]>\n  = Extract<keyof T, `${number}`> extends `${infer N extends number}` ? N : never;\n\nexport type InstanceOrStatic = 'Instance' | 'Static';\n"],"mappings":"+BAEA,MAAa,EAAyC,EAAK,mBAAmB,CAGjE,EAAqD,EAAK,EAAe,GAAG,KAAK,CAAC"}

package/mjs/utils/reflection/FunctionLike.d.mts

@@ -0,0 +1,17 @@
+//#region src/utils/reflection/FunctionLike.d.ts
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * A generic alternative to the boxing {@link Function} type. Based on the
+ * expressions of {@link Parameters} and {@link ReturnType}.
+ * @template [T=((...args: any[] | readonly any[]) => any)] Any function-like type.
+ * @template [P=Parameters<T>]
+ * [INTERNAL] The parameters of {@link T}.
+ * @template [R=ReturnType<T>]
+ * [INTERNAL] The return type of {@link T}.
+ * @default ((...args: any[] | readonly any[]) => any)
+ * @since 3.0.0
+ */
+type FunctionLike<T extends ((...args: any[] | readonly any[]) => any) = ((...args: any[] | readonly any[]) => any), P extends Parameters<T> = Parameters<T>, R extends ReturnType<T> = ReturnType<T>> = T & ((...args: P) => R);
+//#endregion
+export { FunctionLike };
+//# sourceMappingURL=FunctionLike.d.mts.map

package/mjs/utils/reflection/FunctionLike.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionLike.d.mts","names":["FunctionLike","T","P","R","Parameters","ReturnType","args"],"sources":["../../../src/utils/reflection/FunctionLike.d.ts"],"mappings":";;AAYA;;;;;;;;;;;AAAA,KAAYA,YAAAA,gBACKM,IAAAA,yCAA6CA,IAAAA,6CAClDF,UAAAA,CAAWH,CAAAA,IAAKG,UAAAA,CAAWH,CAAAA,aAC3BI,UAAAA,CAAWJ,CAAAA,IAAKI,UAAAA,CAAWJ,CAAAA,KACnCA,CAAAA,QAASK,IAAAA,EAAMJ,CAAAA,KAAMC,CAAAA"}

package/mjs/utils/reflection/GetterDescriptor.d.mts

@@ -0,0 +1,11 @@
+//#region src/utils/reflection/GetterDescriptor.d.ts
+/**
+ * A type for casting a property descriptor to a getter descriptor.\
+ * Cast to this only after checking `typeof propertyDescriptor.get === 'function`
+ * @template [T=unknown] The type of the property.
+ * @since 4.0.0
+ */
+type GetterDescriptor<T = unknown> = Omit<TypedPropertyDescriptor<T>, 'get'> & Required<Pick<TypedPropertyDescriptor<T>, 'get'>>;
+//#endregion
+export { GetterDescriptor };
+//# sourceMappingURL=GetterDescriptor.d.mts.map

package/mjs/utils/reflection/GetterDescriptor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetterDescriptor.d.mts","names":["GetterDescriptor","T","TypedPropertyDescriptor","Omit","Pick","Required"],"sources":["../../../src/utils/reflection/GetterDescriptor.d.ts"],"mappings":";;AAMA;;;;;KAAYA,gBAAAA,gBAAgCG,IAAAA,CAAKD,uBAAAA,CAAwBD,CAAAA,YACrEI,QAAAA,CAASD,IAAAA,CAAKF,uBAAAA,CAAwBD,CAAAA"}

package/mjs/utils/reflection/InstancePropertyDescriptorMap.d.mts

@@ -0,0 +1,26 @@
+import { PropertyDescriptorMap } from "./PropertyDescriptorMap.mjs";
+import { BaseClassProto, ConstructorConstraint, InstanceTypeOrSelf, SuperClassLike, WithProto } from "./inheritance.mjs";
+
+//#region src/utils/reflection/InstancePropertyDescriptorMap.d.ts
+/**
+ * Generically-typed return type of `Object.GetOwnPropertyDescriptors` for class
+ * instances.
+ *
+ * Allows for statically-inferred property keys and values.
+ *
+ * Classes' `public` members are returned, including instance Getters and
+ * Setters.
+ * @template Class
+ * Any class type with its `[[Prototype]]` attached via a type-only `__proto__` property.
+ * The type of `__proto__` must extend {@link SuperClassLike} or {@link BaseClassProto}.
+ * @example
+ * ```ts
+ * const { NugetProjectProperties: NPP } = await import('../dotnet/NugetProjectProperties.js');
+ * const _instanceMembers: InstancePropertyDescriptorMap<typeof NPP>  = Object.getOwnPropertyDescriptors(new NugetProjectProperties('',new CaseInsensitiveMap([['','']])));
+ * ```
+ * @since 3.0.0
+ */
+type InstancePropertyDescriptorMap<Class extends ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>> = Class['__proto__'] extends BaseClassProto ? PropertyDescriptorMap<InstanceType<Class>> : PropertyDescriptorMap<InstanceType<Class>, InstanceTypeOrSelf<Class['__proto__']>>;
+//#endregion
+export { InstancePropertyDescriptorMap };
+//# sourceMappingURL=InstancePropertyDescriptorMap.d.mts.map

package/mjs/utils/reflection/InstancePropertyDescriptorMap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstancePropertyDescriptorMap.d.mts","names":["PropertyDescriptorMap","BaseClassProto","ConstructorConstraint","InstanceTypeOrSelf","SuperClassLike","WithProto","InstancePropertyDescriptorMap","Class","InstanceType"],"sources":["../../../src/utils/reflection/InstancePropertyDescriptorMap.d.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;KA2BYM,6BAAAA,eACIJ,qBAAAA,CAAsBK,KAAAA,IAASF,SAAAA,CAAUD,cAAAA,GAAiBH,cAAAA,KACtEM,KAAAA,sBAA2BN,cAAAA,GAC3BD,qBAAAA,CAAsBQ,YAAAA,CAAaD,KAAAA,KACnCP,qBAAAA,CAAsBQ,YAAAA,CAAaD,KAAAA,GAAQJ,kBAAAA,CAAmBI,KAAAA"}

package/mjs/utils/reflection/InstanceTypeOrSelfPropertyDescriptorMap.d.mts

@@ -0,0 +1,17 @@
+import { PropertyDescriptorMap } from "./PropertyDescriptorMap.mjs";
+import { BaseClassProto, ConstructorLike, InstanceTypeOrSelf, ProtoOrSuperClass, SuperClassLike, WithProto } from "./inheritance.mjs";
+import { InstancePropertyDescriptorMap } from "./InstancePropertyDescriptorMap.mjs";
+
+//#region src/utils/reflection/InstanceTypeOrSelfPropertyDescriptorMap.d.ts
+/**
+ * Variant of {@link InstancePropertyDescriptorMap} with a lesser constraint on {@link T}.
+ * If {@link T} and/or {@link __proto__} are instantiable, the resulting
+ * property descriptor maps will be of the instances' types.
+ * @template T `null` or an `object`-like type.
+ * @template __proto__ The `[[Prototype]]` of {@link T}.
+ * @since 3.0.0
+ */
+type InstanceTypeOrSelfPropertyDescriptorMap<T extends object | null, __proto__ extends ProtoOrSuperClass> = T extends ConstructorLike<T> ? __proto__ extends SuperClassLike | BaseClassProto ? InstancePropertyDescriptorMap<T & WithProto<__proto__>> : PropertyDescriptorMap<InstanceType<T>, InstanceTypeOrSelf<__proto__>> : PropertyDescriptorMap<InstanceTypeOrSelf<T>, InstanceTypeOrSelf<__proto__>>;
+//#endregion
+export { InstanceTypeOrSelfPropertyDescriptorMap };
+//# sourceMappingURL=InstanceTypeOrSelfPropertyDescriptorMap.d.mts.map

package/mjs/utils/reflection/InstanceTypeOrSelfPropertyDescriptorMap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceTypeOrSelfPropertyDescriptorMap.d.mts","names":["BaseClassProto","ConstructorLike","InstanceTypeOrSelf","ProtoOrSuperClass","SuperClassLike","WithProto","InstancePropertyDescriptorMap","PropertyDescriptorMap","InstanceTypeOrSelfPropertyDescriptorMap","T","__proto__","InstanceType"],"sources":["../../../src/utils/reflection/InstanceTypeOrSelfPropertyDescriptorMap.d.ts"],"mappings":";;;;;;AAYA;;;;;;;KAAYQ,uCAAAA,4CAEQL,iBAAAA,IAChBM,CAAAA,SAAUR,eAAAA,CAAgBQ,CAAAA,IAC1BC,SAAAA,SAAkBN,cAAAA,GAAiBJ,cAAAA,GACjCM,6BAAAA,CAA8BG,CAAAA,GAAIJ,SAAAA,CAAUK,SAAAA,KAC5CH,qBAAAA,CAAsBI,YAAAA,CAAaF,CAAAA,GAAIP,kBAAAA,CAAmBQ,SAAAA,KAC5DH,qBAAAA,CAAsBL,kBAAAA,CAAmBO,CAAAA,GAAIP,kBAAAA,CAAmBQ,SAAAA"}

package/mjs/utils/reflection/OwnGetterDescriptorMap.d.mts

@@ -0,0 +1,18 @@
+import { GetterDescriptor } from "./GetterDescriptor.mjs";
+import { OwnKeyOf } from "./OwnKeyOf.mjs";
+
+//#region src/utils/reflection/OwnGetterDescriptorMap.d.ts
+/**
+ * # !WARNING!
+ * > This does _not_ filter out non-getter properties! ALL properties are treated as getters. Because `get` is optional and present on all property descriptors, this type should only be used to cast properties for which `typeof p.get === 'function'`.
+ *
+ * A {@link GetterDescriptorMap} variant for omitting keys inherited from {@link __proto__}.
+ * Note: If `T` is `InstanceOf<class>`, then `__proto__` must be `InstanceTypeOrSelf<__proto__>`
+ * @template T The type the descriptor map describes.
+ * @template __proto__ The `[[Prototype]]` of {@link T}. Keys of {@link __proto__} are omitted from the descriptor map type.
+ * @since 3.0.0
+ */
+type OwnGetterDescriptorMap<T, __proto__ extends object | null> = { [P in OwnKeyOf<T, __proto__>]: GetterDescriptor<T[P]> };
+//#endregion
+export { OwnGetterDescriptorMap };
+//# sourceMappingURL=OwnGetterDescriptorMap.d.mts.map

package/mjs/utils/reflection/OwnGetterDescriptorMap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OwnGetterDescriptorMap.d.mts","names":["GetterDescriptor","OwnKeyOf","OwnGetterDescriptorMap","T","__proto__","P"],"sources":["../../../src/utils/reflection/OwnGetterDescriptorMap.d.ts"],"mappings":";;;;;AAaA;;;;;;;;;KAAYE,sBAAAA,+CAGAD,QAAAA,CAASE,CAAAA,EAAGC,SAAAA,IAAaJ,gBAAAA,CAAiBG,CAAAA,CAAEE,CAAAA"}

package/mjs/utils/reflection/OwnKeyOf.d.mts

@@ -0,0 +1,15 @@
+//#region src/utils/reflection/OwnKeyOf.d.ts
+/**
+ * The `keyof` type {@link T} excluding any keys of type {@link __proto__}
+ * @template T
+ * @template __proto__ `null` or any `object`-like type.
+ * @example
+ * OwnKeyOf<NPP, MSBPP> === "IsPackable" | "SuppressDependenciesWhenPacking" | "PackageVersion" | "PackageId" | "PackageDescription" | "Authors" | "Copyright" | "PackageRequireLicenseAcceptance" | "DevelopmentDependency" | "PackageLicenseExpression" | "PackageLicenseFile" | "PackageProjectUrl" | "PackageIcon" | "PackageReleaseNotes" | "PackageReadmeFile" | "PackageTags" | "PackageOutputPath" | "IncludeSymbols" | "IncludeSource" | "PackageType" | "IsTool" | "RepositoryUrl" | "RepositoryType" | "RepositoryCommit" | "SymbolPackageFormat" | "NoPackageAnalysis" | "MinClientVersion" | "IncludeBuildOutput" | "IncludeContentInPack" | "BuildOutputTargetFolder" | "ContentTargetFolders" | "NuspecFile" | "NuspecBasePath" | "NuspecProperties" | "Title" | "Company" | "Product"
+ * OwnKeyOf<typeof NPP, typeof MSBPP> === never ; // class NPP does not have non-inherited static members
+ * OwnKeyOf<typeof NPP, null> === "prototype" | "GetFullPath"
+ * @since 3.0.0
+ */
+type OwnKeyOf<T, __proto__ extends object | null> = Exclude<__proto__ extends null ? keyof T : Exclude<keyof T, keyof __proto__>, '__proto__'>;
+//#endregion
+export { OwnKeyOf };
+//# sourceMappingURL=OwnKeyOf.d.mts.map

package/mjs/utils/reflection/OwnKeyOf.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OwnKeyOf.d.mts","names":["OwnKeyOf","T","__proto__","Exclude"],"sources":["../../../src/utils/reflection/OwnKeyOf.d.ts"],"mappings":";;AAUA;;;;;;;;;KAAYA,QAAAA,uCACRG,OAAAA,CACAD,SAAAA,sBACUD,CAAAA,GACNE,OAAAA,OACMF,CAAAA,QACAC,SAAAA"}

package/mjs/utils/reflection/OwnPropertyDescriptorMap.d.mts

@@ -0,0 +1,15 @@
+import { BaseClass, ClassLike, ClassLike_Unknown, ProtoOrSuperClass, WithProto } from "./inheritance.mjs";
+
+//#region src/utils/reflection/OwnPropertyDescriptorMap.d.ts
+// todo: Omit [P in keyof T] where T['__proto__'][P] === T[P].
+// todo: NEVER omit overridden class members! Does TypeScript expose that override in accessible metadata?
+/**
+ * A typed {@link PropertyDescriptorMap} without any keys found in its `[[Prototype]]` chain.
+ * This may mean overridden class properties are wrongly omitted.
+ * @template T Any type with its `[[Prototype]]` attached via a type-only `__proto__` property. The type of `__proto__` must extends {@link ProtoOrSuperClass}.
+ * @since 3.0.0
+ */
+type OwnPropertyDescriptorMap<T extends WithProto<ProtoOrSuperClass>> = T['__proto__'] extends null ? { [P0 in keyof T]: TypedPropertyDescriptor<T[P0]> } : Omit<{ [P0 in keyof T]: TypedPropertyDescriptor<T[P0]> }, Exclude<keyof { [P1 in keyof T['__proto__']]: TypedPropertyDescriptor<T['__proto__'][P1]> }, keyof ClassLike<BaseClass<ClassLike_Unknown>>>>;
+//#endregion
+export { OwnPropertyDescriptorMap };
+//# sourceMappingURL=OwnPropertyDescriptorMap.d.mts.map

package/mjs/utils/reflection/OwnPropertyDescriptorMap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OwnPropertyDescriptorMap.d.mts","names":["BaseClass","ClassLike","ClassLike_Unknown","ProtoOrSuperClass","WithProto","OwnPropertyDescriptorMap","T","P0","TypedPropertyDescriptor","P1","Exclude","Omit"],"sources":["../../../src/utils/reflection/OwnPropertyDescriptorMap.d.ts"],"mappings":";;;;;;;;;;;KAiBYK,wBAAAA,WAAmCD,SAAAA,CAAUD,iBAAAA,KACrDG,CAAAA,4CACiBA,CAAAA,GAAIE,uBAAAA,CAAwBF,CAAAA,CAAEC,EAAAA,OAC7CI,IAAAA,gBACeL,CAAAA,GAAIE,uBAAAA,CAAwBF,CAAAA,CAAEC,EAAAA,MAC7CG,OAAAA,sBACuBJ,CAAAA,gBAAiBE,uBAAAA,CAAwBF,CAAAA,cAAeG,EAAAA,YACvER,SAAAA,CAAUD,SAAAA,CAAUE,iBAAAA"}