@ng-zen/cli 19.0.0-alpha.5 → 19.1.0

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 README.mdx

@@ -0,0 +1,9 @@
+import ReadMe from '../../../README.md?raw';
+
+import { Markdown } from '@storybook/blocks';
+
+import { Meta } from '@storybook/blocks';
+
+<Meta title="README" />
+
+<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/stories/pages/3 CHANGELOG.mdx

@@ -0,0 +1,9 @@
+import CHANGELOG from '../../../CHANGELOG.md?raw';
+
+import { Markdown } from '@storybook/blocks';
+
+import { Meta } from '@storybook/blocks';
+
+<Meta title="CHANGELOG" />
+
+<Markdown>{CHANGELOG}</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,40 @@
+## [19.1.0](https://github.com/kstepien3/ng-zen/compare/v19.0.0...v19.1.0) (2025-04-27)
+
+### 🚀 New Features
+
+* **switch:** add missing css variables ([0481ac7](https://github.com/kstepien3/ng-zen/commit/0481ac7d735eba4ee47fbc6a69cdee643f5b9b4c))
+
+### 🏗️ Build Changes
+
+* **deps-dev:** bump @angular-devkit/architect from 0.1902.6 to 0.1902.9 ([#160](https://github.com/kstepien3/ng-zen/issues/160)) ([e8fa092](https://github.com/kstepien3/ng-zen/commit/e8fa092e8aefcd15f4fb5755e150b2834d359fb4))
+* **deps-dev:** bump angular-eslint from 19.0.2 to 19.3.0 ([#136](https://github.com/kstepien3/ng-zen/issues/136)) ([ccad1a9](https://github.com/kstepien3/ng-zen/commit/ccad1a903bbd8edf37571f764dded81ea5fe29aa))
+* **deps-dev:** bump eslint-plugin-storybook from 0.11.6 to 0.12.0 ([#137](https://github.com/kstepien3/ng-zen/issues/137)) ([e8d63f3](https://github.com/kstepien3/ng-zen/commit/e8d63f3ec9d7f0af1a4cb7e2ceb3ff2843af43ad))
+* **deps-dev:** bump typescript-eslint from 8.24.0 to 8.29.0 ([#135](https://github.com/kstepien3/ng-zen/issues/135)) ([89d371f](https://github.com/kstepien3/ng-zen/commit/89d371f73f711848c548c32e8c1d5201f80c3073))
+
+### 🧹 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))
+* **release:** 19.1.0-next.1 [skip ci] ([7ca3b5c](https://github.com/kstepien3/ng-zen/commit/7ca3b5c989121b41c95c261236b5c89409c83210))
+
+### 📚 Documentation
+
+* **readme.md:** update links in badges ([#146](https://github.com/kstepien3/ng-zen/issues/146)) ([667f71c](https://github.com/kstepien3/ng-zen/commit/667f71c3891764f12d7b025e4b0c7e9ea872d00b))
+* **README:** improve documentation ([#149](https://github.com/kstepien3/ng-zen/issues/149)) ([bbbfd4e](https://github.com/kstepien3/ng-zen/commit/bbbfd4e592907c6c544e9004d104842df5475fab))
+* **storybook:** load CHANGELOG.md ([#145](https://github.com/kstepien3/ng-zen/issues/145)) ([f7df739](https://github.com/kstepien3/ng-zen/commit/f7df739ba88d4ffc1a63dea6bdec2bb3112933d0))
+* update development information ([#148](https://github.com/kstepien3/ng-zen/issues/148)) ([981a998](https://github.com/kstepien3/ng-zen/commit/981a9981385d22d763fe63bfcf075970bec4495d))
+
+## [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,54 @@
+# Contributing to @ng-zen/cli
+
+Thank you for your interest in contributing! This document outlines the essential steps and requirements for submitting contributions.
+
+**For detailed information on project setup, the full branching strategy, specific tool usage (Storybook, Verdaccio), and the reasoning behind our workflows, please refer to the [DEVELOPMENT.md](DEVELOPMENT.md) file.**
+
+## Key Requirements for Contributors
+
+1.  **Conventional Commits (Mandatory):** All commit messages **must** adhere to the Conventional Commits specification (https://www.conventionalcommits.org/). This is critical for automated releases. Invalid messages will block commits. See [Commit Messages](DEVELOPMENT.md#commit-messages-crucial) for details on commit types and their impact.
+2.  **Target Branch:** Pull Requests **must target the `develop` branch.** PRs targeting `master` or `next` directly will generally be closed unless specifically requested for hotfixes.
+3.  **Automated Checks:**
+
+- Code formatting and basic lint fixes are applied automatically on commit via `husky` and `nano-staged`.
+- Full CI checks (linting, testing, building) run automatically on Pull Requests via GitHub Actions (`ci.yml`). **Your PR must pass all CI checks to be eligible for merging.**
+
+## Contribution Steps
+
+1.  **Fork & Clone:** Fork the [ng-zen repository](https://github.com/kstepien3/ng-zen) and clone your fork locally. _(See [Prerequisites & Setup](DEVELOPMENT.md#prerequisites--setup) if needed)_.
+2.  **Sync `develop`:** Ensure your local `develop` branch is up-to-date:
+    ```bash
+    git switch develop
+    git pull origin develop
+    ```
+3.  **Create Branch:** Create your working branch **from `develop`**:
+    ```bash
+    # Use format: <type>/<short-description>
+    git switch -c feat/add-hover-effect develop
+    ```
+4.  **Develop:** Implement your code changes. Remember to add or update relevant unit tests (`*.spec.ts`) and documentation/Storybook stories (`*.stories.ts`, etc.) as necessary. _(See [Working with Storybook](DEVELOPMENT.md#working-with-storybook) section for more details)_.
+5.  **Commit:** Commit your work using **Conventional Commit** messages.
+    ```bash
+    git add .
+    git commit -m "feat(button): add configurable hover effect"
+    ```
+6.  **Verify Locally:** Before pushing, ensure all local checks pass:
+    ```bash
+    pnpm run lint
+    pnpm run test
+    ```
+    _(See [Running Tests and Linting](DEVELOPMENT.md#running-tests-and-linting) for details on these commands)_.
+7.  **Push:** Push your branch to your fork: `git push origin feat/add-hover-effect`
+8.  **Create Pull Request:** Open a Pull Request on GitHub from **your branch** to the **`kstepien3/ng-zen:develop`** branch. Provide a clear title and description.
+
+## After Your PR is Submitted
+
+- Wait for the automated CI checks to complete. Address any failures.
+- Respond to code review comments and feedback from maintainers.
+- Once approved and CI passes, a maintainer will merge your PR into `develop`. Your changes will then be included in future pre-releases (from `next`) and stable releases (from `master`).
+
+## Communication
+
+- Use [GitHub Issues](https://github.com/kstepien3/ng-zen/issues) for bug reports, feature proposals, or questions _before_ starting significant work.
+
+Thank you for contributing to **@ng-zen/cli**