@powerlines/plugin-typedoc 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,10 @@
1
1
  export { GenerateDocsOptions, TypeDocPluginContext, TypeDocPluginOptions, TypeDocPluginResolvedConfig, TypeDocPluginUserConfig, __ΩGenerateDocsOptions, __ΩTypeDocPluginContext, __ΩTypeDocPluginOptions, __ΩTypeDocPluginResolvedConfig, __ΩTypeDocPluginUserConfig } from './plugin.cjs';
2
- import '@babel/core';
3
2
  import '@storm-software/build-tools/types';
4
3
  import '@storm-software/config-tools/types';
5
4
  import '@storm-software/config/types';
6
5
  import '@stryke/types/configuration';
7
6
  import '@stryke/types/file';
8
7
  import 'vite';
9
- import '@babel/helper-plugin-utils';
10
8
  import '@stryke/env/get-env-paths';
11
9
  import '@stryke/types/package-json';
12
10
  import 'jiti';
@@ -1,12 +1,10 @@
1
1
  export { GenerateDocsOptions, TypeDocPluginContext, TypeDocPluginOptions, TypeDocPluginResolvedConfig, TypeDocPluginUserConfig, __ΩGenerateDocsOptions, __ΩTypeDocPluginContext, __ΩTypeDocPluginOptions, __ΩTypeDocPluginResolvedConfig, __ΩTypeDocPluginUserConfig } from './plugin.js';
2
- import '@babel/core';
3
2
  import '@storm-software/build-tools/types';
4
3
  import '@storm-software/config-tools/types';
5
4
  import '@storm-software/config/types';
6
5
  import '@stryke/types/configuration';
7
6
  import '@stryke/types/file';
8
7
  import 'vite';
9
- import '@babel/helper-plugin-utils';
10
8
  import '@stryke/env/get-env-paths';
11
9
  import '@stryke/types/package-json';
12
10
  import 'jiti';
@@ -1,11 +1,9 @@
1
- import { PluginItem, PluginObj, PluginPass, transformAsync } from '@babel/core';
2
1
  import { Format } from '@storm-software/build-tools/types';
3
2
  import { LogLevelLabel } from '@storm-software/config-tools/types';
4
3
  import { StormWorkspaceConfig } from '@storm-software/config/types';
5
4
  import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
6
5
  import { AssetGlob } from '@stryke/types/file';
7
6
  import { ResolvedPreviewOptions, PreviewOptions } from 'vite';
8
- import { BabelAPI } from '@babel/helper-plugin-utils';
9
7
  import { EnvPaths } from '@stryke/env/get-env-paths';
10
8
  import { PackageJson } from '@stryke/types/package-json';
11
9
  import { Jiti } from 'jiti';
@@ -1655,7 +1653,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
1655
1653
  /**
1656
1654
  * The resolved options for the Powerlines project configuration.
1657
1655
  */
1658
- type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "build" | "transform" | "override">> & {
1656
+ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "build" | "transform" | "override" | "framework">> & {
1659
1657
  /**
1660
1658
  * The configuration options that were provided inline to the Powerlines CLI.
1661
1659
  */
@@ -2512,24 +2510,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
2512
2510
  }
2513
2511
  type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & UnpluginBuildContext;
2514
2512
 
2515
- type BabelPluginPass<TState = unknown> = PluginPass & TState;
2516
- type BabelTransformPluginFilter = (code: string, id: string) => boolean;
2517
- type BabelTransformPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = ((context: TContext) => (options: {
2518
- name: string;
2519
- log: LogFn;
2520
- api: BabelAPI;
2521
- options: TOptions;
2522
- context: TContext;
2523
- dirname: string;
2524
- }) => PluginObj<TOptions & BabelPluginPass<TState>>) & {
2525
- $$name: string;
2526
- };
2527
- type BabelTransformPluginOptions<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = PluginItem | BabelTransformPlugin<TContext, TOptions, TState> | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions] | [
2528
- BabelTransformPlugin<TContext, TOptions, TState>,
2529
- TOptions,
2530
- BabelTransformPluginFilter
2531
- ];
2532
-
2533
2513
  type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
2534
2514
  /**
2535
2515
  * The {@link StormWorkspaceConfig | configuration} object for an entire Powerlines workspace
@@ -2555,16 +2535,6 @@ type PluginConfigObject<TProps = unknown, TContext extends PluginContext = Plugi
2555
2535
  */
2556
2536
  type PluginConfig<TContext extends PluginContext = PluginContext, TProps = unknown> = string | PluginFactory<void, TContext> | Plugin<TContext> | PluginConfigTuple<TProps> | PluginConfigObject<TProps>;
2557
2537
  type ProjectType = "application" | "library";
2558
- type BabelUserConfig = Parameters<typeof transformAsync>[1] & {
2559
- /**
2560
- * The Babel plugins to be used during the build process
2561
- */
2562
- plugins?: BabelTransformPluginOptions[];
2563
- /**
2564
- * The Babel presets to be used during the build process
2565
- */
2566
- presets?: BabelTransformPluginOptions[];
2567
- };
2568
2538
  interface ESLintConfig {
2569
2539
  eslintOptions?: any;
2570
2540
  reportErrorsOnly?: boolean;
@@ -2638,19 +2608,6 @@ interface OutputConfig {
2638
2608
  */
2639
2609
  assets?: Array<string | AssetGlob>;
2640
2610
  }
2641
- interface TransformConfig {
2642
- /**
2643
- * The Babel configuration options to use for the build process
2644
- */
2645
- babel?: BabelUserConfig;
2646
- /**
2647
- * Reflection configuration options for the Deepkit TSC custom transformers
2648
- *
2649
- * @remarks
2650
- * These options will be merged with the `tsconfig.json` file and the `tsconfigRaw` options.
2651
- */
2652
- deepkit?: DeepkitOptions;
2653
- }
2654
2611
  interface BaseConfig {
2655
2612
  /**
2656
2613
  * The name of the project
@@ -2701,7 +2658,7 @@ interface BaseConfig {
2701
2658
  /**
2702
2659
  * Configuration for the transformation of the source code
2703
2660
  */
2704
- transform?: TransformConfig;
2661
+ transform?: Record<string, any>;
2705
2662
  /**
2706
2663
  * Options to to provide to the build process
2707
2664
  */
@@ -2826,6 +2783,12 @@ interface CommonUserConfig extends BaseConfig {
2826
2783
  * Environment-specific configurations
2827
2784
  */
2828
2785
  environments?: Record<string, EnvironmentConfig>;
2786
+ /**
2787
+ * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
2788
+ *
2789
+ * @defaultValue "powerlines"
2790
+ */
2791
+ framework?: string;
2829
2792
  }
2830
2793
  type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
2831
2794
  build?: TBuildConfig & {
@@ -1,11 +1,9 @@
1
- import { PluginItem, PluginObj, PluginPass, transformAsync } from '@babel/core';
2
1
  import { Format } from '@storm-software/build-tools/types';
3
2
  import { LogLevelLabel } from '@storm-software/config-tools/types';
4
3
  import { StormWorkspaceConfig } from '@storm-software/config/types';
5
4
  import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
6
5
  import { AssetGlob } from '@stryke/types/file';
7
6
  import { ResolvedPreviewOptions, PreviewOptions } from 'vite';
8
- import { BabelAPI } from '@babel/helper-plugin-utils';
9
7
  import { EnvPaths } from '@stryke/env/get-env-paths';
10
8
  import { PackageJson } from '@stryke/types/package-json';
11
9
  import { Jiti } from 'jiti';
@@ -1655,7 +1653,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
1655
1653
  /**
1656
1654
  * The resolved options for the Powerlines project configuration.
1657
1655
  */
1658
- type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "build" | "transform" | "override">> & {
1656
+ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "build" | "transform" | "override" | "framework">> & {
1659
1657
  /**
1660
1658
  * The configuration options that were provided inline to the Powerlines CLI.
1661
1659
  */
@@ -2512,24 +2510,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
2512
2510
  }
2513
2511
  type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & UnpluginBuildContext;
2514
2512
 
2515
- type BabelPluginPass<TState = unknown> = PluginPass & TState;
2516
- type BabelTransformPluginFilter = (code: string, id: string) => boolean;
2517
- type BabelTransformPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = ((context: TContext) => (options: {
2518
- name: string;
2519
- log: LogFn;
2520
- api: BabelAPI;
2521
- options: TOptions;
2522
- context: TContext;
2523
- dirname: string;
2524
- }) => PluginObj<TOptions & BabelPluginPass<TState>>) & {
2525
- $$name: string;
2526
- };
2527
- type BabelTransformPluginOptions<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>, TState = unknown> = PluginItem | BabelTransformPlugin<TContext, TOptions, TState> | [BabelTransformPlugin<TContext, TOptions, TState>, TOptions] | [
2528
- BabelTransformPlugin<TContext, TOptions, TState>,
2529
- TOptions,
2530
- BabelTransformPluginFilter
2531
- ];
2532
-
2533
2513
  type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
2534
2514
  /**
2535
2515
  * The {@link StormWorkspaceConfig | configuration} object for an entire Powerlines workspace
@@ -2555,16 +2535,6 @@ type PluginConfigObject<TProps = unknown, TContext extends PluginContext = Plugi
2555
2535
  */
2556
2536
  type PluginConfig<TContext extends PluginContext = PluginContext, TProps = unknown> = string | PluginFactory<void, TContext> | Plugin<TContext> | PluginConfigTuple<TProps> | PluginConfigObject<TProps>;
2557
2537
  type ProjectType = "application" | "library";
2558
- type BabelUserConfig = Parameters<typeof transformAsync>[1] & {
2559
- /**
2560
- * The Babel plugins to be used during the build process
2561
- */
2562
- plugins?: BabelTransformPluginOptions[];
2563
- /**
2564
- * The Babel presets to be used during the build process
2565
- */
2566
- presets?: BabelTransformPluginOptions[];
2567
- };
2568
2538
  interface ESLintConfig {
2569
2539
  eslintOptions?: any;
2570
2540
  reportErrorsOnly?: boolean;
@@ -2638,19 +2608,6 @@ interface OutputConfig {
2638
2608
  */
2639
2609
  assets?: Array<string | AssetGlob>;
2640
2610
  }
2641
- interface TransformConfig {
2642
- /**
2643
- * The Babel configuration options to use for the build process
2644
- */
2645
- babel?: BabelUserConfig;
2646
- /**
2647
- * Reflection configuration options for the Deepkit TSC custom transformers
2648
- *
2649
- * @remarks
2650
- * These options will be merged with the `tsconfig.json` file and the `tsconfigRaw` options.
2651
- */
2652
- deepkit?: DeepkitOptions;
2653
- }
2654
2611
  interface BaseConfig {
2655
2612
  /**
2656
2613
  * The name of the project
@@ -2701,7 +2658,7 @@ interface BaseConfig {
2701
2658
  /**
2702
2659
  * Configuration for the transformation of the source code
2703
2660
  */
2704
- transform?: TransformConfig;
2661
+ transform?: Record<string, any>;
2705
2662
  /**
2706
2663
  * Options to to provide to the build process
2707
2664
  */
@@ -2826,6 +2783,12 @@ interface CommonUserConfig extends BaseConfig {
2826
2783
  * Environment-specific configurations
2827
2784
  */
2828
2785
  environments?: Record<string, EnvironmentConfig>;
2786
+ /**
2787
+ * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
2788
+ *
2789
+ * @defaultValue "powerlines"
2790
+ */
2791
+ framework?: string;
2829
2792
  }
2830
2793
  type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
2831
2794
  build?: TBuildConfig & {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@powerlines/plugin-typedoc",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "type": "module",
5
5
  "description": "A package containing a Powerlines plugin for running TypeDoc on the codebase.",
6
6
  "repository": {
@@ -89,18 +89,18 @@
89
89
  "keywords": ["powerlines", "storm-software", "powerlines-plugin"],
90
90
  "dependencies": {
91
91
  "@storm-software/config-tools": "^1.188.6",
92
- "@stryke/path": "^0.15.5",
93
92
  "@stryke/fs": "^0.31.4",
94
- "powerlines": "^0.2.0",
93
+ "@stryke/path": "^0.15.5",
94
+ "powerlines": "^0.3.0",
95
95
  "typedoc": "0.25.12",
96
96
  "typedoc-plugin-markdown": "4.0.0-next.20"
97
97
  },
98
98
  "devDependencies": {
99
- "@powerlines/nx": "^0.2.0",
99
+ "@powerlines/nx": "^0.3.0",
100
100
  "@storm-software/tsup": "^0.2.4",
101
101
  "@types/node": "^22.18.11",
102
102
  "tsup": "8.4.0"
103
103
  },
104
104
  "publishConfig": { "access": "public" },
105
- "gitHead": "319be4880b93666a6dafe38d60278a8cad920f0b"
105
+ "gitHead": "fe5e201169810dd966ee328fa3dabf57077eea36"
106
106
  }