@visulima/packem 2.0.0-alpha.1 → 2.0.0-alpha.2

package/README.md

@@ -4,7 +4,7 @@
   <p>
   A fast and modern bundler for Node.js and TypeScript.
 <br /> Supports multiple runtimes, shared modules, server components, dynamic import, wasm, css, and more.
-<br /> Built on top of Rollup, combined with your preferred transformer like esbuild, swc, or sucrase.
+<br /> Built on top of Rollup, combined with your preferred transformer like esbuild, swc, OXC, or sucrase.
   </p>
 </div>
 
@@ -30,33 +30,35 @@
 
 ## Overview
 
-`Visulima Packem` is built on top of Rollup, combined with your preferred transformer like `esbuild`, `swc`, or `sucrase`.
+`Visulima Packem` is built on top of Rollup, combined with your preferred transformer like `esbuild`, `swc`, `OXC`, or `sucrase`.
 It enables you to generate multiple bundles (CommonJS or ESModule) simultaneously while adhering to Node.js’ native file type support.
 
 It uses the `exports` configuration in `package.json` and recognizes entry file conventions to match your exports and build them into bundles.
 
 ## Features
 
--   ✅ package.json#exports, package.json#main, package.json#module to define entry-points
--   ✅ package.json#bin to define executables
--   ✅ package.json#types to define types
--   ✅ Generates package.json#typeVersions to support node 10
--   ✅ Dependency externalization
--   ✅ Minification
--   ✅ TypeScript support + .d.ts bundling
--   ✅ Watch mode
--   ✅ CLI outputs (auto hashbang insertion)
--   ✅ Validates package.json and checks if all fields that are needed to publish your package are configured correctly
--   ✅ Supports multiple runtimes (default, react-server, edge-light)
--   ✅ Supports react server and client components
--   ✅ Supports shared modules
--   ✅ Supports dynamic import
--   ✅ Supports `tsconfig.json` paths and `package.json` imports resolution
--   ✅ ESM ⇄ CJS interoperability
--   ✅ 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
+- ✅ package.json#exports, package.json#main, package.json#module to define entry-points
+- ✅ package.json#bin to define executables
+- ✅ package.json#types to define types
+- ✅ Generates package.json#typeVersions to support node 10
+- ✅ Dependency externalization
+- ✅ Minification
+- ✅ TypeScript support + .d.ts bundling
+- ✅ Watch mode
+- ✅ CLI outputs (auto hashbang insertion)
+- ✅ Validator
+    - Validates package.json and checks if all fields that are needed to publish your package are configured correctly
+    - Bundle size validation
+- ✅ Supports multiple runtimes (default, react-server, edge-light, browser and node)
+- ✅ Supports react server and client components
+- ✅ Supports shared modules
+- ✅ Supports dynamic import
+- ✅ Supports `tsconfig.json` paths and `package.json` imports resolution
+- ✅ ESM ⇄ CJS interoperability
+- ✅ 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
 
 And more...
 
@@ -179,7 +181,7 @@ You can validate your package.json exports configuration with [are the types wro
 
 Links:
 
--   https://github.com/frehner/modern-guide-to-packaging-js-library#set-the-main-field
+- https://github.com/frehner/modern-guide-to-packaging-js-library#set-the-main-field
 
 ## Usage
 
@@ -211,8 +213,8 @@ For example: `src/index.ts` will match the exports name `"."` or the only main e
 Now just run `npm run build` or `pnpm build` / `yarn build` if you're using these package managers, `packem` will find the entry files and build them.
 The output format will be based on the exports condition and also the file extension. Given an example:
 
--   It's CommonJS for `require` and ESM for `import` based on the exports condition.
--   It's CommonJS for `.cjs` and ESM for `.mjs` based on the extension regardless the exports condition. Then for export condition like "node" you could choose the format with your extension.
+- It's CommonJS for `require` and ESM for `import` based on the exports condition.
+- It's CommonJS for `.cjs` and ESM for `.mjs` based on the extension regardless the exports condition. Then for export condition like "node" you could choose the format with your extension.
 
 > [!NOTE]
 > All the `dependencies` and `peerDependencies` will be marked as external automatically and not included in the bundle. If you want to include them in the bundle, you can use the `--no-external` option.
@@ -246,8 +248,8 @@ For instance:
 
 If you need to separate the `production` and `development` exports condition, `packem` provides `process.env.NODE_ENV` injected by default if present that you don't need to manually inject yourself.
 
--   When the `production` exports condition is defined and the file ends with `*.production.*` in the package.json, the bundle will be minified.
--   When the `development` exports condition is defined and the file ends with `*.development.*` in the package.json, the bundle will not be minified.
+- When the `production` exports condition is defined and the file ends with `*.production.*` in the package.json, the bundle will be minified.
+- When the `development` exports condition is defined and the file ends with `*.development.*` in the package.json, the bundle will not be minified.
 
 ```json
 {
@@ -326,6 +328,9 @@ There are always cases that you need to share code among bundles, but they don't
 
 ```js
 // src/util.shared-runtime.js
+/**
+ *
+ */
 export function sharedUtil() {
     /* ... */
 }
@@ -335,12 +340,12 @@ Then you can use them in different entry files:
 
 ```js
 // src/index.js
-import { sharedUtil } from "./util.shared-runtime";
+import { sharedUtil as sharedUtility } from "./util.shared-runtime";
 ```
 
 ```js
 // src/lite.js
-import { sharedUtil } from "./util.shared-runtime";
+import { sharedUtil as sharedUtility } from "./util.shared-runtime";
 ```
 
 `packem` will bundle the shared module into a separate **layer** which matches the file name convention, in the above case it's "shared", and that bundle will be referenced by the different entry bundles.
@@ -354,6 +359,7 @@ With multiple runtime bundles, such as having `default` and `react-server` toget
 
 ```js
 "use client";
+
 // src/app-context.shared-runtime.js
 export const AppContext = React.createContext(null);
 ```
@@ -394,7 +400,7 @@ Use the `--visualize` flag to generate a `packem-bundle-analyze.html` file at bu
 `packem` supports building module workers with the `--workers` flag, which are a special type of bundle that can be used to run code in a web worker.
 
 ```js
-worker = new Worker(new URL("./worker.js", import.meta.url), { type: "module" });
+worker = new Worker(new URL("worker.js", import.meta.url), { type: "module" });
 // or simply:
 worker = new Worker("./worker.js", { type: "module" });
 ```
@@ -409,17 +415,17 @@ The value of `type` can be either `"build"` or `"dts"`, where `"build"` is the d
 
 The resolved plugins will be in the following order:
 
--   Alias
--   User plugins with enforce: 'pre'
--   Rollup core plugins
--   User plugins without enforce value
--   Rollup build plugins
--   User plugins with enforce: 'post'
--   Rollup post build plugins (minify, manifest, copy, reporting)
+- Alias
+- User plugins with enforce: 'pre'
+- Rollup core plugins
+- User plugins without enforce value
+- Rollup build plugins
+- User plugins with enforce: 'post'
+- Rollup post build plugins (minify, manifest, copy, reporting)
 
 ```typescript
-import { defineConfig } from "@visulima/packem/config";
 import { optimizeLodashImports } from "@optimize-lodash/rollup-plugin";
+import { defineConfig } from "@visulima/packem/config";
 
 export default defineConfig({
     // ...
@@ -436,7 +442,7 @@ export default defineConfig({
 
 ### Aliases
 
-Aliases can be configured in the [import map](https://nodejs.org/api/packages.html#imports), defined in `package.json#imports`.
+Aliases are automatically inferred from `paths` in your tsconfig.json file, and can also be configured in the [import map](https://nodejs.org/api/packages.html#imports) defined in `package.json#imports`.
 
 For native Node.js import mapping, all entries must be prefixed with `#` to indicate an internal [subpath import](https://nodejs.org/api/packages.html#subpath-imports). `Packem` takes advantage of this behavior to define entries that are _not prefixed_ with `#` as an alias.
 
@@ -448,13 +454,13 @@ Native Node.js import mapping supports conditional imports (eg. resolving differ
 {
     // ...
 
-    imports: {
+    "imports": {
         // Mapping '~utils' to './src/utils.js'
         "~utils": "./src/utils.js",
 
         // Native Node.js import mapping (can't reference ./src)
-        "#internal-package": "./vendors/package/index.js",
-    },
+        "#internal-package": "./vendors/package/index.js"
+    }
 }
 ```
 
@@ -493,13 +499,100 @@ This will replace all instances of `process.env.NODE_ENV` with `'production'` an
 packem build --env.NODE_ENV=production
 ```
 
-## Validating
+## Programmatic Usage
+
+You can use Packem programmatically in your Node.js applications without the CLI:
+
+```typescript
+import { packem } from "@visulima/packem";
+
+// Basic usage
+await packem("./src", {
+    environment: "production",
+    mode: "build",
+});
+
+// With custom options
+await packem("./src", {
+    declaration: true,
+    environment: "development",
+    logger: {
+        // Custom logger options
+        level: "debug",
+    },
+    minify: true,
+    mode: "build",
+    sourcemap: true,
+});
+```
+
+The `packem` function accepts the following parameters:
+
+- `rootDirectory` (string): The root directory of your project to bundle
+- `options` (PackemOptions): Configuration options that extend the BuildConfig interface
+    - `mode`: The build mode ('build' | 'watch')
+    - `environment`: The target environment ('development' | 'production')
+    - `declaration`: Enable/disable TypeScript declaration file generation
+    - `minify`: Enable/disable code minification
+    - `sourcemap`: Enable/disable source map generation
+    - `logger`: Logger configuration options
+
+For more detailed configuration options, refer to the [Configuration](#configuration) section.
+
+## Validators
+
+### Package.json Validation
 
 `Packem` validates your `package.json` file and checks if all fields are configured correctly, that are needed to publish your package.
 
 > [!NOTE]
 > To have a full validation checkup, visit [publint](https://github.com/bluwy/publint) and [are the types wrong](https://github.com/arethetypeswrong/arethetypeswrong.github.io).
 
+### Bundle Size Validation
+
+`Packem` validates the bundle size and checks if the bundle size is within the limit you set in the configuration file.
+
+```ts
+import { defineConfig } from "@visulima/packem/config";
+
+export default defineConfig({
+    // ...
+    validator: {
+        bundleSize: {
+            limit: 1024 * 1024, // 1MB
+            // or / and limits per file
+            limits: {
+                // Glob pattern
+                "**/*.mjs": "1MB",
+                "index.cjs": 1024 * 1024, // 1MB
+                "test.mjs": "1MB",
+            },
+        },
+    },
+    // ...
+});
+```
+
+## Experimental Features
+
+### OXC Resolver
+
+`packem` supports the [oxc-resolver](https://github.com/oxc-project/oxc-resolver) resolver to resolve modules in your project.
+
+To use the oxc resolver, you need to enable it in the packem configuration file.
+
+```ts
+import { defineConfig } from "@visulima/packem/config";
+
+export default defineConfig({
+    // ...
+    experimental: {
+        oxcResolve: true,
+    },
+    // ...
+});
+```
+
 ## TypeDoc
 
 ### Installation
@@ -547,21 +640,20 @@ export default defineConfig({
 
 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)
+- [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";
+import transformer from "@visulima/packem/transformer/esbuild";
 
-// eslint-disable-next-line import/no-unused-modules
 export default defineConfig({
-    transformer,
     isolatedDeclarationTransformer,
+    transformer,
 });
 ```
 
@@ -571,22 +663,22 @@ export default defineConfig({
 
 `packem` supports:
 
--   [PostCSS](https://github.com/postcss/postcss)
--   [Sass](https://github.com/sass/sass)
--   [Less](https://github.com/less/less.js)
--   [Stylus](https://github.com/stylus/stylus)
--   Up-to-date [CSS Modules](https://github.com/css-modules/css-modules) implementation
--   URL resolving/rewriting with asset handling
--   Ability to use `@import` statements inside regular CSS
--   Built-in assets handler
--   Ability to emit pure CSS for other plugins
--   Complete code splitting support, with respect for multiple entries, `preserveModules` and `manualChunks`
--   Multiple instances support, with check for already processed files
--   Proper sourcemaps, with included sources content by default
--   Respects `assetFileNames` for CSS file names
--   Respects sourcemaps from loaded files
--   Support for implementation forcing for Sass
--   Support for partials and `~` in Less import statements
+- [PostCSS](https://github.com/postcss/postcss)
+- [Sass](https://github.com/sass/sass)
+- [Less](https://github.com/less/less.js)
+- [Stylus](https://github.com/stylus/stylus)
+- Up-to-date [CSS Modules](https://github.com/css-modules/css-modules) implementation
+- URL resolving/rewriting with asset handling
+- Ability to use `@import` statements inside regular CSS
+- Built-in assets handler
+- Ability to emit pure CSS for other plugins
+- Complete code splitting support, with respect for multiple entries, `preserveModules` and `manualChunks`
+- Multiple instances support, with check for already processed files
+- Proper sourcemaps, with included sources content by default
+- Respects `assetFileNames` for CSS file names
+- Respects sourcemaps from loaded files
+- Support for implementation forcing for Sass
+- Support for partials and `~` in Less import statements
 
 ### PostCSS
 
@@ -611,17 +703,17 @@ Add the loader to your `packem.config.ts`:
 
 ```typescript
 import { defineConfig } from "@visulima/packem/config";
-import transformer from "@visulima/packem/transformer/esbuild";
 import postcssLoader from "@visulima/packem/css/loader/postcss";
 import sourceMapLoader from "@visulima/packem/css/loader/sourcemap";
+import transformer from "@visulima/packem/transformer/esbuild";
 
 export default defineConfig({
-    transformer,
     rollup: {
         css: {
             loaders: [postcssLoader, sourceMapLoader],
         },
     },
+    transformer,
 });
 ```
 
@@ -657,18 +749,18 @@ Add the loader to your `packem.config.ts`:
 
 ```typescript
 import { defineConfig } from "@visulima/packem/config";
-import transformer from "@visulima/packem/transformer/esbuild";
 import postcssLoader from "@visulima/packem/css/loader/postcss";
 import sassLoader from "@visulima/packem/css/loader/sass";
 import sourceMapLoader from "@visulima/packem/css/loader/sourcemap";
+import transformer from "@visulima/packem/transformer/esbuild";
 
 export default defineConfig({
-    transformer,
     rollup: {
         css: {
             loaders: [postcssLoader, sassLoader, sourceMapLoader],
         },
     },
+    transformer,
 });
 ```
 
@@ -692,18 +784,18 @@ Add the loader to your `packem.config.ts`:
 
 ```typescript
 import { defineConfig } from "@visulima/packem/config";
-import transformer from "@visulima/packem/transformer/esbuild";
-import postcssLoader from "@visulima/packem/css/loader/postcss";
 import lessLoader from "@visulima/packem/css/loader/less";
+import postcssLoader from "@visulima/packem/css/loader/postcss";
 import sourceMapLoader from "@visulima/packem/css/loader/sourcemap";
+import transformer from "@visulima/packem/transformer/esbuild";
 
 export default defineConfig({
-    transformer,
     rollup: {
         css: {
             loaders: [postcssLoader, lessLoader, sourceMapLoader],
         },
     },
+    transformer,
 });
 ```
 
@@ -727,18 +819,18 @@ Add the loader to your `packem.config.ts`:
 
 ```typescript
 import { defineConfig } from "@visulima/packem/config";
-import transformer from "@visulima/packem/transformer/esbuild";
 import postcssLoader from "@visulima/packem/css/loader/postcss";
-import stylusLoader from "@visulima/packem/css/loader/stylus";
 import sourceMapLoader from "@visulima/packem/css/loader/sourcemap";
+import stylusLoader from "@visulima/packem/css/loader/stylus";
+import transformer from "@visulima/packem/transformer/esbuild";
 
 export default defineConfig({
-    transformer,
     rollup: {
         css: {
             loaders: [postcssLoader, stylusLoader, sourceMapLoader],
         },
     },
+    transformer,
 });
 ```
 
@@ -803,7 +895,7 @@ Will look for `_custom` first (_with the appropriate extension(s)_), and then fo
 styles({
     mode: "inject", // Unnecessary, set by default
     // ...or with custom options for injector
-    mode: ["inject", { container: "body", singleTag: true, prepend: true, attributes: { id: "global" } }],
+    mode: ["inject", { attributes: { id: "global" }, container: "body", prepend: true, singleTag: true }],
     // ...or with custom injector
     mode: ["inject", (varname, id) => `console.log(${varname},${JSON.stringify(id)})`],
 });
@@ -856,10 +948,12 @@ import { defineConfig } from "@visulima/packem/config";
 export default defineConfig({
     // ...
     onSuccess() {
-        const server = http.createServer((req, res) => {
+        const server = http.createServer((request, res) => {
             res.end("Hello World!");
         });
+
         server.listen(3000);
+
         return () => {
             server.close();
         };
@@ -877,18 +971,64 @@ The packem configuration file is a JavaScript file that exports an object with t
 
 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)
+- [esbuild](https://github.com/evanw/esbuild)
+- [@swc/core](https://github.com/swc-project/swc)
+- [sucrase](https://github.com/alangpierce/sucrase)
+- [OXC](https://www.npmjs.com/package/oxc-transform)
+
+### File types
+
+Packem exports a `files.d.ts` file that contains all supported the types.
+
+To shim the types, you can use the following:
+
+```ts
+/// <reference types="@visulima/packem/files" />
+```
+
+Alternatively, you can add `@visulima/packem/files` to `compilerOptions.types` inside `tsconfig.json`:
+
+```json
+{
+    "compilerOptions": {
+        "types": ["@visulima/packem/files"]
+    }
+}
+```
+
+This will provide the following type shims:
+
+- Asset imports (e.g importing an `.svg`, `.module.css` file)
+
+> Tip:
+>
+> To override the default typing, add a type definition file that contains your typings. Then, add the type reference before `@visulima/packem/files`.
+>
+> packem-env-override.d.ts (the file that contains your typings):
+>
+> ```ts
+> declare module "*.svg" {
+>     const content: React.FC<React.SVGProps<SVGElement>>;
+>
+>     export default content;
+> }
+> ```
+>
+> The file containing the reference to `@visulima/packem/files`:
+>
+> ```ts
+> /// <reference types="./packem-env-override.d.ts" />
+> /// <reference types="@visulima/packem/files" />
+> ```
 
 ## Related
 
--   [bunchee](https://github.com/huozhi/bunchee) - Zero config bundler for ECMAScript and TypeScript packages
--   [unbuild](https://github.com/unjs/unbuild) - 📦 An unified javascript build system
--   [pkgroll](https://github.com/privatenumber/pkgroll) - 📦 Zero-config package bundler for Node.js + TypeScript
--   [siroc](https://github.com/danielroe/siroc) - Zero-config build tooling for Node
--   [tsup](https://github.com/egoist/tsup) - The simplest and fastest way to bundle your TypeScript libraries
--   [microbundle](https://github.com/developit/microbundle) - Zero-configuration bundler for tiny JS libs, powered by Rollup.
+- [bunchee](https://github.com/huozhi/bunchee) - Zero config bundler for ECMAScript and TypeScript packages
+- [unbuild](https://github.com/unjs/unbuild) - 📦 An unified javascript build system
+- [pkgroll](https://github.com/privatenumber/pkgroll) - 📦 Zero-config package bundler for Node.js + TypeScript
+- [siroc](https://github.com/danielroe/siroc) - Zero-config build tooling for Node
+- [tsup](https://github.com/egoist/tsup) - The simplest and fastest way to bundle your TypeScript libraries
+- [microbundle](https://github.com/developit/microbundle) - Zero-configuration bundler for tiny JS libs, powered by Rollup.
 
 ## Supported Node.js Versions
 
@@ -903,8 +1043,8 @@ If you would like to help take a look at the [list of issues](https://github.com
 
 ## Credits
 
--   [Daniel Bannert](https://github.com/prisis)
--   [All Contributors](https://github.com/visulima/visulima/graphs/contributors)
+- [Daniel Bannert](https://github.com/prisis)
+- [All Contributors](https://github.com/visulima/visulima/graphs/contributors)
 
 ## License
 

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

@@ -1,3 +1,27 @@
-import type { BuildContext } from "../../types.d.mts";
-declare const builder: (context: BuildContext, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
-export default builder;
+import { c as BuildContext, I as InternalBuildOptions } from '../../packem_shared/types-Bgf1bUQM.mjs';
+import '../../packem_shared/index-Sedl0fV9.mjs';
+import '@rollup/pluginutils';
+import 'rollup';
+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-plugin-dts';
+import 'rollup-plugin-polyfill-node';
+import 'rollup-plugin-pure';
+import 'rollup-plugin-visualizer';
+import 'esbuild';
+import 'oxc-resolver';
+import 'oxc-transform';
+import 'sucrase';
+import '@visulima/package';
+import '@visulima/colorize';
+import '@visulima/rollup-css-plugin';
+import 'jiti';
+import 'typedoc';
+
+declare const builder: (context: BuildContext<InternalBuildOptions>, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
+
+export { builder as default };

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

@@ -1,5 +1,27 @@
-import type { BuildContext } from "../../types.d.ts";
-declare const builder: (context: BuildContext, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
+import { c as BuildContext, I as InternalBuildOptions } from '../../packem_shared/types-C-wHDExv.js';
+import '../../packem_shared/index-Sedl0fV9.js';
+import '@rollup/pluginutils';
+import 'rollup';
+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-plugin-dts';
+import 'rollup-plugin-polyfill-node';
+import 'rollup-plugin-pure';
+import 'rollup-plugin-visualizer';
+import 'esbuild';
+import 'oxc-resolver';
+import 'oxc-transform';
+import 'sucrase';
+import '@visulima/package';
+import '@visulima/colorize';
+import '@visulima/rollup-css-plugin';
+import 'jiti';
+import 'typedoc';
 
+declare const builder: (context: BuildContext<InternalBuildOptions>, cachePath: string | undefined, _: never, logged: boolean) => Promise<void>;
 
-export = builder;
+export = builder;

package/dist/builder/typedoc/index.mjs

@@ -1,5 +1,3 @@
-var k=Object.defineProperty;var m=(e,o)=>k(e,"name",{value:o,configurable:!0});import{cyan as w}from"@visulima/colorize";import{join as g}from"@visulima/path";import{g as E,d as q}from"../../packem_shared/create-or-update-key-storage-BxGi6kMH.mjs";import{readdirSync as A}from"node:fs";import{readFileSync as y,writeFileSync as P}from"@visulima/fs";import{Application as $}from"typedoc";import __cjs_mod__ from "node:module"; // -- packem CommonJS require shim --
-const require = __cjs_mod__.createRequire(import.meta.url);
-var b=Object.defineProperty,_=m((e,o)=>b(e,"name",{value:o,configurable:!0}),"m");const C=_(async(e,o,n,l)=>{if(o.length===0)return;const{format:i,marker:r,output:F,plugin:v,readmePath:a,...f}=e;if(i==="inline"&&a===void 0)throw new Error("The `readmePath` option is required when using the `inline` format.");const h=o.map(d=>d.input),s=await $.bootstrapWithPlugins({...f,compilerOptions:{allowJs:!0,declaration:!1,declarationMap:!1,esModuleInterop:!0,module:99,moduleResolution:100,noEmit:!0,noImplicitAny:!1,skipLibCheck:!0,sourceMap:!1,target:99,...f.compilerOptions},entryPoints:h,hideGenerator:!0,plugin:[...v??[],require.resolve("@ckeditor/typedoc-plugins/lib/module-fixer"),require.resolve("@ckeditor/typedoc-plugins/lib/symbol-fixer"),require.resolve("@ckeditor/typedoc-plugins/lib/interface-augmentation-fixer"),require.resolve("@ckeditor/typedoc-plugins/lib/event-inheritance-fixer"),require.resolve("@ckeditor/typedoc-plugins/lib/purge-private-api-docs"),require.resolve("@ckeditor/typedoc-plugins/lib/tag-error"),require.resolve("@ckeditor/typedoc-plugins/lib/tag-event"),require.resolve("@ckeditor/typedoc-plugins/lib/tag-observable"),require.resolve("typedoc-plugin-rename-defaults"),...i==="inline"||i==="markdown"?["typedoc-plugin-markdown"]:[]],...i==="inline"?{hideBreadcrumbs:!0,hidePageHeader:!0,navigation:!1,outputFileStrategy:"modules",useCodeBlocks:!0}:{}},[]),c=await s.convert();if(c&&(await(i==="json"?s.generateJson(c,n):s.generateDocs(c,n)),i==="inline")){if(r===void 0)throw new Error("The `marker` option is required when using the `inline` format.");const d=A(n,{withFileTypes:!0}).filter(t=>t.isFile());let u="";for(const t of d)t.name==="README.md"&&o.length>1||(u+=y(g(n,t.name)).replaceAll(`<!-- ${r}`,`<!-- _REPLACE_${r}`).replaceAll("<!-- ${marker}",`<!-- _REPLACE_\\${r}`));if(u!==""){const t=y(a),p=E(t,r,`
-`+u);if(!p){l.error({message:`Could not find the typedoc marker: <!-- ${r} --><!-- /${r} --> in ${a}`,prefix:"typedoc"});return}if(t===p)return;p&&P(a,p.replaceAll(`<!-- _REPLACE_${r}`,`<!-- ${r}`).replaceAll(`<!-- _REPLACE_\\${r}`,"<!-- ${marker}"),{overwrite:!0})}}},"generateReferenceDocumentation");var R=Object.defineProperty,D=m((e,o)=>R(e,"name",{value:o,configurable:!0}),"r");const T=D(async(e,o,n,l)=>{if(e.options.typedoc&&e.options.typedoc.format!==void 0){let i="unknown";e.pkg.dependencies?.typedoc?i=e.pkg.dependencies.typedoc:e.pkg.devDependencies?.typedoc&&(i=e.pkg.devDependencies.typedoc),o&&q("typedoc",o,e.logger,!0),l&&e.logger.raw(`
-`),e.logger.info({message:"Using "+w("typedoc")+" "+i+" to generate reference documentation",prefix:"typedoc"}),await e.hooks.callHook("typedoc:before",e);let r=g(e.options.rootDir,"api-docs");e.options.typedoc.format==="inline"&&o&&(r=g(o,"typedoc")),e.options.typedoc.output&&(r=e.options.typedoc.output),await C(e.options.typedoc,e.options.entries,r,e.logger),await e.hooks.callHook("typedoc:done",e)}},"builder");export{T as default};
+var j=Object.defineProperty;var g=(e,o)=>j(e,"name",{value:o,configurable:!0});import{cyan as v}from"@visulima/colorize";import{join as h}from"@visulima/path";import{p as $,d as P}from"../../packem_shared/create-or-update-key-storage-GwAIWW7R.mjs";import{readdirSync as A}from"node:fs";import{readFileSync as w,writeFileSync as F}from"@visulima/fs";import{Application as b}from"typedoc";var T=Object.defineProperty,_=g((e,o)=>T(e,"name",{value:o,configurable:!0}),"w");const C=_(async(e,o,a,s)=>{if(o.length===0)return;const{format:t,jsonFileName:n,marker:i,output:x,plugin:k,readmePath:p,...y}=e;if(t==="inline"&&p===void 0)throw new Error("The `readmePath` option is required when using the `inline` format.");if(t!=="inline"&&typeof p=="string"&&s.warn({message:"The `readmePath` option is only used when the `inline` format is used.",prefix:"typedoc"}),t==="json"){if(n===void 0)throw new Error("The `jsonFileName` option is required when using the `json` format.");if(!n.endsWith(".json"))throw new Error("The `jsonFileName` option must end with `.json`.")}t!=="json"&&typeof n=="string"&&s.warn({message:"The `jsonFileName` option is only used when the `json` format is used.",prefix:"typedoc"});const E=o.map(m=>m.input),u=k??[];u.push("typedoc-plugin-rename-defaults"),(t==="inline"||t==="markdown")&&u.push("typedoc-plugin-markdown");const l=await b.bootstrapWithPlugins({...y,compilerOptions:{allowJs:!0,declaration:!1,declarationMap:!1,esModuleInterop:!0,module:99,moduleResolution:100,noEmit:!0,noImplicitAny:!1,skipLibCheck:!0,sourceMap:!1,target:99,...y.compilerOptions},entryPoints:E,hideGenerator:!0,out:a,plugin:u,...t==="inline"?{hideBreadcrumbs:!0,hidePageHeader:!0,navigation:!1,outputFileStrategy:"modules",useCodeBlocks:!0}:{}},[]),d=await l.convert();if(d){if(t==="json")await l.generateJson(d,n);else if(t==="html")await l.generateDocs(d,a);else if(await l.generateOutputs(d),t==="inline"){if(i===void 0)throw new Error("The `marker` option is required when using the `inline` format.");const m=A(a,{withFileTypes:!0}).filter(r=>r.isFile());let f="";for(const r of m)r.name==="README.md"&&o.length>1||(f+=w(h(a,r.name)).replaceAll(`<!-- ${i}`,`<!-- _REPLACE_${i}`).replaceAll("<!-- ${marker}",`<!-- _REPLACE_\\${i}`));if(f!==""){const r=w(p),c=$(r,i,`
+${f}`);if(!c){s.error({message:`Could not find the typedoc marker: <!-- ${i} --><!-- /${i} --> in ${p}`,prefix:"typedoc"});return}if(r===c)return;c&&F(p,c.replaceAll(`<!-- _REPLACE_${i}`,`<!-- ${i}`).replaceAll(`<!-- _REPLACE_\\${i}`,"<!-- ${marker}"),{overwrite:!0})}}}},"generateReferenceDocumentation");var R=Object.defineProperty,D=g((e,o)=>R(e,"name",{value:o,configurable:!0}),"r");const B=D(async(e,o,a,s)=>{if(e.options.typedoc&&e.options.typedoc.format!==void 0){let t="unknown";e.pkg.dependencies?.typedoc?t=e.pkg.dependencies.typedoc:e.pkg.devDependencies?.typedoc&&(t=e.pkg.devDependencies.typedoc),o&&P("typedoc",o,e.logger,!0),s&&e.logger.raw(`
+`),e.logger.info({message:`Using ${v("typedoc")} ${t} to generate reference documentation`,prefix:"typedoc"}),await e.hooks.callHook("typedoc:before",e);let n=e.options.rootDir;e.options.typedoc.output?n=e.options.typedoc.output:e.options.typedoc.format==="inline"&&o?n=h(o,"typedoc"):e.options.typedoc.format!=="json"&&(n=h(n,"api-docs")),await C(e.options.typedoc,e.options.entries,n,e.logger),await e.hooks.callHook("typedoc:done",e)}},"builder");export{B as default};