@smartsoft001-mobilems/claude-plugins 2.86.0 → 2.88.0

package/plugins/mobilems/skills/mobilems-thematic-publications/references/lib-contents.md

@@ -0,0 +1,134 @@
+# libs/museum-thematic-paths — structure to create
+
+Copy from the reference repo's `libs/museum-thematic-paths` and thread `<PREFIX>`. The lib has two
+projects: a `domain` (entity/interfaces/enums) and a `shell/angular` (the Angular module + NgRx
+`+state` + UI).
+
+```
+libs/museum-thematic-paths/
+├── domain/                              # project: museum-thematic-paths-domain
+│   ├── package.json                     # "name": "museum-thematic-paths-domain"
+│   └── src/
+│       ├── index.ts                     # export * from './lib/entities'; './lib/enums'; './lib/interfaces';
+│       ├── features.ts                  # export const DOMAIN_SERVICES = [];
+│       └── lib/
+│           ├── entities/                # MuseumThematicPath (+ index)
+│           ├── enums/                   # WidgetType enum (+ index)
+│           └── interfaces.ts            # IThematicPath, IPage, IMenu, IImageFile, ICopyright, IDictionaryEntity, …
+└── shell/angular/                       # project: museum-thematic-paths-shell-angular
+    └── src/
+        ├── index.ts                     # export * from './lib/pages'; export * from './lib/thematic-paths.module';
+        └── lib/
+            ├── thematic-paths.module.ts # MuseumThematicPathsModule (references/module-and-routes.md)
+            ├── thematic-paths.routes.ts
+            ├── +state/                  # thematic-paths.facade.ts (ThematicPathsFacade), thematic-paths.reducer.ts (getReducer), thematic-paths.selectors.ts
+            ├── components/              # intro, main, menu, page, show-widgets, list-item, filters,
+            │                            #   widgets/{page-header,text,image,video,audio,image-gallery/*} (+ index)
+            ├── directives/             # scroll-intersection.directive.ts (+ .spec)
+            ├── pages/                   # list (ListComponent), item (ItemComponent) + index
+            └── services/               # thematic-paths.service.ts + index (SERVICES)
+```
+
+> There is **no `src/__mocks__/` dir** in this lib (objects had one; thematic-paths does not). Copy
+> only what the reference has.
+
+## Domain entity (verbatim — thread nothing; pure types)
+
+Unlike objects' `MuseumObject extends MsObject`, this entity `implements` the local interfaces — it
+does NOT extend a feature base class:
+
+```ts
+import { IEntity } from '@smartsoft001/domain-core';
+import { Field, Model } from '@smartsoft001/models';
+
+import {
+  ICopyright,
+  IDictionaryEntity,
+  IImageFile,
+  IMenu,
+  IThematicPath,
+} from '../interfaces';
+
+@Model({})
+export class MuseumThematicPath implements IEntity<any>, IThematicPath {
+  id!: any;
+
+  @Field() title!: string;
+  @Field() textColor!: string;
+  @Field() subTitle!: string;
+  @Field() shortDescription!: string;
+  @Field() author!: string;
+  @Field() backgroundColor!: string;
+  @Field() backgroundColorEnabled!: boolean;
+  @Field() backgroundImage!: IImageFile | null;
+  @Field() copyright!: ICopyright;
+  @Field() cycles!: IDictionaryEntity[];
+  @Field() image?: IImageFile;
+  @Field() keywords!: IDictionaryEntity[];
+  @Field() landingPageEnabled!: boolean;
+  @Field() menuBackgroundColor!: string;
+  @Field() menuBackgroundImage!: string;
+  @Field() menuType!: 'vertical' | 'horizontal';
+  @Field() publicationDate!: string;
+  @Field() sections!: IMenu[];
+}
+```
+
+Copy `domain/src/lib/interfaces.ts` verbatim (defines `IThematicPath`, `IPage`, `IMenu`, `IImageFile`,
+`ICopyright`, `IDictionaryEntity`, and the page/widget shapes the reducer + components consume) and
+`domain/src/lib/enums/index.ts` (`WidgetType`).
+
+## Shell `+state` (NgRx — copy verbatim, thread `<PREFIX>`)
+
+- `thematic-paths.reducer.ts` exports `getReducer()` — wraps `@smartsoft001/crud-shell-angular`'s
+  `getReducer('thematicPaths')` and adds thematic-specific cases (page loading, page desc, menu
+  display, widget id, etc.). This is the function passed as `reducerFactory` in the module config.
+- `thematic-paths.facade.ts` exports `ThematicPathsFacade extends CrudFacade<MuseumThematicPath>`
+  with the paged-reader actions (`loadPage`, `loadPageDesc`, `setPage`, `setWidget`,
+  `setMenuDisplay`, `openPageDesc`) and signal accessors.
+- `thematic-paths.selectors.ts` — the `getThematic*` selectors the facade reads.
+
+## Services — `services/index.ts` exports a `SERVICES` array (copy verbatim)
+
+The service extends `CrudBaseService` and is bound to BOTH `CrudService` and `ArticlesService` (the
+reused Articles shared module resolves `ArticlesService`):
+
+```ts
+import { CrudService } from '@smartsoft001/crud-shell-angular';
+import { ArticlesService } from '@smartsoft001-mobilems/articles-shell-angular';
+
+import { ThematicPathsService } from './thematic-paths.service';
+
+export * from './thematic-paths.service';
+
+export const SERVICES = [
+  ThematicPathsService,
+  { provide: CrudService, useClass: ThematicPathsService },
+  { provide: ArticlesService, useClass: ThematicPathsService },
+];
+```
+
+`ThematicPathsService extends CrudBaseService<MuseumThematicPath>` (from
+`@smartsoft001-mobilems/angular`) and adds `getPage`/`getPageDesc` for the paged reader.
+
+## Wiring
+
+- **tsconfig.base.json paths** (add both):
+  ```json
+  "@<PREFIX>/museum-thematic-paths/domain": ["libs/museum-thematic-paths/domain/src/index.ts"],
+  "@<PREFIX>/museum-thematic-paths/shell/angular": ["libs/museum-thematic-paths/shell/angular/src/index.ts"]
+  ```
+- **project.json / build config** — copy each project's config (names `museum-thematic-paths-domain`,
+  `museum-thematic-paths-shell-angular`) and normalize every path field the reference baked to its
+  origin location — `sourceRoot`, `dest`, `outputPath`, `coverageDirectory`, `jestConfig`,
+  `lintFilePatterns`, and the jest `displayName` — to `libs/museum-thematic-paths/...`. Some reference modules carry stale
+  values (e.g. a `sourceRoot` missing the `shell/angular` segment, or a `coverageDirectory` under
+  `packages/...`) while others are already correct — verify each against a known-good sibling and fix
+  only the stale ones. A `domain` with no `project.json` (Nx-inferred) is fine — just set its
+  `package.json` `name`.
+- **commit scope** — `commitlint.config.js` reads `libs/` dir names, so `museum-thematic-paths`
+  becomes a valid scope automatically; no edit needed.
+
+This module reuses the Articles shared module, so it needs the three `@smartsoft001-mobilems/articles-*`
+npm packages (see SKILL.md step 1). It does NOT need `online-3d-viewer`; `leaflet`/`openseadragon`/
+`swiper` are foundation deps used by the gallery widgets if present.

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

@@ -0,0 +1,107 @@
+# MuseumThematicPathsModule + route registration
+
+## `libs/museum-thematic-paths/shell/angular/src/lib/thematic-paths.module.ts`
+
+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 and a no-op mock during SSR (identical to objects).
+
+```ts
+import { NgModule } from '@angular/core';
+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 { environment } from '@<PREFIX>/angular';
+import { MuseumThematicPath } from '@<PREFIX>/museum-thematic-paths/domain';
+
+import { ThematicPathsFacade } from './+state/thematic-paths.facade';
+import { getReducer } from './+state/thematic-paths.reducer';
+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;
+          }
+        };
+      },
+    },
+  ],
+  imports: [
+    FormsModule,
+    SmartSharedModule,
+    ArticlesSharedModule.forFeature({
+      routing: false,
+      config: {
+        reducerFactory: getReducer,
+        type: MuseumThematicPath,
+        apiUrl: environment.apiUrl,
+        entity: 'thematicPaths',
+      },
+    }),
+    RouterModule.forChild(routes),
+  ],
+})
+export class MuseumThematicPathsModule {}
+```
+
+> Contrast with `mobilems-objects` (`ObjectsSharedModule.forFeature` over `MsObject`, no
+> `reducerFactory`): here the module reuses `ArticlesSharedModule`, supplies `reducerFactory: getReducer`,
+> and there is deliberately **no `baseQuery`** in the config.
+
+## `thematic-paths.routes.ts`
+
+```ts
+import { Route } from '@angular/router';
+
+import { ItemComponent, ListComponent } from './pages';
+
+export const routes: Route[] = [
+  { path: ':id/:slug', component: ItemComponent },
+  { path: ':id', component: ItemComponent },
+  { path: '', component: ListComponent },
+];
+```
+
+## Register in `apps/web/src/app/app.routes.ts`
+
+This module registers a single **top-level** route. Add the `sciezki-tematyczne` route to the
+`appRoutes` array (idempotently — if a `sciezki-tematyczne` route already exists, skip). It is a
+content publication browsed from the top level, so it is NOT added under the `wyszukaj/:text` search
+route — thematic-paths does not appear in the search results.
+
+Top-level — add to `appRoutes`:
+
+```ts
+  {
+    path: 'sciezki-tematyczne',
+    loadChildren: () =>
+      import('@<PREFIX>/museum-thematic-paths/shell/angular').then(
+        (m) => m.MuseumThematicPathsModule,
+      ),
+  },
+```

package/plugins/mobilems/skills/mobilems-thematic-publications/scripts/detect-init.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+#
+# detect-init.sh <workspace-root>
+#
+# Precondition gate for mobilems-objects (and the other module skills follow the same shape):
+# confirm the MobilEMS foundation from mobilems-project-init is present. Portable to macOS bash 3.2.
+#
+# Exit 0 → foundation present, OK to add the module.
+# Exit 3 → foundation missing (tell the user to run /mobilems:project-init first).
+set -eu
+
+ROOT="${1:?usage: detect-init.sh <workspace-root>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+miss() {
+  echo "FOUNDATION MISSING: $1" >&2
+  echo "Run /mobilems:project-init first to lay down the MobilEMS foundation." >&2
+  exit 3
+}
+
+[ -f apps/web/src/app/app.config.ts ] || miss "app.config.ts missing"
+grep -q "SharedModule.forRoot" apps/web/src/app/app.config.ts || miss "SharedModule.forRoot not in app.config.ts (foundation not applied)"
+grep -q "./lib/components" libs/shared/angular/src/index.ts 2>/dev/null || miss "shared-lib components barrel not populated"
+[ -f apps/web/src/app/app.routes.ts ] || miss "app.routes.ts missing"
+
+PREFIX="$(grep -oE '@[a-z0-9-]+/angular' tsconfig.base.json | head -1 | sed -E 's#@([a-z0-9-]+)/angular#\1#')"
+echo "FOUNDATION OK. Detected prefix: ${PREFIX:-<unknown>}"
+[ -d libs/museum-objects ] && echo "NOTE: libs/museum-objects already exists — build steps must be idempotent." >&2
+exit 0

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

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+#
+# verify-module.sh <workspace-root> <PREFIX>
+#
+# Post-condition check for mobilems-thematic-publications: library created, ArticlesSharedModule
+# wired over MuseumThematicPath with its own reducer, facade + +state present, the
+# sciezki-tematyczne route registered as a single top-level route, and the Articles deps installed.
+# macOS bash 3.2 safe.
+set -eu
+
+ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+PREFIX="${2:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+fail=0
+pass() { echo "  PASS: $1"; }
+bad()  { echo "  FAIL: $1" >&2; fail=1; }
+
+MOD=libs/museum-thematic-paths/shell/angular/src/lib/thematic-paths.module.ts
+
+echo "== Library =="
+[ -f "$MOD" ] && pass "MuseumThematicPathsModule present" || bad "thematic-paths.module.ts missing"
+[ -f libs/museum-thematic-paths/domain/src/lib/entities/museum-thematic-path.entity.ts ] && pass "MuseumThematicPath entity present" || bad "domain entity missing"
+grep -q "class MuseumThematicPath" libs/museum-thematic-paths/domain/src/lib/entities/museum-thematic-path.entity.ts 2>/dev/null && pass "MuseumThematicPath class declared" || bad "MuseumThematicPath class not declared"
+grep -q "museum-thematic-paths/shell/angular" tsconfig.base.json && pass "tsconfig shell path added" || bad "tsconfig shell path missing"
+grep -q "museum-thematic-paths/domain" tsconfig.base.json && pass "tsconfig domain path added" || bad "tsconfig domain path missing"
+
+echo "== Module wiring =="
+grep -q "ArticlesSharedModule.forFeature" "$MOD" 2>/dev/null && pass "ArticlesSharedModule.forFeature wired" || bad "ArticlesSharedModule.forFeature missing"
+grep -q "entity: 'thematicPaths'" "$MOD" 2>/dev/null && pass "entity 'thematicPaths' configured" || bad "entity 'thematicPaths' missing"
+grep -q "type: MuseumThematicPath" "$MOD" 2>/dev/null && pass "type MuseumThematicPath configured" || bad "type MuseumThematicPath missing"
+grep -q "reducerFactory: getReducer" "$MOD" 2>/dev/null && pass "reducerFactory: getReducer configured" || bad "reducerFactory: getReducer missing"
+grep -q "ThematicPathsFacade" "$MOD" 2>/dev/null && pass "ThematicPathsFacade provided" || bad "ThematicPathsFacade not provided"
+
+echo "== +state =="
+STATE=libs/museum-thematic-paths/shell/angular/src/lib/+state
+[ -f "$STATE/thematic-paths.facade.ts" ] && pass "facade present" || bad "thematic-paths.facade.ts missing"
+[ -f "$STATE/thematic-paths.reducer.ts" ] && pass "reducer present" || bad "thematic-paths.reducer.ts missing"
+grep -q "export function getReducer" "$STATE/thematic-paths.reducer.ts" 2>/dev/null && pass "getReducer exported" || bad "getReducer not exported in reducer"
+
+echo "== Route registration =="
+ROUTES=apps/web/src/app/app.routes.ts
+grep -q "museum-thematic-paths/shell/angular" "$ROUTES" && pass "thematic-paths route registered" || bad "thematic-paths route not in app.routes.ts"
+# single top-level route — expect exactly 1 occurrence
+n=$(grep -c "museum-thematic-paths/shell/angular" "$ROUTES" || true)
+[ "${n:-0}" -eq 1 ] && pass "registered as a single top-level route ($n)" || bad "expected exactly 1 route registration, found $n"
+grep -q "sciezki-tematyczne" "$ROUTES" && pass "sciezki-tematyczne path present" || bad "sciezki-tematyczne path missing"
+
+echo "== Deps =="
+grep -q "@smartsoft001-mobilems/articles-domain" package.json && pass "articles-domain dep" || bad "articles-domain dep missing"
+grep -q "@smartsoft001-mobilems/articles-shell-angular" package.json && pass "articles-shell-angular dep" || bad "articles-shell-angular dep missing"
+grep -q "@smartsoft001-mobilems/articles-shell-dtos" package.json && pass "articles-shell-dtos dep" || bad "articles-shell-dtos dep missing"
+
+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"