auklet 0.0.16 → 0.0.18

package/README.md

@@ -15,7 +15,7 @@ Build utilities for TypeScript packages and module CSS output.
 - Generate package-level and module-level CSS entries.
 - Infer component style dependencies from source imports.
 - Generate theme and external style entry files.
-- Provide a Vite dev plugin for virtual package CSS entries.
+- Provide a Vite dev plugin for virtual package CSS entries in single-package and monorepo projects.
 - Watch source/config changes and rebuild module CSS output.
 
 ## Requirements
@@ -215,6 +215,25 @@ export default {
 };
 ```
 
+The plugin defaults to `mode: 'package'`, where Vite root is treated as the
+current package root. This is the expected setup for a single-package component
+library.
+
+For a workspace demo or app that imports CSS from packages under
+`packages/*`, enable monorepo mode:
+
+```ts
+import { aukletStylePlugin } from 'auklet';
+
+export default {
+  plugins: [aukletStylePlugin({ mode: 'monorepo' })],
+};
+```
+
+`mode: 'monorepo'` automatically walks upward from Vite root to find
+`pnpm-workspace.yaml`. A custom graph root can be passed with `root` when the
+workspace root cannot be inferred.
+
 The plugin resolves package CSS ids such as:
 
 ```ts
@@ -229,6 +248,23 @@ resolved from the package that declares the dependency and emitted as Vite
 `/@fs/...` imports, so packages such as `katex/dist/katex.min.css` do not need
 to be installed by the consuming app.
 
+## Examples
+
+The repository includes runnable examples for the supported project shapes:
+
+- `examples/components`: monorepo component packages.
+- `examples/libs`: monorepo TypeScript libraries without CSS output.
+- `examples/single-package`: single-package component library with Vite dev mode.
+- `examples/single-lib`: single-package TypeScript library without CSS output.
+
+Useful commands:
+
+```bash
+pnpm run build:examples
+pnpm run test:examples
+pnpm run dev:examples
+```
+
 ## Programmatic API
 
 ```ts

package/dist/build/bundleConfig.d.ts

@@ -1,6 +1,3 @@
 import type { UserConfig } from 'tsdown/config';
 import type { BuildContext, TsdownFormat } from '#auklet/build/tsdown/types';
-export declare function createBundleConfigs(
-  context: BuildContext,
-  formats: Array<TsdownFormat>,
-): UserConfig[];
+export declare function createBundleConfigs(context: BuildContext, formats: Array<TsdownFormat>): UserConfig[];

package/dist/build/bundleConfig.js

@@ -1,80 +1,68 @@
 import { getBundleEntry } from '#auklet/build/tsdown/entries';
-import {
-  getIifeAlwaysBundle,
-  getIifeGlobals,
-} from '#auklet/build/tsdown/dependencies';
-import {
-  configureTsdown,
-  createCommonConfig,
-} from '#auklet/build/tsdown/common';
+import { getIifeAlwaysBundle, getIifeGlobals, } from '#auklet/build/tsdown/dependencies';
+import { configureTsdown, createCommonConfig, } from '#auklet/build/tsdown/common';
 const formatMap = {
-  cjs: '.cjs',
-  iife: '.global.js',
-  esm: ['.js', '.mjs'],
+    cjs: '.cjs',
+    iife: '.global.js',
+    esm: ['.js', '.mjs'],
 };
 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 mainFields = context.mainFields ??
+        (format === 'iife' ? ['browser', 'module', 'main'] : undefined);
+    return (options) => {
+        if (!mainFields)
+            return options;
+        return {
+            ...options,
+            resolve: {
+                ...options.resolve,
+                mainFields,
+            },
+        };
     };
-  };
 };
 export function createBundleConfigs(context, formats) {
-  const outputConfigs = [];
-  let hasDtsConfig = false;
-  for (const format of formats) {
-    const extnames = formatMap[format];
-    for (const extname of Array.isArray(extnames) ? extnames : [extnames]) {
-      const emitDts = !hasDtsConfig;
-      outputConfigs.push({ format, extname, dts: emitDts });
-      hasDtsConfig ||= emitDts;
+    const outputConfigs = [];
+    let hasDtsConfig = false;
+    for (const format of formats) {
+        const extnames = formatMap[format];
+        for (const extname of Array.isArray(extnames) ? extnames : [extnames]) {
+            const emitDts = !hasDtsConfig;
+            outputConfigs.push({ format, extname, dts: emitDts });
+            hasDtsConfig ||= emitDts;
+        }
     }
-  }
-  return outputConfigs.map(({ format, extname, dts }) => {
-    const deps =
-      format === 'iife'
-        ? {
-            neverBundle: context.peerExternal,
-            alwaysBundle: getIifeAlwaysBundle(context),
-            onlyBundle: false,
-          }
-        : {
-            neverBundle: context.packageExternal,
-          };
-    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 },
-    );
-  });
+    return outputConfigs.map(({ format, extname, dts }) => {
+        const deps = format === 'iife'
+            ? {
+                neverBundle: context.peerExternal,
+                alwaysBundle: getIifeAlwaysBundle(context),
+                onlyBundle: false,
+            }
+            : {
+                neverBundle: context.packageExternal,
+            };
+        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 });
+    });
 }

package/dist/build/cleanOutput.d.ts

@@ -1,9 +1,3 @@
 import type { AukletConfig, LoadAukletConfigOptions } from '#auklet/types';
-export declare function cleanAukletOutputByConfig(
-  packageRoot: string,
-  config?: AukletConfig,
-): void;
-export declare function cleanAukletOutput(
-  packageRoot: string,
-  options?: LoadAukletConfigOptions,
-): Promise<void>;
+export declare function cleanAukletOutputByConfig(packageRoot: string, config?: AukletConfig): void;
+export declare function cleanAukletOutput(packageRoot: string, options?: LoadAukletConfigOptions): Promise<void>;

package/dist/build/cleanOutput.js

@@ -3,13 +3,13 @@ import path from 'node:path';
 import { normalizeAukletConfig } from '#auklet/config';
 import { loadAukletConfig } from '#auklet/configLoader';
 export function cleanAukletOutputByConfig(packageRoot, config = {}) {
-  const normalizedConfig = normalizeAukletConfig(config);
-  fs.rmSync(path.join(packageRoot, normalizedConfig.output), {
-    recursive: true,
-    force: true,
-  });
+    const normalizedConfig = normalizeAukletConfig(config);
+    fs.rmSync(path.join(packageRoot, normalizedConfig.output), {
+        recursive: true,
+        force: true,
+    });
 }
 export async function cleanAukletOutput(packageRoot, options = {}) {
-  const rawConfig = await loadAukletConfig(packageRoot, options);
-  cleanAukletOutputByConfig(packageRoot, rawConfig);
+    const rawConfig = await loadAukletConfig(packageRoot, options);
+    cleanAukletOutputByConfig(packageRoot, rawConfig);
 }

package/dist/build/moduleConfig.d.ts

@@ -1,5 +1,3 @@
 import type { UserConfig } from 'tsdown/config';
 import type { BuildContext } from '#auklet/build/tsdown/types';
-export declare function createModuleConfigs(
-  context: BuildContext,
-): UserConfig[];
+export declare function createModuleConfigs(context: BuildContext): UserConfig[];

package/dist/build/moduleConfig.js

@@ -1,46 +1,27 @@
 import path from 'node:path';
-import {
-  configureTsdown,
-  createCommonConfig,
-} from '#auklet/build/tsdown/common';
+import { configureTsdown, createCommonConfig, } from '#auklet/build/tsdown/common';
 import { getModuleEntries } from '#auklet/build/tsdown/entries';
 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 },
-  );
+    return configureTsdown(context, {
+        ...commonConfig,
+        entry,
+        format,
+        outDir,
+        dts: true,
+        unbundle: true,
+        outExtensions: () => ({
+            js: '.js',
+            dts: '.d.ts',
+        }),
+    }, { kind: 'module', format });
 };
 export function createModuleConfigs(context) {
-  const commonConfig = createCommonConfig(context, {
-    neverBundle: context.packageExternal,
-  });
-  const entry = getModuleEntries(context.packageRoot);
-  return [
-    createModuleConfig(
-      context,
-      commonConfig,
-      entry,
-      'esm',
-      path.join(context.output, 'es'),
-    ),
-    createModuleConfig(
-      context,
-      commonConfig,
-      entry,
-      'cjs',
-      path.join(context.output, 'lib'),
-    ),
-  ];
+    const commonConfig = createCommonConfig(context, {
+        neverBundle: context.packageExternal,
+    });
+    const entry = getModuleEntries(context.packageRoot);
+    return [
+        createModuleConfig(context, commonConfig, entry, 'esm', path.join(context.output, 'es')),
+        createModuleConfig(context, commonConfig, entry, 'cjs', path.join(context.output, 'lib')),
+    ];
 }

package/dist/build/runTsdown.d.ts

@@ -1,8 +1,5 @@
 export type RunTsdownOptions = {
-  cwd?: string;
+    cwd?: string;
 };
 export declare function createTsdownArgs(args: Array<string>): string[];
-export declare function runTsdown(
-  args: Array<string>,
-  options?: RunTsdownOptions,
-): Promise<number>;
+export declare function runTsdown(args: Array<string>, options?: RunTsdownOptions): Promise<number>;

package/dist/build/runTsdown.js

@@ -4,32 +4,27 @@ import { execa } from 'execa';
 const require = createRequire(import.meta.url);
 const tsdownRunFile = require.resolve('tsdown/run');
 const currentExtension = import.meta.url.endsWith('.ts') ? 'ts' : 'js';
-const defaultConfigFile = fileURLToPath(
-  new URL(`./tsdownConfig.${currentExtension}`, import.meta.url),
-);
+const defaultConfigFile = fileURLToPath(new URL(`./tsdownConfig.${currentExtension}`, import.meta.url));
 const hasConfigArg = (args) => {
-  return args.some(
-    (arg, index) =>
-      arg === '--no-config' ||
-      arg === '-c' ||
-      arg === '--config' ||
-      arg.startsWith('--config=') ||
-      args[index - 1] === '-c' ||
-      args[index - 1] === '--config',
-  );
+    return args.some((arg, index) => arg === '--no-config' ||
+        arg === '-c' ||
+        arg === '--config' ||
+        arg.startsWith('--config=') ||
+        args[index - 1] === '-c' ||
+        args[index - 1] === '--config');
 };
 export function createTsdownArgs(args) {
-  const tsdownArgs = hasConfigArg(args)
-    ? args
-    : ['--config', defaultConfigFile, ...args];
-  return [tsdownRunFile, ...tsdownArgs];
+    const tsdownArgs = hasConfigArg(args)
+        ? args
+        : ['--config', defaultConfigFile, ...args];
+    return [tsdownRunFile, ...tsdownArgs];
 }
 export async function runTsdown(args, options = {}) {
-  const tsdownArgs = createTsdownArgs(args);
-  const result = await execa(process.execPath, tsdownArgs, {
-    cwd: options.cwd ?? process.cwd(),
-    stdio: 'inherit',
-    reject: false,
-  });
-  return result.exitCode ?? 0;
+    const tsdownArgs = createTsdownArgs(args);
+    const result = await execa(process.execPath, tsdownArgs, {
+        cwd: options.cwd ?? process.cwd(),
+        stdio: 'inherit',
+        reject: false,
+    });
+    return result.exitCode ?? 0;
 }

package/dist/build/tsdown/common.d.ts

@@ -1,30 +1,19 @@
 import type { UserConfig } from 'tsdown/config';
-import type {
-  BuildContext,
-  ConfigureTsdownOptions,
-  TsdownDeps,
-} from '#auklet/build/tsdown/types';
-export declare function createCommonConfig(
-  context: BuildContext,
-  deps: TsdownDeps,
-): {
-  cwd: string;
-  root: string;
-  clean: false;
-  sourcemap: false;
-  tsconfig: string;
-  target: NonNullable<import('../../types').PackageBuildTarget | undefined>;
-  platform: NonNullable<import('../../types').PackageBuildPlatform | undefined>;
-  alias: Record<string, string>;
-  deps: import('node_modules/tsdown/dist/types-CQaSBA5U.mjs').L;
-  define: {
-    __TEST__: string;
-    __VERSION__: string;
-    __DEV__: string;
-  };
+import type { BuildContext, ConfigureTsdownOptions, TsdownDeps } from '#auklet/build/tsdown/types';
+export declare function createCommonConfig(context: BuildContext, deps: TsdownDeps): {
+    cwd: string;
+    root: string;
+    clean: false;
+    sourcemap: false;
+    tsconfig: string;
+    target: NonNullable<import("../../types").PackageBuildTarget | undefined>;
+    platform: NonNullable<import("../../types").PackageBuildPlatform | undefined>;
+    alias: Record<string, string>;
+    deps: import("node_modules/tsdown/dist/types-CQaSBA5U.mjs").L;
+    define: {
+        __TEST__: string;
+        __VERSION__: string;
+        __DEV__: string;
+    };
 };
-export declare function configureTsdown(
-  context: BuildContext,
-  config: UserConfig,
-  options: ConfigureTsdownOptions,
-): UserConfig;
+export declare function configureTsdown(context: BuildContext, config: UserConfig, options: ConfigureTsdownOptions): UserConfig;

package/dist/build/tsdown/common.js

@@ -1,29 +1,26 @@
 export function createCommonConfig(context, deps) {
-  return {
-    cwd: context.packageRoot,
-    root: context.packageRoot,
-    clean: false,
-    sourcemap: false,
-    tsconfig: context.tsconfig,
-    target: context.target,
-    platform: context.platform,
-    alias: context.alias,
-    deps,
-    define: {
-      __TEST__: 'false',
-      __VERSION__: JSON.stringify(context.pkg.version),
-      __DEV__:
-        '(typeof process !== "undefined" ? (process.env?.NODE_ENV !== "production") : false)',
-    },
-  };
+    return {
+        cwd: context.packageRoot,
+        root: context.packageRoot,
+        clean: false,
+        sourcemap: false,
+        tsconfig: context.tsconfig,
+        target: context.target,
+        platform: context.platform,
+        alias: context.alias,
+        deps,
+        define: {
+            __TEST__: 'false',
+            __VERSION__: JSON.stringify(context.pkg.version),
+            __DEV__: '(typeof process !== "undefined" ? (process.env?.NODE_ENV !== "production") : false)',
+        },
+    };
 }
 export function configureTsdown(context, config, options) {
-  return (
-    context.configureTsdown?.(config, {
-      ...options,
-      packageRoot: context.packageRoot,
-      output: context.output,
-      packageName: context.pkg.name,
-    }) ?? config
-  );
+    return (context.configureTsdown?.(config, {
+        ...options,
+        packageRoot: context.packageRoot,
+        output: context.output,
+        packageName: context.pkg.name,
+    }) ?? config);
 }

package/dist/build/tsdown/context.d.ts

@@ -1,23 +1,19 @@
 import type { PackageBuildOptions } from '#auklet/types';
 import type { PackageJsonLike } from '#auklet/build/tsdown/types';
-export declare function createBuildContext(
-  packageRoot: string,
-  options: PackageBuildOptions,
-  output: string,
-): {
-  pkg: PackageJsonLike;
-  banner: string;
-  packageRoot: string;
-  output: string;
-  runtimeDependencyNames: string[];
-  packageExternal: string[];
-  peerExternal: string[];
-  alias: Record<string, string>;
-  mainFields: string[] | undefined;
-  globals: Record<string, string>;
-  globalName: string;
-  platform: import('#auklet/types').PackageBuildPlatform;
-  target: import('#auklet/types').PackageBuildTarget;
-  configureTsdown: import('#auklet/types').ConfigureTsdown | undefined;
-  tsconfig: string;
+export declare function createBuildContext(packageRoot: string, options: PackageBuildOptions, output: string): {
+    pkg: PackageJsonLike;
+    banner: string;
+    packageRoot: string;
+    output: string;
+    runtimeDependencyNames: string[];
+    packageExternal: string[];
+    peerExternal: string[];
+    alias: Record<string, string>;
+    mainFields: string[] | undefined;
+    globals: Record<string, string>;
+    globalName: string;
+    platform: import("#auklet/types").PackageBuildPlatform;
+    target: import("#auklet/types").PackageBuildTarget;
+    configureTsdown: import("#auklet/types").ConfigureTsdown | undefined;
+    tsconfig: string;
 };

package/dist/build/tsdown/context.js

@@ -1,53 +1,49 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import {
-  getPeerExternal,
-  getPackageExternal,
-} from '#auklet/build/tsdown/dependencies';
+import { getPeerExternal, getPackageExternal, } from '#auklet/build/tsdown/dependencies';
 const getGlobalName = (pkg) => {
-  return (pkg?.name ?? '')
-    .replace(/@/g, '')
-    .split(/[/-]/g)
-    .map((label) => label[0].toUpperCase() + label.slice(1))
-    .join('');
+    return (pkg?.name ?? '')
+        .replace(/@/g, '')
+        .split(/[/-]/g)
+        .map((label) => label[0].toUpperCase() + label.slice(1))
+        .join('');
 };
 const findWorkspaceTsconfig = (packageRoot) => {
-  let current = packageRoot;
-  while (true) {
-    const tsconfig = path.join(current, 'tsconfig.json');
-    if (fs.existsSync(tsconfig)) return tsconfig;
-    const parent = path.dirname(current);
-    if (parent === current) return path.join(packageRoot, 'tsconfig.json');
-    current = parent;
-  }
+    let current = packageRoot;
+    while (true) {
+        const tsconfig = path.join(current, 'tsconfig.json');
+        if (fs.existsSync(tsconfig))
+            return tsconfig;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return path.join(packageRoot, 'tsconfig.json');
+        current = parent;
+    }
 };
 export function createBuildContext(packageRoot, options, output) {
-  const pkg = JSON.parse(
-    fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'),
-  );
-  const banner =
-    options.banner ??
-    '/*!\n' +
-      ` * ${pkg.name}.js v${pkg.version}\n` +
-      (pkg.author ? ` * (c) ${new Date().getFullYear()} ${pkg.author}\n` : '') +
-      ' */';
-  return {
-    pkg,
-    banner,
-    packageRoot,
-    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),
-  };
+    const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+    const banner = options.banner ??
+        '/*!\n' +
+            ` * ${pkg.name}.js v${pkg.version}\n` +
+            (pkg.author ? ` * (c) ${new Date().getFullYear()} ${pkg.author}\n` : '') +
+            ' */';
+    return {
+        pkg,
+        banner,
+        packageRoot,
+        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),
+    };
 }

package/dist/build/tsdown/define.d.ts

@@ -1,9 +1,4 @@
 import type { AukletConfig } from '#auklet/types';
 export type { TsdownFormat } from '#auklet/build/tsdown/types';
-export declare function defineKernelPackageConfigFromOptions(
-  packageRoot?: string,
-  config?: AukletConfig,
-): import('tsdown/config').UserConfig[];
-export declare function defineKernelPackageConfigFromFile(
-  packageRoot?: string,
-): Promise<import('tsdown/config').UserConfig[]>;
+export declare function defineKernelPackageConfigFromOptions(packageRoot?: string, config?: AukletConfig): import("tsdown/config").UserConfig[];
+export declare function defineKernelPackageConfigFromFile(packageRoot?: string): Promise<import("tsdown/config").UserConfig[]>;