@smartsoft001-mobilems/claude-plugins 2.116.0 → 2.118.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/claude-plugins",
-  "version": "2.116.0",
+  "version": "2.118.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.116.0"
+  "version": "2.118.0"
 }

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

@@ -2,8 +2,8 @@
 
 An article module wraps `ArticlesSharedModule.forFeature` over the npm `Article` entity and filters
 its API requests with a `template` value. Thread `<PREFIX>` (the `environment` import) and the chosen
-`<name>` / `<entity>` / `<template>`. The `Masonry` factory returns the real library in the browser (`window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts`)
-and a no-op mock during SSR. Copy the file structure from an existing article module in the reference
+`<name>` / `<entity>` / `<template>`. `provideBrowserMasonry()` supplies the real library in the browser (`window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts`)
+and `null` during SSR (the grid skips layout). Copy the file structure from an existing article module in the reference
 MobilEMS app and substitute the parameters.
 
 ## `libs/museum-<name>/shell/angular/src/lib/<name>.module.ts`
@@ -15,32 +15,14 @@ import { RouterModule } from '@angular/router';
 import { SharedModule as SmartSharedModule } from '@smartsoft001/angular';
 import { Article } from '@smartsoft001-mobilems/articles-domain';
 import { ArticlesSharedModule } from '@smartsoft001-mobilems/articles-shell-angular';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 import { environment } from '@<PREFIX>/angular';
 
 import { routes } from './<name>.routes';
 
 @NgModule({
-  providers: [
-    {
-      provide: Masonry,
-      useFactory: () => {
-        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-          return (window as any)['Masonry'];
-        }
-        // Return a mock for SSR
-        return class {
-          constructor() {
-            // no-op
-          }
-          layout() { return; }
-          reloadItems() { return; }
-          destroy() { return; }
-        };
-      },
-    },
-  ],
+  providers: [provideBrowserMasonry()],
   imports: [
     FormsModule,
     SmartSharedModule,

package/plugins/mobilems/skills/mobilems-articles/scripts/verify-module.sh

@@ -70,13 +70,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. a list page must render through the framework grid
 LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
 if [ -n "$LISTP" ]; then
@@ -118,6 +127,18 @@ else
   bad "translation gaps — fix the FAIL lines above"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-devops-config/references/workflows.md

@@ -374,6 +374,10 @@ jobs:
       - name: Install Playwright browsers
         run: npx playwright install --with-deps chromium
 
+      # Static guard for the recurring portal bugs (MOB-1889..1895); it reads sources only, so it
+      # runs before the build. Needs @smartsoft001-mobilems/angular with the `mobilems-check-portal` bin.
+      - run: npx mobilems-check-portal
+
       # Prepend any command with "nx-cloud record --" to record its logs to Nx Cloud
       # - run: npx nx-cloud record -- echo Hello World
       - run: npx nx run-many -t lint test build e2e
@@ -382,6 +386,15 @@ jobs:
         if: always()
 ```
 
+> **`mobilems-check-portal` is part of the CI contract.** Whoever enables the workflow keeps the
+> step before the build. A project that builds in `development.yml` instead adds the same
+> `- run: npx mobilems-check-portal` step ahead of its `nx build` step. `scripts/verify-devops.sh`
+> fails when `ci.yml` / `ci.yml.disabled` lacks it.
+>
+> **Existing portal?** It will report dozens of `innerhtml-external-links` findings until it opts
+> into `contentLinks: true`. Use `- run: npx mobilems-check-portal --skip innerhtml-external-links`
+> (or `check-portal-ignore` comments) first, then remove the `--skip` once `contentLinks: true` is set.
+
 > Note: the reference's `ci.yml.disabled` pins Node 20. We thread `{{NODE_VERSION}}` here so the
 > disabled template matches the rest of the project. If a project has a live `ci.yml` on a stale
 > node version, report the drift and ask before changing it.

package/plugins/mobilems/skills/mobilems-devops-config/scripts/verify-devops.sh

@@ -31,6 +31,16 @@ exists .github/workflows/push-to-client.yml
 exists .github/workflows/ai-plan.yml
 exists .github/workflows/ai-impl.yml
 exists .github/workflows/ci.yml.disabled
+# CI runs the portal guard before the build (references/workflows.md)
+CI_FILE=""
+for f in .github/workflows/ci.yml .github/workflows/ci.yml.disabled; do
+  [ -f "$f" ] && { CI_FILE="$f"; break; }
+done
+if [ -n "$CI_FILE" ] && grep -q "mobilems-check-portal" "$CI_FILE"; then
+  pass "$CI_FILE runs mobilems-check-portal"
+else
+  bad "ci.yml (or ci.yml.disabled) does not run mobilems-check-portal"
+fi
 # secrets are referenced, not hardcoded
 [ -f .github/workflows/development.yml ] && grep -q "secrets.GITLAB_TOKEN" .github/workflows/development.yml && pass "development.yml uses secrets" || bad "development.yml secrets.GITLAB_TOKEN"
 

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

@@ -22,13 +22,13 @@ export class MuseumEventsModule {}
 
 ## `events.routes.ts`
 
-Every page is loaded lazily with `loadComponent`. The list route additionally provides the `Masonry`
-SSR factory (the real library in the browser — `window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts` — a no-op mock during SSR). Copy verbatim — there is no
+Every page is loaded lazily with `loadComponent`. The list route additionally provides
+`provideBrowserMasonry()` (the real library in the browser — `window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts` — and `null` during SSR, where the grid skips layout). Copy verbatim — there is no
 `<PREFIX>` to thread here either.
 
 ```ts
 import { Route } from '@angular/router';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 export const eventsRoutes: Route[] = [
   {
@@ -64,27 +64,7 @@ export const eventsRoutes: Route[] = [
     path: '',
     loadComponent: () =>
       import('./pages/list/list.component').then((m) => m.EventsListComponent),
-    providers: [
-      {
-        provide: Masonry,
-        useFactory: () => {
-          if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-            return (window as any)['Masonry'];
-          }
-          return class {
-            layout() {
-              return;
-            }
-            reloadItems() {
-              return;
-            }
-            destroy() {
-              return;
-            }
-          };
-        },
-      },
-    ],
+    providers: [provideBrowserMasonry()],
   },
 ];
 ```

package/plugins/mobilems/skills/mobilems-events/scripts/verify-module.sh

@@ -67,13 +67,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. a list page must render through the framework grid
 LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
 if [ -n "$LISTP" ]; then
@@ -106,6 +115,18 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

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

@@ -4,8 +4,8 @@
 
 Thread `<PREFIX>` (the `environment` + domain imports). `PublicCollectionsSharedModule.forFeature`
 provides the list/detail behaviour over `MuseumCollection`; `CollectionsService` is provided as the
-`CrudService`; the `Masonry` factory returns the real library in the browser and a no-op mock during
-SSR. Note: unlike the objects module this one does NOT import `SmartSharedModule`.
+`CrudService`; `provideBrowserMasonry()` supplies the real library in the browser and `null` during
+SSR (the grid then skips layout). Note: unlike the objects module this one does NOT import `SmartSharedModule`.
 
 ```ts
 import { NgModule } from '@angular/core';
@@ -13,7 +13,7 @@ import { FormsModule } from '@angular/forms';
 import { RouterModule } from '@angular/router';
 import { CrudService } from '@smartsoft001/crud-shell-angular';
 import { PublicCollectionsSharedModule } from '@smartsoft001-mobilems/public-collections-shell-angular';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 import { environment } from '@<PREFIX>/angular';
 import { MuseumCollection } from '@<PREFIX>/museum-collections/domain';
@@ -28,29 +28,7 @@ import { CollectionsService } from './services';
       provide: CrudService,
       useClass: CollectionsService,
     },
-    {
-      provide: Masonry,
-      useFactory: () => {
-        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-          return (window as any)['Masonry'];
-        }
-        // Return a mock for SSR
-        return class {
-          constructor() {
-            // no-op
-          }
-          layout() {
-            return;
-          }
-          reloadItems() {
-            return;
-          }
-          destroy() {
-            return;
-          }
-        };
-      },
-    },
+    provideBrowserMasonry(),
   ],
   imports: [
     FormsModule,

package/plugins/mobilems/skills/mobilems-object-collections/scripts/verify-module.sh

@@ -53,13 +53,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. the ITEM page renders its objects grid through the framework grid — in the
 #    reference the collections LIST is a plain grid; masonry lives on the item page
 ITEMP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'item*' 2>/dev/null || true)"
@@ -102,6 +111,18 @@ else
   bad "translation gaps — fix the FAIL lines above"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

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

@@ -66,7 +66,7 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    with the `Masonry` SSR factory. Add the lazy `obiekty` route to `appRoutes` in
    `apps/web/src/app/app.routes.ts` and a matching child under the `wyszukaj/:text` search route.
 4. **Objects shared components** — see `references/shared-components.md`: build `objects-grid-item`,
-   `objects-list-item` (each `extends` the framework `Objects…ItemBaseComponent`, with the app's own markup), and the object gallery widget (`widget/gallery-object`) in the shared lib +
+   `objects-list-item` (each `extends` the framework `Objects…ItemBaseComponent`, with the app's own markup), and the object gallery widget (`widget/gallery-object`, `extends` the framework `WidgetGalleryObjectBaseComponent`) in the shared lib +
    export them; and register the object gallery widget in the widget content-type map (`GALLERY_OBJECT`).
    `ISpecificObject` and the filter models come from `@smartsoft001-mobilems/objects-shell-angular`.
 5. **Translations** — copy the module's translation groups (`OBJECTS`, `DETAILS_PAGE`, `GALLERY`) from the reference

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

@@ -3,8 +3,8 @@
 ## `libs/museum-objects/shell/angular/src/lib/objects.module.ts`
 
 Thread `<PREFIX>` (the `environment` import). `ObjectsSharedModule.forFeature` provides the list/detail
-behaviour over `MsObject`; the `Masonry` factory returns the real library in the browser and a no-op
-mock during SSR.
+behaviour over `MsObject`; `provideBrowserMasonry()` supplies the real library in the browser and `null`
+during SSR (the grid then skips layout).
 
 ```ts
 import { NgModule } from '@angular/core';
@@ -13,38 +13,14 @@ import { RouterModule } from '@angular/router';
 import { SharedModule as SmartSharedModule } from '@smartsoft001/angular';
 import { MsObject } from '@smartsoft001-mobilems/objects-domain';
 import { ObjectsSharedModule } from '@smartsoft001-mobilems/objects-shell-angular';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 import { environment } from '@<PREFIX>/angular';
 
 import { routes } from './objects.routes';
 
 @NgModule({
-  providers: [
-    {
-      provide: Masonry,
-      useFactory: () => {
-        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-          return (window as any)['Masonry'];
-        }
-        // Return a mock for SSR
-        return class {
-          constructor() {
-            // no-op
-          }
-          layout() {
-            return;
-          }
-          reloadItems() {
-            return;
-          }
-          destroy() {
-            return;
-          }
-        };
-      },
-    },
-  ],
+  providers: [provideBrowserMasonry()],
   imports: [
     FormsModule,
     SmartSharedModule,

package/plugins/mobilems/skills/mobilems-objects/references/shared-components.md

@@ -32,7 +32,8 @@ export * from './objects-list-item';
 
 ## 2. Object gallery widget
 
-Build `components/widget/gallery-object` and export it from the widget barrel:
+Build `components/widget/gallery-object` as `extends WidgetGalleryObjectBaseComponent` (from
+`@smartsoft001-mobilems/angular`) with the app's own markup and styles, and export it from the widget barrel:
 
 ```ts
 // components/widget/index.ts:

package/plugins/mobilems/skills/mobilems-objects/scripts/verify-module.sh

@@ -59,13 +59,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. a list page must render through the framework grid
 LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
 if [ -n "$LISTP" ]; then
@@ -107,6 +116,18 @@ else
   bad "translation gaps — fix the FAIL lines above"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

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

@@ -4,8 +4,8 @@
 
 Thread `<PREFIX>` (the `environment` import). This module REUSES `ArticlesSharedModule` (the same
 shared module the news/articles/thematic-paths modules use) but configures it over the Articles
-`Article` type with its OWN `getReducer` and **no `baseQuery`**. The `Masonry` factory returns the
-real library in the browser and a no-op mock during SSR (identical to objects). It provides the
+`Article` type with its OWN `getReducer` and **no `baseQuery`**. `provideBrowserMasonry()` supplies the
+real library in the browser and `null` during SSR (identical to objects). It provides the
 `SERVICES` array (which binds both `CrudService` and `ArticlesService` to `PartnersService`).
 
 ```ts
@@ -14,7 +14,7 @@ import { FormsModule } from '@angular/forms';
 import { RouterModule } from '@angular/router';
 import { Article } from '@smartsoft001-mobilems/articles-domain';
 import { ArticlesSharedModule } from '@smartsoft001-mobilems/articles-shell-angular';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 import { environment } from '@<PREFIX>/angular';
 
@@ -23,32 +23,7 @@ import { routes } from './partners.routes';
 import { SERVICES } from './services';
 
 @NgModule({
-  providers: [
-    ...SERVICES,
-    {
-      provide: Masonry,
-      useFactory: () => {
-        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-          return (window as any)['Masonry'];
-        }
-        // Return a mock for SSR
-        return class {
-          constructor() {
-            // no-op
-          }
-          layout() {
-            return;
-          }
-          reloadItems() {
-            return;
-          }
-          destroy() {
-            return;
-          }
-        };
-      },
-    },
-  ],
+  providers: [...SERVICES, provideBrowserMasonry()],
   imports: [
     FormsModule,
     ArticlesSharedModule.forFeature({

package/plugins/mobilems/skills/mobilems-partners/scripts/verify-module.sh

@@ -68,13 +68,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. a list page must render through the framework grid
 LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
 if [ -n "$LISTP" ]; then
@@ -116,6 +125,18 @@ else
   bad "translation gaps — fix the FAIL lines above"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-project-init/references/app-shell.md

@@ -69,14 +69,19 @@ The framework ships the bases; the app keeps the templates (design) and the data
   `PageHeadingOwner`; the template renders `loading()`, `loadFailed()` (→ `app-error-retry (retry)="retry()"`),
   the breadcrumb declaration (`pageRoute ?? '/strona/' + id + '/' + (title | smartSlug)`), a hidden `h1`
   unless `sectionsHaveH1()`, and `<smart-mobilems-page-sections [sections]="pageData.sections ?? null">`
-  with `[innerHTML]="contentHtml()"` in the slot. Routes use `pageResolver` (`strona/:id`) and
+  with `[innerHTML]="contentHtml()"` in the slot. CMS `[innerHTML]` links (leave-site modal, `rel`,
+  new-tab note, `#id` scroll without a route change) are handled by `AppComponent`'s content-link
+  directives, but only when `provideMobilemsApp({ contentLinks: true })` is set — it is **opt-in, off by
+  default**, so the foundation sets it (`references/config-providers.md`). With `contentLinks: false`
+  (or unset), every `[innerHTML]` carries `smartExternalLinks smartInPageAnchors` itself, otherwise
+  `mobilems-check-portal` fails `innerhtml-external-links`. Routes use `pageResolver` (`strona/:id`) and
   `createSlugPageResolver('kontakt', { emptyTitleKey: 'CONTACT.pageTitle' })` with
   `runGuardsAndResolvers: 'always'` and `data: { pageRoute: '/kontakt' }` for `/kontakt`.
 - `search.component` extends `SearchBaseComponent<'obiekty' | …>` and declares only `tabDefinitions`
   (`{ id, labelKey: 'SEARCH.tabs.*', count: (d) => d.objects }` per module the app ships); the template
   renders the heading, `app-tabs` with `[(activeTabId)]="activeTab"` and a `<router-outlet>`.
 - `not-found.component` extends `NotFoundComponent` and renders `<smart-mobilems-not-found-content
-  [fullHeight]="true" />` (plus the breadcrumb declaration with `url`).
+[fullHeight]="true" />` (plus the breadcrumb declaration with `url`).
 
 Run a feature-package grep over the pages you copy as a guard. **Do not copy `article-preview`** — the
 reference's `article-preview` page imports `@smartsoft001-mobilems/articles-domain` (it previews an

package/plugins/mobilems/skills/mobilems-project-init/references/config-providers.md

@@ -45,12 +45,19 @@ export const appConfig: ApplicationConfig = {
     provideMobilemsApp({
       environment, // provides MOBILEMS_ENVIRONMENT; `version` defaults to environment.version
       languages: { available: ['pl', 'en'], default: 'pl' },
+      contentLinks: true, // opt-in (off by default): the shell handles external and #id links in CMS content
       skipLinks: {
         home: [
-          { targetId: 'main-new-objects', translationKey: 'HOME.accessibility.skipToNewObjects' },
+          {
+            targetId: 'main-new-objects',
+            translationKey: 'HOME.accessibility.skipToNewObjects',
+          },
         ],
         subpage: [
-          { targetId: 'main-content', translationKey: 'HOME.accessibility.skipToContent' },
+          {
+            targetId: 'main-content',
+            translationKey: 'HOME.accessibility.skipToContent',
+          },
         ],
       },
       // Produkcyjnie translacje są własnością CMS-a klienta (setting/theme),
@@ -65,7 +72,11 @@ export const appConfig: ApplicationConfig = {
       },
       seo: {
         siteNameFallback: { pl: '<NAZWA MUZEUM>', en: '<MUSEUM NAME>' },
-        defaultOgImage: { url: '/gfx/og-default.jpg', width: 1200, height: 630 },
+        defaultOgImage: {
+          url: '/gfx/og-default.jpg',
+          width: 1200,
+          height: 630,
+        },
         siteUrl: () => environment.siteUrl,
       },
     }),

package/plugins/mobilems/skills/mobilems-project-init/references/qa-hardening.md

@@ -121,3 +121,42 @@ These conventions were enforced by QA across modules — bake them in from the s
 - **Image fallback:** cards show the app's `no-image` placeholder when a thumbnail fails to load.
 - Keyword/tag chips must wrap on 360 px wide screens — no page-level horizontal scroll at
   360/768/1024/1440.
+
+## 8. Recurring portal bugs (MOB-1889..1895)
+
+Run `npx mobilems-check-portal` (it is part of `scripts/verify-init.sh` and of CI, see
+`mobilems-devops-config`). It reads sources only, so the items marked "manual" still need a check in
+the browser or against the SSR response. Each item says what enforces it.
+
+- [ ] **CLS < 0.1 with SSR.** No `[width]`/`[height]` bound to `naturalWidth`/`naturalHeight`, images
+      reserve their space. _Enforced in part_: `natural-size-binding`. Measure the rest (Lighthouse).
+- [ ] **`Content-Encoding` on the HTML.** `createServer` compresses by default (`compression` peer
+      installed, `ICompressionOptions` to tune); do not add a second `compression()`. _Manual_:
+      `curl -sI -H 'Accept-Encoding: gzip' <url>`.
+- [ ] **No `window is not defined` in SSR logs.** Masonry via `provideBrowserMasonry()`, browser-only work
+      behind `isPlatformBrowser`. _Enforced in part_: `masonry-stub`. Read the server log on the first load.
+- [ ] **Modal for a link in content, menu and footer.** Set `provideMobilemsApp({ contentLinks: true })`
+      (opt-in, off by default) or put `smartExternalLinks` on each `[innerHTML]` host and on the menu and
+      footer. _Enforced_: `innerhtml-external-links` (skipped only with the opt-in). Menu/footer: manual.
+- [ ] **Footnote without route change.** A `#id` link scrolls inside the page (`contentLinks` covers it
+      in content). _Manual_: click a footnote, the URL path must not change.
+- [ ] **Photos uncropped and ≤ 50svh.** No `object-cover` on museum photos; cap the height at `50svh`.
+      _Enforced in part_: `object-cover` (the height cap is manual).
+- [ ] **No placeholders in Contact/footer.** _Enforced_: `contact-placeholder` (`Przykładowa`,
+      `00 000 00 00`).
+- [ ] **SVG icons and a safe download filename.** An icon component, not an emoji, arrow or cross glyph;
+      the download name comes from `photoFileName`. _Enforced in part_: `template-emoji` (the filename
+      is manual).
+- [ ] **Year debounce 500 ms.** The year range filter extends the framework date-input base
+      (`FILTER_DATE_INPUT_DEBOUNCE_MS = 500`). _Manual_.
+- [ ] **Filter pill ≥ 24 px.** WCAG 2.2 target size for the active-filter pills. _Manual_ (`ui-a11y-validator`).
+- [ ] **Hover only with a pointer.** `presets: [mobilemsPreset]` (`hoverOnlyWhenSupported`), see
+      `tailwind-styles.md`. _Manual_: no sticky hover on a touch emulation.
+- [ ] **List chunk without `three`.** `online-3d-viewer` is loaded with `createLazyLoader(() => import(…))`,
+      never a static import. _Enforced_: `static-online-3d-viewer`. Confirm in the build stats.
+- [ ] **No `width="0"` in SSR HTML.** _Enforced in part_: `natural-size-binding`. Grep the SSR
+      response: `curl -s <url> | grep -c 'width="0"'`.
+- [ ] **`loading="lazy"` below the first screen.** The LCP image stays eager. _Manual_.
+
+To accept a finding on purpose, add `check-portal-ignore <rule>: reason` on the line (see the framework
+README, `mobilems-check-portal`).

package/plugins/mobilems/skills/mobilems-project-init/references/shared-lib.md

@@ -100,6 +100,23 @@ Build it registering only the **foundation widgets** — `text`, `image`, `video
 and type-map entries when they build those widgets. Build the widget barrel
 (`components/widget/index.ts`) exporting the foundation widgets only.
 
+The foundation `image`, `audio`, `media` and `gallery-image` widgets are generated as `extends
+WidgetImageBaseComponent` / `WidgetAudioBaseComponent` / `WidgetMediaBaseComponent` /
+`WidgetGalleryImageBaseComponent`, with the app's own markup and styles; `text` extends
+`WidgetBaseComponent` and `video` has no framework base. The framework ships no templates.
+
+The bases read template refs, so the generated markup must provide them:
+
+- **`gallery-image`**: the grid element carries `#masonryGrid` and contains one
+  `<div class="masonry-grid-sizer"></div>` (column width), one `<div class="masonry-gutter-sizer"></div>`
+  (gutter) and the `.masonry-item` tiles. Give both sizers their widths in the app CSS, with the same
+  768/1024 px breakpoints as `WIDGET_GALLERY_IMAGE_BREAKPOINTS`. A missing sizer only degrades (gutter `0`,
+  column width from the first tile, one dev-mode `console.warn`), so do not rely on the fallback.
+  Provide `Masonry` with `provideBrowserMasonry()`.
+- **`audio`**: an `<audio #player>` element bound to the events listed in the base's README row.
+- `alt` is an input on `WidgetImageBaseComponent` but a derived computed on
+  `WidgetGalleryImageBaseComponent` — bind widget inputs per type in the container, never `alt` on every widget.
+
 ## Models — framework, not the lib
 
 The museum API models (`IObject`, `IImage`, `IDictionary`, `IDictionaryEntry`, `IArticleListItem`,
@@ -129,16 +146,16 @@ files duplicate exports that now exist; copying those is the single most common
 
 Framework now — do **not** generate (import from `@smartsoft001-mobilems/angular`):
 
-| Kind         | Framework exports                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
-| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| environment  | `createMobilemsEnvironment`, `MOBILEMS_ENVIRONMENT`, `EnvironmentService`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| pipes        | `altText`, `fileUrl`, `backgroundUrl`, `plainText`, `stripAnchors`, `capitalize`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| tools        | `classifyLink`, `isInternalLink`, `normalizeUrl`, `stripHtml`, `formatNamedEntries`, `normalizeSearchText`, `newTabText`, `pageToOffset`, `decodeHtmlEntities`, `ElementIdSequence`, `createSafeTimeouts`, `photoFileName`/`urlExtension`, `widgetImageUrl`, `overflowingTags`, `themeTagKey`, `themeTagsLayout`, `THEME_TAGS_VISIBLE_LIMIT`, `resolveMenuItemTarget`, `isNavigableMenuItem` (+ `MenuItemTarget`), `objectCardMeta`/`objectCardPlace`/`objectCardExhibition`/`exhibitionText` (+ `IObjectCardSource`), `SERIES_TITLES_FILTER`, `catalogEntryFilterParams` (the named-entries filter query params), `recommendedPerPage`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| directives   | `a[smartExternalLink]`, `[smartExternalLinks]`, `[smartFocusTrap]`, `[smartTruncatedTitle]`, `[smartInPageAnchors]` (`InPageAnchorsDirective`; references use `app…` — rename the attributes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| services     | `ConfirmationModalService`, `ExternalLinkConfirmationService`, `FilterPersistenceService`, `OrientationService`, `WcagChangesService`, `LineHeightService`, `BreadcrumbsService`, `ContactService`, `DataService`, `MuseumSeoService`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| interceptors | `LanguageInterceptor`, `PreviewAuthInterceptor`, `SsrTimeoutInterceptor`, `DedupeRequestInterceptor`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
-| bases        | `CalendarBaseComponent`, `PaginationDotsBaseComponent`, `PaginationBaseComponent`, `CarouselBaseComponent`, `PartnersCarouselBaseComponent`, `NewObjectsCarouselBaseComponent`, `ArticlesCarouselBaseComponent`, `SliderBaseComponent` (+ `ISliderOptions`; `ScrollTopComponent` is server-guarded), `GalleryBaseComponent`, `GalleryFullscreenDialogBaseComponent` (`GalleryFullscreenBaseComponent` is `@deprecated`), `ConfirmationModalBaseComponent`, `NewsletterModalBaseComponent`, `MapBaseComponent`, `FilterInputBaseComponent`, `FilterDateInputBaseComponent`, `FilterCustomDictionaryInputBaseComponent`, `FilterDictionaryInputBaseComponent` (inline tree, `source`, paging), `ThemeTagsFilterBaseComponent`, `CatalogFilterBarBaseComponent`, `CatalogToolbarBaseComponent`, `SearchbarBaseComponent`, `SelectCheckboxBaseComponent` (+ `ISelectionHooks`), `DropdownBaseComponent`, `TabsBaseComponent`, `WcagBaseComponent` (+ `WCAG_OPTION_GROUPS`), `BreadcrumbsBaseComponent`, `BreadcrumbsBarBaseComponent`, `MenuItemBaseComponent`, `ObjectCardBaseComponent`, `ObjectsGridItemBaseComponent`, `ObjectsListItemBaseComponent`, `CollectionCardBaseComponent`, `CollectionsGridItemBaseComponent`, `FavoriteButtonBaseComponent` (+ `IFavoriteHooks`, `IFavoriteRef`), `FavoritesNoticeBaseComponent`, `SelectionActionsBaseComponent`, `DownloadCardsBaseComponent`, `RecommendedBaseComponent` |
-| SSR tools    | `injectServerResponseInit`, `appendPreloadLinks` (image preload `Link` headers)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| Kind         | Framework exports                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| environment  | `createMobilemsEnvironment`, `MOBILEMS_ENVIRONMENT`, `EnvironmentService`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| pipes        | `altText`, `fileUrl`, `backgroundUrl`, `plainText`, `stripAnchors`, `capitalize`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| tools        | `classifyLink`, `isInternalLink`, `normalizeUrl`, `stripHtml`, `formatNamedEntries`, `normalizeSearchText`, `newTabText`, `pageToOffset`, `decodeHtmlEntities`, `ElementIdSequence`, `createSafeTimeouts`, `createLazyLoader` (single-flight dynamic `import()`, e.g. `online-3d-viewer`), `photoFileName`/`urlExtension`, `widgetImageUrl`, `overflowingTags`, `themeTagKey`, `themeTagsLayout`, `THEME_TAGS_VISIBLE_LIMIT`, `resolveMenuItemTarget`, `isNavigableMenuItem` (+ `MenuItemTarget`), `objectCardMeta`/`objectCardPlace`/`objectCardExhibition`/`exhibitionText` (+ `IObjectCardSource`), `SERIES_TITLES_FILTER`, `catalogEntryFilterParams` (the named-entries filter query params), `recommendedPerPage`, `widgetDomId`, `cleanWidgetText`, `formatFileSize`, `safeDecode`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| directives   | `a[smartExternalLink]`, `[smartExternalLinks]`, `[smartFocusTrap]`, `[smartTruncatedTitle]`, `[smartInPageAnchors]` (`InPageAnchorsDirective`; references use `app…` — rename the attributes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| services     | `ConfirmationModalService`, `ExternalLinkConfirmationService`, `FilterPersistenceService`, `OrientationService`, `WcagChangesService`, `LineHeightService`, `BreadcrumbsService`, `ContactService`, `DataService`, `MuseumSeoService`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| interceptors | `LanguageInterceptor`, `PreviewAuthInterceptor`, `SsrTimeoutInterceptor`, `DedupeRequestInterceptor`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| bases        | `CalendarBaseComponent`, `PaginationDotsBaseComponent`, `PaginationBaseComponent`, `CarouselBaseComponent`, `PartnersCarouselBaseComponent`, `NewObjectsCarouselBaseComponent`, `ArticlesCarouselBaseComponent`, `SliderBaseComponent` (+ `ISliderOptions`; `ScrollTopComponent` is server-guarded), `GalleryBaseComponent`, `GalleryFullscreenDialogBaseComponent` (`GalleryFullscreenBaseComponent` is `@deprecated`), `ConfirmationModalBaseComponent`, `NewsletterModalBaseComponent`, `MapBaseComponent`, `FilterInputBaseComponent`, `FilterDateInputBaseComponent`, `FilterCustomDictionaryInputBaseComponent`, `FilterDictionaryInputBaseComponent` (inline tree, `source`, paging), `ThemeTagsFilterBaseComponent`, `CatalogFilterBarBaseComponent`, `CatalogToolbarBaseComponent`, `SearchbarBaseComponent`, `SelectCheckboxBaseComponent` (+ `ISelectionHooks`), `DropdownBaseComponent`, `TabsBaseComponent`, `WcagBaseComponent` (+ `WCAG_OPTION_GROUPS`), `BreadcrumbsBaseComponent`, `BreadcrumbsBarBaseComponent`, `MenuItemBaseComponent`, `ObjectCardBaseComponent`, `ObjectsGridItemBaseComponent`, `ObjectsListItemBaseComponent`, `CollectionCardBaseComponent`, `CollectionsGridItemBaseComponent`, `FavoriteButtonBaseComponent` (+ `IFavoriteHooks`, `IFavoriteRef`), `FavoritesNoticeBaseComponent`, `SelectionActionsBaseComponent`, `DownloadCardsBaseComponent`, `RecommendedBaseComponent`, `WidgetImageBaseComponent`, `WidgetMediaBaseComponent`, `WidgetGalleryImageBaseComponent`, `WidgetAudioBaseComponent`, `WidgetGalleryObjectBaseComponent` (all extend `WidgetBaseComponent`) |
+| SSR tools    | `injectServerResponseInit`, `appendPreloadLinks` (image preload `Link` headers)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 
 What stays in the app lib: the **template and styles** of every base above — the museum keeps its
 own HTML and Tailwind classes (the filter inputs, searchbar, catalog toolbar and filter bar, theme tags and select

package/plugins/mobilems/skills/mobilems-project-init/references/tailwind-styles.md

@@ -11,7 +11,10 @@ WCAG-clean skin. The token **keys** are the structural contract the templates us
 as written. Step 9 swaps the values for the client's brand spec if there is one.
 
 ```js
-const { mobilemsContent } = require('@smartsoft001-mobilems/angular/tailwind');
+const {
+  mobilemsContent,
+  mobilemsPreset,
+} = require('@smartsoft001-mobilems/angular/tailwind');
 
 /** @type {import('tailwindcss').Config} */
 module.exports = {
@@ -20,8 +23,7 @@ module.exports = {
     './libs/**/*.{html,ts}',
     ...mobilemsContent,
   ],
-  prefix: 'smart-',
-  darkMode: ['class', '[class~="contrast-high"]'],
+  presets: [mobilemsPreset],
   theme: {
     extend: {
       colors: {
@@ -76,7 +78,10 @@ module.exports = {
 > needed when modules arrive. `mobilemsContent` adds the framework component templates (app shell,
 > 404, page sections, module pages): their `smart-*` classes live in `node_modules`, so without it
 > they are missing from the app CSS — the framework skip links carry their own inline styles, the
-> rest does not. `darkMode` keys off `contrast-high` for the WCAG high-contrast toggle.
+> rest does not. `mobilemsPreset` (opt-in, no `content`, no `theme`) carries what every portal shares:
+> the `smart-` `prefix`, `darkMode` keyed off `contrast-high` for the WCAG high-contrast toggle, and
+> `future.hoverOnlyWhenSupported`, which wraps `hover:` in `@media (hover: hover)` so touch devices no
+> longer get sticky hover states. Brand tokens stay in this file's `theme.extend`.
 
 > **Font tokens are named by role** (`heading`, `body`, `ui`), never after a typeface or a project.
 > In reference mode the copied templates may use the source project's own token names — remap those

package/plugins/mobilems/skills/mobilems-project-init/scripts/verify-init.sh

@@ -143,6 +143,18 @@ else
   pass "workspace aliases use @$PREFIX/"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-search/scripts/verify-search.sh

@@ -56,6 +56,18 @@ else
   echo "  SKIP: mobilems-check-translations niedostępny w tym projekcie (starsza linia frameworka)"
 fi
 
+echo "== Strażnik portalu =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "brak naruszeń strażnika portalu"
+  else
+    bad "strażnik portalu zgłosił błędy — popraw wypisane wyżej"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal niedostępny w tym projekcie (starsza linia frameworka)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-static-pages/scripts/verify-pages.sh

@@ -53,6 +53,18 @@ else
   echo "  SKIP: mobilems-check-translations niedostępny w tym projekcie (starsza linia frameworka)"
 fi
 
+echo "== Strażnik portalu =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "brak naruszeń strażnika portalu"
+  else
+    bad "strażnik portalu zgłosił błędy — popraw wypisane wyżej"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal niedostępny w tym projekcie (starsza linia frameworka)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

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

@@ -4,8 +4,8 @@
 
 Thread `<PREFIX>` (the `environment` + domain imports). This module REUSES `ArticlesSharedModule`
 (the same shared module the news/articles modules use) but configures it over its OWN
-`MuseumThematicPath` entity with its OWN `getReducer` and **no `baseQuery`**. The `Masonry` factory
-returns the real library in the browser (`window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts`) and a no-op mock during SSR (identical to objects).
+`MuseumThematicPath` entity with its OWN `getReducer` and **no `baseQuery`**. `provideBrowserMasonry()`
+supplies the real library in the browser (`window.Masonry`, set by `bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap` in `main.ts`) and `null` during SSR (identical to objects).
 
 ```ts
 import { NgModule } from '@angular/core';
@@ -13,7 +13,7 @@ import { FormsModule } from '@angular/forms';
 import { RouterModule } from '@angular/router';
 import { SharedModule as SmartSharedModule } from '@smartsoft001/angular';
 import { ArticlesSharedModule } from '@smartsoft001-mobilems/articles-shell-angular';
-import { Masonry } from '@thisissoon/angular-masonry';
+import { provideBrowserMasonry } from '@smartsoft001-mobilems/angular';
 
 import { environment } from '@<PREFIX>/angular';
 import { MuseumThematicPath } from '@<PREFIX>/museum-thematic-paths/domain';
@@ -24,33 +24,7 @@ import { SERVICES } from './services';
 import { routes } from './thematic-paths.routes';
 
 @NgModule({
-  providers: [
-    ThematicPathsFacade,
-    ...SERVICES,
-    {
-      provide: Masonry,
-      useFactory: () => {
-        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
-          return (window as any)['Masonry'];
-        }
-        // Return a mock for SSR
-        return class {
-          constructor() {
-            // no-op
-          }
-          layout() {
-            return;
-          }
-          reloadItems() {
-            return;
-          }
-          destroy() {
-            return;
-          }
-        };
-      },
-    },
-  ],
+  providers: [ThematicPathsFacade, ...SERVICES, provideBrowserMasonry()],
   imports: [
     FormsModule,
     SmartSharedModule,

package/plugins/mobilems/skills/mobilems-thematic-publications/scripts/verify-module.sh

@@ -64,13 +64,22 @@ fi
 # 2. the Masonry provider exists ONLY to feed MasonryGridComponent. Providing it without ever
 #    rendering the component means the grid was hand-rolled some other way (CSS columns, flex, …),
 #    which the `new Masonry(` grep above cannot see.
-if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
+if grep -rqE "provide: Masonry|provideBrowserMasonry" "$LIBDIR" 2>/dev/null; then
   if grep -rq "smart-mobilems-masonry-grid" "$LIBDIR" 2>/dev/null; then
     pass "grids render via <smart-mobilems-masonry-grid>"
   else
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
+# 2b. the provider is provideBrowserMasonry() — an anonymous stand-in class next to
+#     `provide: Masonry` reaches for window during SSR and is the bug the framework removed
+STUB="$(grep -rlE "provide: Masonry" "$LIBDIR" 2>/dev/null | xargs grep -lE "return class|: class \{" 2>/dev/null || true)"
+if [ -n "$STUB" ]; then
+  bad "hand-written Masonry stub (return class / : class {) — use provideBrowserMasonry() from @smartsoft001-mobilems/angular:"
+  printf '        %s\n' $STUB >&2
+else
+  pass "no hand-written Masonry stub"
+fi
 # 3. a list page must render through the framework grid
 LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
 if [ -n "$LISTP" ]; then
@@ -103,6 +112,18 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Portal guard =="
+# Static guard for the recurring portal bugs (MOB-1889..1895); needs @smartsoft001-mobilems/angular with the bin.
+if [ -x node_modules/.bin/mobilems-check-portal ]; then
+  if npx --no-install mobilems-check-portal; then
+    pass "mobilems-check-portal clean"
+  else
+    bad "mobilems-check-portal found recurring portal bugs — fix the FAIL lines above"
+  fi
+else
+  echo "  SKIP: mobilems-check-portal unavailable in this project (older framework line)"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"