@real-router/angular 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Oleg Ivanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/angular",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "type": "commonjs",
   "description": "Angular 21 integration for Real-Router",
   "exports": {
@@ -19,14 +19,6 @@
     "type": "git",
     "url": "git+https://github.com/greydragon888/real-router.git"
   },
-  "scripts": {
-    "test": "vitest",
-    "test:stress": "vitest -c vitest.config.stress.mts",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint --cache src/ tests/ --fix --max-warnings 0",
-    "prebundle": "rm -rf src/dom-utils && cp -r ../../shared/dom-utils src/dom-utils && perl -pi -e 's/\\.js\"/\"/g' src/dom-utils/*.ts",
-    "bundle": "ng-packagr -p ng-package.json -c tsconfig.lib.json"
-  },
   "keywords": [
     "router",
     "angular",
@@ -43,9 +35,9 @@
   "license": "MIT",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "workspace:^",
-    "@real-router/route-utils": "workspace:^",
-    "@real-router/sources": "workspace:^"
+    "@real-router/core": "^0.48.0",
+    "@real-router/route-utils": "^0.2.1",
+    "@real-router/sources": "^0.5.1"
   },
   "devDependencies": {
     "@analogjs/vitest-angular": "2.4.7",
@@ -60,5 +52,13 @@
   "peerDependencies": {
     "@angular/common": ">=21.0.0",
     "@angular/core": ">=21.0.0"
+  },
+  "scripts": {
+    "test": "vitest",
+    "test:stress": "vitest -c vitest.config.stress.mts",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint --cache src/ tests/ --fix --max-warnings 0",
+    "prebundle": "rm -rf src/dom-utils && cp -r ../../shared/dom-utils src/dom-utils && perl -pi -e 's/\\.js\"/\"/g' src/dom-utils/*.ts",
+    "bundle": "ng-packagr -p ng-package.json -c tsconfig.lib.json"
   }
-}
+}

package/src/dom-utils/CLAUDE.md

@@ -1,76 +0,0 @@
-# shared/dom-utils — Stable Shared Sources
-
-> DOM helpers инлайнятся во все framework-адаптеры. Код **зрелый**, API устоялся.
-
-## Status: stable
-
-Эти файлы — общий слой для 6 адаптеров (Preact, React, Solid, Vue, Svelte, Angular). Любое изменение здесь немедленно попадает в 6 публичных bundle'ов. Относиться как к low-level примитиву, а не к «просто утилитам».
-
-## Правила работы
-
-### 1. Отладка начинается в адаптере, а не здесь
-
-Перед правкой `shared/dom-utils/*.ts` убедись, что:
-- баг воспроизводится **минимум в 2 адаптерах** (иначе это adapter-specific проблема обёртки);
-- есть падающий тест в функциональном наборе соответствующего адаптера.
-
-Если баг живёт только в одном адаптере — правка идёт в адаптер, не сюда.
-
-### 2. Оптимизаций «на глаз» не делать
-
-Функции уже прошли итерации:
-- `buildActiveClassName` — токен-дедупликация через `Set`, O(n+m);
-- `applyLinkA11y` — defensive null-guard + `hasAttribute` (не `getAttribute`);
-- `buildHref` — optional `buildUrl` + undefined-fallback на `buildPath`;
-- `createRouteAnnouncer` — double `requestAnimationFrame` + Safari-ready буферизация через `pendingText`.
-
-«Рефактор ради чистоты» здесь запрещён — микро-изменение ломает сразу 6 bundle'ов. Изменение кода требует: конкретный баг/юз-кейс, тест на него, прогон `pnpm build`.
-
-### 3. Angular sync после любой правки
-
-`packages/angular/src/dom-utils/` — **git-tracked copy**, не symlink (ng-packagr не следует за symlinks как tsdown).
-
-После правки `shared/dom-utils/*.ts`:
-
-```bash
-pnpm -F @real-router/angular bundle     # пере-материализует копию через prebundle
-diff -r shared/dom-utils/ packages/angular/src/dom-utils/ | grep -v index.ts  # должно быть пусто
-```
-
-Коммитить нужно **оба** варианта: источник в `shared/` и копию в `packages/angular/src/dom-utils/`.
-
-### 4. Валидация изменений
-
-Минимальный чек-лист перед коммитом:
-
-```bash
-pnpm build                                           # 207+ тасков, все адаптеры
-pnpm -F @real-router/react test:properties -- --run  # property-тесты buildActiveClassName/buildHref
-pnpm -F @real-router/svelte test:properties -- --run # property-тесты (дублируют React, оба должны пройти)
-```
-
-## Консумеры
-
-| Источник | Как подключено | Пакеты |
-|---|---|---|
-| `shared/dom-utils/` | symlink → `src/dom-utils` | `preact`, `react`, `solid`, `svelte`, `vue` |
-| `shared/dom-utils/` | git-tracked copy (через `prebundle`) | `angular` |
-
-Проверка, что symlink цел: `readlink packages/preact/src/dom-utils` должен вернуть относительный путь к `shared/dom-utils/`.
-
-## Публичный контракт
-
-| Функция | Используется в | Стабильность |
-|---|---|---|
-| `shouldNavigate(evt)` | все `Link` компоненты + directives/actions | frozen |
-| `buildHref(router, name, params)` | все `Link` компоненты + Angular directive | frozen |
-| `buildActiveClassName(isActive, active, base)` | все `Link` компоненты | frozen |
-| `applyLinkA11y(el)` | все `Link` компоненты + directives | frozen |
-| `createRouteAnnouncer(router, opts)` | все `RouterProvider` / `NavigationAnnouncer` | frozen |
-
-«Frozen» = сигнатура и поведение не меняются без мажорного release-цикла core. Новые фичи — отдельными функциями, не модификацией существующих.
-
-## См. также
-
-- [../../CLAUDE.md](../../CLAUDE.md) — monorepo-level правила symlink-инфраструктуры
-- [../../IMPLEMENTATION_NOTES.md](../../IMPLEMENTATION_NOTES.md) — раздел "Shared Sources via Symlinks"