wexample-wex-addon-dev-javascript 8.0.0__py3-none-any.whl → 8.1.1__py3-none-any.whl

wexample_wex_addon_dev_javascript/config_value/javascript_package_readme_config_value.py

@@ -10,5 +10,8 @@ from wexample_wex_addon_app.config_value.app_readme_config_value import (
 class JavascriptPackageReadmeContentConfigValue(AppReadmeConfigValue):
     """README generation for Javascript packages."""
 
-    def _get_app_description(self) -> str:
-        return self.workdir.get_app_config().get("description", "")
+    def _get_app_description(self) -> str | None:
+        return (
+            self.workdir.get_app_config().get("description")
+            or super()._get_app_description()
+        )

wexample_wex_addon_dev_javascript/formatter/javascript_code_formatter.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, ClassVar
+
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_addon_ai.formatter.abstract_formatter import AbstractFormatter
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+@base_class
+class JavascriptCodeFormatter(AbstractFormatter):
+    """TypeScript and JavaScript shipped by an npm package, under its `src/`.
+
+    Covers both extensions because the packages are TypeScript sources published as
+    ESM, and a `.js` under `src/` is the same code with the types left out. Build
+    output, tests and config files answer elsewhere.
+    """
+
+    FORMATTER_NAME: ClassVar[str] = "javascript-code"
+    SOURCE_SUFFIXES: ClassVar[set[str]] = {".ts", ".tsx", ".js", ".jsx", ".mts", ".cts"}
+
+    def get_design_rules(self) -> str:
+        return self.read_resource("design_rules", "javascript_code.md")
+
+    def get_writing_rules(self) -> str:
+        return self.read_resource("writing_rules", "javascript_code.md")
+
+    def matches_path(self, path: Path) -> bool:
+        """A source file under the `src/` of a directory holding a `package.json`.
+
+        `node_modules` is excluded outright: every dependency in it carries its own
+        `package.json` and would otherwise match exactly like the package that
+        installed it.
+        """
+        if path.suffix not in self.SOURCE_SUFFIXES or "node_modules" in path.parts:
+            return False
+
+        for parent in path.parents:
+            if parent.name == "src" and (parent.parent / "package.json").exists():
+                return True
+        return False

wexample_wex_addon_dev_javascript/javascript_addon_manager.py

@@ -1,7 +1,37 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
+from wexample_wex_addon_ai.formatter.formatter_contributing_addon_mixin import (
+    FormatterContributingAddonMixin,
+)
 from wexample_wex_core.common.abstract_addon_manager import AbstractAddonManager
 
+if TYPE_CHECKING:
+    from wexample_wex_addon_ai.formatter.abstract_formatter import AbstractFormatter
+
+
+class JavascriptAddonManager(FormatterContributingAddonMixin, AbstractAddonManager):
+    def get_formatter_classes(self) -> list[type[AbstractFormatter]]:
+        from wexample_wex_addon_dev_javascript.formatter.javascript_code_formatter import (
+            JavascriptCodeFormatter,
+        )
+
+        return [JavascriptCodeFormatter]
+
+    def get_workdir_types(self) -> dict[str, type]:
+        from wexample_wex_addon_dev_javascript.workdir.javascript_package_workdir import (
+            JavascriptPackageWorkdir,
+        )
+        from wexample_wex_addon_dev_javascript.workdir.javascript_packages_suite_workdir import (
+            JavascriptPackagesSuiteWorkdir,
+        )
+        from wexample_wex_addon_dev_javascript.workdir.javascript_workdir import (
+            JavascriptWorkdir,
+        )
 
-class JavascriptAddonManager(AbstractAddonManager):
-    pass
+        return {
+            "javascript": JavascriptWorkdir,
+            "javascript-package": JavascriptPackageWorkdir,
+            "javascript-packages-suite": JavascriptPackagesSuiteWorkdir,
+        }

wexample_wex_addon_dev_javascript/resources/design_rules/javascript_code.md

@@ -0,0 +1,17 @@
+This file is design rules for TypeScript shipped by an npm package, under its `src/`.
+Decide the layout below before opening an editor — by the time a file is being written,
+its path is already a decision made.
+
+- One class per file, one file per class, and the file name is the class name in
+  PascalCase — `Common/AsyncConstructor.ts` holds `AsyncConstructor` and nothing else.
+  The class is the file's `export default`.
+- Helper functions are grouped by the type they act on, one file per type, named after
+  it: `Helper/Array.ts`, `Helper/String.ts`, `Helper/Dom.ts`. They are named exports,
+  never a default, and each name is prefixed with the file's subject —
+  `arrayShallowCopy`, `stringToKebabCase`. The prefix is what makes the import readable
+  at the call site, where the file name is no longer visible.
+- Kinds live apart, each in its own directory under `src/`: classes in `Common/`, helper
+  functions in `Helper/`. A class dropped next to the helpers because it serves them is
+  the case to move.
+- No barrel files. Import from the module that defines the symbol, so that a consumer
+  bundling one helper does not pull the package in.

wexample_wex_addon_dev_javascript/resources/writing_rules/javascript_code.md

@@ -0,0 +1,26 @@
+This file is TypeScript shipped by an npm package, under its `src/`. The file's path is
+already decided by the time these rules apply — see
+`ai::design/rules --formatter javascript-code` for the layout decisions that come before
+it.
+
+- Code, names, comments and doc comments are in English, whatever language the
+  conversation is held in.
+- Relative imports carry the `.js` extension even though the source is `.ts` —
+  `import { functionIsType } from '../Helper/Function.js'`. The packages publish native
+  ESM, where the specifier is resolved as written at runtime and an extensionless path
+  has nothing to resolve.
+- The packages compile under `strict`, so every parameter and every return is typed, and
+  `any` is a decision to justify rather than a default. Prefer a generic that keeps the
+  caller's type (`<T>(array: T[]): T[]`) over widening to `unknown[]` and casting back.
+- A `try` is occasional and justified: it catches a failure somewhere that knows what to do
+  about it. Wrapping a call defensively, or writing a `catch` that swallows and a `finally`
+  that lets the failure pass, turns a bug into a wrong result reported nowhere. Let it
+  throw — a stack trace at the point of failure is worth more than a silent fallback
+  discovered three layers later.
+- Defensive code goes the same way: a guard against a state that cannot happen, a `typeof`
+  check on something the type already guarantees, a `?.` or `|| fallback` on a value that
+  is never missing. Validate at the boundary — user input, an external API, a parsed
+  payload — and trust what our own code hands you.
+- Comment only what the code cannot say: a constraint, an invariant, the reason a
+  surprising line is the way it is. A comment that no longer matches the code it
+  describes is deleted, not updated around.

wexample_wex_addon_dev_javascript/services/node/commands/service/refresh_lock.py

@@ -20,7 +20,8 @@ if TYPE_CHECKING:
 @option(
     name="npm_packages",
     type=str,
-    required=True,
+    required=False,
+    default="",
     description="Space-separated npm package names whose constraint changed in package.json",
 )
 @command(
@@ -38,7 +39,7 @@ if TYPE_CHECKING:
 def node__service__refresh_lock(
     context: ExecutionContext,
     service: AppService,
-    npm_packages: str,
+    npm_packages: str = "",
 ) -> None:
     """Generic javascript lock refresh, reusable by any service whose
     container runs the app's javascript toolchain.
@@ -47,6 +48,10 @@ def node__service__refresh_lock(
     Yarn classic has no lock-only mode, so node_modules is (re)installed
     along the way — harmless inside the app container.
     """
+    # The hook reaches every service, carrying only the manifests that moved.
+    if not npm_packages:
+        return
+
     script = f"""
 set -e
 cd {APP_DIR}

wexample_wex_addon_dev_javascript-8.1.1.dist-info/METADATA

@@ -0,0 +1,309 @@
+Metadata-Version: 2.1
+Name: wexample-wex-addon-dev-javascript
+Version: 8.1.1
+Summary: Extends wex with JavaScript support: enforces JS/TS project layout and symlinks local npm packages into node_modules
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: cattrs>=23.1.0
+Requires-Dist: wexample-api>=6.8.0
+Requires-Dist: wexample-filestate-javascript>=6.6.0
+Requires-Dist: wexample-wex-addon-ai>=14.0.0
+Requires-Dist: wexample-wex-addon-app>=31.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wex_addon_dev_javascript
+
+Version: 8.1.1
+
+`wex-addon-dev-javascript` extends wex for JavaScript and TypeScript developers: it enforces a standard project layout — requiring `package.json`, `tsconfig.json`, `.npmrc`, `src/`, `tests/`, and the corresponding `.gitignore` rules — and in local environments symlinks locally-developed npm packages directly into a running container's `node_modules/` so monorepo packages resolve without a registry publish cycle. It also contributes a `node` service and a `vite` service, each backed by Docker Compose, where the vite service patches `allowedHosts` in `vite.config.ts` for reverse-proxy use and the node service handles lockfile refresh, annotated-tag release, and registry polling for npm package suites managed through wex.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Tests](#tests)
+- [Architecture](#architecture)
+- [Integration in the Suite](#integration-in-the-suite)
+- [Dependencies](#dependencies)
+- [Versioning & Compatibility Policy](#versioning--compatibility-policy)
+- [License](#license)
+- [About us](#about-us)
+- [Known Limitations & Roadmap](#known-limitations--roadmap)
+- [Status & Compatibility](#status--compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Installation
+
+```bash
+pip install wexample-wex-addon-dev-javascript
+```
+
+Requires Python >=3.10.
+
+## Quickstart
+
+Install the package:
+
+```bash
+pip install wexample-wex-addon-dev-javascript
+```
+
+The public entry point is `JavascriptAddonManager`, defined in src/wexample_wex_addon_dev_javascript/javascript_addon_manager.py:
+
+```python
+from wexample_wex_addon_dev_javascript.javascript_addon_manager import JavascriptAddonManager
+```
+
+Pass it to the kernel's `setup()` call to register the JavaScript addon slot:
+
+```python
+from wexample_wex_core.common.kernel import Kernel
+
+kernel = Kernel()
+kernel.setup(addons=[JavascriptAddonManager])
+```
+
+After `setup()` returns, the kernel recognises three workdir types: `javascript`, `javascript-package`, and `javascript-packages-suite`. Any workdir resolved against a directory holding a `package.json` will be matched to the appropriate class.
+
+The addon also contributes four service commands to the `node` and `vite` namespaces. Wire locally-developed npm packages into a running container's `node_modules/` — replacing the registry copy with a live symlink — with:
+
+```bash
+wex node::service/install_local
+```
+
+Refresh the lockfile in the container after a `package.json` dependency change (the command detects whether the project uses npm, pnpm, or Yarn from whichever lockfile is present):
+
+```bash
+wex node::service/refresh_lock --npm_packages "@vendor/my-lib"
+```
+
+Patch `vite.config.ts` so the Vite dev server accepts requests from any host — required when the service runs behind a reverse proxy:
+
+```bash
+wex vite::service/install
+```
+
+Check whether the Vite dev server inside its container is responding:
+
+```bash
+wex vite::service/ready
+```
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Architecture
+
+The addon is a pure Python package that extends wex with JavaScript and TypeScript support. It has four layers: an addon manager that registers workdir types, a workdir hierarchy that enforces project layout and owns the release lifecycle, a file layer that controls what `package.json` and `tsconfig.json` contain when written to disk, and a service layer that contributes `node` and `vite` Docker service definitions with their commands.
+
+### Entry point
+
+src/wexample_wex_addon_dev_javascript/javascript_addon_manager.py is the only class the host kernel needs. It extends `AbstractAddonManager` and returns three workdir types from `get_workdir_types()`:
+
+| key | class |
+|---|---|
+| `javascript` | `JavascriptWorkdir` |
+| `javascript-package` | `JavascriptPackageWorkdir` |
+| `javascript-packages-suite` | `JavascriptPackagesSuiteWorkdir` |
+
+The kernel resolves a directory to the right class by matching that key against the workdir type declared in the project's wex config.
+
+### Workdir layer
+
+The three classes form a linear inheritance chain.
+
+#### `JavascriptWorkdir`
+
+src/wexample_wex_addon_dev_javascript/workdir/javascript_workdir.py is the base. It extends `CodeBaseWorkdir` (from `wexample-wex-addon-app`) and `WithAiWorkdirMixin`. Its `prepare_value()` declares the required filesystem layout that wex will enforce: `package.json`, `tsconfig.json`, `.npmrc`, a `src/` tree, a `tests/` tree, and `.gitignore` rules covering `node_modules/`, `dist/`, `build/`, `.npm`, and `.eslintcache`. JS/TS files under `src/` and `tests/` are captured by a `ChildrenFilterOption` that matches `*.js|jsx|ts|tsx` and applies the `BiomeOption` from `wexample-filestate-javascript`. The class also appends `JavascriptOptionsProvider` to the options chain and returns a `JavascriptPackageJsonFile` from `get_app_config_file()`.
+
+#### `JavascriptPackageWorkdir`
+
+src/wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py extends `JavascriptWorkdir` and adds everything a publishable npm package needs.
+
+**Naming.** `get_project_name()` returns `@{vendor}/{kebab-case-name}`, giving packages their scoped npm identity.
+
+**Layout addition.** `prepare_value()` appends `.github/workflows/publish.yml` to the enforced file tree. The content is read from the bundled resource src/wexample_wex_addon_dev_javascript/resources/package_publish.yml — a GitHub Actions workflow that publishes to npm on any `v*` tag push.
+
+**Release lifecycle.** `release()` runs three steps in order:
+1. `_refresh_lockfile()` — detects which lockfile is present (`package-lock.json`, `pnpm-lock.yaml`, or `yarn.lock`) and runs the matching lock-only refresh command on the host machine.
+2. `super().release()` — inherited bump, commit, and publish flow; `_publish()` overrides the publish step to create an annotated git tag (`v{version}`) and push it to the configured deployment remote, which triggers the CI workflow above.
+3. `_wait_for_registry()` — polls `NpmRegistryGateway.has_version()` every 30 s for up to 20 minutes before the suite loop advances to the next dependent package.
+
+**Version bump classification.** `_classify_version_bump()` inspects the git diff of `src/` since the last tag: no changes → minor bump; whitespace-only diff → minor; non-TypeScript files only → intermediate; any `.ts`/`.tsx` change → major.
+
+#### `JavascriptPackagesSuiteWorkdir`
+
+src/wexample_wex_addon_dev_javascript/workdir/javascript_packages_suite_workdir.py extends `FrameworkPackageSuiteWorkdir`. It discovers child packages by looking for directories inside `npm/` that contain a `package.json`, and resolves each child as a `JavascriptPackageWorkdir`.
+
+### File layer
+
+#### `NodePackageJsonFile`
+
+src/wexample_wex_addon_dev_javascript/file/node_package_json_file.py composes `AppDependenciesConfigFileMixin` with `JsonFile`. It exposes the dependency-manifest API (`add_dependency`, `add_dependency_from_string`, `get_dependencies_versions`) and reads `dependencies` plus `peerDependencies` as the set of declared runtime constraints. Any workdir that ships a `package.json` — including polyglot app manifests — can attach this class.
+
+#### `JavascriptPackageJsonFile`
+
+src/wexample_wex_addon_dev_javascript/file/javascript_package_json_file.py extends `NodePackageJsonFile`. Its `dumps()` stamps `name`, `version`, and `repository` from the parent workdir before delegating to the JSON serialiser. It also calls `_apply_default_publish_config()`, which sets `type: "module"`, ensures `publishConfig.access` defaults to `"public"`, and — when neither `exports` nor a `dist`-targeting `files` array is already present — injects a default `exports` map (`"./*": { types: "./dist/*.d.ts", default: "./dist/*.js" }`), a `files: ["dist"]` list, and a `typesVersions` block so consumers can import without transpiling sources.
+
+#### `JavascriptTsconfigJsonFile`
+
+src/wexample_wex_addon_dev_javascript/file/javascript_tsconfig_json_file.py extends `JsonFile`. Its `dumps()` fills in `compilerOptions` defaults (`target: ES2020`, `module: NodeNext`, `moduleResolution: NodeNext`, `rootDir: src`, `outDir: dist`, `declaration: true`, `declarationMap: true`, `sourceMap: true`, `strict: false`, `esModuleInterop: true`, `skipLibCheck: true`, `forceConsistentCasingInFileNames: true`) and sets `include: ["src"]`, `exclude: ["dist", "node_modules", "tests"]`. All defaults use `setdefault`, so anything already in the file is left untouched.
+
+### Service layer
+
+Two service namespaces ship as self-contained directories, each containing a `service.yml`, a `docker/docker-compose.yml`, and a `commands/service/` package.
+
+#### `vite` service
+
+Defined in src/wexample_wex_addon_dev_javascript/services/vite/service.yml. The container (`${APP_PROJECT_NAME}_vite`) runs `oven/bun:latest`, mounts the app path to `/app`, persists `node_modules` in a named volume `vite_node_modules`, and starts with `bun install --no-cache && bun run dev --host`. The exposed port is controlled by the `VITE_PORT` var (default `8080`), which the compose file also passes to `nginx-proxy` via `VIRTUAL_PORT`.
+
+src/wexample_wex_addon_dev_javascript/services/vite/app_service.py composes the base `AppService` with `AgentContributingServiceMixin`, which makes the AI agent declared in src/wexample_wex_addon_dev_javascript/services/vite/ai/agents/main/agent.yml discoverable by `wex talk`. The agent's system prompt lives in src/wexample_wex_addon_dev_javascript/services/vite/ai/agents/main/about-service.md.
+
+**`vite::service/install`** — src/wexample_wex_addon_dev_javascript/services/vite/commands/service/install.py patches `vite.config.ts` or `vite.config.js` to add `server: { allowedHosts: true }` inside `defineConfig`. It handles two shapes: a bare `defineConfig()` call and a `defineConfig({ ... })` block. The patch is idempotent (skips if `allowedHosts` is already present).
+
+**`vite::service/ready`** — src/wexample_wex_addon_dev_javascript/services/vite/commands/service/ready.py reads `app.project_name` from the runtime config, resolves the container name as `{project_name}_vite`, reads `VITE_PORT` from the service manifest vars, then runs `docker exec {container} bun -e "await fetch('http://localhost:{port}')"` and returns a `BooleanResponse`.
+
+#### `node` service
+
+Defined in src/wexample_wex_addon_dev_javascript/services/node/service.yml. The container (`${APP_PROJECT_NAME}_node`) runs `node:20-alpine`, mounts the app path to `/var/www/html`, and stays alive with `tail -f /dev/null` so subsequent `docker exec` calls can run inside it.
+
+**`node::service/install_local`** — src/wexample_wex_addon_dev_javascript/services/node/commands/service/install_local.py reads the `local_packages.javascript` key from the runtime config (a map of vendor names to package directories). It builds a shell script that first installs the full `node_modules` tree (using whichever of yarn, pnpm, or npm the project's lockfile identifies), then iterates every directory under `/var/www/javascript-dev/{vendor}/`, reads its `package.json` to get the `name` field, removes the corresponding entry from `node_modules/`, and replaces it with a symlink to the local source. The script runs inside the service container via `docker exec`.
+
+**`node::service/refresh_lock`** — src/wexample_wex_addon_dev_javascript/services/node/commands/service/refresh_lock.py accepts a `--npm_packages` option listing the changed packages (for logging), then runs a lockfile-only install inside the container: `yarn install` if `yarn.lock` is present, `pnpm install --lockfile-only` if `pnpm-lock.yaml`, or `npm install --package-lock-only` if `package-lock.json`.
+
+### Common utilities
+
+src/wexample_wex_addon_dev_javascript/common/npm_registry_gateway.py is a thin HTTP client over `AbstractGateway`. Its single public method `has_version(package, version)` fetches `/{encoded_package_name}` from the configured registry URL, parses the JSON manifest, and returns `True` if `version` appears in the `versions` map. It accepts an optional `token` for Bearer auth on private registries. `JavascriptPackageWorkdir._wait_for_registry()` calls it in a polling loop with a 30-second delay and a 40-attempt ceiling (20 minutes total).
+
+### Constants
+
+src/wexample_wex_addon_dev_javascript/const/tags.py declares `DomainTag` with three values — `domain:dev-server`, `domain:frontend`, `domain:service` — which the service commands attach via the `@command(tags=[...])` decorator. Tags govern how `wex talk` and automated agents filter and describe available commands.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- wexample-api: >=6.8.0
+- wexample-filestate-javascript: >=6.6.0
+- wexample-wex-addon-ai: >=14.0.0
+- wexample-wex-addon-app: >=31.0.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javascript/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
+- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-javascript](https://pypi.org/project/wexample-wex-addon-dev-javascript/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

{wexample_wex_addon_dev_javascript-8.0.0.dist-info → wexample_wex_addon_dev_javascript-8.1.1.dist-info}/RECORD

@@ -1,28 +1,32 @@
-wexample_wex_addon_dev_javascript-8.0.0.dist-info/METADATA,sha256=WTk4F7SPxL-uT9iZKYq_zTQ5MW9VfVjrnZ1xoAPG250,17232
-wexample_wex_addon_dev_javascript-8.0.0.dist-info/WHEEL,sha256=VP-D4TPS230sME9Z3vb3INXvo1yt0924YRm5AOsk_dE,90
-wexample_wex_addon_dev_javascript-8.0.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+wexample_wex_addon_dev_javascript-8.1.1.dist-info/METADATA,sha256=dRqpOZNuc8ztuJRMPSz-m5Uiid6YTmwrFXyc2Sn6oG4,18012
+wexample_wex_addon_dev_javascript-8.1.1.dist-info/WHEEL,sha256=VP-D4TPS230sME9Z3vb3INXvo1yt0924YRm5AOsk_dE,90
+wexample_wex_addon_dev_javascript-8.1.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
 wexample_wex_addon_dev_javascript/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/common/npm_registry_gateway.py,sha256=fdmsO6DZVvAQw1o3QmtjLBq0Dr1i_EAfnKvxQx5VdIw,1657
 wexample_wex_addon_dev_javascript/config_value/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-wexample_wex_addon_dev_javascript/config_value/javascript_package_readme_config_value.py,sha256=6r-4ZhTm39LvJxMhoq3-_RRKRv2KNKSqkCv8xbh8T7c,449
+wexample_wex_addon_dev_javascript/config_value/javascript_package_readme_config_value.py,sha256=FaYjL6A6Zv8sYnz4cWqD4DsrNO9EMYvSi1-8GCbmNvs,522
 wexample_wex_addon_dev_javascript/const/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/const/tags.py,sha256=qirMGuj7UqenempTZeQfJfMa_bC7mt-yLD_BkLnMnKE,307
 wexample_wex_addon_dev_javascript/file/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
 wexample_wex_addon_dev_javascript/file/javascript_package_json_file.py,sha256=yn1ltv3oBYNg1OvUytJ4PEzH8FSJS2KcIKK8y-cMrl4,2906
 wexample_wex_addon_dev_javascript/file/javascript_tsconfig_json_file.py,sha256=a2vfYgB7gbiIiGljU_QA6extFJPyNM6rlhhAS3YoeCs,1395
 wexample_wex_addon_dev_javascript/file/node_package_json_file.py,sha256=SC6Mh--avdxVfDYK_UBGb_LLR_Ivn8Gyc-c9VFy6sXc,2491
-wexample_wex_addon_dev_javascript/javascript_addon_manager.py,sha256=Sjr0CEtNtF3211j1lMtg-pw56zd6unCGNIY7nScddpI,180
+wexample_wex_addon_dev_javascript/formatter/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wexample_wex_addon_dev_javascript/formatter/javascript_code_formatter.py,sha256=6TLrynxXH-P0kHiW6FmgROA8fG2Ik03Pn4JV9dctDuE,1618
+wexample_wex_addon_dev_javascript/javascript_addon_manager.py,sha256=zateyPGxtR4eOdjstfLI6MfTagEOWAAeb2CZqF_qMVo,1387
 wexample_wex_addon_dev_javascript/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/resources/.wex.yml,sha256=JdIF6nGkFcfi76yZYGlXxeWfOK4eAUSV_gAn6i3hk2w,32
+wexample_wex_addon_dev_javascript/resources/design_rules/javascript_code.md,sha256=_X6_j1SS2yoMegK3n1R_dORtBT3__NYQCY1PD-Ssb2o,1159
 wexample_wex_addon_dev_javascript/resources/package_publish.yml,sha256=Omw0Ww4I7jsi2uLSNApRR-Ujt6M_56IsXDyDT7hVncc,421
+wexample_wex_addon_dev_javascript/resources/writing_rules/javascript_code.md,sha256=nzoIZ65UTiwSwst0NoulyE29AfnGCjbOakuPbmeaakI,1808
 wexample_wex_addon_dev_javascript/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/services/node/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/services/node/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/services/node/commands/service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_javascript/services/node/commands/service/install_local.py,sha256=DtR5jrC2H_7h-TU1NhcH4TzzrqZ8_p7DMCfSQ7_GzsE,2773
-wexample_wex_addon_dev_javascript/services/node/commands/service/refresh_lock.py,sha256=rFuBhc-JyzWBSZGoLzM7Rs-g2rPDv8WzCPJIvjAVuH4,2063
+wexample_wex_addon_dev_javascript/services/node/commands/service/refresh_lock.py,sha256=qlGmvYxjnXxrr1DILjBBLfp9kTruuBe-5SYEzxvVNIA,2204
 wexample_wex_addon_dev_javascript/services/node/docker/.wex.yml,sha256=JdIF6nGkFcfi76yZYGlXxeWfOK4eAUSV_gAn6i3hk2w,32
 wexample_wex_addon_dev_javascript/services/node/docker/docker-compose.yml,sha256=GF22uk3PDtywP_GAF0RbfJ7lQ5P5nuuwJQE9ohwQh28,362
 wexample_wex_addon_dev_javascript/services/node/service.yml,sha256=jPLW-E4ymVaEnTwdTjVvTJNx04pwMGN4twxeOuN37mo,95
@@ -44,4 +48,4 @@ wexample_wex_addon_dev_javascript/workdir/__init__.py,sha256=47DEQpj8HBSa-_TImW-
 wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py,sha256=aUO2RdXlExfwIlnSexWGwc-Oh7QBMKKNv6sPgCIev2Q,9302
 wexample_wex_addon_dev_javascript/workdir/javascript_packages_suite_workdir.py,sha256=b0QoTWlNYOYfpqEb8vYzL4WRoY0WwBhYOFUoRc4oySI,928
 wexample_wex_addon_dev_javascript/workdir/javascript_workdir.py,sha256=oKBj-tOV-EH9kqiXnKUE7sKLKU4v0ta4IQr-zLEWgFI,5272
-wexample_wex_addon_dev_javascript-8.0.0.dist-info/RECORD,,
+wexample_wex_addon_dev_javascript-8.1.1.dist-info/RECORD,,

wexample_wex_addon_dev_javascript-8.0.0.dist-info/METADATA

@@ -1,475 +0,0 @@
-Metadata-Version: 2.1
-Name: wexample-wex-addon-dev-javascript
-Version: 8.0.0
-Summary: Python dev addon for wex
-Author-Email: weeger <contact@wexample.com>
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
-Requires-Python: >=3.10
-Requires-Dist: attrs>=23.1.0
-Requires-Dist: cattrs>=23.1.0
-Requires-Dist: wexample-api>=6.8.0
-Requires-Dist: wexample-filestate-javascript>=6.6.0
-Requires-Dist: wexample-wex-addon-ai>=12.1.0
-Requires-Dist: wexample-wex-addon-app>=29.0.0
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Description-Content-Type: text/markdown
-
-# wex_addon_dev_javascript
-
-Version: 8.0.0
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Tests](#tests)
-- [Suite Integration](#suite-integration)
-- [Dependencies](#dependencies)
-- [Versioning](#versioning)
-- [License](#license)
-- [Suite Integration](#suite-integration)
-- [Suite Signature](#suite-signature)
-- [Introduction](#introduction)
-- [Roadmap](#roadmap)
-- [Status Compatibility](#status-compatibility)
-- [Useful Links](#useful-links)
-- [Migration Notes](#migration-notes)
-
-## Tests
-
-This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
-
-### Installation
-
-First, install the required testing dependencies:
-```bash
-.venv/bin/python -m pip install pytest pytest-cov
-```
-
-### Basic Usage
-
-Run all tests with coverage:
-```bash
-.venv/bin/python -m pytest --cov --cov-report=html
-```
-
-### Common Commands
-```bash
-# Run tests with coverage for a specific module
-.venv/bin/python -m pytest --cov=your_module
-
-# Show which lines are not covered
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
-
-# Generate an HTML coverage report
-.venv/bin/python -m pytest --cov=your_module --cov-report=html
-
-# Combine terminal and HTML reports
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
-
-# Run specific test file with coverage
-.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
-```
-
-### Viewing HTML Reports
-
-After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
-
-### Coverage Threshold
-
-To enforce a minimum coverage percentage:
-```bash
-.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
-```
-
-This will cause the test suite to fail if coverage drops below 80%.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-## Dependencies
-
-- attrs: >=23.1.0
-- cattrs: >=23.1.0
-- wexample-api: >=6.8.0
-- wexample-filestate-javascript: >=6.6.0
-- wexample-wex-addon-ai: >=12.1.0
-- wexample-wex-addon-app: >=29.0.0
-
-## Versioning & Compatibility Policy
-
-Wexample packages follow **Semantic Versioning** (SemVer):
-
-- **MAJOR**: Breaking changes
-- **MINOR**: New features, backward compatible
-- **PATCH**: Bug fixes, backward compatible
-
-We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-Free to use in both personal and commercial projects.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-# About us
-
-[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
-
-This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
-
-Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
-
-# wex_addon_dev_javascript
-
-Version: 7.4.3
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Tests](#tests)
-- [Suite Integration](#suite-integration)
-- [Dependencies](#dependencies)
-- [Versioning](#versioning)
-- [License](#license)
-- [Suite Integration](#suite-integration)
-- [Suite Signature](#suite-signature)
-- [Introduction](#introduction)
-- [Roadmap](#roadmap)
-- [Status Compatibility](#status-compatibility)
-- [Useful Links](#useful-links)
-- [Migration Notes](#migration-notes)
-
-## Tests
-
-This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
-
-### Installation
-
-First, install the required testing dependencies:
-```bash
-.venv/bin/python -m pip install pytest pytest-cov
-```
-
-### Basic Usage
-
-Run all tests with coverage:
-```bash
-.venv/bin/python -m pytest --cov --cov-report=html
-```
-
-### Common Commands
-```bash
-# Run tests with coverage for a specific module
-.venv/bin/python -m pytest --cov=your_module
-
-# Show which lines are not covered
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
-
-# Generate an HTML coverage report
-.venv/bin/python -m pytest --cov=your_module --cov-report=html
-
-# Combine terminal and HTML reports
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
-
-# Run specific test file with coverage
-.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
-```
-
-### Viewing HTML Reports
-
-After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
-
-### Coverage Threshold
-
-To enforce a minimum coverage percentage:
-```bash
-.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
-```
-
-This will cause the test suite to fail if coverage drops below 80%.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-## Dependencies
-
-- attrs: >=23.1.0
-- cattrs: >=23.1.0
-- wexample-filestate-javascript: >=6.1.0
-- wexample-wex-addon-app: >=16.6.0
-
-## Versioning & Compatibility Policy
-
-Wexample packages follow **Semantic Versioning** (SemVer):
-
-- **MAJOR**: Breaking changes
-- **MINOR**: New features, backward compatible
-- **PATCH**: Bug fixes, backward compatible
-
-We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-Free to use in both personal and commercial projects.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-# About us
-
-[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
-
-This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
-
-Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
-
-# wex_addon_dev_javascript
-
-Version: 0.1.1
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Tests](#tests)
-- [Suite Integration](#suite-integration)
-- [Dependencies](#dependencies)
-- [Versioning](#versioning)
-- [License](#license)
-- [Suite Integration](#suite-integration)
-- [Suite Signature](#suite-signature)
-- [Roadmap](#roadmap)
-- [Status Compatibility](#status-compatibility)
-- [Useful Links](#useful-links)
-- [Migration Notes](#migration-notes)
-
-## Tests
-
-This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
-
-### Installation
-
-First, install the required testing dependencies:
-```bash
-.venv/bin/python -m pip install pytest pytest-cov
-```
-
-### Basic Usage
-
-Run all tests with coverage:
-```bash
-.venv/bin/python -m pytest --cov --cov-report=html
-```
-
-### Common Commands
-```bash
-# Run tests with coverage for a specific module
-.venv/bin/python -m pytest --cov=your_module
-
-# Show which lines are not covered
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
-
-# Generate an HTML coverage report
-.venv/bin/python -m pytest --cov=your_module --cov-report=html
-
-# Combine terminal and HTML reports
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
-
-# Run specific test file with coverage
-.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
-```
-
-### Viewing HTML Reports
-
-After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
-
-### Coverage Threshold
-
-To enforce a minimum coverage percentage:
-```bash
-.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
-```
-
-This will cause the test suite to fail if coverage drops below 80%.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-## Dependencies
-
-- attrs: >=23.1.0
-- cattrs: >=23.1.0
-- wexample-filestate-javascript: >=0.1.0
-- wexample-wex-addon-app: >=1.1.0
-
-## Versioning & Compatibility Policy
-
-Wexample packages follow **Semantic Versioning** (SemVer):
-
-- **MAJOR**: Breaking changes
-- **MINOR**: New features, backward compatible
-- **PATCH**: Bug fixes, backward compatible
-
-We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-Free to use in both personal and commercial projects.
-
-## Integration in the Suite
-
-This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
-
-### Related Packages
-
-The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
-
-Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-
-# About us
-
-[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
-
-This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
-
-Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
-
-## Known Limitations & Roadmap
-
-Current limitations and planned features are tracked in the GitHub issues.
-
-See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javascript/issues) for upcoming features and improvements.
-
-## Status & Compatibility
-
-**Maturity**: Production-ready
-
-**Python Support**: >=3.10
-
-**OS Support**: Linux, macOS, Windows
-
-**Status**: Actively maintained
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
-- **PyPI**: [pypi.org/project/wex_addon_dev_javascript](https://pypi.org/project/wex_addon_dev_javascript/)
-
-## Migration Notes
-
-When upgrading between major versions, refer to the migration guides in the documentation.
-
-Breaking changes are clearly documented with upgrade paths and examples.
-
-## Known Limitations & Roadmap
-
-Current limitations and planned features are tracked in the GitHub issues.
-
-See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javascript/issues) for upcoming features and improvements.
-
-## Status & Compatibility
-
-**Maturity**: Production-ready
-
-**Python Support**: >=3.10
-
-**OS Support**: Linux, macOS, Windows
-
-**Status**: Actively maintained
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
-- **PyPI**: [pypi.org/project/wex_addon_dev_javascript](https://pypi.org/project/wex_addon_dev_javascript/)
-
-## Migration Notes
-
-When upgrading between major versions, refer to the migration guides in the documentation.
-
-Breaking changes are clearly documented with upgrade paths and examples.
-
-## Known Limitations & Roadmap
-
-Current limitations and planned features are tracked in the GitHub issues.
-
-See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javascript/issues) for upcoming features and improvements.
-
-## Status & Compatibility
-
-**Maturity**: Production-ready
-
-**Python Support**: >=3.10
-
-**OS Support**: Linux, macOS, Windows
-
-**Status**: Actively maintained
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
-- **PyPI**: [pypi.org/project/wex_addon_dev_javascript](https://pypi.org/project/wex_addon_dev_javascript/)
-
-## Migration Notes
-
-When upgrading between major versions, refer to the migration guides in the documentation.
-
-Breaking changes are clearly documented with upgrade paths and examples.