auklet 0.0.8 → 0.0.10

package/README.md

@@ -76,6 +76,20 @@ export const config: AukletConfig = {
   build: {
     formats: ['esm', 'cjs'],
     target: 'es2020',
+    alias: {
+      '@shared': './src/shared',
+    },
+    mainFields: ['browser', 'module', 'main'],
+    globals: {
+      react: 'React',
+    },
+    configureTsdown(config, context) {
+      if (context.kind !== 'bundle') return config;
+      return {
+        ...config,
+        sourcemap: true,
+      };
+    },
     tsconfig: 'tsconfig.json',
   },
 };
@@ -135,6 +149,10 @@ export const config: AukletConfig = {
 - `build.platform`: build target runtime platform: `neutral`, `node`, or `browser`. Defaults to `neutral`.
 - `build.banner`: custom bundle banner. Defaults to a package name/version banner.
 - `build.externals`: additional external packages. Defaults to `[]`.
+- `build.alias`: path aliases passed to tsdown `alias`. Defaults to `{}`.
+- `build.mainFields`: bundle package entry resolution order passed to rolldown `resolve.mainFields`. When omitted, auklet only sets `['browser', 'module', 'main']` for IIFE bundles.
+- `build.globals`: IIFE external global names passed to tsdown `output.globals`. Values override auklet's generated global names.
+- `build.configureTsdown`: final customization hook for each generated tsdown config. It receives `(config, context)` and should return a tsdown config.
 - `build.tsconfig`: TypeScript config path relative to the package root. Defaults to the nearest `tsconfig.json` found from the package root upward.
 
 ### Build Constants

package/dist/build/tsdownConfig.d.ts

@@ -1,216 +1,12 @@
+import type { UserConfig } from 'tsdown/config';
 import type { AukletConfig, PackageBuildFormat } from '#auklet/types';
 export type TsdownFormat = PackageBuildFormat;
 export declare function defineKernelPackageConfigFromOptions(
   packageRoot?: string,
   config?: AukletConfig,
-): (
-  | {
-      entry: {
-        index: string;
-      };
-      format: PackageBuildFormat;
-      globalName: string;
-      outDir: string;
-      dts: boolean;
-      treeshake: true;
-      banner: string;
-      outExtensions: () => {
-        js: string;
-      };
-      outputOptions: {
-        entryFileNames: string;
-        chunkFileNames: string;
-        globals: {
-          [k: string]: string;
-        };
-      };
-      cwd: string;
-      root: string;
-      clean: false;
-      sourcemap: false;
-      tsconfig: string;
-      target: NonNullable<
-        import('#auklet/types').PackageBuildTarget | undefined
-      >;
-      platform: NonNullable<
-        import('#auklet/types').PackageBuildPlatform | undefined
-      >;
-      deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-      define: {
-        __TEST__: string;
-        __VERSION__: string;
-        __DEV__: string;
-      };
-    }
-  | {
-      entry: Record<string, string>;
-      format: 'cjs' | 'esm';
-      outDir: string;
-      dts: true;
-      unbundle: true;
-      outExtensions: () => {
-        js: string;
-        dts: string;
-      };
-      cwd: string;
-      root: string;
-      clean: false;
-      sourcemap: false;
-      tsconfig: string;
-      target: NonNullable<
-        import('#auklet/types').PackageBuildTarget | undefined
-      >;
-      platform: NonNullable<
-        import('#auklet/types').PackageBuildPlatform | undefined
-      >;
-      deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-      define: {
-        __TEST__: string;
-        __VERSION__: string;
-        __DEV__: string;
-      };
-    }
-)[];
+): UserConfig[];
 export declare function defineKernelPackageConfigFromFile(
   packageRoot?: string,
-): Promise<
-  (
-    | {
-        entry: {
-          index: string;
-        };
-        format: PackageBuildFormat;
-        globalName: string;
-        outDir: string;
-        dts: boolean;
-        treeshake: true;
-        banner: string;
-        outExtensions: () => {
-          js: string;
-        };
-        outputOptions: {
-          entryFileNames: string;
-          chunkFileNames: string;
-          globals: {
-            [k: string]: string;
-          };
-        };
-        cwd: string;
-        root: string;
-        clean: false;
-        sourcemap: false;
-        tsconfig: string;
-        target: NonNullable<
-          import('#auklet/types').PackageBuildTarget | undefined
-        >;
-        platform: NonNullable<
-          import('#auklet/types').PackageBuildPlatform | undefined
-        >;
-        deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-        define: {
-          __TEST__: string;
-          __VERSION__: string;
-          __DEV__: string;
-        };
-      }
-    | {
-        entry: Record<string, string>;
-        format: 'cjs' | 'esm';
-        outDir: string;
-        dts: true;
-        unbundle: true;
-        outExtensions: () => {
-          js: string;
-          dts: string;
-        };
-        cwd: string;
-        root: string;
-        clean: false;
-        sourcemap: false;
-        tsconfig: string;
-        target: NonNullable<
-          import('#auklet/types').PackageBuildTarget | undefined
-        >;
-        platform: NonNullable<
-          import('#auklet/types').PackageBuildPlatform | undefined
-        >;
-        deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-        define: {
-          __TEST__: string;
-          __VERSION__: string;
-          __DEV__: string;
-        };
-      }
-  )[]
->;
-declare const _default: Promise<
-  (
-    | {
-        entry: {
-          index: string;
-        };
-        format: PackageBuildFormat;
-        globalName: string;
-        outDir: string;
-        dts: boolean;
-        treeshake: true;
-        banner: string;
-        outExtensions: () => {
-          js: string;
-        };
-        outputOptions: {
-          entryFileNames: string;
-          chunkFileNames: string;
-          globals: {
-            [k: string]: string;
-          };
-        };
-        cwd: string;
-        root: string;
-        clean: false;
-        sourcemap: false;
-        tsconfig: string;
-        target: NonNullable<
-          import('#auklet/types').PackageBuildTarget | undefined
-        >;
-        platform: NonNullable<
-          import('#auklet/types').PackageBuildPlatform | undefined
-        >;
-        deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-        define: {
-          __TEST__: string;
-          __VERSION__: string;
-          __DEV__: string;
-        };
-      }
-    | {
-        entry: Record<string, string>;
-        format: 'cjs' | 'esm';
-        outDir: string;
-        dts: true;
-        unbundle: true;
-        outExtensions: () => {
-          js: string;
-          dts: string;
-        };
-        cwd: string;
-        root: string;
-        clean: false;
-        sourcemap: false;
-        tsconfig: string;
-        target: NonNullable<
-          import('#auklet/types').PackageBuildTarget | undefined
-        >;
-        platform: NonNullable<
-          import('#auklet/types').PackageBuildPlatform | undefined
-        >;
-        deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-        define: {
-          __TEST__: string;
-          __VERSION__: string;
-          __DEV__: string;
-        };
-      }
-  )[]
->;
+): Promise<UserConfig[]>;
+declare const _default: Promise<UserConfig[]>;
 export default _default;

package/dist/build/tsdownConfig.js

@@ -41,9 +41,12 @@ const getDependencyGlobalName = (name) => {
     .join('');
 };
 const getIifeGlobals = (context) => {
-  return Object.fromEntries(
-    context.peerExternal.map((name) => [name, getDependencyGlobalName(name)]),
-  );
+  return {
+    ...Object.fromEntries(
+      context.peerExternal.map((name) => [name, getDependencyGlobalName(name)]),
+    ),
+    ...context.globals,
+  };
 };
 const getIifeAlwaysBundle = (context) => {
   const names = new Set(context.runtimeDependencyNames);
@@ -136,9 +139,13 @@ const createBuildContext = (packageRoot, options, output) => {
     runtimeDependencyNames: Object.keys(pkg.dependencies ?? {}),
     packageExternal: getPackageExternal(pkg, options),
     peerExternal: getPeerExternal(pkg, options),
+    alias: options.alias ?? {},
+    mainFields: options.mainFields,
+    globals: options.globals ?? {},
     globalName: getGlobalName(pkg),
     platform: options.platform,
     target: options.target,
+    configureTsdown: options.configureTsdown,
     tsconfig: options.tsconfig
       ? path.resolve(packageRoot, options.tsconfig)
       : findWorkspaceTsconfig(packageRoot),
@@ -153,6 +160,7 @@ const createCommonConfig = (context, deps) => {
     tsconfig: context.tsconfig,
     target: context.target,
     platform: context.platform,
+    alias: context.alias,
     deps,
     define: {
       __TEST__: 'false',
@@ -162,6 +170,31 @@ const createCommonConfig = (context, deps) => {
     },
   };
 };
+const createBundleInputOptions = (context, format) => {
+  const mainFields =
+    context.mainFields ??
+    (format === 'iife' ? ['browser', 'module', 'main'] : undefined);
+  return (options) => {
+    if (!mainFields) return options;
+    return {
+      ...options,
+      resolve: {
+        ...options.resolve,
+        mainFields,
+      },
+    };
+  };
+};
+const configureTsdown = (context, config, options) => {
+  return (
+    context.configureTsdown?.(config, {
+      ...options,
+      packageRoot: context.packageRoot,
+      output: context.output,
+      packageName: context.pkg.name,
+    }) ?? config
+  );
+};
 const createBundleConfigs = (context, formats) => {
   const outputConfigs = [];
   let hasDtsConfig = false;
@@ -184,39 +217,52 @@ const createBundleConfigs = (context, formats) => {
         : {
             neverBundle: context.packageExternal,
           };
-    return {
-      ...createCommonConfig(context, deps),
-      entry: getBundleEntry(context.packageRoot),
-      format,
-      globalName: context.globalName,
-      outDir: context.output,
-      dts,
-      treeshake: true,
-      banner: context.banner,
-      outExtensions: () => ({
-        js: extname,
-      }),
-      outputOptions: {
-        entryFileNames: `[name]${extname}`,
-        chunkFileNames: `[name]-[hash]${extname}`,
-        globals: format === 'iife' ? getIifeGlobals(context) : {},
+    const inputOptions =
+      context.mainFields || format === 'iife'
+        ? createBundleInputOptions(context, format)
+        : undefined;
+    return configureTsdown(
+      context,
+      {
+        ...createCommonConfig(context, deps),
+        entry: getBundleEntry(context.packageRoot),
+        format,
+        globalName: context.globalName,
+        outDir: context.output,
+        dts,
+        treeshake: true,
+        banner: context.banner,
+        outExtensions: () => ({
+          js: extname,
+        }),
+        outputOptions: {
+          entryFileNames: `[name]${extname}`,
+          chunkFileNames: `[name]-[hash]${extname}`,
+          globals: format === 'iife' ? getIifeGlobals(context) : {},
+        },
+        inputOptions,
       },
-    };
+      { kind: 'bundle', format },
+    );
   });
 };
-const createModuleConfig = (commonConfig, entry, format, outDir) => {
-  return {
-    ...commonConfig,
-    entry,
-    format,
-    outDir,
-    dts: true,
-    unbundle: true,
-    outExtensions: () => ({
-      js: '.js',
-      dts: '.d.ts',
-    }),
-  };
+const createModuleConfig = (context, commonConfig, entry, format, outDir) => {
+  return configureTsdown(
+    context,
+    {
+      ...commonConfig,
+      entry,
+      format,
+      outDir,
+      dts: true,
+      unbundle: true,
+      outExtensions: () => ({
+        js: '.js',
+        dts: '.d.ts',
+      }),
+    },
+    { kind: 'module', format },
+  );
 };
 const createModuleConfigs = (context) => {
   const commonConfig = createCommonConfig(context, {
@@ -225,12 +271,14 @@ const createModuleConfigs = (context) => {
   const entry = getModuleEntries(context.packageRoot);
   return [
     createModuleConfig(
+      context,
       commonConfig,
       entry,
       'esm',
       path.join(context.output, 'es'),
     ),
     createModuleConfig(
+      context,
       commonConfig,
       entry,
       'cjs',

package/dist/config.d.ts

@@ -25,6 +25,10 @@ export declare function normalizeAukletConfig(config?: AukletConfig): {
     platform: import('#auklet/types').PackageBuildPlatform;
     banner?: string;
     externals?: Array<string>;
+    alias?: Record<string, string>;
+    mainFields?: Array<string>;
+    globals?: Record<string, string>;
+    configureTsdown?: import('#auklet/types').ConfigureTsdown;
     tsconfig?: string;
   };
   styles: {

package/dist/css/vite/moduleGraph/requestCache.d.ts

@@ -48,6 +48,10 @@ export declare class ModuleStyleGraphRequestCache {
             platform: import('#auklet/types').PackageBuildPlatform;
             banner?: string;
             externals?: Array<string>;
+            alias?: Record<string, string>;
+            mainFields?: Array<string>;
+            globals?: Record<string, string>;
+            configureTsdown?: import('#auklet/types').ConfigureTsdown;
             tsconfig?: string;
           };
           styles: {

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export type {
   AukletConfig,
+  ConfigureTsdown,
+  ConfigureTsdownContext,
   LoadAukletConfigOptions,
   ModuleStyleBuildConfig,
   ModuleStyleBuildContext,

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { UserConfig } from 'tsdown/config';
 export type StyleDependencyGroup = {
   entry?: string | Array<string>;
   themes?: Record<string, string>;
@@ -25,12 +26,27 @@ export interface NormalizedAukletConfig {
 export type PackageBuildFormat = 'cjs' | 'esm' | 'iife';
 export type PackageBuildPlatform = 'node' | 'neutral' | 'browser';
 export type PackageBuildTarget = string | Array<string> | false;
+export type ConfigureTsdownContext = {
+  kind: 'bundle' | 'module';
+  format: PackageBuildFormat;
+  packageRoot: string;
+  output: string;
+  packageName?: string;
+};
+export type ConfigureTsdown = (
+  config: UserConfig,
+  context: ConfigureTsdownContext,
+) => UserConfig;
 export type PackageBuildOptions = {
   formats?: Array<PackageBuildFormat>;
   target?: PackageBuildTarget;
   platform?: PackageBuildPlatform;
   banner?: string;
   externals?: Array<string>;
+  alias?: Record<string, string>;
+  mainFields?: Array<string>;
+  globals?: Record<string, string>;
+  configureTsdown?: ConfigureTsdown;
   tsconfig?: string;
 };
 export interface AukletConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auklet",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "author": "chentao.arthur",
   "packageManager": "pnpm@10.27.0",