@apollion-dsi/scripts 0.7.7 → 0.8.0

package/coverage/lcov.info

@@ -0,0 +1,236 @@
+TN:
+SF:src/config/env.ts
+FN:16,getEnviroment
+FN:38,(anonymous_2)
+FN:51,(anonymous_3)
+FN:52,(anonymous_4)
+FN:69,getClientEnvironment
+FN:75,(anonymous_6)
+FN:76,(anonymous_7)
+FN:101,(anonymous_8)
+FNF:8
+FNH:7
+FNDA:2,getEnviroment
+FNDA:5,(anonymous_2)
+FNDA:1,(anonymous_3)
+FNDA:0,(anonymous_4)
+FNDA:2,getClientEnvironment
+FNDA:127,(anonymous_6)
+FNDA:1,(anonymous_7)
+FNDA:13,(anonymous_8)
+DA:1,1
+DA:2,1
+DA:16,1
+DA:17,2
+DA:19,2
+DA:20,1
+DA:23,1
+DA:38,1
+DA:39,5
+DA:40,0
+DA:48,1
+DA:49,1
+DA:51,1
+DA:52,0
+DA:69,1
+DA:72,2
+DA:74,2
+DA:75,127
+DA:76,1
+DA:100,2
+DA:101,13
+DA:104,2
+LF:22
+LH:20
+BRDA:19,0,0,1
+BRDA:19,0,1,1
+BRDA:29,1,0,1
+BRDA:29,1,1,0
+BRDA:39,2,0,0
+BRDA:39,2,1,5
+BRDA:49,3,0,1
+BRDA:49,3,1,1
+BRDA:51,4,0,1
+BRDA:51,4,1,0
+BRDA:79,5,0,2
+BRDA:79,5,1,1
+BRF:12
+BRH:9
+end_of_record
+TN:
+SF:src/config/paths.ts
+FN:70,createAppPaths
+FN:72,(anonymous_2)
+FN:83,(anonymous_3)
+FN:84,(anonymous_4)
+FNF:4
+FNH:4
+FNDA:4,createAppPaths
+FNDA:118,(anonymous_2)
+FNDA:8,(anonymous_3)
+FNDA:62,(anonymous_4)
+DA:1,2
+DA:2,2
+DA:4,2
+DA:45,2
+DA:70,2
+DA:71,4
+DA:72,118
+DA:74,4
+DA:76,4
+DA:83,4
+DA:84,62
+DA:86,8
+DA:87,6
+DA:90,2
+DA:93,4
+DA:94,4
+DA:95,4
+DA:97,4
+DA:99,4
+DA:119,2
+LF:20
+LH:20
+BRDA:70,0,0,2
+BRDA:86,1,0,6
+BRDA:86,1,1,2
+BRDA:97,2,0,4
+BRDA:97,2,1,0
+BRDA:97,3,0,4
+BRDA:97,3,1,4
+BRF:7
+BRH:6
+end_of_record
+TN:
+SF:src/config/shared.ts
+FNF:0
+FNH:0
+DA:33,1
+LF:1
+LH:1
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/utils/checkRequiredFiles.ts
+FN:15,checkRequiredFiles
+FN:18,(anonymous_2)
+FNF:2
+FNH:2
+FNDA:3,checkRequiredFiles
+FNDA:4,(anonymous_2)
+DA:1,1
+DA:2,1
+DA:4,1
+DA:15,1
+DA:17,3
+DA:18,3
+DA:19,4
+DA:20,4
+DA:22,2
+DA:24,1
+DA:25,1
+DA:26,1
+DA:27,1
+DA:28,1
+DA:29,1
+LF:15
+LH:15
+BRDA:24,0,0,1
+BRDA:24,0,1,0
+BRDA:25,1,0,1
+BRDA:25,1,1,0
+BRF:4
+BRH:2
+end_of_record
+TN:
+SF:src/utils/formatWebpackMessages.ts
+FN:10,toString
+FN:39,formatWebpackMessages
+FNF:2
+FNH:2
+FNDA:7,toString
+FNDA:7,formatWebpackMessages
+DA:11,7
+DA:12,7
+DA:13,5
+DA:14,3
+DA:15,3
+DA:16,2
+DA:17,2
+DA:18,2
+DA:19,2
+DA:21,1
+DA:22,1
+DA:24,0
+DA:27,2
+DA:39,1
+DA:40,7
+DA:41,7
+DA:42,7
+LF:17
+LH:16
+BRDA:11,0,0,0
+BRDA:11,0,1,7
+BRDA:12,1,0,2
+BRDA:12,1,1,5
+BRDA:13,2,0,3
+BRDA:13,2,1,2
+BRDA:15,3,0,2
+BRDA:15,3,1,1
+BRDA:17,4,0,1
+BRDA:17,4,1,1
+BRDA:40,5,0,4
+BRDA:40,5,1,3
+BRDA:41,6,0,2
+BRDA:41,6,1,5
+BRF:14
+BRH:13
+end_of_record
+TN:
+SF:src/utils/getPublicUrlOrPath.ts
+FN:22,getPublicUrlOrPath
+FNF:1
+FNH:1
+FNDA:12,getPublicUrlOrPath
+DA:1,3
+DA:22,3
+DA:27,12
+DA:29,12
+DA:30,3
+DA:31,3
+DA:32,3
+DA:33,3
+DA:34,3
+DA:36,0
+DA:40,9
+DA:41,7
+DA:42,7
+DA:43,7
+DA:44,7
+DA:45,7
+DA:53,0
+DA:57,2
+LF:18
+LH:16
+BRDA:29,0,0,3
+BRDA:29,0,1,9
+BRDA:31,1,0,1
+BRDA:31,1,1,2
+BRDA:34,2,0,2
+BRDA:34,2,1,1
+BRDA:34,3,0,1
+BRDA:34,3,1,1
+BRDA:40,4,0,7
+BRDA:40,4,1,2
+BRDA:42,5,0,1
+BRDA:42,5,1,6
+BRDA:45,6,0,1
+BRDA:45,6,1,6
+BRDA:46,7,0,0
+BRDA:46,7,1,1
+BRDA:49,8,0,1
+BRDA:49,8,1,5
+BRF:18
+BRH:17
+end_of_record

package/jest.config.js

@@ -0,0 +1,36 @@
+/** @type {import('@jest/types').Config.InitialOptions} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  collectCoverage: true,
+  testMatch: ['<rootDir>/src/__tests__/**/*.test.ts'],
+  testPathIgnorePatterns: ['/node_modules/', '/lib/', '/template/'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/bin.ts',
+    '!src/index.ts',
+    '!src/command/**',
+    '!src/config/webpack.config.js',
+    '!src/config/webpackDevServer.config.ts',
+    '!src/config/modules.ts',
+    '!src/utils/WebpackDevServerUtils.ts',
+    '!src/utils/devServerMiddleware.ts',
+    '!src/utils/Inline*.js',
+    '!src/utils/Module*.js',
+    '!src/utils/Interpolate*.js',
+    '!src/utils/FileSizeReporter.ts',
+    '!src/utils/printBuildError.ts',
+    '!src/utils/printHostingInstructions.ts',
+  ],
+  transform: {
+    '^.+\\.tsx?$': ['ts-jest', { tsconfig: 'tsconfig.test.json' }],
+  },
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+};

package/lib/command/build.d.ts

@@ -1,3 +1,17 @@
 import { AppPaths } from '../config/paths';
 import { CustomConfigType } from '../config/shared';
+/**
+ * Run a one-shot webpack production build for the consumer app at `paths`.
+ *
+ * Side effects:
+ * - Sets `process.env.BABEL_ENV` / `NODE_ENV` to `'production'`.
+ * - Empties `paths.appBuild` and copies `paths.appPublic` into it.
+ * - On failure: prints the formatted error and exits with code 1
+ *   (or merely warns when `TSC_COMPILE_ON_ERROR=true`).
+ * - On `process.env.CI`-truthy runs, treats any webpack warning as a hard error.
+ *
+ * @param paths       Resolved app paths — typically `createAppPaths()`.
+ * @param userConfig  Optional override. Merged on top of {@link defaultDevConfig}.
+ *                    Pass `configureWebpack` here to mutate the final webpack config.
+ */
 export declare function createProductionBuild(paths: AppPaths, userConfig?: CustomConfigType): Promise<void>;

package/lib/command/build.js

@@ -81,6 +81,20 @@ function build(config, previousFileSizes) {
         });
     });
 }
+/**
+ * Run a one-shot webpack production build for the consumer app at `paths`.
+ *
+ * Side effects:
+ * - Sets `process.env.BABEL_ENV` / `NODE_ENV` to `'production'`.
+ * - Empties `paths.appBuild` and copies `paths.appPublic` into it.
+ * - On failure: prints the formatted error and exits with code 1
+ *   (or merely warns when `TSC_COMPILE_ON_ERROR=true`).
+ * - On `process.env.CI`-truthy runs, treats any webpack warning as a hard error.
+ *
+ * @param paths       Resolved app paths — typically `createAppPaths()`.
+ * @param userConfig  Optional override. Merged on top of {@link defaultDevConfig}.
+ *                    Pass `configureWebpack` here to mutate the final webpack config.
+ */
 async function createProductionBuild(paths, userConfig = shared_1.defaultDevConfig) {
     // Warn and crash if required files are missing
     if (!(0, checkRequiredFiles_1.default)([paths.appHtml, paths.appIndexJs])) {

package/lib/command/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/command/build.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/command/build.ts"],"names":[],"mappings":"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"}

package/lib/command/create/helper.js

@@ -26,7 +26,6 @@ exports.templateDependencies = [
     '@types/react-dom',
     '@types/react-router-dom',
     'styled-components',
-    '@types/styled-components',
     '@apollion-dsi/core',
     '@apollion-dsi/scripts',
     '@apollion-dsi/eslint-config',

package/lib/command/create/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../src/command/create/helper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../src/command/create/helper.ts"],"names":[],"mappings":"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"}

package/lib/command/dev.d.ts

@@ -1,3 +1,15 @@
 import { AppPaths } from '../config/paths';
 import { CustomConfigType } from '../config/shared';
+/**
+ * Boot a webpack-dev-server for the consumer app described by `paths`.
+ *
+ * Side effects:
+ * - Sets `process.env.BABEL_ENV` / `NODE_ENV` to `'development'`.
+ * - Picks an available port starting at `userConfig.port ?? 3000`.
+ * - Registers `SIGINT`/`SIGTERM` handlers that stop the server and exit.
+ *
+ * @param paths       Resolved app paths — typically `createAppPaths()`.
+ * @param userConfig  Optional override. Merged on top of {@link defaultDevConfig}.
+ *                    Pass `configureWebpack` here to mutate the final webpack config.
+ */
 export declare function createDevServer(paths: AppPaths, userConfig?: CustomConfigType): Promise<void>;

package/lib/command/dev.js

@@ -23,6 +23,18 @@ const webpack_config_1 = __importDefault(require("../config/webpack.config"));
 const webpackDevServer_config_1 = __importDefault(require("../config/webpackDevServer.config"));
 const checkRequiredFiles_1 = __importDefault(require("../utils/checkRequiredFiles"));
 const WebpackDevServerUtils_1 = require("../utils/WebpackDevServerUtils");
+/**
+ * Boot a webpack-dev-server for the consumer app described by `paths`.
+ *
+ * Side effects:
+ * - Sets `process.env.BABEL_ENV` / `NODE_ENV` to `'development'`.
+ * - Picks an available port starting at `userConfig.port ?? 3000`.
+ * - Registers `SIGINT`/`SIGTERM` handlers that stop the server and exit.
+ *
+ * @param paths       Resolved app paths — typically `createAppPaths()`.
+ * @param userConfig  Optional override. Merged on top of {@link defaultDevConfig}.
+ *                    Pass `configureWebpack` here to mutate the final webpack config.
+ */
 async function createDevServer(paths, userConfig = shared_1.defaultDevConfig) {
     const useCustomConfig = fs_1.default.existsSync(paths.appCustomConfig);
     const { configureWebpack, ...customConfig } = useCustomConfig

package/lib/command/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/command/dev.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/command/dev.ts"],"names":[],"mappings":"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"}

package/lib/config/env.d.ts

@@ -1,5 +1,28 @@
 import { CustomConfigType } from './shared';
+/**
+ * Load environment variables from `.env*` files in cascading order
+ * (`.env.<NODE_ENV>.local`, `.env.local`, `.env.<NODE_ENV>`, `.env`)
+ * and prepend the consumer's `NODE_PATH` entries with absolute paths.
+ *
+ * **Throws** when `process.env.NODE_ENV` is unset — required so the
+ * cascade can pick the right file. Skips `.env.local` for `NODE_ENV=test`.
+ *
+ * @param paths  `AppPaths` (only `paths.dotenv` is read).
+ */
 export declare function getEnviroment(paths: any): void;
+/**
+ * Pick the `REACT_APP_*` subset of `process.env`, augment it with the
+ * fixed `NODE_ENV`/`PUBLIC_URL`/`WDS_SOCKET_*`/`FAST_REFRESH` keys, and
+ * return both the raw object (for runtime consumers) and a stringified
+ * form ready for webpack's `DefinePlugin`.
+ *
+ * **Security:** vars NOT prefixed with `REACT_APP_` (e.g. `SECRET_KEY`)
+ * are excluded — this is the boundary that prevents server-only secrets
+ * from leaking into the client bundle.
+ *
+ * @param publicUrl  `paths.publicUrlOrPath` — exposed as `PUBLIC_URL`.
+ * @param config     Resolved `CustomConfigType` (only `useFastRefresh` is read).
+ */
 export default function getClientEnvironment(publicUrl: string, config: CustomConfigType): {
     raw: {
         NODE_ENV: string;

package/lib/config/env.js

@@ -7,6 +7,16 @@ exports.getEnviroment = getEnviroment;
 exports.default = getClientEnvironment;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+/**
+ * Load environment variables from `.env*` files in cascading order
+ * (`.env.<NODE_ENV>.local`, `.env.local`, `.env.<NODE_ENV>`, `.env`)
+ * and prepend the consumer's `NODE_PATH` entries with absolute paths.
+ *
+ * **Throws** when `process.env.NODE_ENV` is unset — required so the
+ * cascade can pick the right file. Skips `.env.local` for `NODE_ENV=test`.
+ *
+ * @param paths  `AppPaths` (only `paths.dotenv` is read).
+ */
 function getEnviroment(paths) {
     const { NODE_ENV, ENV } = process.env;
     if (!NODE_ENV) {
@@ -40,6 +50,19 @@ function getEnviroment(paths) {
         .map((folder) => path_1.default.resolve(appDirectory, folder))
         .join(path_1.default.delimiter);
 }
+/**
+ * Pick the `REACT_APP_*` subset of `process.env`, augment it with the
+ * fixed `NODE_ENV`/`PUBLIC_URL`/`WDS_SOCKET_*`/`FAST_REFRESH` keys, and
+ * return both the raw object (for runtime consumers) and a stringified
+ * form ready for webpack's `DefinePlugin`.
+ *
+ * **Security:** vars NOT prefixed with `REACT_APP_` (e.g. `SECRET_KEY`)
+ * are excluded — this is the boundary that prevents server-only secrets
+ * from leaking into the client bundle.
+ *
+ * @param publicUrl  `paths.publicUrlOrPath` — exposed as `PUBLIC_URL`.
+ * @param config     Resolved `CustomConfigType` (only `useFastRefresh` is read).
+ */
 function getClientEnvironment(publicUrl, config) {
     // Grab NODE_ENV and REACT_APP_* environment variables and prepare them to be
     // injected into the application via DefinePlugin in webpack configuration.

package/lib/config/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"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"}

package/lib/config/paths.d.ts

@@ -1,22 +1,53 @@
+/**
+ * Resolved filesystem locations the build/dev/test commands operate on.
+ * Every entry is an absolute path computed from the consumer app root.
+ */
 export type AppPaths = {
+    /** `.env` file the consumer app reads from. Suffixed variants (`.env.local`, `.env.<NODE_ENV>`) are derived from this. */
     dotenv: string;
+    /** Consumer app root (= the directory containing `package.json`). */
     appPath: string;
+    /** Output directory for production bundles. Honors `scriptsrc.js#output`, defaults to `build/`. */
     appBuild: string;
+    /** Directory copied verbatim into `appBuild` during production builds. */
     appPublic: string;
+    /** Entry HTML used as the webpack `HtmlWebpackPlugin` template. */
     appHtml: string;
+    /** Resolved JS/TS entry under `src/` (extension picked by `moduleFileExtensions`). */
     appIndexJs: string;
+    /** Consumer app `src/` root. */
     appSrc: string;
+    /** Optional consumer-provided override file (`scriptsrc.js`). */
     appCustomConfig: string;
+    /** Consumer app `tsconfig.json`. */
     appTsConfig: string;
+    /** Consumer `yarn.lock` — drives "use yarn?" detection. */
     yarnLockFile: string;
+    /** Optional `src/setupTests.{ts,tsx,js}` resolved with the same extension precedence. */
     testsSetup: string;
+    /** Optional `src/setupProxy.js`. */
     proxySetup: string;
+    /** Consumer `node_modules/`. */
     appNodeModules: string;
+    /** Consumer `package.json`. */
     appPackageJson: string;
+    /** Public URL (or absolute pathname in dev) derived from env + homepage — see {@link getPublicUrlOrPath}. */
     publicUrlOrPath: string;
+    /** Source extensions tried (in order) when resolving JS/TS entries. */
     moduleFileExtensions: string[];
 };
 export declare const moduleFileExtensions: string[];
+/**
+ * Build the {@link AppPaths} object for the consumer app rooted at `basePath`.
+ *
+ * Reads (synchronously, at call time):
+ * - `<basePath>/package.json` — for `homepage`.
+ * - `<basePath>/scriptsrc.js` — if present, for `output` override.
+ * - `process.env.NODE_ENV`, `process.env.PUBLIC_URL` — drive public-url resolution.
+ *
+ * @param basePath  Defaults to `process.cwd()`. Pass an explicit path in tests
+ *                  to point at a fixture without changing the working dir.
+ */
 export declare function createAppPaths(basePath?: string): AppPaths;
 declare const _default: AppPaths;
 export default _default;

package/lib/config/paths.js

@@ -21,6 +21,17 @@ exports.moduleFileExtensions = [
     'web.jsx',
     'jsx',
 ];
+/**
+ * Build the {@link AppPaths} object for the consumer app rooted at `basePath`.
+ *
+ * Reads (synchronously, at call time):
+ * - `<basePath>/package.json` — for `homepage`.
+ * - `<basePath>/scriptsrc.js` — if present, for `output` override.
+ * - `process.env.NODE_ENV`, `process.env.PUBLIC_URL` — drive public-url resolution.
+ *
+ * @param basePath  Defaults to `process.cwd()`. Pass an explicit path in tests
+ *                  to point at a fixture without changing the working dir.
+ */
 function createAppPaths(basePath = process.cwd()) {
     const appDirectory = fs_1.default.realpathSync(basePath);
     const resolveApp = (relativePath) => path_1.default.resolve(appDirectory, relativePath);

package/lib/config/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":";;;;;;AAsCA,wCA+CC;AArFD,4CAAoB;AACpB,gDAAwB;AAExB,qFAA6D;AAqBhD,QAAA,oBAAoB,GAAG;IAClC,SAAS;IACT,KAAK;IACL,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,SAAS;IACT,KAAK;IACL,MAAM;IACN,SAAS;IACT,KAAK;CACN,CAAC;AAEF,SAAgB,cAAc,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,YAAY,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAE9E,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,IAAA,4BAAkB,EACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EACtC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,EAChC,OAAO,CAAC,GAAG,CAAC,UAAU,CACvB,CAAC;IAEF,kDAAkD;IAClD,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,4BAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAErG,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,iBAAiB,GAAG,YAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACzD,MAAM,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;IAE3D,MAAM,YAAY,GAAG,iBAAiB,IAAI,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5F,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC;QACxB,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC;QAClC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC;QACxC,UAAU,EAAE,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC;QAClD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC;QACzB,WAAW,EAAE,UAAU,CAAC,eAAe,CAAC;QACxC,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC;QACrC,UAAU,EAAE,aAAa,CAAC,UAAU,EAAE,gBAAgB,CAAC;QACvD,UAAU,EAAE,UAAU,CAAC,mBAAmB,CAAC;QAC3C,cAAc,EAAE,UAAU,CAAC,cAAc,CAAC;QAC1C,eAAe;QACf,cAAc;QACd,eAAe;QACf,oBAAoB,EAApB,4BAAoB;KACrB,CAAC;AACJ,CAAC;AAED,kBAAe,cAAc,EAAE,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":";;;;;;AAqEA,wCA+CC;AApHD,4CAAoB;AACpB,gDAAwB;AAExB,qFAA6D;AAyChD,QAAA,oBAAoB,GAAG;IAClC,SAAS;IACT,KAAK;IACL,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,SAAS;IACT,KAAK;IACL,MAAM;IACN,SAAS;IACT,KAAK;CACN,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,YAAY,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,cAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAE9E,MAAM,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,IAAA,4BAAkB,EACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EACtC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,EAChC,OAAO,CAAC,GAAG,CAAC,UAAU,CACvB,CAAC;IAEF,kDAAkD;IAClD,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC5C,MAAM,SAAS,GAAG,4BAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAErG,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,iBAAiB,GAAG,YAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACzD,MAAM,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;IAE3D,MAAM,YAAY,GAAG,iBAAiB,IAAI,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5F,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC;QACxB,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC;QAClC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC;QACxC,UAAU,EAAE,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC;QAClD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC;QACzB,WAAW,EAAE,UAAU,CAAC,eAAe,CAAC;QACxC,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC;QACrC,UAAU,EAAE,aAAa,CAAC,UAAU,EAAE,gBAAgB,CAAC;QACvD,UAAU,EAAE,UAAU,CAAC,mBAAmB,CAAC;QAC3C,cAAc,EAAE,UAAU,CAAC,cAAc,CAAC;QAC1C,eAAe;QACf,cAAc;QACd,eAAe;QACf,oBAAoB,EAApB,4BAAoB;KACrB,CAAC;AACJ,CAAC;AAED,kBAAe,cAAc,EAAE,CAAC"}

package/lib/config/shared.d.ts

@@ -1,17 +1,32 @@
 import { Configuration } from 'webpack';
+/**
+ * Shape of the optional `scriptsrc.js` consumer apps drop next to their
+ * `package.json` to override CLI defaults. Every field is optional —
+ * unset keys fall back to {@link defaultDevConfig}.
+ */
 export type CustomConfigType = {
+    /** Dev server port. Default `3000`. `choosePort` will increment if busy. */
     port?: number;
+    /** Dev server host. Default `'0.0.0.0'` (listens on all interfaces). */
     host?: string;
+    /** HTML `<title>` injected via `HtmlWebpackPlugin`. */
     head?: HeadConfigType;
+    /** Constants exposed to the bundle via `DefinePlugin`. Stringified for you. */
     constants?: Record<string, string>;
+    /** Arbitrary i18n config object — opaque to the CLI, forwarded to consumer code. */
     i18nConfig?: Record<string, any>;
+    /** Enable React Refresh in dev. Default `true`. */
     useFastRefresh?: boolean;
+    /** Relay compiler artifact dir (used by `babel-plugin-relay`). */
     relayArtifactDirectory?: string;
+    /** Last-mile escape hatch: receives the resolved webpack config and must return one. */
     configureWebpack?: (config: Configuration, env: 'development' | 'production' | 'test') => Configuration;
 };
+/** `<head>` overrides — only `title` is consumed today. */
 export type HeadConfigType = {
     title: string;
 };
+/** Defaults merged into every `CustomConfigType` consumer override. */
 export declare const defaultDevConfig: {
     port: number;
     host: string;

package/lib/config/shared.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultDevConfig = void 0;
+/** Defaults merged into every `CustomConfigType` consumer override. */
 exports.defaultDevConfig = {
     port: 3000,
     host: '0.0.0.0',

package/lib/config/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/config/shared.ts"],"names":[],"mappings":";;;AAiBa,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACJ,KAAK,EAAE,UAAU;KAClB;IACD,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,IAAI;CACrB,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/config/shared.ts"],"names":[],"mappings":";;;AA+BA,uEAAuE;AAC1D,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE;QACJ,KAAK,EAAE,UAAU;KAClB;IACD,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,IAAI;CACrB,CAAC"}

package/lib/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Public API of `@apollion-dsi/scripts` — the CRA-style CLI consumed by
+ * Apollion-based clients (Jovian, DEX-Aggregator, Fanaticofc). Detailed
+ * usage lives in {@link README.md}; this barrel only re-exports the
+ * three entry points consumer apps need.
+ *
+ * @packageDocumentation
+ */
 export { createAppPaths, AppPaths } from './config/paths';
 export { createDevServer } from './command/dev';
 export { createProductionBuild } from './command/build';

package/lib/index.js

@@ -1,4 +1,12 @@
 "use strict";
+/**
+ * Public API of `@apollion-dsi/scripts` — the CRA-style CLI consumed by
+ * Apollion-based clients (Jovian, DEX-Aggregator, Fanaticofc). Detailed
+ * usage lives in {@link README.md}; this barrel only re-exports the
+ * three entry points consumer apps need.
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProductionBuild = exports.createDevServer = exports.createAppPaths = void 0;
 var paths_1 = require("./config/paths");

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wCAA0D;AAAjD,uGAAA,cAAc,OAAA;AACvB,qCAAgD;AAAvC,sGAAA,eAAe,OAAA;AACxB,yCAAwD;AAA/C,8GAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,wCAA0D;AAAjD,uGAAA,cAAc,OAAA;AACvB,qCAAgD;AAAvC,sGAAA,eAAe,OAAA;AACxB,yCAAwD;AAA/C,8GAAA,qBAAqB,OAAA"}