@palantir/pack.core 0.0.1-beta.1

package/build/types/types/PackApp.d.ts

@@ -0,0 +1,49 @@
+import type { AppConfig } from "./AppConfig.js";
+import type { ModuleKey } from "./ModuleKey.js";
+/**
+* PackApp provides access to various pack subsystems.
+*
+* Specific modules are available after configuration and through declarations mixed in by import.
+* Eg for state system, if you import @palantir/pack.state.core you will have access to `app.state` accessor.
+* Similarly, auth is added automatically by initPackApp.
+*
+* @example
+* ```typescript
+* import { DocumentRef } from '@palantir/pack.state.core';
+* import { DocSchema } from '@my-app/schema';
+*
+* const app = initPackApp({
+*   tokenProvider: () => 'your-token',
+*   moduleConfigs: {
+*     ...createPackDocumentServiceConfig({appId: 'your-app-id', documentType: 'your-document-type'})
+*   },
+* });
+*
+* const docRef = app.state.getDocument(docSchema, 'your-document-id');
+* const doc = await docRef.getSnapshot(); // get pojo of your doc state.
+* ```
+*/
+export interface PackApp {
+	readonly config: AppConfig;
+}
+/**
+* Module configuration - either a tuple of [ModuleKey, config] or just a ModuleKey (for modules with no config)
+*/
+export type ModuleConfigTuple<T = unknown> = readonly [ModuleKey<T>, unknown];
+export type ModuleConfig<T = unknown> = ModuleConfigTuple<T> | ModuleKey<T>;
+/**
+* Type guard to check if a ModuleConfig is a tuple configuration
+*/
+export declare const isModuleConfigTuple: (config: ModuleConfig) => config is readonly [ModuleKey<unknown>, unknown];
+export interface PackAppInternal {
+	readonly config: AppConfig;
+	/**
+	* Internal module accessor
+	*/
+	getModule<
+		T,
+		TConfig = undefined
+	>(moduleKey: ModuleKey<T, TConfig>): T;
+}
+export declare function assertIsAppInternal(app: PackApp): asserts app is PackApp & PackAppInternal;
+export declare function assertIsAppInternal(app: PackAppInternal): asserts app is PackAppInternal;

package/build/types/types/PackApp.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,iBAAiB;AAC/B,cAAc,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;AAyB/B,iBAAiB,QAAQ;UACd,QAAQ;;;;;AAOnB,YAAY,kBAAkB,yBAAyB,UAAU;AACjE,YAAY,aAAa,eAAe,kBAAkB,KAAK,UAAU;;;;AAKzE,OAAO,cAAM,sBACX,QAAQ,iBACP,oBAAoB;AAIvB,iBAAiB,gBAAgB;UACtB,QAAQ;;;;CAMjB;EAAU;EAAG;GAAqB,WAAW,UAAU,GAAG,WAAW;;AAGvE,OAAO,iBAAS,oBAAoB,KAAK,kBAAkB,OAAO,UAAU;AAC5E,OAAO,iBAAS,oBACd,KAAK,0BACI,OAAO","names":[],"sources":["../../../src/types/PackApp.ts"],"version":3,"file":"PackApp.d.ts"}

package/build/types/types/TokenProvider.d.ts

@@ -0,0 +1 @@
+export type TokenProvider = () => Promise<string>;

package/build/types/types/TokenProvider.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,YAAY,sBAAsB","names":[],"sources":["../../../src/types/TokenProvider.ts"],"version":3,"file":"TokenProvider.d.ts"}

package/build/types/types/Unsubscribe.d.ts

@@ -0,0 +1 @@
+export type Unsubscribe = () => void;

package/build/types/types/Unsubscribe.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,YAAY","names":[],"sources":["../../../src/types/Unsubscribe.ts"],"version":3,"file":"Unsubscribe.d.ts"}

package/build/types/utils/assertNever.d.ts

@@ -0,0 +1 @@
+export declare function assertNever(_x: never): never;

package/build/types/utils/assertNever.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,OAAO,iBAAS,YAAY","names":[],"sources":["../../../src/utils/assertNever.ts"],"version":3,"file":"assertNever.d.ts"}

package/build/types/utils/generateId.d.ts

@@ -0,0 +1 @@
+export declare function generateId(bytes?: number): string;

package/build/types/utils/generateId.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAuBA,OAAO,iBAAS,WAAW","names":[],"sources":["../../../src/utils/generateId.ts"],"version":3,"file":"generateId.d.ts"}

package/build/types/utils/justOnce.d.ts

@@ -0,0 +1,10 @@
+/**
+* Used to call fn only once between app reloads.
+* eg: Useful for logging warnings that should only be logged once.
+*
+* @example
+* ```ts
+* justOnce("unexpected-value", () => console.warn("There was an unexpected value returned", {value}));
+* ```
+*/
+export declare function justOnce(key: string, fn: () => void): void;

package/build/types/utils/justOnce.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;AA2BA,OAAO,iBAAS,SAAS,aAAa","names":[],"sources":["../../../src/utils/justOnce.ts"],"version":3,"file":"justOnce.d.ts"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@palantir/pack.core",
+  "version": "0.0.1-beta.1",
+  "description": "PACK Core functionality and utilities",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/palantir/pack.git"
+  },
+  "exports": {
+    ".": {
+      "browser": "./build/browser/index.js",
+      "import": {
+        "types": "./build/types/index.d.ts",
+        "default": "./build/esm/index.js"
+      },
+      "require": "./build/cjs/index.js",
+      "default": "./build/browser/index.js"
+    },
+    "./*": {
+      "browser": "./build/browser/public/*.js",
+      "import": {
+        "types": "./build/types/public/*.d.ts",
+        "default": "./build/js/public/*.js"
+      },
+      "require": "./build/cjs/public/*.js",
+      "default": "./build/browser/public/*.js"
+    }
+  },
+  "dependencies": {
+    "@osdk/client": "~2.4.2",
+    "remeda": "^2.32.0"
+  },
+  "peerDependencies": {
+    "@osdk/api": "~2.4.2"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "tiny-invariant": "^1.3.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.2",
+    "@palantir/pack.monorepo.tsconfig": "~0.4.0-beta.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "pack",
+    "core"
+  ],
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
+  "types": "./build/cjs/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "clean": "rimraf .turbo build dist lib test-output *.tgz tsconfig.tsbuildinfo",
+    "lint": "eslint ./src ; dprint check --config $(find-up dprint.json) --allow-no-files",
+    "lint:fix": "eslint ./src --fix ; dprint fmt --config $(find-up dprint.json) --allow-no-files",
+    "test": "vitest run --passWithNoTests -u",
+    "test:watch": "vitest --passWithNoTests",
+    "transpileBrowser": "monorepo-transpile -f esm -m bundle -t browser",
+    "transpileCjs": "monorepo-transpile -f cjs -m bundle -t node",
+    "transpileEsm": "monorepo-transpile -f esm -m bundle -t node",
+    "transpileTypes": "monorepo-transpile -f esm -m types -t node",
+    "typecheck": "tsc --noEmit --emitDeclarationOnly false"
+  }
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export type { AppConfig, AppOptions } from "./types/AppConfig.js";
+export type { Branded, Flavored } from "./types/Branded.js";
+export type { ModuleKey } from "./types/ModuleKey.js";
+export { assertIsAppInternal, isModuleConfigTuple } from "./types/PackApp.js";
+export type { ModuleConfig, ModuleConfigTuple, PackApp, PackAppInternal } from "./types/PackApp.js";
+export type { TokenProvider } from "./types/TokenProvider.js";
+export type { Unsubscribe } from "./types/Unsubscribe.js";
+export { assertNever } from "./utils/assertNever.js";
+export { generateId } from "./utils/generateId.js";
+export { justOnce } from "./utils/justOnce.js";

package/src/types/AppConfig.ts

@@ -0,0 +1,97 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { Logger } from "@osdk/api";
+import type { Client } from "@osdk/client";
+import type { ModuleConfigTuple } from "./PackApp.js";
+import type { TokenProvider } from "./TokenProvider.js";
+
+export interface AppConfig {
+  readonly app: {
+    readonly appId: string;
+    readonly appVersion?: string;
+  };
+
+  readonly isTestMode: boolean;
+
+  readonly logger: Logger;
+
+  readonly osdkClient: Client;
+
+  readonly remote: {
+    readonly packApiPath: string;
+    readonly packWsPath: string;
+    readonly baseUrl: string;
+    readonly fetchFn: typeof globalThis.fetch;
+  };
+}
+
+export interface AppOptions {
+  /**
+   * Override the authentication token provider from the OSDK client.
+   *
+   * @default Uses token provider from OSDK client
+   */
+  readonly auth?: TokenProvider;
+
+  /**
+   * The ID of your application.
+   * @default Uses values from page environment meta tags (pack-appId, pack-appVersion)
+   */
+  readonly app?: {
+    readonly appId: string;
+    readonly appVersion?: string;
+  };
+
+  /**
+   * Logger configuration.
+   * @see {@link @osdk/client/internal.BrowserLogger} for a richer console logger.
+   * @default Log warnings & errors only.
+   */
+  readonly logger?: Logger;
+  readonly logLevel?: "debug" | "error" | "info" | "warn";
+
+  /**
+   * Internal testing overrides.
+   */
+  readonly moduleOverrides?: readonly ModuleConfigTuple[];
+
+  readonly remote?: {
+    /**
+     * @default "/pack/api"
+     */
+    readonly packApiPath?: string;
+
+    /**
+     * @default "/pack/ws"
+     */
+    readonly packWsPath?: string;
+
+    /**
+     * Override the base URL from the OSDK client.
+     *
+     * eg "https://example.com"
+     *
+     * @default Uses base URL from OSDK client
+     */
+    readonly baseUrl?: string;
+
+    /**
+     * Override the fetch function from the OSDK client.
+     */
+    readonly fetchFn?: typeof globalThis.fetch;
+  };
+}

package/src/types/Branded.ts

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export type Branded<Brand extends string, T = string> =
+  & T
+  & Readonly<{
+    readonly __pack_brand: Brand;
+  }>;
+
+/**
+ * A type that is "flavored" for self documenting code and prevents some accidental misuse.
+ * This is similar to {@link Branded} but allows implicit use of T without a type assertion,
+ * which is useful for stronger typing within certain systems without forcing it for all
+ * external uses.
+ *
+ * Flavored types with different brands will not match.
+ * A Branded type with the same brand will implicitly match a Flavored type with the same brand,
+ * ie `const foo: Flavored<"foo"> = "foo" as Branded<"foo">`
+ *
+ * @example
+ * type MyId = Flavored<"MyId">;
+ * type OtherId = Flavored<"OtherId">;
+ * const id: MyId = "my-id"; // Good: No type assertion needed
+ * const otherId: OtherId = id; // Error: Type 'MyId' is not assignable to type 'OtherId'
+ * const otherId: OtherId = id as OtherId; // You can assert between flavored types directly
+ */
+export type Flavored<Flavor extends string, T = string> =
+  & T
+  & Readonly<{
+    readonly __pack_brand?: Flavor;
+  }>;

package/src/types/ModuleKey.ts

@@ -0,0 +1,67 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import type { PackAppInternal } from "./PackApp.js";
+
+/**
+ * ModuleKey uniquely identifies a module.
+ *
+ * The key is a symbol and is used to identify the module config.
+ * Modules are lazily initialized on first access.
+ *
+ * @example
+ * ```ts
+ * const MY_MODULE_ACCESSOR = "myModule";
+ *
+ * const MY_MODULE_KEY: ModuleKey<MyModule, MyModuleConfig> = {
+ *   key: Symbol.for("my.module"),
+ *
+ *   appMemberName: MY_MODULE_ACCESSOR,
+ *   initModule: initMyModule,
+ * };
+ *
+ * const app = initPackApp({
+ *   moduleConfig: {
+ *     [MY_MODULE_KEY.key]: { ... config ... } satisfies MyModuleConfig
+ *
+ *     // Note this is the actual shape of the moduleConfig, ie index by module key symbol
+ *     // But it is far more ergonomic to spread from a config creator, ie:
+ *     ...createMyModuleConfig({ ... config ... }),
+ *   }
+ * })
+ *
+ * // Get the module (manual way)
+ * const myModule = app.getModule(MY_MODULE_KEY);
+ *
+ * // Get the module from app property (available via appMemberName sugar)
+ * // You also need to declare the appMemberName on the PackApp interface so the type
+ * // system knows it is present. This keeps your module usage limited to where your module
+ * // is imported
+ * declare module '@palantir/pack.core' {
+ *   interface PackApp {
+ *     readonly [MY_MODULE_ACCESSOR]?: MyModule;
+ *   }
+ * }
+ * const myModule = app.myModule;
+ *
+ * ```
+ */
+export interface ModuleKey<T, TConfig = unknown> {
+  /** If set, this module will have a getter installed on the PackApp interface */
+  readonly appMemberName?: string;
+  readonly key: symbol;
+  readonly initModule: (app: PackAppInternal, config?: TConfig) => T;
+}

package/src/types/PackApp.ts

@@ -0,0 +1,82 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import invariant from "tiny-invariant";
+import type { AppConfig } from "./AppConfig.js";
+import type { ModuleKey } from "./ModuleKey.js";
+
+/**
+ * PackApp provides access to various pack subsystems.
+ *
+ * Specific modules are available after configuration and through declarations mixed in by import.
+ * Eg for state system, if you import @palantir/pack.state.core you will have access to `app.state` accessor.
+ * Similarly, auth is added automatically by initPackApp.
+ *
+ * @example
+ * ```typescript
+ * import { DocumentRef } from '@palantir/pack.state.core';
+ * import { DocSchema } from '@my-app/schema';
+ *
+ * const app = initPackApp({
+ *   tokenProvider: () => 'your-token',
+ *   moduleConfigs: {
+ *     ...createPackDocumentServiceConfig({appId: 'your-app-id', documentType: 'your-document-type'})
+ *   },
+ * });
+ *
+ * const docRef = app.state.getDocument(docSchema, 'your-document-id');
+ * const doc = await docRef.getSnapshot(); // get pojo of your doc state.
+ * ```
+ */
+export interface PackApp {
+  readonly config: AppConfig;
+  // Note auth and other module accessors are added dynamically during initialization
+}
+
+/**
+ * Module configuration - either a tuple of [ModuleKey, config] or just a ModuleKey (for modules with no config)
+ */
+export type ModuleConfigTuple<T = unknown> = readonly [ModuleKey<T>, unknown];
+export type ModuleConfig<T = unknown> = ModuleConfigTuple<T> | ModuleKey<T>;
+
+/**
+ * Type guard to check if a ModuleConfig is a tuple configuration
+ */
+export const isModuleConfigTuple = (
+  config: ModuleConfig,
+): config is readonly [ModuleKey<unknown>, unknown] => {
+  return Array.isArray(config);
+};
+
+export interface PackAppInternal {
+  readonly config: AppConfig;
+
+  /**
+   * Internal module accessor
+   */
+  // TODO: maybe prefix with _ to show it's internal ?
+  getModule<T, TConfig = undefined>(moduleKey: ModuleKey<T, TConfig>): T;
+}
+
+export function assertIsAppInternal(app: PackApp): asserts app is PackApp & PackAppInternal;
+export function assertIsAppInternal(
+  app: PackAppInternal,
+): asserts app is PackAppInternal;
+export function assertIsAppInternal(
+  app: PackApp | PackAppInternal,
+): asserts app is PackAppInternal {
+  invariant("getModule" in app, "App is not an PackAppInternal");
+}

package/src/types/TokenProvider.ts

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export type TokenProvider = () => Promise<string>;

package/src/types/Unsubscribe.ts

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export type Unsubscribe = () => void;

package/src/utils/assertNever.ts

@@ -0,0 +1,19 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function assertNever(_x: never): never {
+  throw new Error("Hit unreachable code");
+}

package/src/utils/generateId.ts

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+function toHexString(byteArray: Int8Array) {
+  return Array.from(byteArray, function(byte) {
+    const h = (byte & 0xff).toString(16);
+    return h.length === 1 ? `0${h}` : h;
+  }).join("");
+}
+
+export function generateId(bytes = 12): string {
+  const array = new Int8Array(bytes);
+  const r = crypto.getRandomValues(array);
+  return toHexString(r);
+}

package/src/utils/justOnce.ts

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+const SEEN_KEYS = new Set<string>();
+
+/**
+ * Used to call fn only once between app reloads.
+ * eg: Useful for logging warnings that should only be logged once.
+ *
+ * @example
+ * ```ts
+ * justOnce("unexpected-value", () => console.warn("There was an unexpected value returned", {value}));
+ * ```
+ */
+export function justOnce(key: string, fn: () => void): void {
+  if (!SEEN_KEYS.has(key)) {
+    SEEN_KEYS.add(key);
+    fn();
+  }
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "extends": "@palantir/pack.monorepo.tsconfig/base.json",
+  "compilerOptions": {
+    "outDir": "./build/esm",
+    "rootDir": "./src",
+    "declarationDir": "./build/types",
+    "tsBuildInfoFile": "./build/tsconfig.tsbuildinfo"
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "build",
+    "dist",
+    "node_modules",
+    "test-output",
+    "**/__tests__/**/__snapshots__",
+    "**/__tests__/**/fixtures"
+  ],
+  "references": []
+}

package/vitest.config.mjs

@@ -0,0 +1,26 @@
+import { coverageConfigDefaults, defaultExclude, defineProject } from "vitest/config";
+
+export default defineProject({
+  test: {
+    exclude: [...defaultExclude, "**/build/**", "**/test-output/**"],
+    coverage: {
+      provider: "v8",
+      all: true,
+      enabled: true,
+      pool: "forks",
+      include: ["src/**/*.{ts,tsx}"],
+      exclude: [
+        ...coverageConfigDefaults.exclude,
+        "**/*.test.{ts,tsx}",
+        "**/__tests__",
+        "build",
+        "coverage",
+        "dist",
+        "node_modules",
+        "src/index.ts",
+        "test-output",
+        "vitest.config.*",
+      ],
+    },
+  },
+});