@ng-zen/cli 19.0.0-alpha.4 → 19.1.0-next.1

package/.commitlintrc

@@ -0,0 +1,3 @@
+{
+  "extends": ["@commitlint/config-conventional"]
+}

package/.editorconfig

@@ -0,0 +1,17 @@
+# Editor configuration, see https://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.ts]
+quote_type = single
+ij_typescript_use_double_quotes = false
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

package/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    target-branch: develop
+    schedule:
+      interval: "weekly"
+      day: sunday
+  - package-ecosystem: "github-actions"
+    target-branch: develop
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: sunday
+
+
+
+

package/.github/workflows/ci.yml

@@ -0,0 +1,112 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [master, develop, next]
+
+env:
+  NODE_VERSION: 22
+  RETENTION_DAYS: 30
+
+jobs:
+  install:
+    runs-on: ubuntu-latest
+    outputs:
+      cache-key: ${{ steps.cache-key.outputs.cache-key }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Enable Corepack
+        run: corepack enable
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+      - id: cache-key
+        run: |
+          CACHE_KEY="${{ runner.os }}-node-${{ env.NODE_VERSION }}-pnpm-cache-$(sha256sum pnpm-lock.yaml | cut -d' ' -f1)"
+          echo "cache-key=$CACHE_KEY" >> $GITHUB_OUTPUT
+      - uses: actions/cache@v4
+        id: pnpm-cache
+        with:
+          path: |
+            node_modules
+            ~/.pnpm-store
+          key: ${{ steps.cache-key.outputs.cache-key }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ env.NODE_VERSION }}-pnpm-cache-
+      - run: pnpm install --frozen-lockfile
+
+  lint:
+    needs: install
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Enable Corepack
+        run: corepack enable
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - uses: actions/cache@v4
+        with:
+          path: |
+            node_modules
+            ~/.pnpm-store
+          key: ${{ needs.install.outputs.cache-key }}
+      - run: pnpm run lint
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: lint-report
+          path: lint-report/
+          retention-days: ${{ env.RETENTION_DAYS }}
+  test:
+    needs: install
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - uses: actions/cache@v4
+        with:
+          path: |
+            node_modules
+            ~/.pnpm-store
+          key: ${{ needs.install.outputs.cache-key }}
+      - run: pnpm run test
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: test-report
+          path: test-report/
+          retention-days: ${{ env.RETENTION_DAYS }}
+
+  build:
+    needs: [install, lint, test]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - uses: actions/cache@v4
+        with:
+          path: |
+            node_modules
+            ~/.pnpm-store
+          key: ${{ needs.install.outputs.cache-key }}
+      - run: pnpm run build
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: build-report
+          path: build-report/
+          retention-days: ${{ env.RETENTION_DAYS }}

package/.github/workflows/deploy.yml

@@ -0,0 +1,33 @@
+name: Deploy Storybook to github pages
+
+on:
+  push:
+    branches: ["master"]
+  workflow_dispatch:
+
+env:
+  NODE_VERSION: 22
+  PNPM_VERSION: 10.0.0
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4 # Checkout your repository
+      - uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - id: build-publish
+        uses: bitovi/github-actions-storybook-to-github-pages@v1.0.3
+        with:
+          install_command: pnpm install --frozen-lockfile
+          build_command: pnpm run storybook:build
+          path: dist/storybook

package/.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+      - next
+  workflow_dispatch:
+
+env:
+  NODE_VERSION: 22
+  PNPM_VERSION: 10.0.0
+
+jobs:
+  release:
+    name: Build, Test and Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: ${{ env.PNPM_VERSION }}
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+      - name: Get pnpm cache directory
+        id: pnpm-cache-dir
+        shell: bash
+        run: echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_OUTPUT
+      - name: Generate cache key
+        id: cache-key
+        shell: bash
+        run: |
+          echo "key=node-v${{ env.NODE_VERSION }}-pnpm-v${{ env.PNPM_VERSION }}-lock-${{ hashFiles('**/pnpm-lock.yaml') }}" >> $GITHUB_OUTPUT
+          echo "restore_key=node-v${{ env.NODE_VERSION }}-pnpm-v${{ env.PNPM_VERSION }}-lock-" >> $GITHUB_OUTPUT
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache-dir.outputs.STORE_PATH }}
+          key: ${{ steps.cache-key.outputs.key }}
+          restore-keys: ${{ steps.cache-key.outputs.restore_key }}
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Run linter
+        run: pnpm run lint
+      - name: Run tests
+        run: pnpm run test
+      - name: Build project
+        run: pnpm run build
+      - name: Run semantic-release
+        run: pnpm run semantic-release --debug
+        env:
+          HUSKY: 0
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.husky/commit-msg

@@ -0,0 +1 @@
+commitlint --edit ${1}

package/.husky/pre-commit

@@ -0,0 +1 @@
+nano-staged

package/.nanostagedrc

@@ -0,0 +1,5 @@
+{
+  "*.{ts,html}": ["eslint --fix"],
+  "*.{js,cjs,mjs,ts,mts,css,scss,html,json,md}": "prettier --write",
+  "*.{scss,css}": ["stylelint --fix"]
+}

package/.prettierignore

@@ -0,0 +1,3 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage

package/.prettierrc

@@ -0,0 +1,23 @@
+{
+  "plugins": [
+    "prettier-plugin-organize-attributes"
+  ],
+  "tabWidth": 2,
+  "useTabs": false,
+  "singleQuote": true,
+  "semi": true,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "trailingComma": "es5",
+  "bracketSameLine": false,
+  "htmlWhitespaceSensitivity": "ignore",
+  "printWidth": 120,
+  "endOfLine": "auto",
+  "attributeGroups": [
+    "$ANGULAR_STRUCTURAL_DIRECTIVE",
+    "$ANGULAR_INPUT",
+    "$ANGULAR_OUTPUT",
+    "$ANGULAR_TWO_WAY_BINDING"
+  ],
+  "attributeSort": "ASC"
+}

package/.releaserc.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json.schemastore.org/semantic-release",
+  "branches": [
+    "master",
+    {
+      "name": "next",
+      "prerelease": true
+    }
+  ],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "preset": "conventionalcommits",
+        "presetConfig": {
+          "types": [
+            { "type": "feat", "section": "🚀 New Features", "hidden": false },
+            { "type": "fix", "section": "🐛 Bug Fixes", "hidden": false },
+            { "type": "perf", "section": "⚡️ Performance Improvements", "hidden": false },
+            { "type": "build", "section": "🏗️ Build Changes", "hidden": false },
+            { "type": "ci", "section": "🔄 Continuous Integration", "hidden": false },
+            { "type": "refactor", "section": "🛠️ Code Refactor", "hidden": false },
+            { "type": "test", "section": "✅ Tests", "hidden": false },
+            { "type": "chore", "section": "🧹 Chore", "hidden": true },
+            { "type": "docs", "section": "📚 Documentation", "hidden": false },
+            { "type": "style", "section": "🎨 Style", "hidden": true }
+          ]
+        }
+      }
+    ],
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "preset": "conventionalcommits",
+        "presetConfig": {
+          "types": [
+            { "type": "feat", "section": "🚀 New Features" },
+            { "type": "fix", "section": "🐛 Bug Fixes" },
+            { "type": "perf", "section": "⚡️ Performance Improvements" },
+            { "type": "build", "section": "🏗️ Build Changes" },
+            { "type": "ci", "section": "🔄 Continuous Integration" },
+            { "type": "refactor", "section": "🛠️ Code Refactor" },
+            { "type": "test", "section": "✅ Tests" },
+            { "type": "chore", "section": "🧹 Chore" },
+            { "type": "docs", "section": "📚 Documentation" },
+            { "type": "style", "section": "🎨 Style" }
+          ]
+        }
+      }
+    ],
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    "@semantic-release/npm",
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["package.json", "CHANGELOG.md", "pnpm-lock.yaml"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    "@semantic-release/github"
+  ]
+}

package/.storybook/main.ts

@@ -0,0 +1,17 @@
+import type { StorybookConfig } from '@storybook/angular';
+
+const config: StorybookConfig = {
+  stories: ['./stories/**/*.@(js|jsx|ts|tsx|mdx)', '../src/schematics/**/*.stories.@(ts)'],
+  addons: [
+    '@storybook/addon-links',
+    '@storybook/addon-essentials',
+    '@chromatic-com/storybook',
+    '@storybook/addon-interactions',
+  ],
+  framework: '@storybook/angular',
+  docs: {
+    autodocs: true,
+    defaultName: 'Docs',
+  },
+};
+export default config;

package/.storybook/preview.ts

@@ -0,0 +1,13 @@
+import { setCompodocJson } from '@storybook/addon-docs/angular';
+import type { Preview } from '@storybook/angular';
+
+import docJson from '../documentation/documentation.json';
+setCompodocJson(docJson);
+
+const preview: Preview = {
+  parameters: {
+    layout: 'centered',
+  },
+};
+
+export default preview;

package/.storybook/stories/pages/1 Welcome.mdx

@@ -0,0 +1,9 @@
+import ReadMe from '../../../README.md?raw';
+
+import { Markdown } from '@storybook/blocks';
+
+import { Meta } from '@storybook/blocks';
+
+<Meta title="Welcome" />
+
+<Markdown>{ReadMe}</Markdown>

package/.storybook/stories/pages/2 License.mdx

@@ -0,0 +1,9 @@
+import License from '../../../LICENSE?raw';
+
+import { Markdown } from '@storybook/blocks';
+
+import { Meta } from '@storybook/blocks';
+
+<Meta title="License - BSD-2-Clause" />
+
+<Markdown>{License}</Markdown>

package/.storybook/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.lib.json",
+  "compilerOptions": {
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true
+  },
+  "exclude": ["../**/*.spec.ts"],
+  "include": ["./preview.ts", "../src/**/*.stories.*", "../src/files/**/*.ts"],
+  "files": ["./typings.d.ts"]
+}

package/.storybook/typings.d.ts

@@ -0,0 +1,4 @@
+declare module '*.md' {
+  const content: string;
+  export default content;
+}

package/.stylelintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["stylelint-config-standard-scss"]
+}

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+## [19.1.0-next.1](https://github.com/kstepien3/ng-zen/compare/v19.0.0...v19.1.0-next.1) (2025-04-06)
+
+### 🚀 New Features
+
+* **switch:** add missing css variables ([0481ac7](https://github.com/kstepien3/ng-zen/commit/0481ac7d735eba4ee47fbc6a69cdee643f5b9b4c))
+
+### 🧹 Chore
+
+* add conventional-changelog-conventionalcommits dependency ([c6d2342](https://github.com/kstepien3/ng-zen/commit/c6d23422c5866645b520f55dc3c10700fc268d06))
+* change version alpha -> next ([aa5482c](https://github.com/kstepien3/ng-zen/commit/aa5482cd504a89e60eae07f6a3ea343ca8886e57))
+* change version to v19.0.0-next.0 [skip ci] ([7ee3dbd](https://github.com/kstepien3/ng-zen/commit/7ee3dbd6d22a3d24c85fba0978c127f28c9248d4))
+* fix problems with release ([a54af7a](https://github.com/kstepien3/ng-zen/commit/a54af7aa33259bb904df707f8450b39a1f8e00c9))

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,30 @@
+# Code of Conduct
+
+The @ng-zen/cli project is committed to fostering an open and welcoming environment for all contributors and users. This Code of Conduct outlines the expectations for behavior within our community.
+
+## Our Pledge
+
+We pledge to make participation in our project and community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+- **Be Respectful**: Treat others with respect and kindness, even when disagreeing.
+- **Be Considerate**: Be mindful of the impact of your words and actions on others.
+- **Be Open**: Be open to different perspectives and experiences.
+- **Be Constructive**: Focus on constructive feedback and suggestions.
+
+## Unacceptable Behavior
+
+- **Harassment**: Unwelcome comments or actions, including but not limited to those related to race, gender, or sexual orientation.
+- **Spamming**: Posting irrelevant or repetitive content.
+- **Trolling**: Posting inflammatory or off-topic messages.
+
+## Reporting Incidents
+
+If you experience or witness any unacceptable behavior, please report it to the project maintainers via email at kord.stp@gmail.com.
+
+## Enforcement
+
+The project maintainers are responsible for clarifying and enforcing our standards of acceptable behavior. They will take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+By participating in this project, you agree to abide by this Code of Conduct in all interactions related to the project.

package/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing to @ng-zen/cli
+
+Thank you for considering contributing to **@ng-zen/cli**! This project is maintained by Konrad Stępień and is open to contributions from the community.
+
+## How to Contribute
+
+1. **Fork the Repository**: Create a fork of the [ng-zen repository](https://github.com/Kordrad/ng-zen) on GitHub.
+2. **Create a Feature Branch**: Create a new branch for your feature or bug fix. Use a descriptive name for the branch, such as `feature/new-component` or `fix/documentation`.
+3. **Make Your Changes**: Implement your feature or fix. Ensure that your code adheres to the project's coding standards and best practices.
+4. **Write Tests**: If applicable, add unit tests or integration tests to cover your changes.
+5. **Submit a Pull Request**: Push your changes to your fork and submit a pull request to the main repository. Include a detailed description of your changes.
+
+## Contribution Guidelines
+
+- **Code Quality**: Ensure that your code is well-formatted, readable, and follows Angular best practices.
+- **Documentation**: Update documentation if necessary. Use JSDoc for code comments and ensure that Storybook examples are updated.
+- **Testing**: Include tests for new functionality or bug fixes.
+- **Commit Messages**: Use meaningful commit messages that follow the conventional commit format.
+
+## Communication
+
+- **Issues**: If you encounter any issues or have questions, feel free to open an issue on GitHub.
+- **Pull Request Reviews**: Be prepared to address feedback from maintainers during the review process.
+
+## Acknowledgments
+
+Your contributions are invaluable to the growth and success of **@ng-zen/cli**. Thank you for your time and effort!

package/DEVELOPMENT.md

@@ -0,0 +1,80 @@
+# Local Development Setup
+
+This guide will help you set up a local development environment for **@ng-zen/cli**.
+
+## Prerequisites
+
+- Node.js (preferably the latest LTS version)
+- pnpm
+- Angular CLI installed globally
+- verdaccio
+
+## Working with Storybook
+
+**Storybook** is the primary tool for developing and testing UI components. To start Storybook, run:
+
+```bash
+pnpm run storybook
+```
+
+This command will launch Storybook in your default browser, allowing you to interact with and test the components visually.
+
+### Building Storybook
+
+To build a static version of Storybook for deployment, testing or release, use:
+
+```bash
+pnpm run storybook:build
+```
+
+## Setting Up Verdaccio
+
+1. **Install Verdaccio**:
+   Follow the instructions on the [Verdaccio website](https://verdaccio.org/docs/installation#installing-the-cli) to install Verdaccio.
+
+2. **Start Local Registry**:
+   Run the following command to start the local registry:
+
+   ```bash
+   pnpm run verdaccio
+   ```
+
+3. **Configure npm to Use Local Registry**:
+   Follow the prompts from Verdaccio to configure npm to use the local registry.
+
+## Publishing Locally
+
+1. **Publish Package Locally**:
+   Use the following command to publish the package to your local registry:
+   ```bash
+   pnpm run publish:local
+   ```
+2. **Test in Angular Project**:
+   Add the package to an Angular project using the local registry:
+   ```bash
+   ng add @ng-zen/cli --registry http://localhost:4873/
+   ```
+
+## Running Tests
+
+- **Unit Tests**: Run unit tests using the command:
+  ```bash
+  pnpm run test
+  ```
+- **Linting**: Check code style and fix issues with:
+  ```bash
+  pnpm run lint
+  pnpm run lint:fix
+  ```
+
+## Building and Packaging
+
+**Build** the project using:
+
+```bash
+pnpm run build
+```
+
+---
+
+By following these steps, you should be able to set up a fully functional local development environment for **@ng-zen/cli**.