objcjs-types 0.5.0 → 0.5.1

package/dist/bind.js

@@ -90,6 +90,10 @@ export function isKindOfClass(obj, cls) {
  */
 export function _bindClass(lib, name) {
     const cls = lib[name];
+    if (!cls) {
+        // Very unlikely to happen, but just in case, return undefined.
+        return undefined;
+    }
     Object.defineProperty(cls, Symbol.hasInstance, {
         value: (obj) => _isKindOfClass(obj, cls)
     });

package/dist/helpers.d.ts

@@ -27,4 +27,30 @@ export declare function NSStringFromString(str: string): _NSString;
 export declare function options<T extends number>(...values: T[]): T;
 export declare function NSArrayFromObjects(objects: NobjcObject[]): _NSArray;
 export declare function NSDictionaryFromKeysAndValues(keys: NobjcObject[], values: NobjcObject[]): _NSDictionary;
+/**
+ * Returns the key name for a given numeric value in a const enum-like object.
+ *
+ * @param enumObj - A const object mapping string keys to numeric values.
+ * @param value - The numeric value to look up.
+ * @returns The matching key name, or `undefined` if not found.
+ *
+ * @example
+ * ```ts
+ * const state = enumFromValue(
+ *   ASAuthorizationWebBrowserPublicKeyCredentialManagerAuthorizationState,
+ *   rawValue
+ * ); // e.g. "Authorized" | "Denied" | "NotDetermined" | undefined
+ * ```
+ */
+export declare function enumFromValue<T extends Record<string, number>>(enumObj: T, value: number): keyof T | undefined;
+/**
+ * Converts a callback-based function with a single result parameter into a Promise.
+ *
+ * @template TArgs - The argument types of the original function (excluding the callback)
+ * @template TResult - The type of the result passed to the callback
+ * @param func - A function that takes arguments and a callback with a single result parameter
+ * @param args - The arguments to pass to the function (excluding the callback)
+ * @returns A Promise that resolves with the result passed to the callback
+ */
+export declare function makePromise1Result<TArgs extends any[], TResult>(func: (...args: [...TArgs, (result: TResult) => void]) => void, ...args: TArgs): Promise<TResult>;
 export { isKindOfClass } from "./bind.js";

package/dist/helpers.js

@@ -54,4 +54,48 @@ export function NSDictionaryFromKeysAndValues(keys, values) {
     const valuesArray = NSArrayFromObjects(values);
     return NSDictionary.dictionaryWithObjects$forKeys$(valuesArray, keysArray);
 }
+/**
+ * Returns the key name for a given numeric value in a const enum-like object.
+ *
+ * @param enumObj - A const object mapping string keys to numeric values.
+ * @param value - The numeric value to look up.
+ * @returns The matching key name, or `undefined` if not found.
+ *
+ * @example
+ * ```ts
+ * const state = enumFromValue(
+ *   ASAuthorizationWebBrowserPublicKeyCredentialManagerAuthorizationState,
+ *   rawValue
+ * ); // e.g. "Authorized" | "Denied" | "NotDetermined" | undefined
+ * ```
+ */
+export function enumFromValue(enumObj, value) {
+    return Object.keys(enumObj).find((key) => enumObj[key] === value);
+}
+function PromiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve: resolve, reject: reject };
+}
+/**
+ * Converts a callback-based function with a single result parameter into a Promise.
+ *
+ * @template TArgs - The argument types of the original function (excluding the callback)
+ * @template TResult - The type of the result passed to the callback
+ * @param func - A function that takes arguments and a callback with a single result parameter
+ * @param args - The arguments to pass to the function (excluding the callback)
+ * @returns A Promise that resolves with the result passed to the callback
+ */
+export function makePromise1Result(func, ...args) {
+    const { promise, resolve } = PromiseWithResolvers();
+    const callback = (result) => {
+        resolve(result);
+    };
+    func(...args, callback);
+    return promise;
+}
 export { isKindOfClass } from "./bind.js";

package/generator/index.ts

@@ -329,7 +329,7 @@ async function main(): Promise<void> {
   // The actual per-task bottleneck is clang execution + JSON.parse (~95% of
   // task time), not the AST walk passes (~5%). Any Xcode-capable Mac with
   // 32+GB RAM handles 8 workers comfortably.
-  const cpuCount = navigator.hardwareConcurrency ?? 4;
+  const cpuCount = navigator.hardwareConcurrency || 4;
   const poolSize = Math.min(cpuCount, 8);
   const pool = new WorkerPool(poolSize);
   const totalBatchTasks = batchTasks.length;

package/generator/templates/bind.ts

@@ -93,6 +93,10 @@ export function isKindOfClass<T extends NobjcObject>(obj: NobjcObject, cls: any)
  */
 export function _bindClass<T>(lib: any, name: string): T {
   const cls = lib[name];
+  if (!cls) {
+    // Very unlikely to happen, but just in case, return undefined.
+    return undefined as unknown as T;
+  }
   Object.defineProperty(cls, Symbol.hasInstance, {
     value: (obj: any) => _isKindOfClass(obj, cls)
   });

package/generator/templates/helpers.ts

@@ -67,4 +67,57 @@ export function NSDictionaryFromKeysAndValues(keys: NobjcObject[], values: Nobjc
   return NSDictionary.dictionaryWithObjects$forKeys$(valuesArray, keysArray);
 }
 
+/**
+ * Returns the key name for a given numeric value in a const enum-like object.
+ *
+ * @param enumObj - A const object mapping string keys to numeric values.
+ * @param value - The numeric value to look up.
+ * @returns The matching key name, or `undefined` if not found.
+ *
+ * @example
+ * ```ts
+ * const state = enumFromValue(
+ *   ASAuthorizationWebBrowserPublicKeyCredentialManagerAuthorizationState,
+ *   rawValue
+ * ); // e.g. "Authorized" | "Denied" | "NotDetermined" | undefined
+ * ```
+ */
+export function enumFromValue<T extends Record<string, number>>(enumObj: T, value: number): keyof T | undefined {
+  return (Object.keys(enumObj) as (keyof T)[]).find((key) => enumObj[key] === value);
+}
+
+function PromiseWithResolvers<T = void>(): {
+  promise: Promise<T>;
+  resolve: (value: T | PromiseLike<T>) => void;
+  reject: (reason?: unknown) => void;
+} {
+  let resolve: (value: T | PromiseLike<T>) => void;
+  let reject: (reason?: unknown) => void;
+  const promise = new Promise<T>((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return { promise, resolve: resolve!, reject: reject! };
+}
+/**
+ * Converts a callback-based function with a single result parameter into a Promise.
+ *
+ * @template TArgs - The argument types of the original function (excluding the callback)
+ * @template TResult - The type of the result passed to the callback
+ * @param func - A function that takes arguments and a callback with a single result parameter
+ * @param args - The arguments to pass to the function (excluding the callback)
+ * @returns A Promise that resolves with the result passed to the callback
+ */
+export function makePromise1Result<TArgs extends any[], TResult>(
+  func: (...args: [...TArgs, (result: TResult) => void]) => void,
+  ...args: TArgs
+): Promise<TResult> {
+  const { promise, resolve } = PromiseWithResolvers<TResult>();
+  const callback = (result: TResult) => {
+    resolve(result);
+  };
+  func(...args, callback);
+  return promise;
+}
+
 export { isKindOfClass } from "./bind.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "objcjs-types",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Auto-generated TypeScript type declarations for macOS Objective-C frameworks",
   "type": "module",
   "main": "./dist/index.js",
@@ -69,7 +69,7 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@typescript/native-preview": "^7.0.0-dev.20260218.1",
-    "objc-js": "^1.3.0",
+    "objc-js": "^1.3.1",
     "prettier": "^3.8.1"
   },
   "trustedDependencies": [