@ai-ecoverse/slicc-shared-web 0.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,191 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright
+      owner or by an individual or Legal Entity authorized to submit on
+      behalf of the copyright owner. For the purposes of this definition,
+      "submitted" means any form of electronic, verbal, or written
+      communication sent to the Licensor or its representatives, including
+      but not limited to communication on electronic mailing lists, source
+      code control systems, and issue tracking systems that are managed by,
+      or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or otherwise designated in writing by the copyright owner as
+      "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 ai-ecoverse
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,9 +1,28 @@
-# @ai-ecoverse/slicc-shared-web
+# slicc-shared-web
 
-🐣 This package name has been claimed with [fledgling](https://github.com/dmno-dev/fledgling) for [https://github.com/ai-ecoverse/slicc-shared-web](https://github.com/ai-ecoverse/slicc-shared-web), and a real release will land here soon.
+Configuration shared by SLICC's web repos ([slicc-bios](https://github.com/ai-ecoverse/slicc-bios), [slicc-kernel](https://github.com/ai-ecoverse/slicc-kernel), [slicc-spectrum](https://github.com/ai-ecoverse/slicc-spectrum), and whatever comes next), so a rule changes in one place.
 
-This is a placeholder — there is nothing to install yet.
+| File | What it is | How a repo uses it |
+|---|---|---|
+| `default.json` | Root Renovate preset: automerge on, one dependency per PR, exact pins, 7-day release age (14 for majors, 0 for vulnerability fixes and for our own `@ai-ecoverse` packages, which also jump the PR queue), and a manager for jsDelivr pins inside `src/` | `renovate.json`: `{ "extends": ["github>ai-ecoverse/slicc-shared-web"] }` |
+| `.github/workflows/node-ci.yml` | Reusable CI: `npm ci`, lint, Chromium's system libraries, integration tests, hotspots in the job summary, coverage/profiles/screenshots as artifacts. The browser itself comes from each repo's `pretest` | `jobs: { ci: { uses: ai-ecoverse/slicc-shared-web/.github/workflows/node-ci.yml@vX.Y.Z } }` |
+| `biome.json` | Formatter settings and slicc's strict linter: cognitive complexity ≤ 25, functions ≤ 150 lines, no unused variables or imports, no floating or misused promises, naming conventions, `import type`/`export type`. Test files under `test/` get slicc's test exemptions | `biome.json`: `{ "extends": ["@ai-ecoverse/slicc-shared-web/biome"] }` |
+| `tsconfig.json` | TypeScript base for Node's type stripping | `tsconfig.json`: `{ "extends": "@ai-ecoverse/slicc-shared-web/tsconfig.json", "include": ["src/**/*.ts"] }` |
+| `lefthook.yml` | Pre-commit hooks: Biome, typecheck, no comments, no unit tests in git, AGENTS.md, diff coverage | `lefthook.yml`: `extends: [node_modules/@ai-ecoverse/slicc-shared-web/lefthook.yml]` |
+| `mcr.config.mjs` | Unit-test coverage for JS and TS sources in `src/` (TS types are stripped first), written to `coverage/unit/lcov.info` | `test:unit`: `mcr -c node_modules/@ai-ecoverse/slicc-shared-web/mcr.config.mjs node --test 'test/unit/**/*.test.mjs'` |
+| `bin/` | `slicc-lint` runs every check below plus Biome and, if the repo has one, `typecheck`. `slicc-lint-comments` runs the [slicc no-comment checker](https://github.com/ai-ecoverse/slicc/tree/main/packages/dev-tools/no-comment) at a pinned commit, allowing AGENTS.md. `slicc-agents-md`, `slicc-no-unit-tests` and `slicc-diff-cover` complete the set | `lint`: `slicc-lint`, and the hooks above |
 
----
+Install it from npm, and pin the reusable workflow to the matching `vX.Y.Z` tag. Renovate keeps both current without the usual waiting period:
 
-Want to claim a name of your own? Run `npx fledgling add <name> --new --yes` — it reserves the name on npm and can set up token-less (OIDC trusted) publishing for when you are ready.
+```sh
+npm install --save-dev --save-exact @ai-ecoverse/slicc-shared-web
+```
+
+The hooks expect two scripts in each repo: `test:unit`, which writes `coverage/unit/lcov.info` (unit tests stay out of git), and, in TypeScript repos, `typecheck`. The reusable workflow expects `lint`, plus `test` for the integration tests, with a `pretest` that installs Chromium (`playwright-core install --no-shell chromium`). The diff-coverage hook runs `diff-cover` through `uvx`, so install [uv](https://docs.astral.sh/uv/) once.
+
+## Rules every repo follows
+
+- No comments anywhere, and no `.md` files except README.md and AGENTS.md.
+- Agent guidance committed to a repo lives in AGENTS.md only, at most 1,000 characters per file. The repo has no CLAUDE.md, not even as a symlink, since Claude reads AGENTS.md. The check covers tracked and untracked files; gitignored local files are personal and stay out of it.
+- Unit tests stay out of git, in a gitignored `test/unit/`. The pre-commit hook requires them to execute every staged line in `src/`.
+- Integration tests are committed and run in CI.

package/bin/slicc-agents-md.sh

@@ -0,0 +1,23 @@
+#!/bin/sh
+set -u
+limit=1000
+failed=0
+list="${TMPDIR:-/tmp}/slicc-agents-md.$$"
+git ls-files --cached --others --exclude-standard | grep -E '(^|/)(AGENTS|CLAUDE)\.md$' > "$list" || true
+while IFS= read -r file; do
+  case "$file" in
+    CLAUDE.md | */CLAUDE.md)
+      printf '%s: agent guidance lives in AGENTS.md only, with no CLAUDE.md file or symlink\n' "$file" >&2
+      failed=1
+      ;;
+    *)
+      chars=$(node -e "process.stdout.write(String([...require('node:fs').readFileSync(process.argv[1], 'utf8')].length))" "$file")
+      if [ "$chars" -gt "$limit" ]; then
+        printf '%s: %s characters, the limit is %s\n' "$file" "$chars" "$limit" >&2
+        failed=1
+      fi
+      ;;
+  esac
+done < "$list"
+rm -f "$list"
+exit "$failed"

package/bin/slicc-diff-cover.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+set -eu
+if ! command -v uvx > /dev/null 2>&1; then
+  printf 'slicc-diff-cover runs diff-cover through uvx; install uv first: https://docs.astral.sh/uv/getting-started/installation/\n' >&2
+  exit 1
+fi
+exec uvx diff-cover@10.6.0 "${1:-coverage/unit/lcov.info}" --compare-branch HEAD --ignore-unstaged --fail-under 100

package/bin/slicc-lint-comments.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+set -eu
+sha=9cc7617c94c24b84c4d6fd8edf92441378257d07
+dir="node_modules/.cache/slicc-no-comment-$sha"
+if [ ! -f "$dir/check.mjs" ]; then
+  mkdir -p "$dir"
+  for file in lib comments marker check; do
+    curl -fsSL -o "$dir/$file.mjs" "https://raw.githubusercontent.com/ai-ecoverse/slicc/$sha/packages/dev-tools/no-comment/$file.mjs"
+  done
+fi
+report=$(node "$dir/check.mjs" --force "$@" 2>&1) || true
+if [ -z "$report" ]; then
+  printf 'slicc-lint-comments: the no-comment checker produced no report\n' >&2
+  exit 1
+fi
+rest=$(printf '%s\n' "$report" | grep -vE '^ok: |^(.+/)?AGENTS\.md: documentation file is not allowed' || true)
+if [ -n "$rest" ]; then
+  printf '%s\n' "$rest" >&2
+  exit 1
+fi
+printf 'ok: no comments, and no documentation besides README.md and AGENTS.md\n'

package/bin/slicc-lint.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+set -eu
+bin=$(dirname "$(readlink -f "$0")")
+npx --no-install biome check .
+if node -e "process.exit(require('./package.json').scripts?.typecheck ? 0 : 1)"; then
+  npm run --silent typecheck
+fi
+"$bin/slicc-lint-comments.sh"
+"$bin/slicc-no-unit-tests.sh"
+"$bin/slicc-agents-md.sh"

package/bin/slicc-no-unit-tests.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+set -u
+found=$(git ls-files --cached --others --exclude-standard | grep -E '(^|/)(tests?|__tests__)/|\.(test|spec)\.' | grep -vE '^test/integration/')
+if [ -n "$found" ]; then
+  printf 'Unit tests stay out of git; keep them in the gitignored test/unit/:\n%s\n' "$found" >&2
+  exit 1
+fi

package/biome.json

@@ -0,0 +1,228 @@
+{
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100,
+    "lineEnding": "lf"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "always",
+      "trailingCommas": "es5",
+      "arrowParentheses": "always",
+      "bracketSpacing": true
+    }
+  },
+  "html": {
+    "formatter": {
+      "enabled": true
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["test/**", "**/*.test.ts", "**/*.test.mjs"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          },
+          "correctness": {
+            "noEmptyPattern": "off",
+            "noUnusedVariables": "off",
+            "noConstructorReturn": "off",
+            "noUnsafeOptionalChaining": "off"
+          },
+          "style": {
+            "useNamingConvention": "off"
+          },
+          "complexity": {
+            "noExcessiveCognitiveComplexity": "off",
+            "noExcessiveLinesPerFunction": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["**/*.json", "**/*.jsonc", "**/tsconfig*.json", "**/.releaserc.json"],
+      "linter": {
+        "enabled": false
+      }
+    }
+  ],
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "complexity": {
+        "noExcessiveCognitiveComplexity": {
+          "level": "error",
+          "options": {
+            "maxAllowedComplexity": 25
+          }
+        },
+        "noExcessiveLinesPerFunction": {
+          "level": "error",
+          "options": {
+            "maxLines": 150,
+            "skipIifes": true
+          }
+        },
+        "noForEach": "off",
+        "noBannedTypes": "off",
+        "noUselessConstructor": "off",
+        "noUselessSwitchCase": "off",
+        "noStaticOnlyClass": "off",
+        "noUselessFragments": "off",
+        "useArrowFunction": "off",
+        "useOptionalChain": "error",
+        "useLiteralKeys": "off",
+        "noImportantStyles": "error"
+      },
+      "correctness": {
+        "noUnusedVariables": {
+          "level": "error",
+          "options": {
+            "ignoreRestSiblings": true
+          }
+        },
+        "noUnusedImports": "error",
+        "noUnusedFunctionParameters": "off",
+        "noUnusedPrivateClassMembers": "off",
+        "useExhaustiveDependencies": "off",
+        "noNodejsModules": "off",
+        "noUndeclaredVariables": "off",
+        "noConstantCondition": "error",
+        "noInnerDeclarations": "off",
+        "noConstAssign": "error",
+        "noPrecisionLoss": "error",
+        "noSwitchDeclarations": "off",
+        "noUnreachable": "error"
+      },
+      "style": {
+        "useNamingConvention": {
+          "level": "warn",
+          "options": {
+            "strictCase": false,
+            "requireAscii": true,
+            "conventions": [
+              {
+                "selector": {
+                  "kind": "function"
+                },
+                "match": "_*(.+?)_*",
+                "formats": ["camelCase", "PascalCase"]
+              },
+              {
+                "selector": {
+                  "kind": "classMember"
+                },
+                "match": "_*(.+?)_*",
+                "formats": ["camelCase", "PascalCase", "CONSTANT_CASE"]
+              },
+              {
+                "selector": {
+                  "kind": "objectLiteralProperty"
+                },
+                "match": ".*"
+              },
+              {
+                "selector": {
+                  "kind": "typeProperty"
+                },
+                "match": ".*"
+              },
+              {
+                "selector": {
+                  "kind": "enumMember"
+                },
+                "formats": ["camelCase", "PascalCase", "CONSTANT_CASE"]
+              },
+              {
+                "selector": {
+                  "kind": "typeLike"
+                },
+                "formats": ["PascalCase"]
+              },
+              {
+                "selector": {
+                  "kind": "variable"
+                },
+                "match": "_*\\$?(.+?)_*",
+                "formats": ["camelCase", "PascalCase", "CONSTANT_CASE"]
+              }
+            ]
+          }
+        },
+        "useImportType": "error",
+        "useExportType": "error",
+        "useConst": "error",
+        "useTemplate": "off",
+        "useSingleVarDeclarator": "off",
+        "useNumberNamespace": "off",
+        "useEnumInitializers": "off",
+        "useNodejsImportProtocol": "off",
+        "useDefaultParameterLast": "off",
+        "useExponentiationOperator": "off",
+        "useLiteralEnumMembers": "off",
+        "noUselessElse": "off",
+        "noNonNullAssertion": "off",
+        "noParameterAssign": "off",
+        "noUnusedTemplateLiteral": "off",
+        "noInferrableTypes": "off"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn",
+        "noEmptyBlockStatements": "off",
+        "noEmptyInterface": "off",
+        "noConfusingVoidType": "off",
+        "noAssignInExpressions": "off",
+        "noConsole": "off",
+        "noShadowRestrictedNames": "off",
+        "noImplicitAnyLet": "off",
+        "noPrototypeBuiltins": "off",
+        "noGlobalIsNan": "off",
+        "noControlCharactersInRegex": "off",
+        "noSparseArray": "error",
+        "noDoubleEquals": {
+          "level": "error",
+          "options": {
+            "ignoreNull": true
+          }
+        },
+        "noDebugger": "error",
+        "noDuplicateCase": "error",
+        "noIrregularWhitespace": "error",
+        "noFunctionAssign": "error",
+        "noArrayIndexKey": "off",
+        "noEvolvingTypes": "off",
+        "noAsyncPromiseExecutor": "error",
+        "noThenProperty": "off",
+        "noCatchAssign": "off",
+        "noFallthroughSwitchClause": "off",
+        "noTemplateCurlyInString": "off",
+        "useIterableCallbackReturn": "error"
+      },
+      "performance": {
+        "noDelete": "off",
+        "noAccumulatingSpread": "off"
+      },
+      "nursery": {
+        "noFloatingPromises": "error",
+        "noMisusedPromises": "error"
+      },
+      "a11y": {
+        "preset": "none"
+      },
+      "security": {
+        "preset": "recommended"
+      }
+    }
+  }
+}

package/default.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "description": [
+    "Root Renovate preset for SLICC's web repos. Extend it with github>ai-ecoverse/slicc-shared-web and keep repo-specific rules in the repo's own renovate.json.",
+    "Every dependency updates in its own PR so a breaking bump fails in isolation; only purposeful cohesion groups exist, never a catch-all group.",
+    "Automerge is on: a PR merges by itself once CI is green and the release is old enough."
+  ],
+  "extends": ["config:recommended"],
+  "semanticCommits": "enabled",
+  "rebaseWhen": "conflicted",
+  "automerge": true,
+  "automergeType": "pr",
+  "platformAutomerge": true,
+  "minimumReleaseAge": "7 days",
+  "prHourlyLimit": 4,
+  "internalChecksFilter": "strict",
+  "vulnerabilityAlerts": {
+    "enabled": true,
+    "minimumReleaseAge": "0 days"
+  },
+  "customManagers": [
+    {
+      "customType": "regex",
+      "description": "npm packages pinned by exact version in jsDelivr URLs inside sources, such as the tar library slicc-bios imports at runtime.",
+      "managerFilePatterns": ["/(^|/)src/.+\\.(js|mjs|ts)$/"],
+      "matchStrings": [
+        "https://cdn\\.jsdelivr\\.net/npm/(?<depName>(?:@[^/@\\s'\"`]+/)?[^/@\\s'\"`]+)@(?<currentValue>\\d[^/\\s'\"`]*)"
+      ],
+      "datasourceTemplate": "npm"
+    }
+  ],
+  "packageRules": [
+    {
+      "description": "Pin npm dependencies to exact versions so every change is a visible package.json diff in its own PR. engines and peerDependencies keep their ranges.",
+      "matchManagers": ["npm"],
+      "matchDepTypes": ["dependencies", "devDependencies"],
+      "rangeStrategy": "pin"
+    },
+    {
+      "description": "Major bumps wait longer: more risk of breaking changes and a more attractive target for malicious releases.",
+      "matchUpdateTypes": ["major"],
+      "minimumReleaseAge": "14 days"
+    },
+    {
+      "description": "Our own packages and shared config ship together: take them as soon as they are released, ahead of the hourly PR limit, whether Renovate sees them by package name (npm, reusable workflows, git URLs) or by dependency name.",
+      "matchPackageNames": [
+        "@ai-ecoverse/{/,}**",
+        "ai-ecoverse/**",
+        "https://github.com/ai-ecoverse/**"
+      ],
+      "minimumReleaseAge": "0 days",
+      "prPriority": 10
+    },
+    {
+      "matchDepNames": ["@ai-ecoverse/{/,}**"],
+      "minimumReleaseAge": "0 days",
+      "prPriority": 10
+    },
+    {
+      "matchPackageNames": ["semantic-release", "@semantic-release/{/,}**"],
+      "groupName": "semantic-release packages"
+    },
+    {
+      "description": "Formatter bumps can reflow existing code and fail the Biome check; label them so they stand out when they do.",
+      "matchPackageNames": ["@biomejs/biome"],
+      "addLabels": ["formatter-bump"]
+    },
+    {
+      "description": "Packages carried with a patch-package patch. A bump orphans the version-pinned patch, so group them and never automerge.",
+      "matchPackageNames": ["@zenfs/core", "@zenfs/dom"],
+      "groupName": "patched dependencies",
+      "groupSlug": "patched-deps",
+      "addLabels": ["patched-dependency"],
+      "automerge": false
+    }
+  ]
+}

package/lefthook.yml

@@ -0,0 +1,18 @@
+pre-commit:
+  parallel: true
+  jobs:
+    - name: biome
+      glob: "*.{js,mjs,cjs,ts,json,css,html}"
+      run: npx biome check --no-errors-on-unmatched --files-ignore-unknown=true {staged_files}
+    - name: typecheck
+      glob: "*.ts"
+      run: npm run --silent typecheck
+    - name: no comments
+      run: npx --no-install slicc-lint-comments
+    - name: no unit tests in git
+      run: npx --no-install slicc-no-unit-tests
+    - name: AGENTS.md
+      run: npx --no-install slicc-agents-md
+    - name: diff coverage
+      glob: "src/**.{js,mjs,ts}"
+      run: npm run --silent test:unit && npx --no-install slicc-diff-cover

package/mcr.config.mjs

@@ -0,0 +1,17 @@
+import { stripTypeScriptTypes } from 'node:module';
+
+const strip = (entry) => {
+  if (entry.url.endsWith('.ts')) entry.source = stripTypeScriptTypes(entry.source);
+};
+
+const ours = (url) =>
+  url.includes('/src/') && !url.includes('/node_modules/') && /\.(m?js|ts)$/.test(url);
+
+export default {
+  name: process.env.npm_package_name ?? 'unit',
+  outputDir: 'coverage/unit',
+  reports: ['lcovonly', 'console-details'],
+  all: { dir: 'src', filter: '**/*.{js,mjs,ts}', transformer: strip },
+  entryFilter: (entry) => ours(entry.url),
+  onEntry: strip,
+};

package/package.json

@@ -1,10 +1,56 @@
 {
   "name": "@ai-ecoverse/slicc-shared-web",
-  "version": "0.0.0",
+  "version": "1.1.0",
   "description": "Shared Renovate, Biome, TypeScript, lefthook and GitHub Actions configuration for SLICC's web repos",
+  "type": "module",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ai-ecoverse/slicc-shared-web.git"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "fledgling": {
+    "provider": "github",
+    "workflow": "release.yml",
+    "repo": "ai-ecoverse/slicc-shared-web",
+    "publish": true
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "exports": {
+    "./biome": "./biome.json",
+    "./tsconfig.json": "./tsconfig.json",
+    "./lefthook.yml": "./lefthook.yml",
+    "./package.json": "./package.json",
+    "./mcr.config.mjs": "./mcr.config.mjs"
+  },
+  "bin": {
+    "slicc-agents-md": "bin/slicc-agents-md.sh",
+    "slicc-diff-cover": "bin/slicc-diff-cover.sh",
+    "slicc-lint": "bin/slicc-lint.sh",
+    "slicc-lint-comments": "bin/slicc-lint-comments.sh",
+    "slicc-no-unit-tests": "bin/slicc-no-unit-tests.sh"
+  },
+  "files": [
+    "bin",
+    "biome.json",
+    "default.json",
+    "lefthook.yml",
+    "mcr.config.mjs",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "lint": "bin/slicc-lint.sh && shellcheck bin/*.sh",
+    "trust": "npx fledgling sync -y --skip-publish",
+    "trust:dry": "npx fledgling sync --dry-run -y --skip-publish",
+    "release": "semantic-release"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "semantic-release": "25.0.9"
   }
 }

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2024", "DOM", "DOM.Iterable", "WebWorker.ImportScripts"],
+    "types": [],
+    "strict": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+    "allowImportingTsExtensions": true,
+    "rewriteRelativeImportExtensions": false,
+    "noEmit": true
+  }
+}