@nodaro/shared 1.4.2

package/src/furniture.ts

@@ -0,0 +1,167 @@
+/**
+ * Canonical catalog of furniture presets for the Object entity node.
+ *
+ * When the Object category is "furniture", users pick a specific furniture
+ * piece from this catalog. The picker auto-fills the object's `objectName`
+ * and `description` so the existing `buildObjectPrompt` pipeline just works
+ * — no backend prompt changes needed.
+ *
+ * Organized into everyday sub-categories: seating, tables, beds, storage,
+ * lighting, kitchen & dining, outdoor, decorative, and bath.
+ */
+
+export type FurnitureSubcategory =
+  | "seating"
+  | "tables"
+  | "beds"
+  | "storage"
+  | "lighting"
+  | "kitchen-dining"
+  | "outdoor"
+  | "decorative"
+  | "bath"
+
+export interface Furniture {
+  readonly id: string
+  readonly label: string
+  readonly subcategory: FurnitureSubcategory
+  readonly description: string
+}
+
+export const FURNITURE: ReadonlyArray<Furniture> = [
+  // -------------------- Seating --------------------
+  { id: "sofa",                 label: "Sofa",                subcategory: "seating", description: "Three-seater sofa with plush cushioned back and seat, low armrests and upholstery in a neutral tone" },
+  { id: "sectional-sofa",       label: "Sectional Sofa",      subcategory: "seating", description: "L-shaped sectional sofa with deep seats, soft cushions, a chaise end and hidden storage or recline mechanisms" },
+  { id: "loveseat",             label: "Loveseat",            subcategory: "seating", description: "Compact two-seat loveseat with rolled arms, tufted back and tapered wooden legs" },
+  { id: "armchair",             label: "Armchair",            subcategory: "seating", description: "Upholstered armchair with a tall padded back, curved armrests and four slim wooden legs" },
+  { id: "recliner",             label: "Recliner",            subcategory: "seating", description: "Padded recliner chair with a pull lever, extending footrest, thick leather upholstery and a reclined backrest" },
+  { id: "office-chair",         label: "Office Chair",        subcategory: "seating", description: "Ergonomic office chair with a mesh back, adjustable armrests, gas-lift height and a five-point caster base" },
+  { id: "rocking-chair",        label: "Rocking Chair",       subcategory: "seating", description: "Wooden rocking chair with curved rockers, a woven cane back and a padded seat cushion" },
+  { id: "throne",               label: "Throne",              subcategory: "seating", description: "Ornate royal throne with a towering carved back, gilded trim, jeweled accents and a plush velvet cushion" },
+  { id: "bean-bag",             label: "Bean Bag",            subcategory: "seating", description: "Oversized slouchy bean bag chair with soft fabric exterior and a pillowy squishy shape that molds to the body" },
+  { id: "stool",                label: "Stool",               subcategory: "seating", description: "Simple backless stool with a round wooden seat, four splayed turned legs and a worn comfortable patina" },
+  { id: "bench",                label: "Bench",               subcategory: "seating", description: "Long wooden bench with a flat seat, open slatted back and sturdy planked legs" },
+  { id: "chaise-lounge",        label: "Chaise Lounge",       subcategory: "seating", description: "Elegant chaise lounge with a sloped headrest, elongated upholstered seat and turned wooden legs" },
+  { id: "dining-chair",         label: "Dining Chair",        subcategory: "seating", description: "Formal dining chair with a high slatted back, upholstered seat cushion and tapered wooden legs" },
+
+  // -------------------- Tables --------------------
+  { id: "dining-table",         label: "Dining Table",        subcategory: "tables", description: "Large rectangular dining table with a polished wooden top, thick trestle base and seating for six to eight" },
+  { id: "coffee-table",         label: "Coffee Table",        subcategory: "tables", description: "Low rectangular coffee table with a glass or wooden top, clean minimalist legs and a lower shelf for magazines" },
+  { id: "side-table",           label: "Side Table",          subcategory: "tables", description: "Petite side table with a round top, single drawer and slim tapered legs" },
+  { id: "console-table",        label: "Console Table",       subcategory: "tables", description: "Narrow console table with a long slim top, delicate legs and decorative scrollwork along the apron" },
+  { id: "desk",                 label: "Desk",                subcategory: "tables", description: "Writing desk with a flat work surface, drawer bank on the side and a cable management cutout at the back" },
+  { id: "workbench",            label: "Workbench",           subcategory: "tables", description: "Heavy-duty workbench with a thick butcher-block top, pegboard back panel and a vice clamped to one edge" },
+  { id: "vanity-table",         label: "Vanity Table",        subcategory: "tables", description: "Dressing vanity with a wide tri-fold mirror, small drawers on each side and a cushioned bench tucked underneath" },
+  { id: "nightstand",           label: "Nightstand",          subcategory: "tables", description: "Small bedside nightstand with a single drawer, open lower shelf and a lamp-ready top surface" },
+  { id: "picnic-table",         label: "Picnic Table",        subcategory: "tables", description: "Classic wooden picnic table with a plank top, attached bench seats and weathered outdoor finish" },
+
+  // -------------------- Beds --------------------
+  { id: "bed-single",           label: "Single Bed",          subcategory: "beds", description: "Narrow single bed with a padded headboard, tailored fitted sheet and a folded throw blanket at the foot" },
+  { id: "bed-queen",            label: "Queen Bed",           subcategory: "beds", description: "Queen-size bed with a tall upholstered headboard, layered pillows, a crisp duvet and a runner across the foot" },
+  { id: "bed-king",             label: "King Bed",            subcategory: "beds", description: "Grand king-size bed with a tufted headboard, multiple plush pillows, crisp white linens and a thick quilted duvet" },
+  { id: "bunk-bed",             label: "Bunk Bed",            subcategory: "beds", description: "Sturdy wooden bunk bed with two stacked mattresses, side ladder, safety rails and matching kid-friendly bedding" },
+  { id: "canopy-bed",           label: "Canopy Bed",          subcategory: "beds", description: "Four-poster canopy bed with tall carved posts, a fabric canopy draped overhead and flowing curtains at each corner" },
+  { id: "four-poster-bed",      label: "Four-Poster Bed",     subcategory: "beds", description: "Four-poster bed with turned wooden columns at each corner rising unadorned to match the headboard's carved profile" },
+  { id: "daybed",               label: "Daybed",              subcategory: "beds", description: "Daybed with a low frame, three upholstered sides acting as back and armrests and bolster cushions along the wall" },
+  { id: "crib",                 label: "Baby Crib",           subcategory: "beds", description: "Wooden baby crib with vertical slatted sides, a small fitted mattress and soft plush toys tucked inside" },
+  { id: "futon",                label: "Futon",               subcategory: "beds", description: "Convertible futon with a slim padded mattress over a folding metal frame that converts from sofa to bed" },
+  { id: "hammock",              label: "Hammock",             subcategory: "beds", description: "Woven rope hammock slung between two supports, gently sagging with an inviting curve and colorful tassels at each end" },
+
+  // -------------------- Storage --------------------
+  { id: "bookshelf",            label: "Bookshelf",           subcategory: "storage", description: "Tall freestanding bookshelf with multiple horizontal shelves, wooden sides and rows of neatly stacked books" },
+  { id: "wardrobe",             label: "Wardrobe",            subcategory: "storage", description: "Large double-door wardrobe with a full-length hanging section, drawer bank and decorative paneled doors" },
+  { id: "dresser",              label: "Dresser",             subcategory: "storage", description: "Wooden dresser with a wide top, six deep drawers in two columns, brass pull handles and short tapered legs" },
+  { id: "cabinet",              label: "Cabinet",             subcategory: "storage", description: "Storage cabinet with paneled doors, interior adjustable shelves and brass hardware" },
+  { id: "chest",                label: "Storage Chest",       subcategory: "storage", description: "Weathered wooden storage chest with iron banding, a hinged domed lid and a heavy clasp latch at the front" },
+  { id: "trunk",                label: "Steamer Trunk",       subcategory: "storage", description: "Vintage steamer trunk with leather straps, brass corners, travel stickers and a latched lid revealing tray inserts" },
+  { id: "filing-cabinet",       label: "Filing Cabinet",      subcategory: "storage", description: "Four-drawer metal filing cabinet with label slots on each drawer, recessed pull handles and a key lock at the top" },
+  { id: "tv-stand",             label: "TV Stand",            subcategory: "storage", description: "Low entertainment TV stand with open shelves, glass-fronted cabinet doors and cable pass-throughs" },
+  { id: "display-case",         label: "Display Case",        subcategory: "storage", description: "Tall glass display case with interior lighting, glass shelves and a lockable framed door" },
+  { id: "hutch",                label: "China Hutch",         subcategory: "storage", description: "Two-part china hutch with a glass-fronted upper cabinet showing plates on edge and a buffet base with drawers and doors" },
+  { id: "toy-chest",            label: "Toy Chest",           subcategory: "storage", description: "Painted wooden toy chest with cheerful decals, a soft-close hinged lid and stickers accumulated on the sides" },
+
+  // -------------------- Lighting --------------------
+  { id: "floor-lamp",           label: "Floor Lamp",          subcategory: "lighting", description: "Tall floor lamp with a slim metal stand, weighted base, pull-chain switch and a drum fabric shade at the top" },
+  { id: "table-lamp",           label: "Table Lamp",          subcategory: "lighting", description: "Classic table lamp with a ceramic base, pleated fabric shade and a small pull-chain switch" },
+  { id: "desk-lamp",            label: "Desk Lamp",           subcategory: "lighting", description: "Articulating desk lamp with an adjustable arm, hinged head and a small cone-shaped metal shade" },
+  { id: "chandelier",           label: "Chandelier",          subcategory: "lighting", description: "Grand crystal chandelier with tiered cascading crystals, curved golden arms and multiple flame-shaped bulbs" },
+  { id: "pendant-light",        label: "Pendant Light",       subcategory: "lighting", description: "Modern pendant light hanging from a long cord with a minimalist metal or glass shade" },
+  { id: "sconce",               label: "Wall Sconce",         subcategory: "lighting", description: "Wall-mounted sconce with a decorative backplate, curved arm and a fabric or glass shade pointing upward" },
+  { id: "lantern",              label: "Lantern",             subcategory: "lighting", description: "Classic lantern with a metal frame, glass panels, a candle or flickering bulb inside and a carrying ring on top" },
+  { id: "candelabra",           label: "Candelabra",          subcategory: "lighting", description: "Ornate silver candelabra with multiple curved branching arms each holding a tall taper candle" },
+  { id: "neon-sign",            label: "Neon Sign",           subcategory: "lighting", description: "Glowing neon sign with bent glass tubes shaped into cursive lettering or a retro icon, casting colored light on the wall" },
+
+  // -------------------- Kitchen & Dining --------------------
+  { id: "kitchen-island",       label: "Kitchen Island",      subcategory: "kitchen-dining", description: "Freestanding kitchen island with a thick butcher-block top, cabinet storage below, bar stool overhang and a rack above" },
+  { id: "bar-counter",          label: "Bar Counter",         subcategory: "kitchen-dining", description: "Home bar counter with a polished wooden top, brass footrail, backlit glass shelving and rows of bottles displayed behind" },
+  { id: "bar-stool",            label: "Bar Stool",           subcategory: "kitchen-dining", description: "Tall bar stool with a round swiveling seat, footrest ring, metal frame and an optional low backrest" },
+  { id: "pot-rack",             label: "Pot Rack",            subcategory: "kitchen-dining", description: "Overhead hanging pot rack with a wrought-iron frame, S-hooks dangling pots and pans and shelving for spices on top" },
+  { id: "spice-rack",           label: "Spice Rack",          subcategory: "kitchen-dining", description: "Wall-mounted spice rack with rows of small labeled glass jars, wooden shelves and a cheerful cluttered charm" },
+  { id: "buffet",               label: "Buffet",              subcategory: "kitchen-dining", description: "Long dining-room buffet with a flat top for serving platters, drawers for linens and cabinet doors for dishware below" },
+
+  // -------------------- Outdoor --------------------
+  { id: "patio-chair",          label: "Patio Chair",         subcategory: "outdoor", description: "Outdoor patio chair with a weather-resistant woven wicker seat, aluminum frame and a weatherproof cushion" },
+  { id: "adirondack-chair",     label: "Adirondack Chair",    subcategory: "outdoor", description: "Classic wooden Adirondack chair with a slanted slatted back, wide flat armrests and a seat that scoops gently back" },
+  { id: "porch-swing",          label: "Porch Swing",         subcategory: "outdoor", description: "Wooden porch swing suspended on chains from the ceiling with a slatted seat and a row of colorful outdoor cushions" },
+  { id: "gazebo",               label: "Gazebo",              subcategory: "outdoor", description: "Freestanding outdoor gazebo with a peaked shingled roof, six open wooden columns, railings and a raised wooden floor" },
+  { id: "bistro-set",           label: "Bistro Set",          subcategory: "outdoor", description: "Compact outdoor bistro set with a round wrought-iron table and two matching chairs in a glossy weather-resistant finish" },
+  { id: "sun-lounger",          label: "Sun Lounger",         subcategory: "outdoor", description: "Poolside sun lounger with an adjustable reclining back, white vinyl straps and a matching side table" },
+  { id: "fire-pit",             label: "Fire Pit",            subcategory: "outdoor", description: "Round outdoor fire pit bowl with a rough-iron exterior, flickering flames and glowing embers beneath a protective mesh screen" },
+
+  // -------------------- Decorative --------------------
+  { id: "mirror",               label: "Mirror",              subcategory: "decorative", description: "Large wall mirror with an ornate gilded frame, carved scrollwork and slightly aged silvering in the glass" },
+  { id: "rug",                  label: "Rug",                 subcategory: "decorative", description: "Large patterned area rug with intricate woven motifs, tasseled ends and a soft plush pile" },
+  { id: "vase",                 label: "Vase",                subcategory: "decorative", description: "Tall ceramic vase with a rounded body, narrow neck, glazed finish and a fresh bouquet of flowers arranged inside" },
+  { id: "grandfather-clock",    label: "Grandfather Clock",   subcategory: "decorative", description: "Tall wooden grandfather clock with a glass pendulum door, brass clock face, roman numerals and a chime mechanism" },
+  { id: "wall-art",             label: "Framed Wall Art",     subcategory: "decorative", description: "Large framed artwork in a gilded or minimalist frame with a gallery-style matte border and a single focal painting" },
+  { id: "pillow",               label: "Throw Pillow",        subcategory: "decorative", description: "Decorative throw pillow with a patterned cover, piped edges, plush fill and an invisible zipper closure" },
+  { id: "curtains",             label: "Curtains",            subcategory: "decorative", description: "Full-length curtains with thick draping fabric, pleated tops hanging from a metal rod and tie-backs on each side" },
+  { id: "sculpture",            label: "Sculpture",           subcategory: "decorative", description: "Abstract sculpture on a pedestal with flowing organic forms in bronze or marble catching the light from multiple angles" },
+
+  // -------------------- Bath --------------------
+  { id: "bathtub",              label: "Bathtub",             subcategory: "bath", description: "Freestanding clawfoot bathtub with rolled rim, polished white enamel interior and four ornate cast-iron feet" },
+  { id: "shower",               label: "Walk-In Shower",      subcategory: "bath", description: "Walk-in shower with frameless glass panels, tiled walls, a rainfall showerhead and a linear floor drain" },
+  { id: "toilet",               label: "Toilet",              subcategory: "bath", description: "Standard white ceramic toilet with an oval bowl, elongated seat and a tank with a chrome flush handle" },
+  { id: "sink-vanity",          label: "Sink Vanity",         subcategory: "bath", description: "Bathroom sink vanity with a stone countertop, undermount basin, wide mirror above and paneled cabinet doors below" },
+  { id: "towel-rack",           label: "Towel Rack",          subcategory: "bath", description: "Wall-mounted heated towel rack with multiple horizontal bars and fluffy folded towels draped over each bar" },
+] as const
+
+const furnitureById = new Map<string, Furniture>(FURNITURE.map((f) => [f.id, f]))
+
+export function getFurniture(id: string | undefined | null): Furniture | undefined {
+  if (!id) return undefined
+  return furnitureById.get(id)
+}
+
+export function getFurnitureLabel(id: string | undefined | null, fallback?: string): string {
+  const f = getFurniture(id)
+  if (f) return f.label
+  if (fallback !== undefined) return fallback
+  return (id ?? "").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase())
+}
+
+export const FURNITURE_IDS: ReadonlyArray<string> = FURNITURE.map((f) => f.id)
+
+export const FURNITURE_SUBCATEGORY_LABELS: Readonly<Record<FurnitureSubcategory, string>> = {
+  seating: "Seating",
+  tables: "Tables",
+  beds: "Beds",
+  storage: "Storage",
+  lighting: "Lighting",
+  "kitchen-dining": "Kitchen & Dining",
+  outdoor: "Outdoor",
+  decorative: "Decorative",
+  bath: "Bath",
+}
+
+export const FURNITURE_SUBCATEGORY_ORDER: ReadonlyArray<FurnitureSubcategory> = [
+  "seating",
+  "tables",
+  "beds",
+  "storage",
+  "lighting",
+  "kitchen-dining",
+  "outdoor",
+  "decorative",
+  "bath",
+]

package/src/generate-text-items.ts

@@ -0,0 +1,15 @@
+/** Delimiter the Generate Text templates instruct the LLM to emit between blocks. */
+export const GENERATE_TEXT_DELIMITER = "===NEXT==="
+
+/**
+ * Split a Generate Text result into fan-out items. Used by BOTH the frontend
+ * extractNodeOutput and the backend output-extractor so single-node and DAG
+ * execution produce identical `items`.
+ */
+export function splitGeneratedItems(text: string | null | undefined): string[] {
+  if (!text) return []
+  const parts = text.split(GENERATE_TEXT_DELIMITER).map((s) => s.trim()).filter(Boolean)
+  if (parts.length > 0) return parts
+  const trimmed = text.trim()
+  return trimmed ? [trimmed] : []
+}

package/src/generated-results.ts

@@ -0,0 +1,63 @@
+/**
+ * Helpers for reading a node's accumulated `generatedResults` array.
+ *
+ * Used by both frontend DAG executor (`node-input-resolver.ts`) and backend
+ * orchestrator (`output-extractor.ts`) so they agree on when a node has
+ * upstream-consumable output.
+ */
+
+/**
+ * Extract all output values from a node's accumulated generatedResults.
+ * Returns the full flat list (any length). Returns undefined only when empty.
+ */
+export function extractAllGeneratedResults(
+  data: Record<string, unknown>,
+): string[] | undefined {
+  const results = data.generatedResults as
+    | Array<{ url?: string; text?: string }>
+    | undefined
+  if (!results || results.length === 0) return undefined
+  const outputs = results
+    .map((r) => r.url || r.text || "")
+    .filter((v) => v.length > 0)
+  return outputs.length > 0 ? outputs : undefined
+}
+
+/**
+ * Extract a JSON array (e.g. web-scrape `generatedJson`) as a list of strings.
+ * Each array element is stringified; already-string elements pass through.
+ */
+export function extractGeneratedJsonAsList(
+  data: Record<string, unknown>,
+): string[] | undefined {
+  const jsonArr = data.generatedJson
+  if (!Array.isArray(jsonArr) || jsonArr.length === 0) return undefined
+  return jsonArr.map((item: unknown) =>
+    typeof item === "string" ? item : JSON.stringify(item),
+  )
+}
+
+/**
+ * If a collected item list has a single entry whose contents parse to a
+ * non-empty JSON array, spread the array's elements into separate items.
+ * Mirrors the `output.json` spread in the orchestrator so a list node with
+ * one row holding a JSON array feeds filter-list / deduplicate / sort-list /
+ * merge-lists per-element instead of as one giant stringified blob.
+ */
+export function spreadJsonArrayIfSingleton(items: string[]): string[] {
+  if (items.length !== 1) return items
+  const single = items[0]
+  if (typeof single !== "string") return items
+  const trimmed = single.trim()
+  if (!trimmed.startsWith("[")) return items
+  let parsed: unknown
+  try {
+    parsed = JSON.parse(trimmed)
+  } catch {
+    return items
+  }
+  if (!Array.isArray(parsed) || parsed.length === 0) return items
+  return parsed.map((el) =>
+    typeof el === "string" ? el : JSON.stringify(el),
+  )
+}

package/src/group-aggregation.ts

@@ -0,0 +1,75 @@
+import type { OutputType } from "./presentation-utils.js"
+
+// Intentional subset of OutputType (presentation-utils.ts:152) —
+// excludes "data" (multi-output / opaque types are skipped from aggregation).
+export type AggregateableType = "text" | "image" | "video" | "audio"
+
+// Stable ordered tuple of aggregateable types — used for handle ordering + presentTypes.
+export const AGGREGATEABLE_TYPES = ["text", "image", "video", "audio"] as const
+
+export interface Member {
+  nodeId: string
+  type: AggregateableType
+  value: string
+}
+
+export interface AggregationBuckets {
+  text: string[]
+  image: string[]
+  video: string[]
+  audio: string[]
+}
+
+export function aggregateByType(members: Member[]): AggregationBuckets {
+  const buckets: AggregationBuckets = { text: [], image: [], video: [], audio: [] }
+  for (const m of members) buckets[m.type].push(m.value)
+  return buckets
+}
+
+export function presentTypes(buckets: AggregationBuckets): AggregateableType[] {
+  return AGGREGATEABLE_TYPES.filter((t) => buckets[t].length > 0)
+}
+
+// Type guard for narrowing OutputType to AggregateableType.
+export function isAggregateableType(t: OutputType | undefined): t is AggregateableType {
+  return t === "text" || t === "image" || t === "video" || t === "audio"
+}
+
+// Handle id naming conventions for Group / Collect dynamic output handles + Collect's single input handle.
+export const GROUP_HANDLE_PREFIX = "out-" as const
+export const COLLECT_IN_HANDLE = "in" as const
+
+export function groupHandleId(t: AggregateableType): string {
+  return `${GROUP_HANDLE_PREFIX}${t}`
+}
+
+export function parseGroupHandle(h: string | null | undefined): AggregateableType | undefined {
+  if (!h || !h.startsWith(GROUP_HANDLE_PREFIX)) return undefined
+  const candidate = h.slice(GROUP_HANDLE_PREFIX.length) as OutputType
+  return isAggregateableType(candidate) ? candidate : undefined
+}
+
+/**
+ * Build a parent → children-ids map from a flat node array in a single pass.
+ * Used by both engines' `buildExecutionLevels` to derive the implicit
+ * child → group dependency edges in O(N+G) instead of O(N×G).
+ */
+export function buildChildrenByParent<N extends { id: string; parentId?: string }>(
+  nodes: ReadonlyArray<N>,
+): Map<string, string[]> {
+  const childrenByParent = new Map<string, string[]>()
+  for (const n of nodes) {
+    if (!n.parentId) continue
+    const list = childrenByParent.get(n.parentId)
+    if (list) list.push(n.id)
+    else childrenByParent.set(n.parentId, [n.id])
+  }
+  return childrenByParent
+}
+
+// Whether an edge targets a Collect node's "in" handle. The default-"in" fallback
+// matches every other call site so legacy edges without an explicit targetHandle
+// keep working. Duck-typed input shape avoids a runtime dep on @xyflow/react.
+export function isCollectInEdge(e: { targetHandle?: string | null }): boolean {
+  return (e.targetHandle ?? COLLECT_IN_HANDLE) === COLLECT_IN_HANDLE
+}

package/src/hint-graph-types.ts

@@ -0,0 +1,18 @@
+/** Structural node/edge/graph shapes used by hint + aggregation helpers. */
+export interface HintNodeLike {
+  readonly id: string
+  readonly type?: string
+  readonly data?: unknown
+}
+
+export interface HintEdgeLike {
+  readonly source: string
+  readonly target: string
+  readonly sourceHandle?: string | null
+  readonly targetHandle?: string | null
+}
+
+export interface HintGraphContext {
+  readonly nodes: ReadonlyArray<HintNodeLike>
+  readonly edges: ReadonlyArray<HintEdgeLike>
+}

package/src/i18n/action-fx.ar.ts

@@ -0,0 +1,89 @@
+import type { LocaleCatalogMap } from "./types.js"
+
+const map: LocaleCatalogMap = {
+  // ── Disaster ──
+  "earthquake-tremor": { label: "هزة أرضية", description: "اهتزاز خفيف للأرض، أشياء معلقة تتأرجح" },
+  "earthquake-major": { label: "زلزال كبير", description: "أرض تتشقق، حطام يتساقط" },
+  "building-collapse": { label: "انهيار مبنى", description: "بناء يتفتت أثناء سقوطه" },
+  "tsunami-wave": { label: "موجة تسونامي", description: "جدار شاهق من الماء يندفع للأمام" },
+  "tornado": { label: "إعصار قمعي", description: "سحابة قمعية تلامس الأرض" },
+  "hurricane": { label: "إعصار", description: "رياح عاصفة تثني الأشجار، أمطار غزيرة" },
+  "blizzard-whiteout": { label: "عاصفة ثلجية مُعمية", description: "ثلوج كثيفة تمحو الرؤية" },
+  "sandstorm": { label: "عاصفة رملية", description: "جدار من الغبار البرتقالي يبتلع المشهد" },
+  "dust-storm-haboob": { label: "عاصفة غبار (هبوب)", description: "جبهة غبار صحراوية شاهقة" },
+  "wildfire-distant": { label: "حريق غابات بعيد", description: "توهج برتقالي + دخان في الأفق" },
+  "wildfire-engulfing": { label: "حريق ملتهم", description: "ألسنة لهب تقترب، تموج حراري شديد" },
+  "volcanic-eruption": { label: "ثوران بركاني", description: "حمم تتدفق، عمود رماد" },
+  "lava-flow": { label: "تدفق حمم", description: "نهر منصهر متوهج يزحف على الأرض" },
+  "ash-rain": { label: "مطر رماد", description: "رماد رمادي مرعب يتساقط كالثلج" },
+  "avalanche": { label: "انهيار جليدي", description: "جدار من الثلج ينهمر على المنحدر" },
+  "hailstorm": { label: "عاصفة بَرَد", description: "حبات بَرَد كبيرة ترتد عن الأسطح" },
+
+  // ── Fire & Blasts ──
+  "explosion-small": { label: "انفجار صغير", description: "انفجار مُحكم مع وميض مركزي" },
+  "explosion-large": { label: "انفجار كبير", description: "كرة نارية بحجم مركبة مع حطام" },
+  "explosion-massive": { label: "انفجار هائل", description: "كرة نارية تسوي مبانٍ مع موجة صدمة" },
+  "nuclear-detonation": { label: "تفجير نووي", description: "سحابة فطرية + ومضة تضيء الأفق" },
+  "fireball-airborne": { label: "كرة نار محمولة جوا", description: "كرة لهب متدحرجة في الجو" },
+  "gas-explosion": { label: "انفجار غاز", description: "اندفاع لامع بأسلوب بروبان" },
+  "oil-fire": { label: "حريق نفط", description: "ألسنة لهب طويلة دهنية + دخان أسود كثيف" },
+  "blazing-inferno": { label: "جحيم متوهج", description: "جدار من النار يلتهم كل شيء" },
+  "flame-burst": { label: "اندفاع لهب", description: "نفاثة سريعة موجهة من اللهب" },
+  "ember-shower": { label: "وابل جمرات", description: "شلال من الجمرات البرتقالية المتوهجة" },
+  "smoke-pillar": { label: "عمود دخان", description: "عمود عمودي طويل من الدخان الأسود" },
+  "mushroom-cloud": { label: "سحابة فطرية", description: "سحابة تفجير كلاسيكية بقبة وجذع" },
+
+  // ── Electric ──
+  "lightning-bolt": { label: "صاعقة برق", description: "ضربة متفرعة عبر سماء عاصفة" },
+  "lightning-strike-impact": { label: "ضربة برق", description: "صاعقة تضرب الأرض بانفجار من الضوء" },
+  "lightning-storm": { label: "عاصفة برقية", description: "ضربات متعددة متزامنة" },
+  "ball-lightning": { label: "برق كروي", description: "كرة متوهجة من البلازما الكهربائية تطفو في الجو" },
+  "plasma-arc": { label: "قوس بلازما", description: "قوس مستمر عالي الجهد بين نقطتين" },
+  "taser-sparks": { label: "شرر صاعق كهربائي", description: "تفريغ كهربائي مُحكم متطاير عند التلامس" },
+  "electric-discharge": { label: "تفريغ كهربائي", description: "اندفاع طاقة متقوسة من جهاز معطل" },
+  "transformer-blowout": { label: "انفجار محول كهربائي", description: "انفجار أزرق أبيض فوق عمود كهرباء" },
+  "st-elmos-fire": { label: "نار القديس إلمو", description: "توهج بلازما أزرق مخيف على أطراف معدنية" },
+  "static-shock-burst": { label: "صدمة كهرباء ساكنة", description: "ومضة صغيرة مرئية من كهرباء ساكنة" },
+
+  // ── Combat ──
+  "muzzle-flash": { label: "ومضة فوهة", description: "ومضة برتقالية ساطعة من فوهة بندقية" },
+  "gunshot-impact": { label: "ارتطام طلقة", description: "رصاصة تصيب سطحا ببخاخ من الحطام" },
+  "bullet-trail": { label: "أثر رصاصة", description: "أثر مرئي لرصاصة عبر الهواء" },
+  "sword-spark": { label: "شرر سيف", description: "وابل ماكرو من الشرر بفعل احتكاك المعدن" },
+  "blade-clash": { label: "اشتباك نصال", description: "نصلان يلتقيان بموجة ارتطام" },
+  "ricochet-spark": { label: "شرر ارتداد", description: "رصاصة ترتد عن المعدن مع شرر" },
+  "debris-field": { label: "حقل حطام", description: "شظايا متجمدة في الجو تتناثر" },
+  "glass-shatter-airborne": { label: "تحطم زجاج في الجو", description: "زجاج ينفجر للخارج إلى شظايا معلقة" },
+  "shockwave-ground": { label: "موجة صدمة أرضية", description: "حلقة مرئية تتسع على مستوى الأرض" },
+  "sonic-boom": { label: "دوي صوتي", description: "مخروط هواء مضغوط بسرعة فوق صوتية" },
+  "smoke-grenade": { label: "قنبلة دخانية", description: "دخان ملون كثيف يتفتح للخارج" },
+  "flashbang": { label: "قنبلة صوتية ضوئية", description: "اندفاع أبيض مُعمي من الضوء" },
+  "blood-spray": { label: "رذاذ دم", description: "قوس سينمائي من قطرات الدم" },
+  "arrow-hit-spark": { label: "شرر ارتطام سهم", description: "سهم يضرب بشرر صغير عند الارتطام" },
+
+  // ── Sci-Fi ──
+  "laser-blast": { label: "إطلاق ليزر", description: "شعاع متماسك ساطع من الطاقة" },
+  "energy-beam": { label: "شعاع طاقة", description: "شعاع عريض نابض من طاقة البلازما" },
+  "plasma-bolt": { label: "قذيفة بلازما", description: "مقذوف متوهج يترك أثرا من البخار" },
+  "force-field-shimmer": { label: "تلألؤ حقل قوة", description: "حاجز طاقة شفاف بنمط سداسي" },
+  "force-field-impact": { label: "ارتطام بحقل قوة", description: "تموج مرئي حيث يصطدم المقذوف بالدرع" },
+  "portal-opening": { label: "فتح بوابة", description: "دوامة طاقة تشق الفضاء" },
+  "warp-distortion": { label: "تشويه حرف", description: "زمكان ينحني حول جسم" },
+  "hologram-flicker": { label: "وميض هولوجرام", description: "إسقاط شفاف يتعطل" },
+  "ion-storm": { label: "عاصفة أيونية", description: "حقل متطاير من جسيمات مشحونة على خلفية كونية" },
+  "antimatter-flash": { label: "ومضة مضاد المادة", description: "اندفاع طاقة بيضاء يمزق الواقع" },
+
+  // ── Magic ──
+  "fireball-spell": { label: "تعويذة كرة نار", description: "كرة نار دوارة مُلقاة باليد" },
+  "magic-aura": { label: "هالة سحرية", description: "هالة طاقة متوهجة حول شخصية" },
+  "summoning-glyph": { label: "حرف استدعاء", description: "دائرة سحرية متوهجة على الأرض" },
+  "lightning-magic": { label: "سحر برق", description: "سحر كهربائي يتقوس من يدي الساحر" },
+  "ice-shard-burst": { label: "اندفاع شظايا ثلجية", description: "شظايا بلورية تتطاير للخارج" },
+  "energy-rune": { label: "رمز طاقة", description: "رمز سحري متوهج معلق في الهواء" },
+  "portal-magic": { label: "بوابة سحرية", description: "مدخل غامض دوار في الفضاء" },
+  "healing-glow": { label: "توهج شفاء", description: "ضوء ذهبي دافئ ينبعث من الساحر" },
+  "dark-vortex": { label: "دوامة مظلمة", description: "فراغ دوار أسود بنفسجي مشؤوم" },
+  "light-explosion": { label: "انفجار ضوء", description: "اندفاع من إشعاع أبيض ذهبي خالص" },
+}
+
+export default map

package/src/i18n/action-fx.de.ts

@@ -0,0 +1,89 @@
+import type { LocaleCatalogMap } from "./types.js"
+
+const map: LocaleCatalogMap = {
+  // ── Disaster ──
+  "earthquake-tremor": { label: "Erdbeben (leicht)", description: "Leichtes Beben, hängende Objekte schwanken" },
+  "earthquake-major": { label: "Schweres Erdbeben", description: "Aufreißender Boden, herabstürzende Trümmer" },
+  "building-collapse": { label: "Gebäudeeinsturz", description: "Bauwerk zerbricht im Fall" },
+  "tsunami-wave": { label: "Tsunami-Welle", description: "Hereinstürzende Wand aus Wasser" },
+  "tornado": { label: "Tornado", description: "Trichterwolke berührt den Boden" },
+  "hurricane": { label: "Hurrikan", description: "Heulende Winde, gebogene Bäume, Regenschleier" },
+  "blizzard-whiteout": { label: "Schneesturm-Whiteout", description: "Dichter Schnee löscht die Sicht aus" },
+  "sandstorm": { label: "Sandsturm", description: "Wand aus orangefarbenem Staub verschluckt die Szene" },
+  "dust-storm-haboob": { label: "Staubsturm (Haboob)", description: "Hochaufragende Wüsten-Staubfront" },
+  "wildfire-distant": { label: "Ferner Waldbrand", description: "Oranges Glühen + Rauch am Horizont" },
+  "wildfire-engulfing": { label: "Verschlingender Waldbrand", description: "Flammen rücken näher, intensives Hitzeflimmern" },
+  "volcanic-eruption": { label: "Vulkanausbruch", description: "Aufsteigende Lava, Aschewolke" },
+  "lava-flow": { label: "Lavastrom", description: "Glühender geschmolzener Strom kriecht über den Boden" },
+  "ash-rain": { label: "Aschefall", description: "Apokalyptische graue Asche fällt wie Schnee" },
+  "avalanche": { label: "Lawine", description: "Schneewand stürzt den Berghang hinunter" },
+  "hailstorm": { label: "Hagelsturm", description: "Große Hagelkörner prallen von Oberflächen ab" },
+
+  // ── Fire & Blasts ──
+  "explosion-small": { label: "Kleine Explosion", description: "Kompakte Detonation mit Lichtblitz im Zentrum" },
+  "explosion-large": { label: "Große Explosion", description: "Feuerball in Fahrzeuggröße mit umherfliegenden Trümmern" },
+  "explosion-massive": { label: "Massive Explosion", description: "Gebäudezerschmetternder Feuerball mit Druckwelle" },
+  "nuclear-detonation": { label: "Nukleare Detonation", description: "Atompilz und horizonterhellender Lichtblitz" },
+  "fireball-airborne": { label: "Schwebender Feuerball", description: "Rollende Feuerkugel in der Luft" },
+  "gas-explosion": { label: "Gasexplosion", description: "Heller Propan-artiger Lichtblitz" },
+  "oil-fire": { label: "Ölbrand", description: "Hohe fettige Flammen + dichter schwarzer Rauch" },
+  "blazing-inferno": { label: "Loderndes Inferno", description: "Feuerwand verschlingt alles" },
+  "flame-burst": { label: "Flammenstoß", description: "Schneller gerichteter Flammenstrahl" },
+  "ember-shower": { label: "Funkenflug", description: "Kaskade glühender oranger Funken" },
+  "smoke-pillar": { label: "Rauchsäule", description: "Hohe vertikale Säule aus schwarzem Rauch" },
+  "mushroom-cloud": { label: "Atompilz", description: "Klassische Detonationswolke aus Stiel und Kuppel" },
+
+  // ── Electric ──
+  "lightning-bolt": { label: "Blitz", description: "Verzweigte Entladung am Sturmhimmel" },
+  "lightning-strike-impact": { label: "Blitzeinschlag", description: "Blitz schlägt in den Boden mit Lichtexplosion" },
+  "lightning-storm": { label: "Gewittersturm", description: "Mehrere gleichzeitige Einschläge" },
+  "ball-lightning": { label: "Kugelblitz", description: "Glühender Plasma-Orb schwebt in der Luft" },
+  "plasma-arc": { label: "Plasmabogen", description: "Hochspannungs-Dauerlichtbogen zwischen zwei Punkten" },
+  "taser-sparks": { label: "Taser-Funken", description: "Kompakte knisternde elektrische Entladung beim Kontakt" },
+  "electric-discharge": { label: "Elektrische Entladung", description: "Schauer aus Lichtbögen aus einem defekten Gerät" },
+  "transformer-blowout": { label: "Transformator-Explosion", description: "Blau-weiße Explosion auf einem Strommast" },
+  "st-elmos-fire": { label: "Elmsfeuer", description: "Unheimliches blaues Plasmaglühen an Metallspitzen" },
+  "static-shock-burst": { label: "Statikentladung", description: "Winziger sichtbarer Funken statischer Elektrizität" },
+
+  // ── Combat ──
+  "muzzle-flash": { label: "Mündungsfeuer", description: "Heller orangefarbener Blitz aus dem Gewehrlauf" },
+  "gunshot-impact": { label: "Schuss-Einschlag", description: "Kugel trifft Oberfläche mit Trümmer-Auswurf" },
+  "bullet-trail": { label: "Geschossspur", description: "Sichtbarer Streif einer Kugel durch die Luft" },
+  "sword-spark": { label: "Klingenfunken", description: "Makro-Schauer aus Reibungsfunken Metall auf Metall" },
+  "blade-clash": { label: "Klingenstoß", description: "Zwei Klingen treffen mit Schockwelle aufeinander" },
+  "ricochet-spark": { label: "Querschläger-Funken", description: "Kugel prallt von Metall mit Funkenflug ab" },
+  "debris-field": { label: "Trümmerfeld", description: "In der Luft erstarrende Splitter zerstreuen sich" },
+  "glass-shatter-airborne": { label: "Glas zerspringt im Flug", description: "Glas explodiert nach außen in Splittern in der Luft" },
+  "shockwave-ground": { label: "Druckwelle am Boden", description: "Sichtbarer expandierender Ring auf Bodenhöhe" },
+  "sonic-boom": { label: "Überschallknall", description: "Kegel komprimierter Luft bei Überschallgeschwindigkeit" },
+  "smoke-grenade": { label: "Rauchgranate", description: "Dichter farbiger Rauch breitet sich nach außen aus" },
+  "flashbang": { label: "Blendgranate", description: "Blendender weißer Lichtblitz" },
+  "blood-spray": { label: "Blutsprenkel", description: "Filmreifer Bogen aus Bluttropfen" },
+  "arrow-hit-spark": { label: "Pfeil-Einschlagfunken", description: "Pfeil trifft mit kleinen Funken am Aufprall ein" },
+
+  // ── Sci-Fi ──
+  "laser-blast": { label: "Laserstrahl", description: "Heller kohärenter Energiestrahl" },
+  "energy-beam": { label: "Energiestrahl", description: "Breiter pulsierender Plasma-Energiestrahl" },
+  "plasma-bolt": { label: "Plasmageschoss", description: "Glühendes Projektil mit Dampfschweif" },
+  "force-field-shimmer": { label: "Kraftfeld-Schimmer", description: "Durchscheinende Energiebarriere mit Hex-Muster" },
+  "force-field-impact": { label: "Kraftfeld-Aufprall", description: "Sichtbare Welle dort, wo das Geschoss den Schild trifft" },
+  "portal-opening": { label: "Portalöffnung", description: "Wirbelnder Energievortex reißt den Raum auf" },
+  "warp-distortion": { label: "Warp-Verzerrung", description: "Raumzeit krümmt sich um ein Objekt" },
+  "hologram-flicker": { label: "Hologramm-Flackern", description: "Durchscheinende Projektion glitcht" },
+  "ion-storm": { label: "Ionensturm", description: "Knisterndes Feld geladener Teilchen vor kosmischer Kulisse" },
+  "antimatter-flash": { label: "Antimaterie-Blitz", description: "Realitäts-zerreißender Stoß reiner weißer Energie" },
+
+  // ── Magic ──
+  "fireball-spell": { label: "Feuerball-Zauber", description: "Mit der Hand geworfener Wirbel aus Feuer" },
+  "magic-aura": { label: "Magische Aura", description: "Glühender Energie-Halo um eine Figur" },
+  "summoning-glyph": { label: "Beschwörungsglyphe", description: "Glühender magischer Kreis am Boden" },
+  "lightning-magic": { label: "Blitzmagie", description: "Elektrische Zauberei aus den Händen des Magiers" },
+  "ice-shard-burst": { label: "Eissplitter-Stoß", description: "Kristalline Splitter spritzen nach außen" },
+  "energy-rune": { label: "Energierune", description: "Glühendes arkanes Symbol schwebt in der Luft" },
+  "portal-magic": { label: "Magisches Portal", description: "Wirbelndes mystisches Tor im Raum" },
+  "healing-glow": { label: "Heilungsschein", description: "Warmes goldenes Licht strömt vom Zaubernden aus" },
+  "dark-vortex": { label: "Dunkler Vortex", description: "Bedrohlicher schwarz-violetter Wirbelschlund" },
+  "light-explosion": { label: "Lichtexplosion", description: "Blitz aus reinem weiß-goldenem Strahlen" },
+}
+
+export default map