@smartsoft001-mobilems/claude-plugins 2.100.0 → 2.101.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/claude-plugins",
-  "version": "2.100.0",
+  "version": "2.101.0",
   "publishConfig": {
     "access": "public"
   },

package/plugins/mobilems/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "mobilems",
   "description": "MobilEMS-specific Claude Code skills (MuzaCMS / MobileMS indexer API)",
-  "version": "2.100.0"
+  "version": "2.101.0"
 }

package/plugins/mobilems/skills/mobilems-articles/SKILL.md

@@ -60,6 +60,7 @@ list — re-implementing framework code is a defect, not a shortcut:
 | a masonry grid (`new Masonry(...)`, per-page masonry JS/CSS) | `<smart-mobilems-masonry-grid>` (`MasonryGridComponent`) with a `#masonryContentTpl`; the `Masonry` provider only feeds it                        |
 | filter state / hand-built `query` arrays                     | `FiltersBaseComponent<Article>` + its `FiltersContext` accessors (`searchText`, `authors`, `cycles`, `publicationDateFrom/To`, `page`, `sort`, …) |
 | list/detail plumbing (facade wiring, id-from-route, PDF)     | the `ArticlesListComponent` / `ArticlesItemComponent` base classes                                                                                |
+| CMS preview logic (query params, credentialed fetch, states) | the `ArticlesPreviewComponent` base class — the app's `/article-preview` component is view-only                                                   |
 | media URLs, meta/OG tags, filter dictionaries, modals, WCAG  | `FileUrlService`, `SeoService`/`MetaService`, `DictionaryService`, `ModalService`, `WcagService`                                                  |
 | a content-block renderer                                     | `WidgetComponent` + the `ArticleWidgetType` map                                                                                                   |
 
@@ -94,7 +95,8 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    SSR factory. Add the lazy `<route>` route to `appRoutes` in `apps/web/src/app/app.routes.ts`, and a
    matching child under the `wyszukaj/:text` search route if the module's results belong in site search.
    Also build the app's **`/article-preview` page** if it isn't there yet (it previews an `Article`, so
-   it belongs to the articles feature, not the foundation) — idempotent across runs; see
+   it belongs to the articles feature, not the foundation) — component, client route **and** the
+   `RenderMode.Client` server route in `app.routes.server.ts`; idempotent across runs; see
    `references/module-and-routes.md`.
 5. **Article card shared components** — see `references/shared-components.md`: build the module's grid
    and list cards (`<name>-grid-item`, `<name>-list-item`) in `libs/shared/angular` and export them; if

package/plugins/mobilems/skills/mobilems-articles/references/module-and-routes.md

@@ -160,7 +160,12 @@ feature — the foundation deliberately leaves it out. Build it the first time a
 added, and skip it if it already exists (idempotent across article-module runs):
 
 1. Copy `apps/web/src/app/article-preview/` (`.component.ts` + `.html`) from the reference app, thread
-   `<PREFIX>`.
+   `<PREFIX>`. The component **extends `ArticlesPreviewComponent`** from
+   `@smartsoft001-mobilems/articles-shell-angular` and owns only the view (imports, the
+   `PARENT_TITLE_TOKEN` provider and an effect feeding `plainTitle()` into it). Do not re-implement
+   query-param handling, the credentialed fetch or the `loading` / `noLogin` / `noQueryParams` states —
+   the base exposes them, plus `item`, `widgets` and `authorsText`. If the app's thematic-paths route
+   is not `/sciezki-tematyczne`, override `protected readonly thematicPathRoute`.
 2. Add its route to `appRoutes` in `apps/web/src/app/app.routes.ts` (a plain top-level route, before
    the `**` catch-all):
 
@@ -173,3 +178,15 @@ added, and skip it if it already exists (idempotent across article-module runs):
       ),
   },
 ```
+
+3. Add its server route to `serverRoutes` in `apps/web/src/app/app.routes.server.ts`, before the
+   `**` catch-all. This step is **mandatory**: the preview fetches `dataUrl` with `withCredentials`,
+   and the CMS session cookie exists only in the browser. Rendered on the server, the request has no
+   cookie, the page lands in the `noLogin` state and hydration replays that error.
+
+```ts
+  {
+    path: 'article-preview',
+    renderMode: RenderMode.Client,
+  },
+```