@futdevpro/fsm-dynamo 1.15.21 → 1.15.22

package/.vscode/settings.json

@@ -1,11 +1,11 @@
-{
-  "eslint.run": "onSave",
-  "eslint.workingDirectories": [{ "mode": "auto" }],
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  },
-  "eslint.validate": [
-    "javascript",
-    "typescript"
-  ]
-}
+{
+  "eslint.run": "onSave",
+  "eslint.workingDirectories": [{ "mode": "auto" }],
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "eslint.validate": [
+    "javascript",
+    "typescript"
+  ]
+}

package/LICENSE

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

package/__documentations/2026-06-01-fr047-p1-function-calling-vocabulary.md

@@ -0,0 +1,75 @@
+# FR-047 P1 — Provider-agnostic function-calling vocabulary + per-model registry (2026-06-01)
+
+**Commit**: `08e8859` — v01.15.16 → v01.15.17 (published)
+**Parent**: `__agent/feature-requests/FR-047-phase-1-tool-abstraction.md` (master: `FR-047-provider-agnostic-function-calling.md`)
+**Pattern**: `documentations/guidelines/development/ai-function-calling.md`
+**Also in this commit**: FR-048 settings-schema reservation (`FR-048-per-model-agnostic-settings.md`)
+
+## What
+
+Adds the SDK-free, vendor-neutral vocabulary for LLM function calling to `@futdevpro/fsm-dynamo/ai`,
+plus a per-model capability registry. After this, the execution layer (`nts-dynamo`, FR-047 P2+P3)
+can speak one tool shape across providers.
+
+## Why
+
+Function calling existed ONLY in the legacy OpenAI-only `FDPNTS_GPT_ControlService.getAnswerWithTools`
+(nts-fdp-templates). The strategic provider-agnostic layer had ZERO tool support: `DyFM_AI_Message`
+was `{role,content}`, `DyFM_AI_LLM_Response` had no `toolCalls`, and the `functionCalling` provider-
+capability flag was dead. This commit is the foundation for moving tool use into the strategic layer.
+
+## Design
+
+### Tool models (`src/_modules/ai/_models/`)
+```ts
+DyFM_AI_Tool          // { name, description, parameters: object /* JSON Schema */ }
+DyFM_AI_ToolCall      // { id, name, arguments: Record<string,unknown> } (normalized; OpenAI JSON-string parsed at boundary)
+DyFM_AI_ToolResult    // { toolCallId, content: string, isError? }
+DyFM_AI_ToolHandler / DyFM_AI_ToolHandlers   // lifted from legacy FDPNTS_GPT_ToolHandler(s)
+```
+
+### Additive extensions (non-breaking, optional fields)
+- `DyFM_AI_Message` + `toolCalls?` (assistant tool-call turn) + `toolCallId?` (tool-result message)
+- `DyFM_AI_LLM_Response` + `toolCalls?` + `stopReason?`
+- `DyFM_AI_MessageRole.tool`
+- `DyFM_AI_ModelType` + `Image`, `Audio`
+
+### Per-model registry
+- `DyFM_AI_ModelInfo` (id / provider / modelType / capabilities / contextWindow / maxOutputTokens
+  + lifecycle: status / successorId / sunsetDate + displayName / tier)
+- `DyFM_AI_ModelCapabilities` (functionCalling / vision / streaming / jsonMode / audioInput /
+  audioOutput / imageGeneration / embeddings)
+- Per-provider const arrays: `DyFM_OAI_Models`, `DyFM_AAI_Models`, `DyFM_GAI_Models`, `DyFM_LAI_Models`,
+  `DyFM_FdpAI_Models` (2026-06 verified data — see `[[reference_ai_provider_model_registry_research]]`)
+- `DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)` / `modelSupportsTools(models, id)` — the
+  registry array is **passed in**, so the agnostic `./ai` core imports NO provider submodule
+  (keeps it SDK-free). Unknown id → `false` (honesty).
+
+### FR-048 reservation (space left, NOT implemented)
+- `DyFM_AI_ModelSettingsSchema` + `DyFM_AI_SettingConstraint` (reserved placeholder)
+- `DyFM_AI_ModelInfo.settingsSchema?` + thorough doc on `DyFM_AI_CallSettings` — the per-model
+  "which params does this model accept/reject" system. Sibling of capabilities. See `ai-per-model-settings.md`.
+
+## Spec coverage
+
+`src/_modules/ai/_collections/ai-model-registry.util.spec.ts` — findModelInfo (known/unknown) +
+modelSupportsTools (tool-capable chat / embedding=false / unknown=false). `pnpm test`: **1302/0** (70 pending).
+
+## Optional-SDK discipline
+
+The agnostic `./ai` index imports no provider submodule → `import '@futdevpro/fsm-dynamo/ai'` pulls
+zero AI SDKs. Provider model data lives under `./ai/<provider>` subpaths.
+
+## What's NOT in this commit
+
+- The agent-loop / execution (nts-dynamo P2+P3 — `requestWithTools`).
+- `adultContent` capability (added later, `de1da9b`, v01.15.18).
+- `./ai/google` + `./ai/local` subpath export-bug fix (FR-047 P5, `6a4ce9c`).
+- FR-048 runtime reconciler (reserved only).
+
+## Cross-references
+
+- `documentations/guidelines/development/ai-function-calling.md` (pattern)
+- `documentations/guidelines/development/ai-per-model-settings.md` (FR-048)
+- `NPM-packages/dynamo-nts/__documentations/2026-06-01-fr047-p2p3-function-calling.md` (the consumer)
+- legacy `NPM-packages/fdp-templates-nts/src/_modules/gpt/_services/gpt-handler.control-service.ts`

package/__documentations/plans/00-MASTER-ngx-models-fsm-merge.md

@@ -0,0 +1,70 @@
+# MASTER — `@futdevpro/ngx-dynamo-models` → `@futdevpro/fsm-dynamo` merge + `DyNM_`→`DyFM_` rename
+
+> Koordinációs master-plan (UI-20260604-002). Dátum: 2026-06-06.
+> Egyedi al-tervek: [`01-naming-convention-DyNM-to-DyFM.md`](./01-naming-convention-DyNM-to-DyFM.md),
+> [`02-consumer-rollout.md`](./02-consumer-rollout.md).
+> Ez a fájl CSAK koordinál — a részletek az al-tervekben.
+
+## Context — miért
+
+A `@futdevpro/ngx-dynamo-models` (mappa: `NPM-packages/dynamo-ngx-models`, `DyNM_` prefix, 76 forrás + 12 spec)
+egy **framework-agnosztikus** model/enum/control-model gyűjtemény (az egyetlen `@angular` import ki van
+kommentezve). Ma **körkörös függésben** van a `@futdevpro/fsm-dynamo`-val (peerDependency `fsm-dynamo` 1.15.21),
+miközben tartalmilag a fsm-dynamo `DyFM_` rétegének UI-közeli kiterjesztése.
+
+**Cél**: bemozgatni a fsm-dynamo egy submodulja alá (`_modules/ngx-models`), átnevezni a `DyNM_` szimbólumokat
+`DyFM_`-re (user-direktíva 2026-06-06), átállítani az összes fogyasztót, majd az ngx-dynamo-models-t deprecate-elni.
+Eredmény: egy bedrock model-package, megszűnő körkörös függés, egységes `DyFM_` névkonvenció.
+
+## A három fő munka
+
+| # | Al-terv | Lényeg |
+|---|---------|--------|
+| A | [01 — Naming](./01-naming-convention-DyNM-to-DyFM.md) | 105 `DyNM_` szimbólum → `DyFM_`: 95 tiszta, 6 konvergál, 4 külön-névre. Codemod + ütközés-feloldás. |
+| B | [02 — Consumer rollout](./02-consumer-rollout.md) | 113 fájl / 15 projekt top-down, hullámokban, bridge-shimmel + validation gate-ekkel. |
+| C | Modul-integráció (lent) | A kód fizikai bemozgatása a fsm-dynamo-ba + subpath export. |
+
+## C — Modul-integráció a fsm-dynamo-ba (additív)
+
+Követett minta: meglévő `src/_modules/<modul>/index.ts` + `package.json` `exports`/`typesVersions` subpath
+(pl. `./crypto`, `./state-machine`). Belső modulok **relatív** importtal hivatkoznak a root-ra (`from '../../..'`).
+
+1. Új mappa `src/_modules/ngx-models/` — az ngx `_collections`, `_enums`, `_models` bemozgatva.
+2. A 8 `@futdevpro/fsm-dynamo` (+1 `/socket`) import → relatív belső import. A 9 szimbólum mind létezik a fsm-ben.
+3. `package.json`: `"./ngx-models"` export + `typesVersions["ngx-models"]`.
+4. A `DyNM_`→`DyFM_` rename (A al-terv) a bemozgatott modulon belül történik.
+
+## Sorrend (gate-elt hullámok)
+
+```
+Wave 0  Modul-integráció + rename a fsm-dynamo-ban (C + A) ──┐ bedrock, additív+rename
+                                                              ├─ publish fsm-dynamo
+Wave 0b ngx-dynamo-models → bridge-shim (re-export fsm/ngx-models) + DyNM_ deprecated-alias réteg
+─────────────────────────────  USER VALIDATION GATE  ─────────────────────────────
+Wave 1  NPM hubok: dynamo-ngx (7 collision-fájl!), fdp-templates-ngx, dynamo-builder-models
+─────────────────────────────  USER VALIDATION GATE  ─────────────────────────────
+Wave 2  LIVE prio szerint: organizer(46) → dynamo-builder(18) → overseer(13) → fdp-assistant(6) → adventor(5) → ...
+Wave 3  TEMPLATE-ek (+ `dc pattern` snapshot refresh) + OGS oldlight-site
+Wave 4  Tooling (fdp-github-actions fixture-ök) + `npm deprecate` ngx-dynamo-models + sunset
+```
+
+> A bridge-shim + `DyNM_` deprecated-aliasok miatt a Wave 1–4 NEM törésveszélyes: a régi `DyNM_` nevek és a régi
+> package-import is működik, amíg a fogyasztó migrál. Lásd [02](./02-consumer-rollout.md).
+
+## Phase 5 (külön feladat, NEM ez)
+
+A 4 divergens collision (signal-vs-observable DataHandler, UI-vs-data Error_Settings, UI-vs-infra Global_Settings)
+tényleges **összevonása/leépítése** — önálló plan, a rename után. Itt CSAK külön-névre keresztelünk + deprecated.
+
+## Bedrock-megkötések, amik érvényesek
+
+- A rename most **user-engedélyezett** (felülírja a `bedrock-no-unverified-rename` defaultot) — de a 4 divergens esetnél
+  NEM nevezünk át foglalt névre, hanem distinct `DyFM_` névre + alias-bridge (behavior-megőrzés).
+- `forward-only / no-rollback`: minden hullám előre lép; a shim a visszafelé-kompat eszköze, nem rollback.
+- `push-discipline`: hullámonként bundle-ölt commit, zöld teszt után push.
+
+## Globális verifikáció
+
+- Wave 0 után: `dynamo-fsm` build+jasmine zöld (12 áthozott spec is); subpath-feloldás füstteszt.
+- Minden hullám: érintett package/projekt build+teszt zöld a gate előtt.
+- Záró: workspace-szintű `grep DyNM_` csak a deprecated-alias rétegben ad találatot.

package/__documentations/plans/01-naming-convention-DyNM-to-DyFM.md

@@ -0,0 +1,103 @@
+# 01 — Naming convention átvezetés: `DyNM_` → `DyFM_`
+
+> Al-terv a [MASTER](./00-MASTER-ngx-models-fsm-merge.md)-hez. Dátum: 2026-06-06.
+
+## Context
+
+A bemozgatott model-réteg ma `DyNM_` (Dynamo NGX Models) prefixet használ; a fsm-dynamo `DyFM_` (Dynamo Full-stack
+Models). A user direktívája: egységesítsünk `DyFM_`-re. **Ez NEM vak prefix-csere** — 105 `DyNM_` szimbólumból 10
+ütközik már létező `DyFM_` névvel, és ezek egy része teljesen más doménű. A terv ezt a 3 kategóriát kezeli.
+
+Felmérés (mind verifikált): **105** exportált `DyNM_` szimbólum, **312** `DyFM_` a fsm-ben, **10** név-ütközés,
+**2** élő legacy alias (`D_Button_P`, `D_Button_Params`, fogyasztó nem használja), **113** érintett fájl / 15 projekt.
+
+## A 3 kategória
+
+### Kategória 1 — Tiszta átnevezés (95 szimbólum)
+Nincs `DyFM_` ütközés → mechanikus `DyNM_X` → `DyFM_X` csere a definícióban ÉS minden használati helyen.
+Reprezentatív minták: `DyNM_Button_Settings`, `DyNM_Field_Settings`, `DyNM_Form_Settings`, `DyNM_FormNew_Settings`,
+`DyNM_Voice*` (14 db), `DyNM_*FieldNew_Settings` (8 db), összes `_enums/*` enum-NÉV, `DyNM_*Placeholder` (4 db),
+`DyNM_sameObjects`, `DyNM_setExisitngNonSetValuesOnly`, stb.
+
+**Enum-caveat**: az enum NEVE változik (`DyNM_Button_Type`→`DyFM_Button_Type`), de a string-VALUE-k VÁLTOZATLANOK
+(CSS-class-ekre képződnek, a forrásban explicit warning — `button-type.enum.ts`). A codemod csak az azonosítót cseréli, az értékeket SOHA.
+
+> ⚠️ **VERIFIED REVISION (2026-06-06, Wave-0 végrehajtáskor)** — a Kat-2 „6 converge" besorolás forrás-ellenőrzés
+> után **felülírva**. A 4 settings-osztály (`DyNM_DataHandler_Settings` + 3 leszármazott) a `dependencyDataHandler?:`
+> / `dependentDataHandlers?:` / `getPostProcess?:` mezőkön át **paradigma-kötött** a signal `DyNM_DataHandler`-hez;
+> a fsm `DyFM_DataHandler_Settings` ugyanezeket az **rxjs** `DyFM_DataHandler`-re tipizálja. Összeolvasztásuk
+> **eltörné a signal-handler dependency-típusát** → NEM converge-elhetők, a Phase 5 paradigma-refaktorhoz tartoznak.
+> **Tényleges Wave-0 döntés: mind a 10 ütközés → DISTINCT `DyFM_` név (lásd lent), NULLA converge, NULLA bedrock-módosítás,
+> NULLA törlés. Minden konvergencia → Phase 5.** A 2 belső típus (`...DataLoadInProgress/PostProcess`) bitre azonos a
+> fsm-ével (converge-elhető lett volna), de a cluster-önállóságért szintén distinct `DyFM_Signal...` nevet kaptak.
+> Végrehajtott rename + build+jasmine zöld (1409 spec, 0 fail). Az alábbi eredeti Kat-2/3 szöveg a kiindulási terv.
+
+### Kategória 2 — ~~Konvergáló ütközés (6 szimbólum)~~ → VERIFIED: Phase 5-re halasztva (lásd fenti revízió)
+Itt NEM hozunk létre új `DyFM_X`-et, hanem a bemozgatott DyNM_ definíciót **töröljük**, és a használatok a
+fsm meglévő `DyFM_X`-ére mutatnak (ekvivalens/superset, drop-in vagy kis igazítás).
+
+| DyNM_ szimbólum | fsm cél | Verdict | Teendő |
+|---|---|---|---|
+| `DyNM_DataHandlerDataLoadInProgress` | `DyFM_DataHandlerDataLoadInProgress` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataHandlerDataLoadPostProcess` | `DyFM_...PostProcess` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataSearchHandler_Settings` | `DyFM_DataSearchHandler_Settings` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_ListCollectorDataHandler_Settings` | `DyFM_ListCollector...` | EQUIVALENT | törlés, fsm-re mutat |
+| `DyNM_DataHandler_Settings` | `DyFM_DataHandler_Settings` | SUPERSET | fsm-be portolni a plusz mezőt (`dontDefaultSetActiveItem` lánc), majd fsm-re mutat |
+| `DyNM_DataListHandler_Settings` | `DyFM_DataListHandler_Settings` | SUPERSET | mint fent |
+
+> A DyNM superset-mezők (`createObservable`, `loopSafety`) a signal-világhoz tartoznak — ezek a Kat-3
+> `DataHandler` döntéséhez kötöttek, NEM a settings-konvergenciához. Lásd Kat-3 / Phase 5.
+
+### Kategória 3 — Divergens ütközés (4 szimbólum) → DISTINCT `DyFM_` név + alias-bridge
+Csak a NÉV egyezik, a tartalom más doménű. Foglalt névre átnevezni TILOS (törne). → új, megkülönböztető `DyFM_` név,
++ deprecated alias a régi `DyNM_` néven (behavior-megőrzés a fogyasztóknak). Tényleges összevonás = Phase 5.
+
+| DyNM_ szimbólum | Mi ez | Ütközik | Javasolt DISTINCT név (döntést igényel) |
+|---|---|---|---|
+| `DyNM_DataHandler` (abstract, **signal**-alapú) | UI signal data-handler | `DyFM_DataHandler` (Observable) | **`DyFM_SignalDataHandler`** |
+| `DyNM_Error_Settings` (UI display settings, 7 mező) | error-komponens megjelenítés | `DyFM_Error_Settings` (error adat-modell, 22+ mező) | **`DyFM_ErrorDisplay_Settings`** |
+| `DyNM_Global_Settings` (UI/form globál) | Angular UI globál config | `DyFM_Global_Settings` (infra) | **`DyFM_UiGlobal_Settings`** |
+| `DyNM_global_settings` (const) | a fenti példánya | `DyFM_global_settings` (const) | **`DyFM_uiGlobal_settings`** |
+
+> ⚠️ **Nyitott döntés**: a 4 distinct név (`DyFM_SignalDataHandler`, `DyFM_ErrorDisplay_Settings`,
+> `DyFM_UiGlobal_Settings`, `DyFM_uiGlobal_settings`). Fenti = ajánlás; a user módosíthatja.
+
+### ✅ VÉGREHAJTOTT distinct-rename map (Wave-0, user-jóváhagyott + verified-kiterjesztett)
+
+Mind a 10 ütközés distinct `DyFM_` nevet kapott (a settings-cluster a paradigma-kötöttség miatt szintén ide került):
+
+| Régi `DyNM_` | Új distinct `DyFM_` | Megjegyzés |
+|---|---|---|
+| `DyNM_DataHandler` | `DyFM_SignalDataHandler` | user-jóváhagyott |
+| `DyNM_DataHandlerDataLoadInProgress` | `DyFM_SignalDataHandlerDataLoadInProgress` | bitre = fsm, de cluster-önállóság |
+| `DyNM_DataHandlerDataLoadPostProcess` | `DyFM_SignalDataHandlerDataLoadPostProcess` | bitre = fsm, de cluster-önállóság |
+| `DyNM_DataHandler_Settings` | `DyFM_SignalDataHandler_Settings` | paradigma-kötött |
+| `DyNM_DataListHandler_Settings` | `DyFM_SignalDataListHandler_Settings` | paradigma-kötött |
+| `DyNM_DataSearchHandler_Settings` | `DyFM_SignalDataSearchHandler_Settings` | paradigma-kötött |
+| `DyNM_ListCollectorDataHandler_Settings` | `DyFM_SignalListCollectorDataHandler_Settings` | paradigma-kötött |
+| `DyNM_Error_Settings` | `DyFM_ErrorDisplay_Settings` | user-jóváhagyott |
+| `DyNM_Global_Settings` | `DyFM_UiGlobal_Settings` | user-jóváhagyott |
+| `DyNM_global_settings` | `DyFM_uiGlobal_settings` | user-jóváhagyott |
+
+A maradék **95** szimbólum tiszta `DyNM_X`→`DyFM_X`. **Env-kulcs kivétel**: a `DyNM_STORAGE_ENCRYPTION_KEY` string-literál
+(runtime env-var kulcs, `dynamo-global.settings.ts`) **VÁLTOZATLAN** maradt — átnevezése a Keystore/deploy-kontraktust
+törné (FR-015 requireEnv deploy-order). A `DyFM_SharedService` osztály log-üzenet-stringjei is átírva a konzisztenciáért.
+
+### Legacy aliasok (cleanup)
+`D_Button_P`, `D_Button_Params` (= `DyNM_Button_Params` aliasai, `button-params.control-model.ts:17-18`) —
+fogyasztó nem használja → **törlés** a merge során. A `DNM_*` változatok ki vannak kommentezve, ignore.
+
+## Mechanika — codemod, NEM kézi
+
+1. **Forrás-igazság**: a 95+6+4 szimbólum + 2 alias egy `rename-map.json`-ban (szimbólum → akció: rename/converge/distinct/drop).
+2. **AST-alapú csere** (ts-morph / a meglévő `dynamo-fix` tooling láncban, NEM nyers `sed`): csak azonosító-tokenek,
+   szöveg-literál/string-VALUE érintetlen. Word-boundary `\bDyNM_…\b`.
+3. **Sorrend**: előbb a fsm-modul belseje (Wave 0), aztán hullámonként a fogyasztók ([02](./02-consumer-rollout.md)).
+4. **Deprecated-alias réteg** a bridge-ben: minden régi `DyNM_X` `export … DyNM_X = DyFM_X /* @deprecated */` —
+   így a nem-migrált fogyasztó fordul, amíg a saját hulláma le nem fut.
+
+## Verifikáció
+
+- `dynamo-fsm` build+jasmine zöld a rename után (a 12 spec szimbólumai is átírva).
+- Ütközés-ellenőrzés újrafuttatva: 0 duplikált `DyFM_` export (a Kat-2 törlés + Kat-3 distinct miatt).
+- `grep -rE '\bDyNM_' src` a fsm-modulban → 0 (csak a bridge deprecated-alias rétegben maradhat, ott szándékos).

package/__documentations/plans/02-consumer-rollout.md

@@ -0,0 +1,84 @@
+# 02 — Consumer rollout: a `DyNM_`-et használó projektek átállítása
+
+> Al-terv a [MASTER](./00-MASTER-ngx-models-fsm-merge.md)-hez. Dátum: 2026-06-06.
+
+## Context
+
+A merge + rename után **15 projekt / 113 fájl** hivatkozik `DyNM_` szimbólumokra és/vagy a
+`@futdevpro/ngx-dynamo-models` package-re. Ezt top-down, gate-elt hullámokban állítjuk át, hogy semmi ne törjön.
+Két, egymástól független átállítás van projektenként, és MINDKETTŐ kell:
+
+1. **Package-import**: `@futdevpro/ngx-dynamo-models` → `@futdevpro/fsm-dynamo/ngx-models` (+ package.json dep).
+2. **Symbol-rename**: `DyNM_X` → `DyFM_X` (a [01](./01-naming-convention-DyNM-to-DyFM.md) rename-map szerint).
+
+> A **bridge-shim** (ngx-dynamo-models re-export + `DyNM_` deprecated-aliasok) miatt egy projekt akkor is fordul,
+> ha még egyik átállítást sem kapta meg → a hullámok sorrendje rugalmas, nincs hard dependency-lánc.
+
+## Fogyasztói leltár (verifikált)
+
+| Projekt | Típus | DyNM_ fájl | Import | Collision-szimbólum? |
+|---|---|---:|---|---|
+| organizer | LIVE | 46 | direkt | csak teszt-spec (`DyNM_DataHandler`) |
+| dynamo-builder | LIVE | 18 | direkt | csak teszt-spec |
+| overseer | LIVE | 13 | direkt | nincs forrásban |
+| fdp-assistant | LIVE | 6 | direkt | nincs |
+| code-documentation-master | LIVE | 6 | tranzitív (ngx) | nincs |
+| adventor | LIVE | 5 | direkt | nincs |
+| dynamo-template-project | TEMPLATE | 4 | tranzitív | nincs |
+| fdp-template-project | TEMPLATE | 3 | tranzitív | nincs |
+| fdp-pal | LIVE | 2 | tranzitív | nincs |
+| war-factory | LIVE | 2 | tranzitív | nincs |
+| oldlight-site | OGS | 2 | tranzitív | nincs |
+| art-tarot | LIVE | 2 | tranzitív | nincs |
+| fury | STALE | 2 | tranzitív | nincs |
+| dum | LIVE | 1 | tranzitív | nincs |
+| warbots-distribution-server | LIVE | 1 | tranzitív | nincs |
+
+**NPM hubok** (külön, Wave 1): `dynamo-ngx` (**7 fájl, az összes valódi collision itt él** — DataHandler-család a
+`projects/ngx-dynamo/.../_models/data-handlers/`-ban), `fdp-templates-ngx`, `dynamo-builder-models` (extends DyNM modelleket).
+
+> Kulcsmegfigyelés: a 10 collision-szimbólum **valódi forrás-használata a `dynamo-ngx`-be koncentrálódik**; a LIVE
+> fogyasztók szinte mind csak a 95 tiszta szimbólumot használják, a collision-t legfeljebb teszt-specben. Ez a
+> kockázatot a Wave 1-re fókuszálja, a LIVE-hullám mechanikus.
+
+## Per-projekt eljárás (minden projektnél azonos, dev-cycle 9 szakasz)
+
+1. `git pull` → gather (érintett fájlok listája a leltárból).
+2. **dep-csere**: ha direkt — `@futdevpro/ngx-dynamo-models` ki, `@futdevpro/fsm-dynamo` be (a publikált verzióra,
+   `dc sfd`/`dc sync-fdp-deps`). Ha tranzitív — csak a hub-verzió emelése (Wave 1 után).
+3. **import-csere**: `from '@futdevpro/ngx-dynamo-models'` → `from '@futdevpro/fsm-dynamo/ngx-models'`.
+4. **symbol-rename**: codemod a rename-map alapján (`DyNM_`→`DyFM_`, a Kat-3 distinct nevekkel).
+5. **review** (dedikált) → **test**: full suite (NEM filterezett), kliens `ng build --configuration production`.
+6. test-fix-review loop piros tesztre.
+7. document (`__documentations/`) → commit (zöld) + push (bundle-ölt, nem fájlonként).
+8. **USER VALIDATION GATE** a tier-váltás előtt (Wave 1→2, és a LIVE prio-tier-ek között).
+
+## Hullámok
+
+- **Wave 1 — NPM hubok** (CRITICAL, itt a collision-munka):
+  `dynamo-ngx` (7 collision-fájl: a DataHandler-család a Kat-2 konvergencia + Kat-3 distinct szerint),
+  `fdp-templates-ngx`, `dynamo-builder-models` (öröklési lánc figyelése). Build+publish mindhárom.
+- **Wave 2 — LIVE prio szerint** (`project_live_priorities`): organizer → dynamo-builder → overseer →
+  fdp-assistant → adventor → fdp-pal → war-factory → art-tarot → dum → warbots-distribution-server →
+  code-documentation-master. (organizer a legnagyobb felület, de tiszta-rename dominál.)
+- **Wave 3 — TEMPLATE + OGS**: dynamo-template-project, fdp-template-project (client+mobile),
+  oldlight-site → utána `dc pattern` snapshot-refresh (`project_fdp_pattern_provider_keep_current`).
+- **Wave 4 — Tooling + deprecate**: `fdp-github-actions` dev-leftovers fixture-ök (`failing/`+`passing/`
+  package.json + tsconfig + workflow-referenciák); `npm deprecate @futdevpro/ngx-dynamo-models`; sunset.
+  A bridge-shim addig él, amíg minden fogyasztó (köztük STALE `fury`) migrált VAGY tudatosan elengedett.
+
+## Kockázat / nyitott pont
+
+- `dynamo-builder-models` DyNM_ modelleket **extends-el** (`form-settings.data-model.ts`, `field-settings.data-model.ts`)
+  → Wave 1-ben az öröklési lánc a Kat-2/Kat-3 döntésekkel együtt mozog.
+- Verzió-fragmentáció a fogyasztóknál (1.15.7–1.15.14): a shim + fsm verzió legyen ≥ a legmagasabb jelenlegi.
+- STALE `fury`: nem blokkol; a bridge-shim eltartja, vagy tudatosan kihagyjuk.
+- A `dynamo-ngx` sandbox (`dynamo-ngx-sandbox`) is használja `DyNM_Global_Settings`/`DyNM_global_settings` →
+  a Kat-3 distinct névre + alias migrál.
+
+## Verifikáció (rollout záró)
+
+- Minden hullám gate-jénél: érintett projektek build+full-suite zöld.
+- Záró sweep: workspace-szintű `grep -rE '\bDyNM_'` (node_modules nélkül) → 0 valódi használat
+  (csak a bridge deprecated-alias rétege, ami a deprecate után törölhető).
+- A bridge-shim eltávolítása + package `npm deprecate` csak akkor, ha a sweep tiszta.

package/build/_modules/ngx-models/_collections/angular-placeholders.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Lightweight substitute for an Angular Signal.
+ * It simply returns the current value when called.
+ *
+ * @example
+ * ```ts
+ * const num$: DyFM_SignalPlaceholder<number> = () => 5;
+ * console.log(num$());
+ * ```
+ */
+export type DyFM_SignalPlaceholder<T> = () => T;
+/**
+ * Represents a signal that can also be updated.
+ *
+ * @example
+ * ```ts
+ * const counter: DyFM_WritableSignalPlaceholder<number> = (() => 0) as any;
+ * counter.set(1);
+ * ```
+ */
+export type DyFM_WritableSignalPlaceholder<T> = DyFM_SignalPlaceholder<T> & {
+    set(value: T): void;
+};
+/**
+ * Union of readable and writable signal placeholders.
+ */
+export type DyFM_AnySignalPlaceholder<T> = DyFM_SignalPlaceholder<T> | DyFM_WritableSignalPlaceholder<T>;
+/**
+ * Generic key-value map used to store arbitrary parameters.
+ */
+export type DyFM_ParamsPlaceholder = {
+    [key: string]: any;
+};
+//# sourceMappingURL=angular-placeholders.d.ts.map

package/build/_modules/ngx-models/_collections/angular-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-placeholders.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ngx-models/_collections/angular-placeholders.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAAE,CAAC;AAErG;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,CAAC,GAAG,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEzG;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC"}

package/build/_modules/ngx-models/_collections/angular-placeholders.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=angular-placeholders.js.map

package/build/_modules/ngx-models/_collections/angular-placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-placeholders.js","sourceRoot":"","sources":["../../../../src/_modules/ngx-models/_collections/angular-placeholders.ts"],"names":[],"mappings":""}

package/build/_modules/ngx-models/_collections/button-new-style-settings-presets.const.d.ts

@@ -0,0 +1,54 @@
+import { DyFM_ButtonNewStyle_Settings } from '../_models/control-models/button-new-style-settings.control-model';
+/**
+ * Collection of commonly used button style presets.
+ * Each preset is an instance of `DyFM_ButtonNewStyle_Settings`
+ * preconfigured for a specific look.
+ *
+ * **sizes:** xs, small, icon, large, xl
+ * **styles:** tonal, stroked, backgroundless
+ * **border radius:** rounded, unset
+ *
+ * @example
+ * ```ts
+ * const style = DyFM_ButtonNewStyleSettingsPresets.smallStroked;
+ * ```
+ */
+export declare const DyFM_ButtonNewStyleSettingsPresets: {
+    xs: DyFM_ButtonNewStyle_Settings;
+    xsIcon: DyFM_ButtonNewStyle_Settings;
+    xsRounded: DyFM_ButtonNewStyle_Settings;
+    xsStroked: DyFM_ButtonNewStyle_Settings;
+    xsStrokedIcon: DyFM_ButtonNewStyle_Settings;
+    xsBackgroundlessIcon: DyFM_ButtonNewStyle_Settings;
+    xsRoundedTonal: DyFM_ButtonNewStyle_Settings;
+    small: DyFM_ButtonNewStyle_Settings;
+    smallIcon: DyFM_ButtonNewStyle_Settings;
+    smallStrokedIcon: DyFM_ButtonNewStyle_Settings;
+    smallTonalIcon: DyFM_ButtonNewStyle_Settings;
+    smallRounded: DyFM_ButtonNewStyle_Settings;
+    smallStroked: DyFM_ButtonNewStyle_Settings;
+    smallTonal: DyFM_ButtonNewStyle_Settings;
+    smallRoundedTonal: DyFM_ButtonNewStyle_Settings;
+    smallStrokedRounded: DyFM_ButtonNewStyle_Settings;
+    smallBackgroundless: DyFM_ButtonNewStyle_Settings;
+    icon: DyFM_ButtonNewStyle_Settings;
+    backgroundlessSmallIconUnset: DyFM_ButtonNewStyle_Settings;
+    backgroundlessIconUnset: DyFM_ButtonNewStyle_Settings;
+    smallBackgroundlessIcon: DyFM_ButtonNewStyle_Settings;
+    strokedIcon: DyFM_ButtonNewStyle_Settings;
+    backgroundlessIcon: DyFM_ButtonNewStyle_Settings;
+    accent: DyFM_ButtonNewStyle_Settings;
+    strokedAccent: DyFM_ButtonNewStyle_Settings;
+    stroked: DyFM_ButtonNewStyle_Settings;
+    round: DyFM_ButtonNewStyle_Settings;
+    strokedRound: DyFM_ButtonNewStyle_Settings;
+    large: DyFM_ButtonNewStyle_Settings;
+    largeStroked: DyFM_ButtonNewStyle_Settings;
+    largeStrokedRound: DyFM_ButtonNewStyle_Settings;
+    largeTonal: DyFM_ButtonNewStyle_Settings;
+    largeIcon: DyFM_ButtonNewStyle_Settings;
+    largeStrokedIcon: DyFM_ButtonNewStyle_Settings;
+    xl: DyFM_ButtonNewStyle_Settings;
+    xlIcon: DyFM_ButtonNewStyle_Settings;
+};
+//# sourceMappingURL=button-new-style-settings-presets.const.d.ts.map

package/build/_modules/ngx-models/_collections/button-new-style-settings-presets.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-new-style-settings-presets.const.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ngx-models/_collections/button-new-style-settings-presets.const.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mEAAmE,CAAC;AAEjH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4J9C,CAAA"}