@storm-software/workspace-tools 1.62.18 → 1.62.19

package/src/executors/tsup-node/schema.d.ts

@@ -0,0 +1,7 @@
+import type { TsupNeutralExecutorSchema } from "../tsup-neutral/schema";
+import type { Platform } from "../tsup/schema";
+
+export type TsupNodeExecutorSchema = Omit<TsupNeutralExecutorSchema, "platform"> & {
+  transports: string[];
+  platform?: Platform;
+};

package/src/executors/tsup-node/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "tsup-node",
+  "extends": "../tsup/schema.json",
+  "version": 2,
+  "title": "Node TypeScript Builder",
+  "description": "Runs a node platform TypeScript build",
+  "type": "object",
+  "properties": {
+    "transports": {
+      "type": "array",
+      "description": "",
+      "items": {
+        "type": "string"
+      },
+      "default": ["pino-pretty", "pino-loki"]
+    }
+  },
+  "required": []
+}

package/src/executors/typia/schema.d.ts

@@ -0,0 +1,6 @@
+export interface TypiaExecutorSchema {
+  entryPath: string;
+  outputPath: string;
+  tsConfig: string;
+  clean?: boolean;
+}

package/src/executors/typia/schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "typia",
+  "version": 2,
+  "title": "Typia Generate Executor",
+  "description": "Run the Typia generator to create runtime type validators",
+  "type": "object",
+  "properties": {
+    "entryPath": {
+      "type": "string",
+      "description": "The path of the typescript files using `typia`.",
+      "alias": "main",
+      "default": "{sourceRoot}"
+    },
+    "outputPath": {
+      "type": "string",
+      "description": "The output path of the generated files.",
+      "x-completion-type": "directory",
+      "x-priority": "important",
+      "default": "{sourceRoot}/__generated__/typia"
+    },
+    "tsConfig": {
+      "type": "string",
+      "description": "The path to the `tsconfig.json` file.",
+      "x-completion-type": "file",
+      "x-completion-glob": "tsconfig.*.json",
+      "x-priority": "important",
+      "default": "{projectRoot}/tsconfig.json"
+    },
+    "clean": {
+      "type": "boolean",
+      "description": "Remove previous output before build.",
+      "alias": "deleteOutputPath",
+      "default": true
+    }
+  },
+  "required": ["entryPath", "outputPath", "tsConfig"]
+}

package/src/generators/browser-library/files/README.md

@@ -0,0 +1,58 @@
+<!-- START header -->
+<!-- END header -->
+
+# <%= name %>
+
+<%= description %>
+
+<!-- START doctoc -->
+<!-- END doctoc -->
+
+## Installing
+
+Using [pnpm](http://pnpm.io):
+
+```bash
+pnpm add -D <%= namespace %>/<%= name %>
+```
+
+<details>
+  <summary>Using npm</summary>
+
+```bash
+npm install -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+<details>
+  <summary>Using yarn</summary>
+
+```bash
+yarn add -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+## Reduced Package Size
+
+This project uses [tsup](https://tsup.egoist.dev/) to package the source code due to its ability to remove unused code and ship smaller javascript files thanks to code splitting. This helps to greatly reduce the size of the package and to make it easier to use in other projects.
+
+## Development
+
+This project is built using [Nx](https://nx.dev). As a result, many of the usual commands are available to assist in development.
+
+### Building
+
+Run `nx build <%= name %>` to build the library.
+
+### Running unit tests
+
+Run `nx test <%= name %>` to execute the unit tests via [Jest](https://jestjs.io).
+
+### Linting
+
+Run `nx lint <%= name %>` to run [ESLint](https://eslint.org/) on the package.
+
+<!-- START footer -->
+<!-- END footer -->

package/src/generators/browser-library/files/jest.config.ts

@@ -0,0 +1,3 @@
+import { getJestConfig } from "@storm-software/testing-tools";
+
+export default getJestConfig("<%= directory %>", true, "<%= name %>");

package/src/generators/browser-library/files/src/index.ts.template

@@ -0,0 +1,10 @@
+/**
+ * The <%= name %> library used by Storm Software for building TypeScript applications.
+ *
+ * @remarks
+ * <%= description %>
+ *
+ * @packageDocumentation
+ */
+
+const variable = "<%= name %>";

package/src/generators/browser-library/files/tsconfig.spec.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "<%= offsetFromRoot %>dist/out-tsc",
+    "types": ["jest"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}

package/src/generators/browser-library/schema.d.ts

@@ -0,0 +1,22 @@
+import { LibraryGeneratorSchema } from "@nx/js/src/utils/schema";
+
+export type BrowserLibraryGeneratorSchema = Omit<
+  LibraryGeneratorSchema,
+  | "js"
+  | "pascalCaseFiles"
+  | "skipFormat"
+  | "skipTsConfig"
+  | "skipPackageJson"
+  | "includeBabelRc"
+  | "unitTestRunner"
+  | "linter"
+  | "testEnvironment"
+  | "config"
+  | "compiler"
+  | "bundler"
+  | "skipTypeCheck"
+  | "minimal"
+> & {
+  name: string;
+  description: string;
+};

package/src/generators/browser-library/schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "browser-library",
+  "title": "Add browser Library",
+  "description": "Create a new browser TypeScript library package in the Storm workspace",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "A name for the library.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the library?",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*|^[a-zA-Z][^:]*)$"
+    },
+    "description": {
+      "type": "string",
+      "description": "The library used by Storm Software for building TypeScript applications.",
+      "$default": {
+        "$source": "argv",
+        "index": 2
+      },
+      "x-prompt": "Provide description to use as a summary of the library?"
+    },
+    "directory": {
+      "type": "string",
+      "description": "A directory where the lib is placed.",
+      "x-priority": "important"
+    },
+    "projectNameAndRootFormat": {
+      "description": "Whether to generate the project name and root directory as provided (`as-provided`) or generate them composing their values and taking the configured layout into account (`derived`).",
+      "type": "string",
+      "enum": ["as-provided", "derived"]
+    },
+    "tags": {
+      "type": "string",
+      "description": "Add tags to the library (used for linting)."
+    },
+    "strict": {
+      "type": "boolean",
+      "description": "Whether to enable tsconfig strict mode or not.",
+      "default": true
+    },
+    "publishable": {
+      "type": "boolean",
+      "default": false,
+      "description": "Generate a publishable library.",
+      "x-priority": "important"
+    },
+    "importPath": {
+      "type": "string",
+      "description": "The library name used to import it, like @storm-software/my-awesome-lib. Required for publishable library.",
+      "x-priority": "important"
+    },
+    "buildable": {
+      "type": "boolean",
+      "default": true,
+      "description": "Generate a buildable library.",
+      "x-deprecated": "Use the `bundler` option for greater control (swc, tsc, rollup, vite, esbuild, none)."
+    },
+    "setParserOptionsProject": {
+      "type": "boolean",
+      "description": "Whether or not to configure the ESLint `parserOptions.project` option. We do not do this by default for lint performance reasons.",
+      "default": false
+    },
+    "rootProject": {
+      "type": "boolean",
+      "default": false,
+      "description": "Is the current project the root project in the workspace."
+    }
+  },
+  "required": [
+    "name",
+    "directory",
+    "projectNameAndRootFormat",
+    "publishable",
+    "importPath",
+    "buildable"
+  ]
+}

package/src/generators/config-schema/schema.d.ts

@@ -0,0 +1,3 @@
+export interface ConfigSchemaGeneratorSchema {
+  outputFile?: string;
+}

package/src/generators/config-schema/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "config-schema",
+  "title": "Configuration Schema Creator",
+  "description": "Create a StormConfig JSON schema based on the workspace's project configurations",
+  "type": "object",
+  "properties": {
+    "outputFile": {
+      "type": "string",
+      "description": "The file path where the schema json will be written (relative to the workspace root)",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "Where should the schema json be written (relative to the workspace root)?",
+      "default": "{workspaceRoot}/storm.schema.json"
+    }
+  },
+  "required": ["outputFile"]
+}

package/src/generators/init/schema.d.ts

@@ -0,0 +1,3 @@
+export interface Schema {
+  skipFormat?: boolean;
+}

package/src/generators/init/schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "StormWorkspaceInit",
+  "cli": "nx",
+  "title": "Init Storm Workspace Plugin",
+  "description": "Init Storm Workspace Plugin.",
+  "type": "object",
+  "properties": {
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false
+    }
+  },
+  "required": []
+}

package/src/generators/neutral-library/files/README.md

@@ -0,0 +1,58 @@
+<!-- START header -->
+<!-- END header -->
+
+# <%= name %>
+
+<%= description %>
+
+<!-- START doctoc -->
+<!-- END doctoc -->
+
+## Installing
+
+Using [pnpm](http://pnpm.io):
+
+```bash
+pnpm add -D <%= namespace %>/<%= name %>
+```
+
+<details>
+  <summary>Using npm</summary>
+
+```bash
+npm install -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+<details>
+  <summary>Using yarn</summary>
+
+```bash
+yarn add -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+## Reduced Package Size
+
+This project uses [tsup](https://tsup.egoist.dev/) to package the source code due to its ability to remove unused code and ship smaller javascript files thanks to code splitting. This helps to greatly reduce the size of the package and to make it easier to use in other projects.
+
+## Development
+
+This project is built using [Nx](https://nx.dev). As a result, many of the usual commands are available to assist in development.
+
+### Building
+
+Run `nx build <%= name %>` to build the library.
+
+### Running unit tests
+
+Run `nx test <%= name %>` to execute the unit tests via [Jest](https://jestjs.io).
+
+### Linting
+
+Run `nx lint <%= name %>` to run [ESLint](https://eslint.org/) on the package.
+
+<!-- START footer -->
+<!-- END footer -->

package/src/generators/neutral-library/files/jest.config.ts

@@ -0,0 +1,3 @@
+import { getJestConfig } from "@storm-software/testing-tools";
+
+export default getJestConfig("<%= directory %>", true, "<%= name %>");

package/src/generators/neutral-library/files/src/index.ts.template

@@ -0,0 +1,10 @@
+/**
+ * The <%= name %> library used by Storm Software for building TypeScript applications.
+ *
+ * @remarks
+ * <%= description %>
+ *
+ * @packageDocumentation
+ */
+
+const variable = "<%= name %>";

package/src/generators/neutral-library/files/tsconfig.spec.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "<%= offsetFromRoot %>dist/out-tsc",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}

package/src/generators/neutral-library/schema.d.ts

@@ -0,0 +1,6 @@
+import { TypeScriptLibraryGeneratorSchema } from "../../base/typescript-library-generator";
+
+export type NeutralLibraryGeneratorSchema = Omit<
+  TypeScriptLibraryGeneratorSchema,
+  "platform"
+>;

package/src/generators/neutral-library/schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "neutral-library",
+  "title": "Add Neutral Library",
+  "description": "Create a new Neutral TypeScript library package in the Storm workspaces",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "A name for the library.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the library?",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*|^[a-zA-Z][^:]*)$"
+    },
+    "description": {
+      "type": "string",
+      "description": "The library used by Storm Software for building TypeScript applications.",
+      "$default": {
+        "$source": "argv",
+        "index": 2
+      },
+      "x-prompt": "Provide description to use as a summary of the library?"
+    },
+    "directory": {
+      "type": "string",
+      "description": "A directory where the lib is placed.",
+      "x-priority": "important"
+    },
+    "projectNameAndRootFormat": {
+      "description": "Whether to generate the project name and root directory as provided (`as-provided`) or generate them composing their values and taking the configured layout into account (`derived`).",
+      "type": "string",
+      "enum": ["as-provided", "derived"]
+    },
+    "tags": {
+      "type": "string",
+      "description": "Add tags to the library (used for linting)."
+    },
+    "strict": {
+      "type": "boolean",
+      "description": "Whether to enable tsconfig strict mode or not.",
+      "default": true
+    },
+    "publishable": {
+      "type": "boolean",
+      "default": false,
+      "description": "Generate a publishable library.",
+      "x-priority": "important"
+    },
+    "importPath": {
+      "type": "string",
+      "description": "The library name used to import it, like @storm-software/my-awesome-lib. Required for publishable library.",
+      "x-priority": "important"
+    },
+    "buildable": {
+      "type": "boolean",
+      "default": true,
+      "description": "Generate a buildable library.",
+      "x-deprecated": "Use the `bundler` option for greater control (swc, tsc, rollup, vite, esbuild, none)."
+    },
+    "setParserOptionsProject": {
+      "type": "boolean",
+      "description": "Whether or not to configure the ESLint `parserOptions.project` option. We do not do this by default for lint performance reasons.",
+      "default": false
+    },
+    "rootProject": {
+      "type": "boolean",
+      "default": false,
+      "description": "Is the current project the root project in the workspace."
+    }
+  },
+  "required": [
+    "name",
+    "directory",
+    "projectNameAndRootFormat",
+    "publishable",
+    "importPath",
+    "buildable"
+  ]
+}

package/src/generators/node-library/files/README.md

@@ -0,0 +1,58 @@
+<!-- START header -->
+<!-- END header -->
+
+# <%= name %>
+
+<%= description %>
+
+<!-- START doctoc -->
+<!-- END doctoc -->
+
+## Installing
+
+Using [pnpm](http://pnpm.io):
+
+```bash
+pnpm add -D <%= namespace %>/<%= name %>
+```
+
+<details>
+  <summary>Using npm</summary>
+
+```bash
+npm install -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+<details>
+  <summary>Using yarn</summary>
+
+```bash
+yarn add -D <%= namespace %>/<%= name %>
+```
+
+</details>
+
+## Reduced Package Size
+
+This project uses [tsup](https://tsup.egoist.dev/) to package the source code due to its ability to remove unused code and ship smaller javascript files thanks to code splitting. This helps to greatly reduce the size of the package and to make it easier to use in other projects.
+
+## Development
+
+This project is built using [Nx](https://nx.dev). As a result, many of the usual commands are available to assist in development.
+
+### Building
+
+Run `nx build <%= name %>` to build the library.
+
+### Running unit tests
+
+Run `nx test <%= name %>` to execute the unit tests via [Jest](https://jestjs.io).
+
+### Linting
+
+Run `nx lint <%= name %>` to run [ESLint](https://eslint.org/) on the package.
+
+<!-- START footer -->
+<!-- END footer -->

package/src/generators/node-library/files/jest.config.ts

@@ -0,0 +1,3 @@
+import { getJestConfig } from "@storm-software/testing-tools";
+
+export default getJestConfig("<%= directory %>", true, "<%= name %>");

package/src/generators/node-library/files/src/index.ts.template

@@ -0,0 +1,10 @@
+/**
+ * The <%= name %> library used by Storm Software for building TypeScript applications.
+ *
+ * @remarks
+ * <%= description %>
+ *
+ * @packageDocumentation
+ */
+
+const variable = "<%= name %>";

package/src/generators/node-library/files/tsconfig.spec.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "<%= offsetFromRoot %>dist/out-tsc",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}

package/src/generators/node-library/schema.d.ts

@@ -0,0 +1,22 @@
+import { LibraryGeneratorSchema } from "@nx/js/src/utils/schema";
+
+export type NodeLibraryGeneratorSchema = Omit<
+  LibraryGeneratorSchema,
+  | "js"
+  | "pascalCaseFiles"
+  | "skipFormat"
+  | "skipTsConfig"
+  | "skipPackageJson"
+  | "includeBabelRc"
+  | "unitTestRunner"
+  | "linter"
+  | "testEnvironment"
+  | "config"
+  | "compiler"
+  | "bundler"
+  | "skipTypeCheck"
+  | "minimal"
+> & {
+  name: string;
+  description: string;
+};