@powerlines/plugin-react 0.1.0

package/dist/components/react-optimized.d.ts

@@ -0,0 +1,96 @@
+import * as _alloy_js_core from '@alloy-js/core';
+import { Children as Children$1, SourceFileProps as SourceFileProps$1 } from '@alloy-js/core';
+import { Children } from '@alloy-js/core/jsx-runtime';
+import { O as OutputModeType } from '../vfs-Bl84Hw2V.js';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+
+/**
+ * A type that represents the props of a component that can have children.
+ */
+interface ComponentProps {
+    children?: Children;
+}
+interface TypescriptFileImportItem {
+    name: string;
+    default?: boolean;
+    alias?: string;
+    type?: boolean;
+}
+type TypescriptFileImports = Record<string, null | Array<TypescriptFileImportItem | string>>;
+
+interface TSDocModuleProps extends ComponentProps {
+    /**
+     * the prefix for the builtin module name
+     *
+     * @defaultValue "storm"
+     */
+    prefix?: string;
+    /**
+     * The name of the module
+     *
+     * @remarks
+     * This will be used in the `@module` tag as well as the import path for the module, e.g. `storm:<name>`.
+     *
+     * @example
+     * ```ts
+     * import { MyModule } from "storm:my-module";
+     * ```
+     */
+    name: Children$1;
+}
+
+type SourceFileProps = SourceFileProps$1 & ComponentProps & {
+    /**
+     * If true, indicates that the file is virtual and should not be written to disk.
+     *
+     * @defaultValue false
+     */
+    mode?: OutputModeType;
+    /**
+     * The metadata associated with the source file.
+     *
+     * @remarks
+     * The values stored in the metadata will be available in the rendering context.
+     */
+    meta?: Record<string, any>;
+};
+
+type TypescriptFileProps = Omit<SourceFileProps, "filetype"> & ComponentProps & {
+    header?: Children$1;
+    imports?: TypescriptFileImports;
+    export?: boolean | string;
+    tsx?: boolean;
+};
+
+type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProps, "name"> & {
+    /**
+     * The runtime module identifier.
+     *
+     * @remarks
+     * This value will be included after the \`storm:\` prefix in the import statement.
+     */
+    id: string;
+    /**
+     * The description for the builtin module.
+     */
+    description?: string;
+    /**
+     * Whether the file is a TSX file.
+     *
+     * @defaultValue false
+     */
+    tsx?: boolean;
+};
+
+interface ReactOptimizedBuiltinProps extends Omit<BuiltinFileProps, "id"> {
+    override?: boolean;
+}
+/**
+ * Generates the `react/optimized` builtin module for the Powerlines project.
+ */
+declare function ReactOptimizedBuiltin(props: ReactOptimizedBuiltinProps): _alloy_js_core.Children;
+
+export { ReactOptimizedBuiltin, type ReactOptimizedBuiltinProps };

package/dist/components/react-optimized.js

@@ -0,0 +1,8 @@
+import {a}from'../chunk-UCUR73HG.js';import {createComponent,mergeProps}from'@alloy-js/core/jsx-runtime';import {splitProps,code}from'@alloy-js/core';import {FunctionDeclaration}from'@alloy-js/typescript';import {usePowerlines}from'@powerlines/alloy/core/contexts/context';import {refkey}from'@powerlines/alloy/helpers/refkey';import {BuiltinFile}from'@powerlines/alloy/typescript/components/builtin-file';import {TSDoc,TSDocLink,TSDocReturns}from'@powerlines/alloy/typescript/components/tsdoc';import h from'defu';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+const v=refkey("isOptimizationEnabled");function k(n){const[{override:t},i]=splitProps(n,["override"]),c=usePowerlines();return createComponent(BuiltinFile,mergeProps(i,{id:"react/optimized",description:"A built-in module to provide access to environment configuration to determine React optimizations.",get imports(){return h({[`${c?.config.output.builtinPrefix}:env`]:["env","isDevelopment"]},i.imports??{})},get children(){return [createComponent(TSDoc,{heading:"A gating function to determine if the optimized [React compiler](https://react.dev/reference/react-compiler) source code should be used.",get children(){return [createComponent(TSDocLink,{children:"https://react.dev/reference/react-compiler/gating"}),createComponent(TSDocReturns,{children:"A boolean indicating if the React compiler's optimizations should be used."})]}}),createComponent(FunctionDeclaration,{refkey:v,async:false,export:true,name:"isOptimizationEnabled",returnType:"boolean",children:t!==void 0?code`return ${t};`:code`return !env.DISABLE_REACT_COMPILER && !isDevelopment; `})]}}))}a(k,"ReactOptimizedBuiltin");
+export{k as ReactOptimizedBuiltin};

package/dist/index.cjs

@@ -0,0 +1,8 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var chunkFBBMZ4NC_cjs=require('./chunk-FBBMZ4NC.cjs'),jsxRuntime=require('@alloy-js/core/jsx-runtime'),createPlugin=require('@powerlines/alloy/create-plugin'),type=require('@powerlines/deepkit/vendor/type'),m=require('@powerlines/plugin-babel'),f=require('@powerlines/plugin-env'),types$1=require('@storm-software/config-tools/types'),g=require('@vitejs/plugin-react'),d=require('defu'),tsconfig=require('powerlines/lib/typescript/tsconfig'),reactOptimized=require('./components/react-optimized'),components=require('./components'),types=require('./types');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var m__default=/*#__PURE__*/_interopDefault(m);var f__default=/*#__PURE__*/_interopDefault(f);var g__default=/*#__PURE__*/_interopDefault(g);var d__default=/*#__PURE__*/_interopDefault(d);/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+const h=createPlugin.createAlloyPlugin(s=>({name:"react",dependsOn:[m__default.default(s.babel),f__default.default(s.env)],config(){return d__default.default({react:s},{react:{jsxImportSource:this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource}},{react:{jsxRuntime:"automatic",jsxImportSource:"react",compiler:{target:"react19",compilationMode:"infer",gating:{source:`${this.config.output.builtinPrefix}:react/optimized`,importSpecifierName:"isOptimizationEnabled"},enableReanimatedCheck:true,logger:{logEvent:chunkFBBMZ4NC_cjs.a((o,i)=>{this.log(i.kind==="CompileSuccess"?types$1.LogLevelLabel.SUCCESS:i.kind==="AutoDepsEligible"||i.kind==="AutoDepsDecorations"?types$1.LogLevelLabel.INFO:i.kind==="CompileSkip"||i.kind==="CompileDiagnostic"?types$1.LogLevelLabel.DEBUG:i.kind==="Timing"?types$1.LogLevelLabel.TRACE:types$1.LogLevelLabel.ERROR,`(${o}) ${i.kind==="CompileSuccess"?"React Compiler Success":i.kind==="AutoDepsEligible"?`React AutoDeps Eligible - ${i.depArrayLoc.identifierName||"No identifier"}`:i.kind==="AutoDepsDecorations"?`React AutoDeps Decorations - ${i.decorations.filter(n=>n.identifierName).map(n=>n.identifierName).join(", ")}`:i.kind==="CompileSkip"?`React Compile Skip - ${i.reason}`:i.kind==="CompileDiagnostic"?`React Compile Diagnostic - (Category: ${i.detail.category}) ${i.detail.reason}${i.detail.description?`
+${i.detail.description}`:""}`:i.kind==="Timing"?`React ${i.measurement.entryType} Timing (${i.measurement.name}) - ${i.measurement.duration}ms`:`React Compiler Error - ${i.fnLoc?.identifierName||"unknown location"}`}`);},"logEvent")}}}})},configResolved(){if(this.dependencies.react="^19.2.0",this.dependencies["react-dom"]="^19.2.0",this.devDependencies["@types/react"]="^19.2.2",this.devDependencies["@types/react-dom"]="^19.2.2",this.config.react.compiler!==false&&(this.config.transform.babel??={},this.config.transform.babel.plugins??=[],this.config.transform.babel.plugins.push(["babel-plugin-react-compiler",this.config.react.compiler])),this.tsconfig.tsconfigJson.compilerOptions??={},this.tsconfig.tsconfigJson.compilerOptions.module??="esnext",this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource=this.config.react.jsxImportSource,this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource==="react"?this.tsconfig.tsconfigJson.compilerOptions.jsx??="react-jsx":this.tsconfig.tsconfigJson.compilerOptions.jsx??="preserve",this.tsconfig.tsconfigJson.compilerOptions.lib=[],tsconfig.isMatchFound("dom",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("DOM"),tsconfig.isMatchFound("dom.iterable",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("DOM.Iterable"),tsconfig.isMatchFound("esnext",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("ESNext"),this.tsconfig.options.resolveJsonModule!==true&&(this.tsconfig.tsconfigJson.compilerOptions.resolveJsonModule=true),this.config.build.variant==="vite"){this.tsconfig.tsconfigJson.compilerOptions.types??=[],tsconfig.isMatchFound("vite/client",this.tsconfig.tsconfigJson.compilerOptions.types)||this.tsconfig.tsconfigJson.compilerOptions.types.push("vite/client");const o=this.config.build;o.build??={},o.build.target="chrome95",o.plugins??=[],o.plugins.unshift(g__default.default({babel:this.config.transform.babel,jsxImportSource:this.config.react.jsxImportSource,jsxRuntime:this.config.react.jsxRuntime,reactRefreshHost:this.config.react.reactRefreshHost}));}this.env?.types?.env&&!this.env.types.env.hasProperty("DISABLE_REACT_COMPILER")&&this.env.types.env.addProperty({name:"DISABLE_REACT_COMPILER",optional:true,readonly:true,description:"Disables the React compiler optimizations.",visibility:type.ReflectionVisibility.public,type:{kind:type.ReflectionKind.boolean},default:false});},render(){const o=this;return jsxRuntime.createComponent(reactOptimized.ReactOptimizedBuiltin,{get override(){return o.config.react.compiler===false?false:void 0}})}}));var j=h;exports.default=j;exports.plugin=h;Object.keys(components).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return components[k]}})});Object.keys(types).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return types[k]}})});

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+import { P as PluginContext, a as Plugin } from './runtime-Ft55bXzz.cjs';
+import { Children } from '@alloy-js/core/jsx-runtime';
+import { PrintTreeOptions } from '@alloy-js/core';
+import { ReactPluginContext } from './types/plugin.cjs';
+export { ReactCompilerOptions, ReactPluginOptions, ReactPluginResolvedConfig, ReactPluginUserConfig } from './types/plugin.cjs';
+export { ReactOptimizedBuiltin, ReactOptimizedBuiltinProps } from './components/react-optimized.cjs';
+export { ReactEnvInterface } from './types/runtime.cjs';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import './vfs-Bl84Hw2V.cjs';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@deepkit/type';
+import '@stryke/capnp';
+import '@stryke/env/types';
+import 'babel-plugin-react-compiler';
+
+type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
+    /**
+     * If true, the Alloy framework is used to generate JSON output files.
+     *
+     * @defaultValue false
+     */
+    generatesJson?: boolean;
+    /**
+     * If true, the Alloy framework is used to generate Markdown output files.
+     *
+     * @defaultValue false
+     */
+    generatesMarkdown?: boolean;
+};
+
+interface AlloyPluginOptions {
+    alloy?: PluginPluginAlloyOptions;
+}
+type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
+    render: (this: TContext) => Children;
+};
+type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => AlloyPluginBuilderResult<TContext>;
+
+/**
+ * A package containing a Powerlines plugin for building a React application.
+ */
+declare const plugin: (options: Parameters<AlloyPluginBuilder<ReactPluginContext>>[0] & AlloyPluginOptions) => Plugin<ReactPluginContext>;
+
+export { ReactPluginContext, plugin as default, plugin };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { P as PluginContext, a as Plugin } from './runtime-DQYHDea3.js';
+import { Children } from '@alloy-js/core/jsx-runtime';
+import { PrintTreeOptions } from '@alloy-js/core';
+import { ReactPluginContext } from './types/plugin.js';
+export { ReactCompilerOptions, ReactPluginOptions, ReactPluginResolvedConfig, ReactPluginUserConfig } from './types/plugin.js';
+export { ReactOptimizedBuiltin, ReactOptimizedBuiltinProps } from './components/react-optimized.js';
+export { ReactEnvInterface } from './types/runtime.js';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@babel/core';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@babel/helper-plugin-utils';
+import '@stryke/types/array';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import './vfs-Bl84Hw2V.js';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@deepkit/type';
+import '@stryke/capnp';
+import '@stryke/env/types';
+import 'babel-plugin-react-compiler';
+
+type PluginPluginAlloyOptions = Partial<PrintTreeOptions> & {
+    /**
+     * If true, the Alloy framework is used to generate JSON output files.
+     *
+     * @defaultValue false
+     */
+    generatesJson?: boolean;
+    /**
+     * If true, the Alloy framework is used to generate Markdown output files.
+     *
+     * @defaultValue false
+     */
+    generatesMarkdown?: boolean;
+};
+
+interface AlloyPluginOptions {
+    alloy?: PluginPluginAlloyOptions;
+}
+type AlloyPluginBuilderResult<TContext extends PluginContext = PluginContext> = Plugin<TContext> & {
+    render: (this: TContext) => Children;
+};
+type AlloyPluginBuilder<TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => AlloyPluginBuilderResult<TContext>;
+
+/**
+ * A package containing a Powerlines plugin for building a React application.
+ */
+declare const plugin: (options: Parameters<AlloyPluginBuilder<ReactPluginContext>>[0] & AlloyPluginOptions) => Plugin<ReactPluginContext>;
+
+export { ReactPluginContext, plugin as default, plugin };

package/dist/index.js

@@ -0,0 +1,8 @@
+import {a}from'./chunk-UCUR73HG.js';import {createComponent}from'@alloy-js/core/jsx-runtime';import {createAlloyPlugin}from'@powerlines/alloy/create-plugin';import {ReflectionKind,ReflectionVisibility}from'@powerlines/deepkit/vendor/type';import m from'@powerlines/plugin-babel';import f from'@powerlines/plugin-env';import {LogLevelLabel}from'@storm-software/config-tools/types';import g from'@vitejs/plugin-react';import d from'defu';import {isMatchFound}from'powerlines/lib/typescript/tsconfig';import {ReactOptimizedBuiltin}from'./components/react-optimized';export*from'./components';export*from'./types';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+const h=createAlloyPlugin(s=>({name:"react",dependsOn:[m(s.babel),f(s.env)],config(){return d({react:s},{react:{jsxImportSource:this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource}},{react:{jsxRuntime:"automatic",jsxImportSource:"react",compiler:{target:"react19",compilationMode:"infer",gating:{source:`${this.config.output.builtinPrefix}:react/optimized`,importSpecifierName:"isOptimizationEnabled"},enableReanimatedCheck:true,logger:{logEvent:a((o,i)=>{this.log(i.kind==="CompileSuccess"?LogLevelLabel.SUCCESS:i.kind==="AutoDepsEligible"||i.kind==="AutoDepsDecorations"?LogLevelLabel.INFO:i.kind==="CompileSkip"||i.kind==="CompileDiagnostic"?LogLevelLabel.DEBUG:i.kind==="Timing"?LogLevelLabel.TRACE:LogLevelLabel.ERROR,`(${o}) ${i.kind==="CompileSuccess"?"React Compiler Success":i.kind==="AutoDepsEligible"?`React AutoDeps Eligible - ${i.depArrayLoc.identifierName||"No identifier"}`:i.kind==="AutoDepsDecorations"?`React AutoDeps Decorations - ${i.decorations.filter(n=>n.identifierName).map(n=>n.identifierName).join(", ")}`:i.kind==="CompileSkip"?`React Compile Skip - ${i.reason}`:i.kind==="CompileDiagnostic"?`React Compile Diagnostic - (Category: ${i.detail.category}) ${i.detail.reason}${i.detail.description?`
+${i.detail.description}`:""}`:i.kind==="Timing"?`React ${i.measurement.entryType} Timing (${i.measurement.name}) - ${i.measurement.duration}ms`:`React Compiler Error - ${i.fnLoc?.identifierName||"unknown location"}`}`);},"logEvent")}}}})},configResolved(){if(this.dependencies.react="^19.2.0",this.dependencies["react-dom"]="^19.2.0",this.devDependencies["@types/react"]="^19.2.2",this.devDependencies["@types/react-dom"]="^19.2.2",this.config.react.compiler!==false&&(this.config.transform.babel??={},this.config.transform.babel.plugins??=[],this.config.transform.babel.plugins.push(["babel-plugin-react-compiler",this.config.react.compiler])),this.tsconfig.tsconfigJson.compilerOptions??={},this.tsconfig.tsconfigJson.compilerOptions.module??="esnext",this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource=this.config.react.jsxImportSource,this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource==="react"?this.tsconfig.tsconfigJson.compilerOptions.jsx??="react-jsx":this.tsconfig.tsconfigJson.compilerOptions.jsx??="preserve",this.tsconfig.tsconfigJson.compilerOptions.lib=[],isMatchFound("dom",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("DOM"),isMatchFound("dom.iterable",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("DOM.Iterable"),isMatchFound("esnext",this.tsconfig.tsconfigJson.compilerOptions.lib)||this.tsconfig.tsconfigJson.compilerOptions.lib.push("ESNext"),this.tsconfig.options.resolveJsonModule!==true&&(this.tsconfig.tsconfigJson.compilerOptions.resolveJsonModule=true),this.config.build.variant==="vite"){this.tsconfig.tsconfigJson.compilerOptions.types??=[],isMatchFound("vite/client",this.tsconfig.tsconfigJson.compilerOptions.types)||this.tsconfig.tsconfigJson.compilerOptions.types.push("vite/client");const o=this.config.build;o.build??={},o.build.target="chrome95",o.plugins??=[],o.plugins.unshift(g({babel:this.config.transform.babel,jsxImportSource:this.config.react.jsxImportSource,jsxRuntime:this.config.react.jsxRuntime,reactRefreshHost:this.config.react.reactRefreshHost}));}this.env?.types?.env&&!this.env.types.env.hasProperty("DISABLE_REACT_COMPILER")&&this.env.types.env.addProperty({name:"DISABLE_REACT_COMPILER",optional:true,readonly:true,description:"Disables the React compiler optimizations.",visibility:ReflectionVisibility.public,type:{kind:ReflectionKind.boolean},default:false});},render(){const o=this;return createComponent(ReactOptimizedBuiltin,{get override(){return o.config.react.compiler===false?false:void 0}})}}));var I=h;export{I as default,h as plugin};