@visulima/packem 1.7.0 → 1.7.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## @visulima/packem [1.7.2](https://github.com/visulima/packem/compare/@visulima/packem@1.7.1...@visulima/packem@1.7.2) (2024-11-17)
+
+### Bug Fixes
+
+* updated oxc deps ([5989b86](https://github.com/visulima/packem/commit/5989b86dfd589bd3afb8557a8d962b368e077f0b))
+
+## @visulima/packem [1.7.1](https://github.com/visulima/packem/compare/@visulima/packem@1.7.0...@visulima/packem@1.7.1) (2024-11-17)
+
+### Bug Fixes
+
+* updated docs about isolated declarations, moved sourcemapsPlugin… ([#63](https://github.com/visulima/packem/issues/63)) ([d64d022](https://github.com/visulima/packem/commit/d64d022305df696c809aa7f0480e04e8829c2bfb))
+
 ## @visulima/packem [1.7.0](https://github.com/visulima/packem/compare/@visulima/packem@1.6.5...@visulima/packem@1.7.0) (2024-11-17)
 
 ### Features

package/README.md

@@ -53,7 +53,7 @@ It uses the `exports` configuration in `package.json` and recognizes entry file
 -   ✅ Supports dynamic import
 -   ✅ Supports `tsconfig.json` paths and `package.json` imports resolution
 -   ✅ ESM ⇄ CJS interoperability
--   ✅ Supports isolated declaration types (experimental)
+-   ✅ Supports isolated declaration types (experimental) (Typescript version 5.5 or higher)
 -   ✅ Supports wasm [WebAssembly modules](http://webassembly.org)
 -   ✅ Supports css, [sass](https://github.com/sass/sass), [less](https://github.com/less/less.js), [stylus](https://github.com/stylus/stylus) and Up-to-date [CSS Modules](https://github.com/css-modules/css-modules) (experimental)
 -   ✅ [TypeDoc](https://github.com/TypeStrong/TypeDoc) documentation generation
@@ -541,6 +541,30 @@ export default defineConfig({
 });
 ```
 
+### Isolated declaration types (in TypeScript 5.5)
+
+> Generating .d.ts files with the default `rollup-plugin-dts` is slow because the TypeScript compiler must perform costly type inference, but these files streamline type checking by removing unnecessary details, and while shipping raw TypeScript files could simplify workflows, it is impractical due to ecosystem assumptions and performance trade-offs, which isolated declarations aim to address.
+
+You need to choose of the supported transformer to use isolated declaration types.
+
+-   [oxc](https://github.com/oxc-project/oxc)
+-   [@swc/core](https://github.com/swc-project/swc)
+-   [typescript](https://github.com/microsoft/TypeScript)
+
+Default is `typescript`.
+
+```ts
+import { defineConfig } from "@visulima/packem/config";
+import transformer from "@visulima/packem/transformer/esbuild";
+import isolatedDeclarationTransformer from "@visulima/packem/dts/isolated/transformer/typescript";
+
+// eslint-disable-next-line import/no-unused-modules
+export default defineConfig({
+    transformer,
+    isolatedDeclarationTransformer,
+});
+```
+
 <!-- Modified copy of https://github.com/Anidetrix/rollup-plugin-styles/blob/main/README.md -->
 
 ## Css and Css Modules
@@ -802,20 +826,6 @@ You can feed the output file to analysis tools like [bundle buddy](https://www.b
 
 The file outputs as metafile-{bundleName}-{format}.json, e.g. `packem` will generate metafile-test-cjs.json and metafile-test-es.json.
 
-## Configuration
-
-### packem.config.js
-
-The packem configuration file is a JavaScript file that exports an object with the following properties:
-
-#### transformer
-
-You choose which one of the three supported transformer to use.
-
--   [esbuild](https://github.com/evanw/esbuild)
--   [@swc/core](https://github.com/swc-project/swc)
--   [sucrase](https://github.com/alangpierce/sucrase)
-
 ### onSuccess
 
 You can specify command to be executed after a successful build, specially useful for **Watch mode**
@@ -857,6 +867,20 @@ export default defineConfig({
 });
 ```
 
+## Configuration
+
+### packem.config.js
+
+The packem configuration file is a JavaScript file that exports an object with the following properties:
+
+#### transformer
+
+You choose which one of the three supported transformer to use.
+
+-   [esbuild](https://github.com/evanw/esbuild)
+-   [@swc/core](https://github.com/swc-project/swc)
+-   [sucrase](https://github.com/alangpierce/sucrase)
+
 ## Related
 
 -   [bunchee](https://github.com/huozhi/bunchee) - Zero config bundler for ECMAScript and TypeScript packages

package/dist/build.d.cts

@@ -0,0 +1,6 @@
+import type { BuildContext } from "./types.d.cts";
+import type FileCache from "./utils/file-cache.d.cts";
+declare const build: (context: BuildContext, fileCache: FileCache) => Promise<boolean>;
+
+
+export = build;

package/dist/build.d.mts

@@ -0,0 +1,4 @@
+import type { BuildContext } from "./types.d.mts";
+import type FileCache from "./utils/file-cache.d.mts";
+declare const build: (context: BuildContext, fileCache: FileCache) => Promise<boolean>;
+export default build;

package/dist/build.d.ts

@@ -0,0 +1,6 @@
+import type { BuildContext } from "./types.d.ts";
+import type FileCache from "./utils/file-cache.d.ts";
+declare const build: (context: BuildContext, fileCache: FileCache) => Promise<boolean>;
+
+
+export = build;

package/dist/builder/typedoc/generate-reference-documentation.d.cts

@@ -0,0 +1,6 @@
+import type { Pail } from "@visulima/pail";
+import type { BuildEntry, TypeDocumentOptions } from "../../types.d.cts";
+declare const generateReferenceDocumentation: (options: TypeDocumentOptions, entries: BuildEntry[], outputDirectory: string, logger: Pail) => Promise<void>;
+
+
+export = generateReferenceDocumentation;

package/dist/builder/typedoc/generate-reference-documentation.d.mts

@@ -0,0 +1,4 @@
+import type { Pail } from "@visulima/pail";
+import type { BuildEntry, TypeDocumentOptions } from "../../types.d.mts";
+declare const generateReferenceDocumentation: (options: TypeDocumentOptions, entries: BuildEntry[], outputDirectory: string, logger: Pail) => Promise<void>;
+export default generateReferenceDocumentation;

package/dist/builder/typedoc/generate-reference-documentation.d.ts

@@ -0,0 +1,6 @@
+import type { Pail } from "@visulima/pail";
+import type { BuildEntry, TypeDocumentOptions } from "../../types.d.ts";
+declare const generateReferenceDocumentation: (options: TypeDocumentOptions, entries: BuildEntry[], outputDirectory: string, logger: Pail) => Promise<void>;
+
+
+export = generateReferenceDocumentation;

package/dist/builder/typedoc/index.d.cts

@@ -1,36 +1,5 @@
-import { a as BuildContext } from '../../packem_shared/types-kgeUjygP.cjs';
-import '@rollup/plugin-alias';
-import '@rollup/plugin-commonjs';
-import '@rollup/plugin-json';
-import '@rollup/plugin-node-resolve';
-import '@rollup/plugin-replace';
-import '@rollup/plugin-wasm';
-import '@rollup/pluginutils';
-import '@visulima/package';
-import '@visulima/pail';
-import '@visulima/tsconfig';
-import 'hookable';
-import 'jiti';
-import 'rollup';
-import 'rollup-plugin-dts';
-import 'rollup-plugin-polyfill-node';
-import 'rollup-plugin-visualizer';
-import 'typedoc';
-import 'cssnano';
-import 'lightningcss';
-import 'postcss';
-import 'postcss-load-config';
-import 'node-sass';
-import 'sass';
-import 'sass-embedded';
-import '../../packem_shared/types-Cxx27LIj.cjs';
-import 'esbuild';
-import '../../packem_shared/types-DvWhOdt5.cjs';
-import 'sucrase';
-import '../../packem_shared/types-CzGE8V_d.cjs';
-import 'stylus';
-import 'source-map-js';
-
+import type { BuildContext } from "../../types.d.cts";
 declare const builder: (context: BuildContext, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
 
-export = builder;
+
+export = builder;

package/dist/builder/typedoc/index.d.mts

@@ -1,36 +1,3 @@
-import { a as BuildContext } from '../../packem_shared/types-Fi7FTwGc.mjs';
-import '@rollup/plugin-alias';
-import '@rollup/plugin-commonjs';
-import '@rollup/plugin-json';
-import '@rollup/plugin-node-resolve';
-import '@rollup/plugin-replace';
-import '@rollup/plugin-wasm';
-import '@rollup/pluginutils';
-import '@visulima/package';
-import '@visulima/pail';
-import '@visulima/tsconfig';
-import 'hookable';
-import 'jiti';
-import 'rollup';
-import 'rollup-plugin-dts';
-import 'rollup-plugin-polyfill-node';
-import 'rollup-plugin-visualizer';
-import 'typedoc';
-import 'cssnano';
-import 'lightningcss';
-import 'postcss';
-import 'postcss-load-config';
-import 'node-sass';
-import 'sass';
-import 'sass-embedded';
-import '../../packem_shared/types-Cxx27LIj.mjs';
-import 'esbuild';
-import '../../packem_shared/types-DvWhOdt5.mjs';
-import 'sucrase';
-import '../../packem_shared/types-CzGE8V_d.mjs';
-import 'stylus';
-import 'source-map-js';
-
+import type { BuildContext } from "../../types.d.mts";
 declare const builder: (context: BuildContext, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
-
-export { builder as default };
+export default builder;

package/dist/builder/typedoc/index.d.ts

@@ -1,36 +1,5 @@
-import { a as BuildContext } from '../../packem_shared/types-CAFfUy8-.js';
-import '@rollup/plugin-alias';
-import '@rollup/plugin-commonjs';
-import '@rollup/plugin-json';
-import '@rollup/plugin-node-resolve';
-import '@rollup/plugin-replace';
-import '@rollup/plugin-wasm';
-import '@rollup/pluginutils';
-import '@visulima/package';
-import '@visulima/pail';
-import '@visulima/tsconfig';
-import 'hookable';
-import 'jiti';
-import 'rollup';
-import 'rollup-plugin-dts';
-import 'rollup-plugin-polyfill-node';
-import 'rollup-plugin-visualizer';
-import 'typedoc';
-import 'cssnano';
-import 'lightningcss';
-import 'postcss';
-import 'postcss-load-config';
-import 'node-sass';
-import 'sass';
-import 'sass-embedded';
-import '../../packem_shared/types-Cxx27LIj.js';
-import 'esbuild';
-import '../../packem_shared/types-DvWhOdt5.js';
-import 'sucrase';
-import '../../packem_shared/types-CzGE8V_d.js';
-import 'stylus';
-import 'source-map-js';
-
+import type { BuildContext } from "../../types.d.ts";
 declare const builder: (context: BuildContext, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
 
-export = builder;
+
+export = builder;

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {};