feat: add type-utils package

Author: Ohh-889

primitives/type-utils/CHANGELOG.md

@@ -0,0 +1 @@
+

primitives/type-utils/README.md

@@ -0,0 +1 @@
+

primitives/type-utils/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "skyroc-type-utils",
+  "type": "module",
+  "version": "0.0.1",
+  "private": true,
+  "description": "UI Primitives Template",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "types": "src/index.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "devDependencies": {
+    "tsdown": "0.12.9",
+    "typescript": "5.8.2"
+  }
+}

primitives/type-utils/src/fn.ts

@@ -0,0 +1,51 @@
+export type Fn = (...args: any[]) => any;
+
+export type Noop = () => void;
+
+/**
+ * - get all the function types in an object
+ * @example
+ * interface Foo {
+ *   a: number;
+ *   b?: string;
+ *   c(): void;
+ *   d: (x: number) => string;
+ *   e?: () => void;     // optional also can be recognized
+ * }
+ * type FooFnTypes  = FunctionUnion<Foo>;  // (() => void) | ((x:number)=>string) | (()=>void)
+ */
+export type OnlyFunctions<T> = {
+  [K in keyof T as NonNullable<T[K]> extends Fn ? K : never]: T[K];
+};
+
+/**
+ * - get all the function keys in an object
+ * @example
+ * interface Foo {
+ *   a: number;
+ *   b?: string;
+ *   c(): void;
+ *   d: (x: number) => string;
+ *   e?: () => void;     // 可选也能识别
+ * }
+ * type FooFnKeys  = FunctionKeys<Foo>;  // 'c' | 'd' | 'e'
+ */
+export type FunctionKeys<T> = {
+  [K in keyof T]?: NonNullable<T[K]> extends Fn ? K : never;
+}[keyof T];
+
+/**
+ * - get all the function types in an object
+ * @example
+ * interface Foo {
+ *   a: number;
+ *   b?: string;
+ *   c(): void;
+ *   d: (x: number) => string;
+ *   e?: () => void;     // 可选也能识别
+ * }
+ * type FooFnTypes  = FunctionUnion<Foo>;  // (() => void) | ((x:number)=>string) | (()=>void)
+ */
+export type FunctionUnion<T> = {
+  [K in keyof T]: NonNullable<T[K]> extends Fn ? T[K] : never;
+}[keyof T];

primitives/type-utils/src/index.ts

@@ -0,0 +1,3 @@
+export * from './fn';
+
+export * from './utils';

primitives/type-utils/src/utils.ts

@@ -0,0 +1,9 @@
+/**
+ * @description
+ * without changing the type’s semantics, it only prettifies the IDE display—flattening the shape so hints are easier to read.
+ * @example
+ * type Raw = { a: number } & { b: string };
+ * type Pretty = Prettify<Raw>;
+ * // => { a: number; b: string; }
+ */
+export type Prettify<T> = { [K in keyof T]: T[K] } & {};

primitives/type-utils/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "jsx": "preserve",
+    "jsxImportSource": "vue",
+    "lib": ["DOM", "ESNext"],
+    "baseUrl": ".",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": ["node"],
+    "strict": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "outDir": "./dist",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

primitives/type-utils/tsdown.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  clean: true,
+  dts: true,
+  entry: ['src/index.ts'],
+  minify: false,
+  platform: 'neutral',
+  shims: true,
+  sourcemap: false
+});