@halospv3/hce.shared-config 3.0.0-develop.2 → 3.0.0-develop.21

package/mjs/utils/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","sources":["../../src/utils/env.ts"],"sourcesContent":null,"names":["loadDotenv"],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE;AACjD,EAAEA,MAAU,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,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE;AAClE;AACA,EAAE,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,WAAW,GAAG,SAAS,GAAG,KAAK;AAClE;;;;"}

package/mjs/utils/execAsync.d.ts

@@ -0,0 +1,37 @@
+import type { ObjectType } from 'arktype/internal/methods/object.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}
+ */
+export declare function execAsync(command: string, setStderrAsCause?: boolean): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+declare const T_ExecException: ObjectType<{
+    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;
+export 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;
+}
+export {};
+//# sourceMappingURL=execAsync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execAsync.d.ts","sourceRoot":"","sources":["../../src/utils/execAsync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAMrE;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,UAAQ,GAAG,OAAO,CAAC;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD;AAED,QAAA,MAAM,eAAe,EAAE,UAAU,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACnd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAUC,CAAC;AAEH,KAAK,cAAc,GAAG,OAAO,eAAe,CAAC,QAAQ,CAAC;AAEtD,qBAAa,0BAA2B,SAAQ,KAAM,YAAW,cAAc;gBAE3E,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EACpC,OAAO,EAAE,OAAO,eAAe,CAAC,OAAO;IAYzC,GAAG,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;IACzC,IAAI,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3C,MAAM,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;CAChD"}

package/mjs/utils/execAsync.mjs

@@ -0,0 +1,59 @@
+import { type } from 'arktype';
+import { exec } from 'node:child_process';
+import { constants } from 'node:os';
+import { promisify } from 'node:util';
+import { isNativeError } from 'node:util/types';
+
+/* 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 (!isNativeError(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

package/mjs/utils/execAsync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execAsync.mjs","sources":["../../src/utils/execAsync.ts"],"sourcesContent":null,"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,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACrE,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;AACA,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;AACA,IAAI,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;AAC9D,GAAG,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;AACA,EAAE,GAAG;AACL,EAAE,IAAI;AACN,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR;;;;"}

package/mjs/utils/miscTypes.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"miscTypes.d.ts","sourceRoot":"","sources":["../../src/utils/miscTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,OAAO,GAAG,MAAM,CAA4B,CAAC;AACrF,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,KAAK,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,GAAG,MAAM,CAAiC,CAAC;AAChG,MAAM,MAAM,oBAAoB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAEtE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IACjD,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC"}

package/mjs/utils/miscTypes.mjs

@@ -0,0 +1,10 @@
+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

package/mjs/utils/miscTypes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"miscTypes.mjs","sources":["../../src/utils/miscTypes.ts"],"sourcesContent":null,"names":[],"mappings":";;AACY,MAAC,cAAc,GAAG,IAAI,CAAC,kBAAkB;AACzC,MAAC,qBAAqB,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC;;AAEjE;AACA;AACA;;;;"}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=FunctionLike.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionLike.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=GetterDescriptor.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GetterDescriptor.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=InstancePropertyDescriptorMap.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstancePropertyDescriptorMap.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=InstanceTypeOrSelfPropertyDescriptorMap.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceTypeOrSelfPropertyDescriptorMap.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=OwnGetterDescriptorMap.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OwnGetterDescriptorMap.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=OwnKeyOf.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OwnKeyOf.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=OwnPropertyDescriptorMap.d.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OwnPropertyDescriptorMap.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/utils/reflection/PropertyDescriptorMap.d.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=PropertyDescriptorMap.d.mjs.map

package/mjs/utils/reflection/PropertyDescriptorMap.d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyDescriptorMap.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/utils/reflection/filterForGetters.d.ts

@@ -0,0 +1,7 @@
+import type { BaseClassProto, baseClassProto, ClassLike, ConstructorConstraint, InstanceTypeOrSelf, SuperClassLike, WithProto } from './inheritance.js';
+import type { InstancePropertyDescriptorMap } from './InstancePropertyDescriptorMap.js';
+import type { OwnGetterDescriptorMap } from './OwnGetterDescriptorMap.js';
+import type { OwnPropertyDescriptorMap } from './OwnPropertyDescriptorMap.js';
+export declare function filterForGetters<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | typeof baseClassProto>>>(descriptorMap: InstancePropertyDescriptorMap<Class>): Partial<OwnGetterDescriptorMap<InstanceType<Class>, Class['__proto__'] extends BaseClassProto ? null : InstanceTypeOrSelf<Class['__proto__']>>>;
+export declare function filterForGetters<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>>(descriptorMap: OwnPropertyDescriptorMap<Class>): Partial<OwnGetterDescriptorMap<Class, Class['__proto__']>>;
+//# sourceMappingURL=filterForGetters.d.ts.map

package/mjs/utils/reflection/filterForGetters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterForGetters.d.ts","sourceRoot":"","sources":["../../../src/utils/reflection/filterForGetters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAG9E,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,OAAO,cAAc,CAAC,CAAC,EAEzG,aAAa,EAAE,6BAA6B,CAAC,KAAK,CAAC,GAClD,OAAO,CAAC,sBAAsB,CAC/B,YAAY,CAAC,KAAK,CAAC,EACnB,KAAK,CAAC,WAAW,CAAC,SAAS,cAAc,GAAG,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAC1F,CAAC,CAAC;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAElG,aAAa,EAAE,wBAAwB,CAAC,KAAK,CAAC,GAC7C,OAAO,CAAC,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC"}

package/mjs/utils/reflection/filterForGetters.mjs

@@ -0,0 +1,27 @@
+/**
+ * Iterates through the descriptors object, checking for property descriptors whose `get` is a function.
+ * Returns an {@link OwnGetterDescriptorMap} of the getters.
+ * If you want only own, non-inherited getters, you must filter sanitize the
+ * type the `descriptors` parameter yourself e.g. `Omit<Class, keyof
+ * SuperClass>`.
+ * @param descriptorMap An object like the return value of Object.getOwnPropertyDescriptors
+ * @template Class Any ClassLike type
+ * @template T Any `object`-like type.
+ * @template [__proto__=null] If {@link Class} is not {@link ClassLike}, the `__proto__` of {@link T}.
+ * @returns An {@link OwnGetterDescriptorMap}.
+ * @since 3.0.0
+ */
+function filterForGetters(descriptorMap) {
+  let getterDescriptorMap = {};
+  for (const key in descriptorMap) {
+    const element = descriptorMap[key];
+    if (typeof element.get === 'function') {
+      getterDescriptorMap = Object.assign(getterDescriptorMap, {
+        [key]: element
+      });
+    }
+  }
+  return getterDescriptorMap;
+}
+export { filterForGetters };
+//# sourceMappingURL=filterForGetters.mjs.map

package/mjs/utils/reflection/filterForGetters.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterForGetters.mjs","sources":["../../../src/utils/reflection/filterForGetters.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,aAAa,EAAE;AAChD,EAAE,IAAI,mBAAmB,GAAG,EAAE;AAC9B,EAAE,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE;AACnC,IAAI,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC;AACtC,IAAI,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE;AAC3C,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;AAC/D,QAAQ,CAAC,GAAG,GAAG;AACf,OAAO,CAAC;AACR;AACA;AACA,EAAE,OAAO,mBAAmB;AAC5B;;;;"}

package/mjs/utils/reflection/getOwnPropertyDescriptors.d.ts

@@ -0,0 +1,22 @@
+import type { InstanceOrStatic } from '../miscTypes.js';
+import type { BaseClassProto, ClassLike, ConstructorConstraint, SuperClassLike, WithProto } from './inheritance.js';
+import type { InstancePropertyDescriptorMap } from './InstancePropertyDescriptorMap.js';
+import type { OwnPropertyDescriptorMap } from './OwnPropertyDescriptorMap.js';
+/**
+ * Get the property descriptors of the class or constructor similar to {@link Object.getOwnPropertyDescriptors}, but with more options--including recursion.
+ * @template {InstanceOrStatic} _InstanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @param classDefinition A class or constructor, cast to {@link ClassLike}.
+ * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class
+ * The typeof {@link classDefinition}.
+ * {@link WithProto}<{@link SuperClassLike}> is necessary for walking the
+ * prototype chain for both Instance  and Static properties.
+ * If unspecified, the return type may be incorrect.
+ * @returns ({@link instanceOrStatic} === 'Instance') ? {@link InstancePropertyDescriptorMap<Class>}\
+ * : ({@link instanceOrStatic} === 'Static') ? {@link OwnPropertyDescriptorMap<Class>}\
+ * : never
+ * @throws {TypeError}
+ * @since 3.0.0
+ */
+export declare function getOwnPropertyDescriptors<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>, _InstanceOrStatic extends InstanceOrStatic>(classDefinition: Class, instanceOrStatic: _InstanceOrStatic): [_InstanceOrStatic] extends ['Instance'] ? InstancePropertyDescriptorMap<Class> : [_InstanceOrStatic] extends ['Static'] ? OwnPropertyDescriptorMap<Class> : never;
+//# sourceMappingURL=getOwnPropertyDescriptors.d.ts.map

package/mjs/utils/reflection/getOwnPropertyDescriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPropertyDescriptors.d.ts","sourceRoot":"","sources":["../../../src/utils/reflection/getOwnPropertyDescriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAClG,iBAAiB,SAAS,gBAAgB,EAE1C,eAAe,EAAE,KAAK,EACtB,gBAAgB,EAAE,iBAAiB,GAClC,CAAC,iBAAiB,CAAC,SAAS,CAAC,UAAU,CAAC,GACvC,6BAA6B,CAAC,KAAK,CAAC,GACpC,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,GAClC,wBAAwB,CAAC,KAAK,CAAC,GAC/B,KAAK,CAoBZ"}

package/mjs/utils/reflection/getOwnPropertyDescriptors.mjs

@@ -0,0 +1,34 @@
+/**
+ * Get the property descriptors of the class or constructor similar to {@link Object.getOwnPropertyDescriptors}, but with more options--including recursion.
+ * @template {InstanceOrStatic} _InstanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @param classDefinition A class or constructor, cast to {@link ClassLike}.
+ * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @template {ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>} Class
+ * The typeof {@link classDefinition}.
+ * {@link WithProto}<{@link SuperClassLike}> is necessary for walking the
+ * prototype chain for both Instance  and Static properties.
+ * If unspecified, the return type may be incorrect.
+ * @returns ({@link instanceOrStatic} === 'Instance') ? {@link InstancePropertyDescriptorMap<Class>}\
+ * : ({@link instanceOrStatic} === 'Static') ? {@link OwnPropertyDescriptorMap<Class>}\
+ * : never
+ * @throws {TypeError}
+ * @since 3.0.0
+ */
+function getOwnPropertyDescriptors(classDefinition, instanceOrStatic) {
+  switch (instanceOrStatic) {
+    case 'Instance':
+      {
+        return Object.getOwnPropertyDescriptors(classDefinition.prototype);
+      }
+    case 'Static':
+      {
+        return Object.getOwnPropertyDescriptors(classDefinition);
+      }
+    default:
+      {
+        throw new TypeError('Argument `instanceOrStatic` must be "Instance" or "Static".');
+      }
+  }
+}
+export { getOwnPropertyDescriptors };
+//# sourceMappingURL=getOwnPropertyDescriptors.mjs.map

package/mjs/utils/reflection/getOwnPropertyDescriptors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPropertyDescriptors.mjs","sources":["../../../src/utils/reflection/getOwnPropertyDescriptors.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,yBAAyB,CAAC,eAAe,EAAE,gBAAgB,EAAE;AAC7E,EAAE,QAAQ,gBAAgB;AAC1B,IAAI,KAAK,UAAU;AACnB,MAAM;AACN,QAAQ,OAAO,MAAM,CAAC,yBAAyB,CAAC,eAAe,CAAC,SAAS,CAAC;AAC1E;AACA,IAAI,KAAK,QAAQ;AACjB,MAAM;AACN,QAAQ,OAAO,MAAM,CAAC,yBAAyB,CAAC,eAAe,CAAC;AAChE;AACA,IAAI;AACJ,MAAM;AACN,QAAQ,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC;AAC1F;AACA;AACA;;;;"}

package/mjs/utils/reflection/getOwnPropertyDescriptorsRecursively.d.ts

@@ -0,0 +1,56 @@
+import type { Increment } from '../GracefulRecursion.js';
+import type { InstanceOrStatic, Integer } from '../miscTypes.js';
+import type { BaseClass, BaseClassProto, ClassLike, ConstructorConstraint, ConstructorLike, SuperClassLike, WithProto } from './inheritance.js';
+import type { InstanceTypeOrSelfPropertyDescriptorMap } from './InstanceTypeOrSelfPropertyDescriptorMap.js';
+import type { OwnPropertyDescriptorMap } from './OwnPropertyDescriptorMap.js';
+/**
+ * JSDoc type imports
+ * @typedef {import('./getPrototypeOf.js').getPrototypeOf} getPrototypeOf
+ * @typedef {import('./listOwnGetters.js').listOwnGetters} listOwnGetters
+ * @typedef {import('./InstancePropertyDescriptorMap.js').InstancePropertyDescriptorMap} InstancePropertyDescriptorMap
+ */
+/**
+ * A conditional wrapper for {@link InstanceTypeOrSelfPropertyDescriptorMap} and
+ * {@link OwnPropertyDescriptorMap}.
+ *
+ * If {@link _InstanceOrStatic} is 'Instance', {@link InstanceTypeOrSelfPropertyDescriptorMap}.\
+ * Else if {@link _InstanceOrStatic} is 'Static',
+ * {@link OwnPropertyDescriptorMap }.\
+ * Else, `never`.
+ * @template {ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>} Class
+ * A class definition cast to {@link ClassLike}.
+ * @template {InstanceOrStatic} _InstanceOrStatic
+ * 'Instance' or 'Static'. Determines the return type.
+ * @since 3.0.0
+ */
+export type RecursedPropertyDescriptorMap<Class extends ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>, _InstanceOrStatic extends InstanceOrStatic> = [_InstanceOrStatic] extends ['Instance'] ? InstanceTypeOrSelfPropertyDescriptorMap<Class, Class['__proto__']> : [_InstanceOrStatic] extends ['Static'] ? OwnPropertyDescriptorMap<Class> : never;
+/**
+ * An
+ * ordered array of {@link OwnPropertyDescriptorMap} or
+ * {@link InstancePropertyDescriptorMap} starting with {@link classDefinition}
+ * and ending with a {@link BaseClass}.
+ * @template {ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>} Class
+ * @template {'Instance' | 'Static'} InstanceOrStatic
+ * @template {Integer<number>} [Limit=16]
+ * @template {Integer<number>} [CurrentLevel=0]
+ */
+export type RecursedPropertyDescriptorMapArray<Class extends ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>, InstanceOrStatic extends 'Instance' | 'Static', Limit extends Integer<number> = 16, CurrentLevel extends Integer<number> = 0> = Class['__proto__'] extends BaseClassProto['__proto__'] | BaseClassProto['__proto__']['__proto__'] ? never : Class['__proto__'] extends BaseClassProto ? [RecursedPropertyDescriptorMap<BaseClass<Class>, InstanceOrStatic>] : Class['__proto__'] extends ConstructorLike<Class['__proto__']> ? [
+    RecursedPropertyDescriptorMap<Class, InstanceOrStatic>,
+    ...RecursedPropertyDescriptorMapArray<ClassLike<Exclude<Class['__proto__'], BaseClassProto> & WithProto<SuperClassLike | BaseClassProto>>, InstanceOrStatic, Limit, Increment<CurrentLevel>>
+] : never;
+/**
+ * Walks the class inheritance chain to get a PropertyDescriptorMap of each class.
+ *
+ * While you _can_ use this to get an array of getter names/keys, you should use {@link getPrototypeOf} and {@link listOwnGetters}, instead!
+ * @template Class Any class definition type-cast to {@link ClassLike}
+ * @template _InstanceOrStatic
+ * @param classDefinition Any class definition type-cast to {@link ClassLike}
+ * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @returns An
+ * ordered array of {@link OwnPropertyDescriptorMap} or
+ * {@link InstancePropertyDescriptorMap} starting with {@link classDefinition}
+ * and ending with a {@link BaseClass}.
+ * @since 3.0.0
+ */
+export declare function getOwnPropertyDescriptorsRecursively<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>, _InstanceOrStatic extends InstanceOrStatic, Limit extends Integer<number> = 16>(classDefinition: Class, instanceOrStatic: _InstanceOrStatic): RecursedPropertyDescriptorMapArray<Class, _InstanceOrStatic>;
+//# sourceMappingURL=getOwnPropertyDescriptorsRecursively.d.ts.map

package/mjs/utils/reflection/getOwnPropertyDescriptorsRecursively.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPropertyDescriptorsRecursively.d.ts","sourceRoot":"","sources":["../../../src/utils/reflection/getOwnPropertyDescriptorsRecursively.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,eAAe,EAEf,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,8CAA8C,CAAC;AAC5G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;;;GAKG;AAGH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,6BAA6B,CACvC,KAAK,SAAS,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,EACvF,iBAAiB,SAAS,gBAAgB,IACxC,CAAC,iBAAiB,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,uCAAuC,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,GAC7G,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,GACpE,KAAK,CAAC;AAEd;;;;;;;;;GASG;AACH,MAAM,MAAM,kCAAkC,CAC5C,KAAK,SAAS,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,EACvF,gBAAgB,SAAS,UAAU,GAAG,QAAQ,EAC9C,KAAK,SAAS,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,EAClC,YAAY,SAAS,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IACtC,KAAK,CAAC,WAAW,CAAC,SAAS,cAAc,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,GAAG,KAAK,GACzG,KAAK,CAAC,WAAW,CAAC,SAAS,cAAc,GAAG,CAAC,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAC7G,KAAK,CAAC,WAAW,CAAC,SAAS,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAC5D;IACE,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACtD,GAAG,kCAAkC,CACnC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EACnG,gBAAgB,EAChB,KAAK,EACL,SAAS,CAAC,YAAY,CAAC,CACxB;CACF,GACD,KAAK,CAAC;AACd;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAElD,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAClG,iBAAiB,SAAS,gBAAgB,EAE1C,KAAK,SAAS,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,EAElC,eAAe,EAAE,KAAK,EACtB,gBAAgB,EAAE,iBAAiB,GAClC,kCAAkC,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAmB9D"}

package/mjs/utils/reflection/getOwnPropertyDescriptorsRecursively.mjs

@@ -0,0 +1,72 @@
+import { getOwnPropertyDescriptors } from './getOwnPropertyDescriptors.mjs';
+import { getPrototypesChainOf } from './getPrototypeChainOf.mjs';
+
+/* eslint-disable jsdoc/check-tag-names */
+/**
+ * JSDoc type imports
+ * @typedef {import('./getPrototypeOf.js').getPrototypeOf} getPrototypeOf
+ * @typedef {import('./listOwnGetters.js').listOwnGetters} listOwnGetters
+ * @typedef {import('./InstancePropertyDescriptorMap.js').InstancePropertyDescriptorMap} InstancePropertyDescriptorMap
+ */
+/* eslint-enable jsdoc/check-tag-names */
+
+/**
+ * A conditional wrapper for {@link InstanceTypeOrSelfPropertyDescriptorMap} and
+ * {@link OwnPropertyDescriptorMap}.
+ *
+ * If {@link _InstanceOrStatic} is 'Instance', {@link InstanceTypeOrSelfPropertyDescriptorMap}.\
+ * Else if {@link _InstanceOrStatic} is 'Static',
+ * {@link OwnPropertyDescriptorMap }.\
+ * Else, `never`.
+ * @template {ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>} Class
+ * A class definition cast to {@link ClassLike}.
+ * @template {InstanceOrStatic} _InstanceOrStatic
+ * 'Instance' or 'Static'. Determines the return type.
+ * @since 3.0.0
+ */
+
+/**
+ * An
+ * ordered array of {@link OwnPropertyDescriptorMap} or
+ * {@link InstancePropertyDescriptorMap} starting with {@link classDefinition}
+ * and ending with a {@link BaseClass}.
+ * @template {ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>} Class
+ * @template {'Instance' | 'Static'} InstanceOrStatic
+ * @template {Integer<number>} [Limit=16]
+ * @template {Integer<number>} [CurrentLevel=0]
+ */
+
+/**
+ * Walks the class inheritance chain to get a PropertyDescriptorMap of each class.
+ *
+ * While you _can_ use this to get an array of getter names/keys, you should use {@link getPrototypeOf} and {@link listOwnGetters}, instead!
+ * @template Class Any class definition type-cast to {@link ClassLike}
+ * @template _InstanceOrStatic
+ * @param classDefinition Any class definition type-cast to {@link ClassLike}
+ * @param instanceOrStatic 'Instance' or 'Static'. Determines the return type.
+ * @returns An
+ * ordered array of {@link OwnPropertyDescriptorMap} or
+ * {@link InstancePropertyDescriptorMap} starting with {@link classDefinition}
+ * and ending with a {@link BaseClass}.
+ * @since 3.0.0
+ */
+function getOwnPropertyDescriptorsRecursively(classDefinition, instanceOrStatic) {
+  const staticProtoChain = getPrototypesChainOf(classDefinition, 'classes');
+  if (isSingleTuple(staticProtoChain)) {
+    return [getOwnPropertyDescriptors(staticProtoChain[0], instanceOrStatic)];
+  }
+  const recursedPropertyDescriptorMapArray = staticProtoChain.map(classDefinition => getOwnPropertyDescriptors(classDefinition, instanceOrStatic));
+  return recursedPropertyDescriptorMapArray;
+}
+
+/**
+ * Simple utility for single-tuple type assertion
+ * @template {T} T T in T[]
+ * @param array an array
+ * @returns array is [T]
+ */
+function isSingleTuple(array) {
+  return Array.isArray(array) && array.length === 1;
+}
+export { getOwnPropertyDescriptorsRecursively };
+//# sourceMappingURL=getOwnPropertyDescriptorsRecursively.mjs.map

package/mjs/utils/reflection/getOwnPropertyDescriptorsRecursively.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOwnPropertyDescriptorsRecursively.mjs","sources":["../../../src/utils/reflection/getOwnPropertyDescriptorsRecursively.ts"],"sourcesContent":null,"names":[],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oCAAoC,CAAC,eAAe,EAAE,gBAAgB,EAAE;AACxF,EAAE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,eAAe,EAAE,SAAS,CAAC;AAC3E,EAAE,IAAI,aAAa,CAAC,gBAAgB,CAAC,EAAE;AACvC,IAAI,OAAO,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC7E;AACA,EAAE,MAAM,kCAAkC,GAAG,gBAAgB,CAAC,GAAG,CAAC,eAAe,IAAI,yBAAyB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAClJ,EAAE,OAAO,kCAAkC;AAC3C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,KAAK,EAAE;AAC9B,EAAE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AACnD;;;;"}

package/mjs/utils/reflection/getPrototypeChainOf.d.ts

@@ -0,0 +1,16 @@
+import { type BaseClassProto, type ClassLike, type ConstructorConstraint, type ProtoChainOfClass, type ProtoChainOfClassInstance, type SuperClassLike, type WithProto } from './inheritance.js';
+type ProtoChain<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>, ClassesOrInstances extends 'classes' | 'classInstances'> = [ClassesOrInstances] extends ['classInstances'] ? ProtoChainOfClassInstance<Class> : [ClassesOrInstances] extends ['classes'] ? ProtoChainOfClass<Class> : never;
+/**
+ * Iterate through the class and its base/super classes until an anonymous function is reached. This is the default superclass all classes extend.
+ * @template Class Any {@link ClassLike} type.
+ * @template ClassesOrInstances 'classes' or 'classInstances'
+ * @param classDefinition Any class type satisfying {@link Class}. This class (or its instance type) is included in the return value.
+ * @param [returnType='classes'] Determines return type. If 'classInstances', the return type is an array of the classes' `.prototype`. Else, the classes themselves are returned.
+ * @since 3.0.0
+ * @returns
+ * `returnType extends 'classInstances' ? ClassLike<T>[] : ClassLike<T>[].map(c => c.prototype)`
+ * Excludes default superclasses e.g. anonymous functions, native code.
+ */
+export declare function getPrototypesChainOf<Class extends ClassLike<ConstructorConstraint<Class> & WithProto<SuperClassLike | BaseClassProto>>, ClassesOrInstances extends 'classes' | 'classInstances'>(classDefinition: Class, returnType: ClassesOrInstances): ProtoChain<Class, ClassesOrInstances>;
+export {};
+//# sourceMappingURL=getPrototypeChainOf.d.ts.map

package/mjs/utils/reflection/getPrototypeChainOf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPrototypeChainOf.d.ts","sourceRoot":"","sources":["../../../src/utils/reflection/getPrototypeChainOf.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAG1B,KAAK,UAAU,CACb,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAClG,kBAAkB,SAAS,SAAS,GAAG,gBAAgB,IACrD,CAAC,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,GAClF,CAAC,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAC/D,KAAK,CAAC;AAEd;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,SAAS,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAClG,kBAAkB,SAAS,SAAS,GAAG,gBAAgB,EAEvD,eAAe,EAAE,KAAK,EACtB,UAAU,EAAE,kBAAkB,GAC7B,UAAU,CAAC,KAAK,EAAE,kBAAkB,CAAC,CA6CvC"}

package/mjs/utils/reflection/getPrototypeChainOf.mjs

@@ -0,0 +1,55 @@
+import { getPrototypeOf } from './getPrototypeOf.mjs';
+import { baseClassProto } from './inheritance.mjs';
+import { isConstructor } from './isConstructor.mjs';
+
+/* eslint-disable jsdoc/no-defaults */
+
+/**
+ * Iterate through the class and its base/super classes until an anonymous function is reached. This is the default superclass all classes extend.
+ * @template Class Any {@link ClassLike} type.
+ * @template ClassesOrInstances 'classes' or 'classInstances'
+ * @param classDefinition Any class type satisfying {@link Class}. This class (or its instance type) is included in the return value.
+ * @param [returnType='classes'] Determines return type. If 'classInstances', the return type is an array of the classes' `.prototype`. Else, the classes themselves are returned.
+ * @since 3.0.0
+ * @returns
+ * `returnType extends 'classInstances' ? ClassLike<T>[] : ClassLike<T>[].map(c => c.prototype)`
+ * Excludes default superclasses e.g. anonymous functions, native code.
+ */
+function getPrototypesChainOf(classDefinition, returnType) {
+  // class definitions or their respective .prototype; exclude default superclasses.
+  let current = classDefinition;
+  let parent;
+  const returnValue = [];
+  let index = 0;
+  while (baseClassProto !== current) {
+    parent = getPrototypeOf(current);
+    // current is a Class symbol/constructor. Object.getOwnPropertyDescriptors on current will include static properties.
+    if (!isConstructor(current)) break;
+    if (returnType === 'classInstances') {
+      const instanceOfCurrent = current.prototype;
+      returnValue[index] = instanceOfCurrent;
+    } else {
+      returnValue[index] = current;
+    }
+
+    /**
+     * Assign the super class to current.
+     * If the argument is a class, Reflect.getPrototypeOf method returns the
+     * superclass.
+     */
+    if (isConstructor(parent) && 'name' in parent && typeof parent.name === 'string' && '' !== parent.name // it's possible for a Function/Constructor to be anonymous...
+    ) {
+      current = parent;
+    } else {
+      break;
+    }
+    index++;
+  }
+  return returnValue;
+  /*
+    assuming current is NugetProjectProperties...
+    Reflect.getPrototypeOf(current).name is 'MSBuildProjectProperties'
+   */
+}
+export { getPrototypesChainOf };
+//# sourceMappingURL=getPrototypeChainOf.mjs.map

package/mjs/utils/reflection/getPrototypeChainOf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPrototypeChainOf.mjs","sources":["../../../src/utils/reflection/getPrototypeChainOf.ts"],"sourcesContent":null,"names":[],"mappings":";;;;AAAA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,eAAe,EAAE,UAAU,EAAE;AAClE;AACA,EAAE,IAAI,OAAO,GAAG,eAAe;AAC/B,EAAE,IAAI,MAAM;AACZ,EAAE,MAAM,WAAW,GAAG,EAAE;AACxB,EAAE,IAAI,KAAK,GAAG,CAAC;AACf,EAAE,OAAO,cAAc,KAAK,OAAO,EAAE;AACrC,IAAI,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;AACpC;AACA,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE;AACjC,IAAI,IAAI,UAAU,KAAK,gBAAgB,EAAE;AACzC,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS;AACjD,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,iBAAiB;AAC5C,KAAK,MAAM;AACX,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI;AAC1G,MAAM;AACN,MAAM,OAAO,GAAG,MAAM;AACtB,KAAK,MAAM;AACX,MAAM;AACN;AACA,IAAI,KAAK,EAAE;AACX;AACA,EAAE,OAAO,WAAW;AACpB;AACA;AACA;AACA;AACA;;;;"}

package/mjs/utils/reflection/getPrototypeOf.d.ts

@@ -0,0 +1,8 @@
+import type { ProtoOrSuperClass, WithProto } from './inheritance.js';
+/**
+ * A nearly useless wrapper for {@link Reflect.getPrototypeOf}
+ * @param object An object with the internal `__proto__` property present in its type.
+ * @returns The `__proto__` of the `object` param.
+ */
+export declare function getPrototypeOf<T extends WithProto<ProtoOrSuperClass>>(object: T): T['__proto__'];
+//# sourceMappingURL=getPrototypeOf.d.ts.map

package/mjs/utils/reflection/getPrototypeOf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPrototypeOf.d.ts","sourceRoot":"","sources":["../../../src/utils/reflection/getPrototypeOf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,CAAC,SAAS,SAAS,CAAC,iBAAiB,CAAC,EACtC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,CAE3B"}

package/mjs/utils/reflection/getPrototypeOf.mjs

@@ -0,0 +1,10 @@
+/**
+ * A nearly useless wrapper for {@link Reflect.getPrototypeOf}
+ * @param object An object with the internal `__proto__` property present in its type.
+ * @returns The `__proto__` of the `object` param.
+ */
+function getPrototypeOf(object) {
+  return Reflect.getPrototypeOf(object);
+}
+export { getPrototypeOf };
+//# sourceMappingURL=getPrototypeOf.mjs.map

package/mjs/utils/reflection/getPrototypeOf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPrototypeOf.mjs","sources":["../../../src/utils/reflection/getPrototypeOf.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE;AACvC,EAAE,OAAO,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC;AACvC;;;;"}