@nx/angular 0.0.0-pr-22179-271588f

package/src/generators/setup-tailwind/lib/add-tailwind-required-packages.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addTailwindRequiredPackages = void 0;
+const devkit_1 = require("@nx/devkit");
+const version_utils_1 = require("../../utils/version-utils");
+function addTailwindRequiredPackages(tree) {
+    const pkgVersions = (0, version_utils_1.versions)(tree);
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, {
+        autoprefixer: pkgVersions.autoprefixerVersion,
+        postcss: pkgVersions.postcssVersion,
+        tailwindcss: pkgVersions.tailwindVersion,
+    });
+}
+exports.addTailwindRequiredPackages = addTailwindRequiredPackages;

package/src/generators/setup-tailwind/lib/detect-tailwind-installed-version.d.ts

@@ -0,0 +1,2 @@
+import { Tree } from '@nx/devkit';
+export declare function detectTailwindInstalledVersion(tree: Tree): '2' | '3' | undefined;

package/src/generators/setup-tailwind/lib/detect-tailwind-installed-version.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTailwindInstalledVersion = void 0;
+const devkit_1 = require("@nx/devkit");
+const semver_1 = require("@nx/devkit/src/utils/semver");
+const semver_2 = require("semver");
+function detectTailwindInstalledVersion(tree) {
+    const { dependencies, devDependencies } = (0, devkit_1.readJson)(tree, 'package.json');
+    const tailwindVersion = dependencies?.tailwindcss ?? devDependencies?.tailwindcss;
+    if (!tailwindVersion) {
+        return undefined;
+    }
+    const version = (0, semver_1.checkAndCleanWithSemver)('tailwindcss', tailwindVersion);
+    if ((0, semver_2.lt)(version, '2.0.0')) {
+        throw new Error(`The Tailwind CSS version "${tailwindVersion}" is not supported. Please upgrade to v2.0.0 or higher.`);
+    }
+    return (0, semver_2.lt)(version, '3.0.0') ? '2' : '3';
+}
+exports.detectTailwindInstalledVersion = detectTailwindInstalledVersion;

package/src/generators/setup-tailwind/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from './add-tailwind-config-path-to-project';
+export * from './add-tailwind-config';
+export * from './add-tailwind-required-packages';
+export * from './detect-tailwind-installed-version';
+export * from './normalize-options';
+export * from './update-application-styles';

package/src/generators/setup-tailwind/lib/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./add-tailwind-config-path-to-project"), exports);
+tslib_1.__exportStar(require("./add-tailwind-config"), exports);
+tslib_1.__exportStar(require("./add-tailwind-required-packages"), exports);
+tslib_1.__exportStar(require("./detect-tailwind-installed-version"), exports);
+tslib_1.__exportStar(require("./normalize-options"), exports);
+tslib_1.__exportStar(require("./update-application-styles"), exports);

package/src/generators/setup-tailwind/lib/normalize-options.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions, NormalizedGeneratorOptions } from '../schema';
+export declare function normalizeOptions(options: GeneratorOptions): NormalizedGeneratorOptions;

package/src/generators/setup-tailwind/lib/normalize-options.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = void 0;
+function normalizeOptions(options) {
+    return {
+        ...options,
+        buildTarget: options.buildTarget || 'build',
+    };
+}
+exports.normalizeOptions = normalizeOptions;

package/src/generators/setup-tailwind/lib/update-application-styles.d.ts

@@ -0,0 +1,3 @@
+import { ProjectConfiguration, Tree } from '@nx/devkit';
+import { NormalizedGeneratorOptions } from '../schema';
+export declare function updateApplicationStyles(tree: Tree, options: NormalizedGeneratorOptions, project: ProjectConfiguration): void;

package/src/generators/setup-tailwind/lib/update-application-styles.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateApplicationStyles = void 0;
+const devkit_1 = require("@nx/devkit");
+function updateApplicationStyles(tree, options, project) {
+    let stylesEntryPoint = options.stylesEntryPoint;
+    if (stylesEntryPoint && !tree.exists(stylesEntryPoint)) {
+        throw new Error(`The provided styles entry point "${stylesEntryPoint}" could not be found.`);
+    }
+    if (!stylesEntryPoint) {
+        stylesEntryPoint = findStylesEntryPoint(tree, options, project);
+        if (!stylesEntryPoint) {
+            throw new Error((0, devkit_1.stripIndents) `Could not find a styles entry point for project "${options.project}".
+        Please specify a styles entry point using the "--stylesEntryPoint" option.`);
+        }
+    }
+    const stylesEntryPointContent = tree.read(stylesEntryPoint, 'utf-8');
+    tree.write(stylesEntryPoint, (0, devkit_1.stripIndents) `@tailwind base;
+    @tailwind components;
+    @tailwind utilities;
+
+    ${stylesEntryPointContent}`);
+}
+exports.updateApplicationStyles = updateApplicationStyles;
+function findStylesEntryPoint(tree, options, project) {
+    // first check for common names
+    const possibleStylesEntryPoints = [
+        (0, devkit_1.joinPathFragments)(project.sourceRoot ?? project.root, 'styles.css'),
+        (0, devkit_1.joinPathFragments)(project.sourceRoot ?? project.root, 'styles.scss'),
+        (0, devkit_1.joinPathFragments)(project.sourceRoot ?? project.root, 'styles.sass'),
+        (0, devkit_1.joinPathFragments)(project.sourceRoot ?? project.root, 'styles.less'),
+    ];
+    let stylesEntryPoint = possibleStylesEntryPoints.find((s) => tree.exists(s));
+    if (stylesEntryPoint) {
+        return stylesEntryPoint;
+    }
+    // then check for the specified styles in the build configuration if it exists
+    const styles = project.targets?.[options.buildTarget].options?.styles;
+    if (!styles) {
+        return undefined;
+    }
+    // find the first style that belongs to the project source
+    const style = styles.find((s) => typeof s === 'string'
+        ? s.startsWith(project.root) && tree.exists(s)
+        : s.input.startsWith(project.root) &&
+            s.inject !== false &&
+            tree.exists(s.input));
+    if (!style) {
+        return undefined;
+    }
+    return typeof style === 'string' ? style : style.input;
+}

package/src/generators/setup-tailwind/schema.d.ts

@@ -0,0 +1,11 @@
+export interface GeneratorOptions {
+  project: string;
+  buildTarget?: string;
+  skipFormat?: boolean;
+  stylesEntryPoint?: string;
+  skipPackageJson?: boolean;
+}
+
+export interface NormalizedGeneratorOptions extends GeneratorOptions {
+  buildTarget: string;
+}

package/src/generators/setup-tailwind/schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "NxAngularTailwindSetupGenerator",
+  "cli": "nx",
+  "title": "Configures Tailwind CSS for an application or a buildable/publishable library.",
+  "description": "Adds the Tailwind CSS configuration files for a given Angular project and installs, if needed, the packages required for Tailwind CSS to work.",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the project to add the Tailwind CSS setup for.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What project would you like to add the Tailwind CSS setup?"
+    },
+    "buildTarget": {
+      "type": "string",
+      "description": "The name of the target used to build the project. This option only applies to buildable/publishable libraries.",
+      "default": "build"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skips formatting the workspace after the generator completes.",
+      "x-priority": "internal"
+    },
+    "stylesEntryPoint": {
+      "type": "string",
+      "description": "Path to the styles entry point relative to the workspace root. If not provided the generator will do its best to find it and it will error if it can't. This option only applies to applications."
+    },
+    "skipPackageJson": {
+      "type": "boolean",
+      "default": false,
+      "description": "Do not add dependencies to `package.json`.",
+      "x-priority": "internal"
+    }
+  },
+  "additionalProperties": false,
+  "required": ["project"],
+  "examplesFile": "../../../docs/setup-tailwind-examples.md"
+}

package/src/generators/setup-tailwind/setup-tailwind.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import { GeneratorOptions } from './schema';
+export declare function setupTailwindGenerator(tree: Tree, rawOptions: GeneratorOptions): Promise<GeneratorCallback>;
+export default setupTailwindGenerator;

package/src/generators/setup-tailwind/setup-tailwind.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupTailwindGenerator = void 0;
+const devkit_1 = require("@nx/devkit");
+const lib_1 = require("./lib");
+async function setupTailwindGenerator(tree, rawOptions) {
+    const options = (0, lib_1.normalizeOptions)(rawOptions);
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    const tailwindInstalledVersion = (0, lib_1.detectTailwindInstalledVersion)(tree);
+    let installTask = () => { };
+    if (!options.skipPackageJson) {
+        if (tailwindInstalledVersion === undefined) {
+            installTask = (0, lib_1.addTailwindRequiredPackages)(tree);
+        }
+    }
+    (0, lib_1.addTailwindConfig)(tree, options, project, tailwindInstalledVersion ?? '3');
+    if (project.projectType === 'application') {
+        (0, lib_1.updateApplicationStyles)(tree, options, project);
+    }
+    else if (project.projectType === 'library') {
+        (0, lib_1.addTailwindConfigPathToProject)(tree, options, project);
+    }
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return installTask;
+}
+exports.setupTailwindGenerator = setupTailwindGenerator;
+exports.default = setupTailwindGenerator;

package/src/generators/stories/lib/get-e2e-project.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectConfiguration, Tree } from '@nx/devkit';
+export declare function getE2EProject(tree: Tree, e2eProjectName: string): ProjectConfiguration;

package/src/generators/stories/lib/get-e2e-project.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getE2EProject = void 0;
+const devkit_1 = require("@nx/devkit");
+function getE2EProject(tree, e2eProjectName) {
+    let e2eProject;
+    try {
+        e2eProject = (0, devkit_1.readProjectConfiguration)(tree, e2eProjectName);
+    }
+    catch {
+        e2eProject = undefined;
+    }
+    return e2eProject;
+}
+exports.getE2EProject = getE2EProject;

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

@@ -0,0 +1,8 @@
+export interface StoriesGeneratorOptions {
+  name: string;
+  interactionTests?: boolean;
+  skipFormat?: boolean;
+  ignorePaths?: string[];
+  cypressProject?: string;
+  generateCypressSpecs?: boolean;
+}

package/src/generators/stories/schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "NxAngularStorybookStoriesGenerator",
+  "title": "Create Storybook stories/specs",
+  "description": "Creates Storybook stories/specs for all Angular components declared in a project.",
+  "cli": "nx",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "aliases": ["project", "projectName"],
+      "description": "Project for which to generate stories.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What's the name of the project for which you want to generate stories?",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "interactionTests": {
+      "type": "boolean",
+      "description": "Set up Storybook interaction tests.",
+      "x-prompt": "Do you want to set up Storybook interaction tests?",
+      "x-priority": "important",
+      "default": true
+    },
+    "generateCypressSpecs": {
+      "type": "boolean",
+      "description": "Specifies whether to automatically generate `*.spec.ts` files in the Cypress e2e app generated by the `cypress-configure` generator."
+    },
+    "cypressProject": {
+      "type": "string",
+      "description": "The Cypress project to generate the stories under. This is inferred from `name` by default."
+    },
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    },
+    "ignorePaths": {
+      "type": "array",
+      "description": "Paths to ignore when looking for components.",
+      "items": {
+        "type": "string",
+        "description": "Path to ignore."
+      },
+      "default": [
+        "*.stories.ts,*.stories.tsx,*.stories.js,*.stories.jsx,*.stories.mdx"
+      ],
+      "examples": [
+        "apps/my-app/src/not-stories/**",
+        "**/**/src/**/not-stories/**",
+        "libs/my-lib/**/*.something.ts",
+        "**/**/src/**/*.other.*",
+        "libs/my-lib/src/not-stories/**,**/**/src/**/*.other.*,apps/my-app/**/*.something.ts"
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "required": ["name"],
+  "examplesFile": "../../../docs/stories-examples.md"
+}

package/src/generators/stories/stories.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { StoriesGeneratorOptions } from './schema';
+export declare function angularStoriesGenerator(tree: Tree, options: StoriesGeneratorOptions): Promise<GeneratorCallback>;
+export default angularStoriesGenerator;

package/src/generators/stories/stories.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularStoriesGenerator = void 0;
+const devkit_1 = require("@nx/devkit");
+const component_cypress_spec_1 = require("../component-cypress-spec/component-cypress-spec");
+const component_story_1 = require("../component-story/component-story");
+const component_info_1 = require("../utils/storybook-ast/component-info");
+const entry_point_1 = require("../utils/storybook-ast/entry-point");
+const get_e2e_project_1 = require("./lib/get-e2e-project");
+const module_info_1 = require("../utils/storybook-ast/module-info");
+const minimatch_1 = require("minimatch");
+const versions_1 = require("../../utils/versions");
+async function angularStoriesGenerator(tree, options) {
+    const e2eProjectName = options.cypressProject ?? `${options.name}-e2e`;
+    const e2eProject = (0, get_e2e_project_1.getE2EProject)(tree, e2eProjectName);
+    const entryPoints = (0, entry_point_1.getProjectEntryPoints)(tree, options.name);
+    const componentsInfo = [];
+    for (const entryPoint of entryPoints) {
+        const moduleFilePaths = (0, module_info_1.getModuleFilePaths)(tree, entryPoint);
+        componentsInfo.push(...(0, component_info_1.getComponentsInfo)(tree, entryPoint, moduleFilePaths, options.name), ...(0, component_info_1.getStandaloneComponentsInfo)(tree, entryPoint));
+    }
+    if (options.generateCypressSpecs && !e2eProject) {
+        devkit_1.logger.info(`There was no e2e project "${e2eProjectName}" found, so cypress specs will not be generated. Pass "--cypressProject" to specify a different e2e project name.`);
+    }
+    const componentInfos = componentsInfo.filter((f) => !options.ignorePaths?.some((pattern) => {
+        const shouldIgnorePath = (0, minimatch_1.minimatch)((0, devkit_1.joinPathFragments)(f.moduleFolderPath, f.path, `${f.componentFileName}.ts`), pattern);
+        return shouldIgnorePath;
+    }));
+    for (const info of componentInfos) {
+        if (info === undefined) {
+            continue;
+        }
+        await (0, component_story_1.default)(tree, {
+            projectPath: info.moduleFolderPath,
+            componentName: info.name,
+            componentPath: info.path,
+            componentFileName: info.componentFileName,
+            interactionTests: options.interactionTests ?? true,
+            skipFormat: true,
+        });
+        if (options.generateCypressSpecs && e2eProject) {
+            await (0, component_cypress_spec_1.default)(tree, {
+                projectName: options.name,
+                projectPath: info.moduleFolderPath,
+                cypressProject: options.cypressProject,
+                componentName: info.name,
+                componentPath: info.path,
+                componentFileName: info.componentFileName,
+                specDirectory: (0, devkit_1.joinPathFragments)(info.entryPointName, info.path),
+                skipFormat: true,
+            });
+        }
+    }
+    const tasks = [];
+    if (options.interactionTests) {
+        const { interactionTestsDependencies, addInteractionsInAddons } = (0, devkit_1.ensurePackage)('@nx/storybook', versions_1.nxVersion);
+        const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, options.name);
+        addInteractionsInAddons(tree, projectConfiguration);
+        tasks.push((0, devkit_1.addDependenciesToPackageJson)(tree, {}, interactionTestsDependencies()));
+    }
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return (0, devkit_1.runTasksInSerial)(...tasks);
+}
+exports.angularStoriesGenerator = angularStoriesGenerator;
+exports.default = angularStoriesGenerator;

package/src/generators/storybook-configuration/lib/assert-compatible-storybook-version.d.ts

@@ -0,0 +1 @@
+export declare function assertCompatibleStorybookVersion(): void;

package/src/generators/storybook-configuration/lib/assert-compatible-storybook-version.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertCompatibleStorybookVersion = void 0;
+const semver_1 = require("semver");
+function assertCompatibleStorybookVersion() {
+    let storybookVersion;
+    try {
+        storybookVersion = require(require.resolve('@storybook/angular/package.json')).version;
+    }
+    catch { }
+    if (storybookVersion && (0, semver_1.lt)(storybookVersion, '6.4.0-rc.1')) {
+        throw new Error('Incompatible Storybook Version: Please use a version of @storybook/angular higher than 6.4.0-rc.1');
+    }
+}
+exports.assertCompatibleStorybookVersion = assertCompatibleStorybookVersion;

package/src/generators/storybook-configuration/lib/generate-stories.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from '@nx/devkit';
+import type { StorybookConfigurationOptions } from '../schema';
+export declare function generateStories(tree: Tree, options: StorybookConfigurationOptions): Promise<void>;

package/src/generators/storybook-configuration/lib/generate-stories.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateStories = void 0;
+const devkit_1 = require("@nx/devkit");
+const versions_1 = require("../../../utils/versions");
+const stories_1 = require("../../stories/stories");
+async function generateStories(tree, options) {
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    (0, devkit_1.ensurePackage)('@nx/cypress', versions_1.nxVersion);
+    const { getE2eProjectName } = await Promise.resolve().then(() => require('@nx/cypress/src/utils/project-name'));
+    const e2eProjectName = getE2eProjectName(options.project, project.root, options.cypressDirectory);
+    await (0, stories_1.angularStoriesGenerator)(tree, {
+        name: options.project,
+        generateCypressSpecs: options.configureCypress && options.generateCypressSpecs,
+        cypressProject: e2eProjectName,
+        ignorePaths: options.ignorePaths,
+        interactionTests: options.interactionTests,
+        skipFormat: true,
+    });
+}
+exports.generateStories = generateStories;

package/src/generators/storybook-configuration/lib/generate-storybook-configuration.d.ts

@@ -0,0 +1,3 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { StorybookConfigurationOptions } from '../schema';
+export declare function generateStorybookConfiguration(tree: Tree, options: StorybookConfigurationOptions): Promise<GeneratorCallback>;

package/src/generators/storybook-configuration/lib/generate-storybook-configuration.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateStorybookConfiguration = void 0;
+const devkit_1 = require("@nx/devkit");
+const versions_1 = require("../../../utils/versions");
+async function generateStorybookConfiguration(tree, options) {
+    const { configurationGenerator } = (0, devkit_1.ensurePackage)('@nx/storybook', versions_1.nxVersion);
+    return await configurationGenerator(tree, {
+        project: options.project,
+        uiFramework: '@storybook/angular',
+        configureCypress: options.configureCypress,
+        linter: options.linter,
+        cypressDirectory: options.cypressDirectory,
+        tsConfiguration: options.tsConfiguration,
+        interactionTests: options.interactionTests,
+        configureStaticServe: options.configureStaticServe,
+        skipFormat: true,
+        addPlugin: false,
+        addExplicitTargets: true,
+    });
+}
+exports.generateStorybookConfiguration = generateStorybookConfiguration;

package/src/generators/storybook-configuration/lib/validate-options.d.ts

@@ -0,0 +1,2 @@
+import type { StorybookConfigurationOptions } from '../schema';
+export declare function validateOptions(options: StorybookConfigurationOptions): void;

package/src/generators/storybook-configuration/lib/validate-options.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = void 0;
+function validateOptions(options) {
+    if (options.generateCypressSpecs && !options.generateStories) {
+        throw new Error('Cannot set generateCypressSpecs to true when generateStories is set to false.');
+    }
+}
+exports.validateOptions = validateOptions;

package/src/generators/storybook-configuration/schema.d.ts

@@ -0,0 +1,15 @@
+import type { Linter } from '@nx/eslint';
+
+export interface StorybookConfigurationOptions {
+  configureStaticServe?: boolean;
+  generateStories: boolean;
+  linter: Linter;
+  project: string;
+  tsConfiguration?: boolean;
+  skipFormat?: boolean;
+  ignorePaths?: string[];
+  interactionTests?: boolean;
+  configureCypress?: boolean;
+  generateCypressSpecs?: boolean;
+  cypressDirectory?: string;
+}

package/src/generators/storybook-configuration/schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "NxAngularStorybookConfigurationGenerator",
+  "title": "Adds Storybook configuration to a project.",
+  "description": "Adds Storybook configuration to a project to be able to use and create stories.",
+  "cli": "nx",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "aliases": ["name", "projectName"],
+      "description": "Project for which to generate Storybook configuration.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "For which project do you want to generate Storybook configuration?",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "interactionTests": {
+      "type": "boolean",
+      "description": "Set up Storybook interaction tests.",
+      "x-prompt": "Do you want to set up Storybook interaction tests?",
+      "alias": ["configureTestRunner"],
+      "x-priority": "important",
+      "default": true
+    },
+    "configureCypress": {
+      "type": "boolean",
+      "description": "Specifies whether to configure Cypress or not.",
+      "x-deprecated": "Use interactionTests instead. This option will be removed in v19."
+    },
+    "generateStories": {
+      "type": "boolean",
+      "description": "Specifies whether to automatically generate `*.stories.ts` files for components declared in this project or not.",
+      "x-prompt": "Automatically generate *.stories.ts files for components declared in this project?",
+      "default": true,
+      "x-priority": "important"
+    },
+    "generateCypressSpecs": {
+      "type": "boolean",
+      "description": "Specifies whether to automatically generate test files in the generated Cypress e2e app.",
+      "x-deprecated": "Use interactionTests instead. This option will be removed in v19."
+    },
+    "configureStaticServe": {
+      "type": "boolean",
+      "description": "Specifies whether to configure a static file server target for serving storybook. Helpful for speeding up CI build/test times.",
+      "x-prompt": "Configure a static file server for the storybook instance?",
+      "default": true,
+      "x-priority": "important"
+    },
+    "cypressDirectory": {
+      "type": "string",
+      "description": "A directory where the Cypress project will be placed. Placed at the root by default.",
+      "x-deprecated": "Use interactionTests instead. This option will be removed in v19."
+    },
+    "linter": {
+      "description": "The tool to use for running lint checks.",
+      "type": "string",
+      "enum": ["eslint", "none"],
+      "default": "eslint"
+    },
+    "tsConfiguration": {
+      "type": "boolean",
+      "description": "Configure your project with TypeScript. Generate main.ts and preview.ts files, instead of main.js and preview.js.",
+      "default": true,
+      "x-priority": "important"
+    },
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    },
+    "ignorePaths": {
+      "type": "array",
+      "description": "Paths to ignore when looking for components.",
+      "items": {
+        "type": "string",
+        "description": "Path to ignore."
+      },
+      "default": [
+        "*.stories.ts,*.stories.tsx,*.stories.js,*.stories.jsx,*.stories.mdx"
+      ],
+      "examples": [
+        "apps/my-app/src/not-stories/**",
+        "**/**/src/**/not-stories/**",
+        "libs/my-lib/**/*.something.ts",
+        "**/**/src/**/*.other.*",
+        "libs/my-lib/src/not-stories/**,**/**/src/**/*.other.*,apps/my-app/**/*.something.ts"
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "required": ["project"],
+  "examplesFile": "../../../docs/storybook-configuration-examples.md"
+}

package/src/generators/storybook-configuration/storybook-configuration.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { StorybookConfigurationOptions } from './schema';
+export declare function storybookConfigurationGenerator(tree: Tree, options: StorybookConfigurationOptions): Promise<GeneratorCallback>;
+export default storybookConfigurationGenerator;

package/src/generators/storybook-configuration/storybook-configuration.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storybookConfigurationGenerator = void 0;
+const devkit_1 = require("@nx/devkit");
+const update_app_editor_tsconfig_excluded_files_1 = require("../utils/update-app-editor-tsconfig-excluded-files");
+const assert_compatible_storybook_version_1 = require("./lib/assert-compatible-storybook-version");
+const generate_stories_1 = require("./lib/generate-stories");
+const generate_storybook_configuration_1 = require("./lib/generate-storybook-configuration");
+const validate_options_1 = require("./lib/validate-options");
+// TODO(katerina): Nx 19 -> remove Cypress
+async function storybookConfigurationGenerator(tree, options) {
+    (0, assert_compatible_storybook_version_1.assertCompatibleStorybookVersion)();
+    (0, validate_options_1.validateOptions)(options);
+    const storybookGeneratorInstallTask = await (0, generate_storybook_configuration_1.generateStorybookConfiguration)(tree, {
+        ...options,
+        interactionTests: options.interactionTests ?? true, // default is true
+        tsConfiguration: options.tsConfiguration ?? true, // default is true
+    });
+    if (options.generateStories) {
+        await (0, generate_stories_1.generateStories)(tree, {
+            ...options,
+            interactionTests: options.interactionTests ?? true,
+            skipFormat: true,
+        });
+    }
+    const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
+    if (project.projectType === 'application') {
+        (0, update_app_editor_tsconfig_excluded_files_1.updateAppEditorTsConfigExcludedFiles)(tree, project);
+    }
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return storybookGeneratorInstallTask;
+}
+exports.storybookConfigurationGenerator = storybookConfigurationGenerator;
+exports.default = storybookConfigurationGenerator;