wexample-wex-addon-dev-javascript 8.4.0__tar.gz → 8.6.0__tar.gz

{wexample_wex_addon_dev_javascript-8.4.0 → wexample_wex_addon_dev_javascript-8.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-javascript
-Version: 8.4.0
+Version: 8.6.0
 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
@@ -13,8 +13,8 @@ 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>=18.3.0
-Requires-Dist: wexample-wex-addon-app>=33.4.0
+Requires-Dist: wexample-wex-addon-ai>=19.0.0
+Requires-Dist: wexample-wex-addon-app>=34.1.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_javascript
 
-Version: 8.4.0
+Version: 8.6.0
 
 `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.
 
@@ -243,16 +243,14 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 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: >=18.3.0
-- wexample-wex-addon-app: >=33.4.0
+- wexample-wex-addon-ai: >=19.0.0
+- wexample-wex-addon-app: >=34.1.0
 
 ## Versioning & Compatibility Policy
 
@@ -278,6 +276,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 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.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -297,7 +297,6 @@ See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javas
 ## 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/)

{wexample_wex_addon_dev_javascript-8.4.0 → wexample_wex_addon_dev_javascript-8.6.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_javascript
 
-Version: 8.4.0
+Version: 8.6.0
 
 `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.
 
@@ -221,16 +221,14 @@ This package is part of the Wexample Suite — a collection of high-quality, mod
 
 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: >=18.3.0
-- wexample-wex-addon-app: >=33.4.0
+- wexample-wex-addon-ai: >=19.0.0
+- wexample-wex-addon-app: >=34.1.0
 
 ## Versioning & Compatibility Policy
 
@@ -256,6 +254,8 @@ This packages suite embodies this spirit. Trusted by professionals and enthusias
 
 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.
 
+Built and maintained by [Romain Weeger](https://weeger.io).
+
 ## Known Limitations & Roadmap
 
 Current limitations and planned features are tracked in the GitHub issues.
@@ -275,7 +275,6 @@ See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_javas
 ## 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/)

{wexample_wex_addon_dev_javascript-8.4.0 → wexample_wex_addon_dev_javascript-8.6.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-javascript"
-version = "8.4.0"
+version = "8.6.0"
 description = "Extends wex with JavaScript support: enforces JS/TS project layout and symlinks local npm packages into node_modules"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -22,8 +22,8 @@ dependencies = [
     "cattrs>=23.1.0",
     "wexample-api>=6.8.0",
     "wexample-filestate-javascript>=6.6.0",
-    "wexample-wex-addon-ai>=18.3.0",
-    "wexample-wex-addon-app>=33.4.0",
+    "wexample-wex-addon-ai>=19.0.0",
+    "wexample-wex-addon-app>=34.1.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_javascript-8.6.0/src/wexample_wex_addon_dev_javascript/file/javascript_package_lock_json_file.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from wexample_filestate.item.file.json_file import JsonFile
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class JavascriptPackageLockJsonFile(JsonFile):
+    """A published javascript package's package-lock.json.
+
+    npm records the package's own version in its lock, twice. The bump writes
+    it into package.json alone, so the lock kept the previous one, and the next
+    `npm install` — a test run, a lock refresh — wrote it back: a change in the
+    working tree, which made every package of the suite look modified again and
+    be published once more at the next run. Written here, from the same source
+    and at the same time as package.json's.
+    """
+
+    def dumps(self, content: dict | None = None) -> str:
+        content = content or self.read_parsed()
+
+        version = self.get_parent_item().get_setup_version()
+        if "version" in content:
+            content["version"] = version
+        root = (content.get("packages") or {}).get("")
+        if isinstance(root, dict) and "version" in root:
+            root["version"] = version
+
+        # With the newline npm ends the file with: without it, the next install
+        # would change the file back, and the loop this class closes reopens.
+        dumped = super().dumps(content)
+        return dumped if dumped.endswith("\n") else dumped + "\n"

wexample_wex_addon_dev_javascript-8.6.0/src/wexample_wex_addon_dev_javascript/resources/package_gitlab_ci.yml

@@ -0,0 +1,4 @@
+include:
+  - remote: 'https://gitlab.wexample.com/wexample-public/ci-cd/-/raw/main/.gitlab-ci.type.node.package.yml'
+variables:
+  MAIN_BRANCH_NAME: main

{wexample_wex_addon_dev_javascript-8.4.0 → wexample_wex_addon_dev_javascript-8.6.0}/src/wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py

@@ -92,6 +92,23 @@ class JavascriptPackageWorkdir(JavascriptWorkdir):
             }
         )
 
+        # Every package is tested by GitLab at each push, the way a consumer
+        # installs it. The file is only an include: the job itself lives in
+        # the ci-cd repository, one place to change for every package. Created
+        # when absent, never rewritten: a package may add to it.
+        children.append(
+            {
+                "name": ".gitlab-ci.yml",
+                "type": DiskItemType.FILE,
+                "should_exist": True,
+                "default_content": lambda _: file_read(
+                    module_get_path(wexample_wex_addon_dev_javascript)
+                    / "resources"
+                    / "package_gitlab_ci.yml"
+                ),
+            }
+        )
+
         return raw_value
 
     def release(self, **kwargs) -> None:

{wexample_wex_addon_dev_javascript-8.4.0 → wexample_wex_addon_dev_javascript-8.6.0}/src/wexample_wex_addon_dev_javascript/workdir/javascript_workdir.py

@@ -83,6 +83,9 @@ class JavascriptWorkdir(WithAiWorkdirMixin, CodeBaseWorkdir):
         from wexample_wex_addon_dev_javascript.file.javascript_package_json_file import (
             JavascriptPackageJsonFile,
         )
+        from wexample_wex_addon_dev_javascript.file.javascript_package_lock_json_file import (
+            JavascriptPackageLockJsonFile,
+        )
         from wexample_wex_addon_dev_javascript.file.javascript_tsconfig_json_file import (
             JavascriptTsconfigJsonFile,
         )
@@ -118,6 +121,12 @@ class JavascriptWorkdir(WithAiWorkdirMixin, CodeBaseWorkdir):
                     "type": DiskItemType.FILE,
                     "should_exist": True,
                 },
+                # Not required: a package installed by yarn or pnpm has none.
+                {
+                    "class": JavascriptPackageLockJsonFile,
+                    "name": "package-lock.json",
+                    "type": DiskItemType.FILE,
+                },
                 {
                     "class": JavascriptTsconfigJsonFile,
                     "name": "tsconfig.json",