@budarin/use-route 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# История изменений
+
+Все значимые изменения в проекте описываются в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
+версионирование — [Semantic Versioning](https://semver.org/lang/ru/).
+
+## [1.1.1] - 2025-01-30
+
+### Добавлено
+
+- **section** в `UseRouteOptions`: путь подраздела под глобальным base (например `/dashboard`). `pathname` возвращается без этого префикса; `navigate(to)` добавляет глобальный base + section. Комбинируется с `configureRouter.base`, не заменяет его.
+- **section** и **base** в `NavigateOptions`: переопределение section или полного base для одного перехода (например `navigate('/', { section: '' })` — в корень приложения, `navigate('/login', { base: '' })` — путь вне приложения).
+- Демо-приложение в `demo/` (Vite + React): примеры section, base, push/replace, свой matcher.
+- CI (GitHub Actions): проверка форматирования, типов, тесты и сборка при push в `master`.
+
+### Изменено
+
+- Эффективный base для маршрута при `useRoute({ section })` теперь `combineBases(globalBase, section)`; глобальный base больше не отбрасывается при заданном section.
+- Формулировки в README и демо: единый термин **section** (убраны «префикс» и «локальный base» в тексте для пользователя).
+
+## [1.0.0] - 2024-12-01
+
+### Добавлено
+
+- Первый релиз.
+- Хук `useRoute(options?)`: `pathname`, `searchParams`, `navigate`, `replace`, `back`, `forward`, `canGoBack`, `canGoForward`, `state`, опционально `pattern` и параметры URL.
+- `configureRouter(options)`: глобальные `base`, `logger`, `initialLocation` (SSR).
+- Интеграция с Navigation API; запасной вариант для старых окружений.

package/README.md

@@ -21,7 +21,7 @@
 [![bundle](https://img.shields.io/bundlephobia/minzip/@budarin/use-route)](https://bundlephobia.com/result?p=@budarin/use-route)
 [![GitHub](https://img.shields.io/github/license/budarin/use-route)](https://github.com/budarin/use-route)
 
-**Живое демо:** запуск в браузере без установки; исходники в папке [demo/](https://github.com/budarin/use-route/tree/master/demo).
+**Живое демо:** запуск в браузере без установки;.
 
 - [Open in StackBlitz](https://stackblitz.com/github/budarin/use-route/tree/master/demo)
 - [Open in CodeSandbox](https://codesandbox.io/p/sandbox/github/budarin/use-route/tree/master/demo)

package/demo/package.json

@@ -9,7 +9,7 @@
         "preview": "vite preview"
     },
     "dependencies": {
-        "@budarin/use-route": "workspace:*",
+        "@budarin/use-route": "^1.1.0",
         "react": "^19.0.0",
         "react-dom": "^19.0.0"
     },

package/demo/src/App.tsx

@@ -11,7 +11,7 @@ import { BaseDemo } from './pages/BaseDemo';
 
 function Nav() {
     const { pathname, searchParams, back, forward, canGoBack, canGoForward } = useRoute();
-    const base = pathname.startsWith('/base-demo') ? '/base-demo' : '';
+    const section = pathname.startsWith('/base-demo') ? '/base-demo' : '';
     const urlPath = pathname + (searchParams.toString() ? '?' + searchParams.toString() : '');
 
     return (
@@ -33,54 +33,56 @@ function Nav() {
                 </button>
                 <span style={{ width: '0.5rem' }} />
                 <Link
-                    to={base || '/'}
-                    className={pathname === (base || '/') ? 'active' : ''}
+                    to={section || '/'}
+                    className={pathname === (section || '/') ? 'active' : ''}
                     title="Главная страница демо"
                 >
                     Главная
                 </Link>
                 <Link
-                    to={(base || '') + '/users'}
-                    className={pathname === (base || '') + '/users' ? 'active' : ''}
+                    to={(section || '') + '/users'}
+                    className={pathname === (section || '') + '/users' ? 'active' : ''}
                     title="Параметры в URL: /users/123"
                 >
                     Пользователи
                 </Link>
                 <Link
-                    to={(base || '') + '/posts'}
-                    className={pathname.startsWith((base || '') + '/posts') ? 'active' : ''}
+                    to={(section || '') + '/posts'}
+                    className={pathname.startsWith((section || '') + '/posts') ? 'active' : ''}
                     title="Параметры в строке запроса: ?page=2"
                 >
                     Посты
                 </Link>
                 <Link
-                    to={(base || '') + '/history'}
-                    className={pathname === (base || '') + '/history' ? 'active' : ''}
+                    to={(section || '') + '/history'}
+                    className={pathname === (section || '') + '/history' ? 'active' : ''}
                     title="Назад / Вперёд по истории"
                 >
                     История
                 </Link>
                 <Link
-                    to={(base || '') + '/push-replace'}
-                    className={pathname.startsWith((base || '') + '/push-replace') ? 'active' : ''}
+                    to={(section || '') + '/push-replace'}
+                    className={
+                        pathname.startsWith((section || '') + '/push-replace') ? 'active' : ''
+                    }
                     title="Добавить или заменить запись в истории"
                 >
                     Push/Replace
                 </Link>
                 <Link
-                    to={(base || '') + '/products/books/1'}
-                    className={pathname.startsWith((base || '') + '/products') ? 'active' : ''}
+                    to={(section || '') + '/products/books/1'}
+                    className={pathname.startsWith((section || '') + '/products') ? 'active' : ''}
                     title="Свой разбор пути (PathMatcher)"
                 >
                     Товары
                 </Link>
-                {!base ? (
+                {!section ? (
                     <Link
                         to="/base-demo"
                         className={pathname.startsWith('/base-demo') ? 'active' : ''}
-                        title="Раздел с префиксом в URL"
+                        title="Раздел (section) в URL"
                     >
-                        Раздел (base)
+                        Раздел (section)
                     </Link>
                 ) : (
                     <Link to="/">Выйти из раздела</Link>

package/demo/src/pages/BaseDemo.tsx

@@ -8,18 +8,18 @@ export function BaseDemo() {
 
     return (
         <div className="demo-content">
-            <h1>Раздел с префиксом (локальный base)</h1>
+            <h1>Раздел (section)</h1>
             <p className="demo-lead">
                 Когда приложение живёт не в корне сайта, а в подпапке (например <code>/app/</code>),
                 можно задать <code>section: '/base-demo'</code>. Тогда внутри раздела{' '}
                 <code>pathname</code>
-                приходит без префикса, а <code>navigate('/page1')</code> ведёт на{' '}
+                приходит без пути раздела (section), а <code>navigate('/page1')</code> ведёт на{' '}
                 <code>/base-demo/page1</code>. Так удобно писать пути «относительно раздела». Ниже —
                 кнопки перехода внутри раздела и выход на главную.
             </p>
             <p>
                 Сейчас pathname внутри раздела: <code>{pathname || '/'}</code> (в полном адресе к
-                нему добавлен префикс <code>/base-demo</code>).
+                нему добавлен section <code>/base-demo</code>).
             </p>
             <h2>Действия</h2>
             <div className="demo-buttons">
@@ -37,7 +37,7 @@ export function BaseDemo() {
                     Вне приложения → /login (base: '')
                 </button>
                 <button type="button" onClick={() => navigate('/profile', { base: '/base-demo' })}>
-                    С другим base → /base-demo/profile (base: '/base-demo')
+                    С опцией base → /base-demo/profile (base: '/base-demo')
                 </button>
             </div>
         </div>

package/demo/src/pages/Home.tsx

@@ -31,7 +31,7 @@ export function Home() {
                     Push и Replace — как добавлять или заменять запись в истории
                 </button>
                 <Link to="/products/books/1">Товары — свой разбор пути (PathMatcher)</Link>
-                <Link to="/base-demo">Раздел с префиксом (локальный base)</Link>
+                <Link to="/base-demo">Раздел (section)</Link>
             </div>
         </div>
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@budarin/use-route",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/.github/workflows/ci.yml

@@ -1,45 +0,0 @@
-name: CI
-
-on:
-    push:
-        branches: [master]
-        paths:
-            - 'src/**'
-            - 'tests/**'
-            - 'package.json'
-            - 'pnpm-lock.yaml'
-            - 'tsconfig.json'
-            - 'vitest.config.ts'
-            - '.prettierrc'
-            - '.prettierignore'
-            - '.github/workflows/**'
-
-jobs:
-    check:
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@v4
-
-            - uses: pnpm/action-setup@v4
-              with:
-                  version: 9
-
-            - uses: actions/setup-node@v4
-              with:
-                  node-version: '20'
-                  cache: 'pnpm'
-
-            - name: Установка зависимостей
-              run: pnpm install --frozen-lockfile
-
-            - name: Lint
-              run: pnpm lint
-
-            - name: Type-check
-              run: pnpm type-check
-
-            - name: Тесты
-              run: pnpm test:run
-
-            - name: Сборка
-              run: pnpm build