@flood-md/agent 0.2.10 → 0.2.12

package/dist/materials/token-sys.motion.distance-small.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.distance-small",
+  "cssName": "--flood-sys-motion-distance-small",
+  "description": "Bounded movement for compact surfaces",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.distance-small",
+      "type": "dimension",
+      "cssName": "--flood-sys-motion-distance-small",
+      "description": "Bounded movement for compact surfaces",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Bounded movement for compact surfaces"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 4,
+        "unit": "px"
+      },
+      "alias": "ref.motion.distance-small",
+      "dependencies": [
+        "ref.motion.distance-small"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.duration-enter.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.duration-enter",
+  "cssName": "--flood-sys-motion-duration-enter",
+  "description": "Anchored layers and arriving feedback",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.duration-enter",
+      "type": "duration",
+      "cssName": "--flood-sys-motion-duration-enter",
+      "description": "Anchored layers and arriving feedback",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Anchored layers and arriving feedback"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 180,
+        "unit": "ms"
+      },
+      "alias": "ref.motion.duration-enter",
+      "dependencies": [
+        "ref.motion.duration-enter"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.duration-exit.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.duration-exit",
+  "cssName": "--flood-sys-motion-duration-exit",
+  "description": "Dismissal where visual presence is safe",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.duration-exit",
+      "type": "duration",
+      "cssName": "--flood-sys-motion-duration-exit",
+      "description": "Dismissal where visual presence is safe",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Dismissal where visual presence is safe"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 120,
+        "unit": "ms"
+      },
+      "alias": "ref.motion.duration-exit",
+      "dependencies": [
+        "ref.motion.duration-exit"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.duration-layer.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.duration-layer",
+  "cssName": "--flood-sys-motion-duration-layer",
+  "description": "Modal and edge panel entrances",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.duration-layer",
+      "type": "duration",
+      "cssName": "--flood-sys-motion-duration-layer",
+      "description": "Modal and edge panel entrances",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Modal and edge panel entrances"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 240,
+        "unit": "ms"
+      },
+      "alias": "ref.motion.duration-layer",
+      "dependencies": [
+        "ref.motion.duration-layer"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.duration-loop.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.duration-loop",
+  "cssName": "--flood-sys-motion-duration-loop",
+  "description": "Repeating activity feedback",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.duration-loop",
+      "type": "duration",
+      "cssName": "--flood-sys-motion-duration-loop",
+      "description": "Repeating activity feedback",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Repeating activity feedback"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 1000,
+        "unit": "ms"
+      },
+      "alias": "ref.motion.duration-loop",
+      "dependencies": [
+        "ref.motion.duration-loop"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.duration-press.json

@@ -0,0 +1,36 @@
+{
+  "role": "sys.motion.duration-press",
+  "cssName": "--flood-sys-motion-duration-press",
+  "description": "Fast tactile state changes",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.duration-press",
+      "type": "duration",
+      "cssName": "--flood-sys-motion-duration-press",
+      "description": "Fast tactile state changes",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Fast tactile state changes"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": {
+        "value": 70,
+        "unit": "ms"
+      },
+      "alias": "ref.motion.duration-press",
+      "dependencies": [
+        "ref.motion.duration-press"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.easing-enter.json

@@ -0,0 +1,38 @@
+{
+  "role": "sys.motion.easing-enter",
+  "cssName": "--flood-sys-motion-easing-enter",
+  "description": "Responsive entrance with a soft stop",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.easing-enter",
+      "type": "cubicBezier",
+      "cssName": "--flood-sys-motion-easing-enter",
+      "description": "Responsive entrance with a soft stop",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Responsive entrance with a soft stop"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": [
+        0.16,
+        1,
+        0.3,
+        1
+      ],
+      "alias": "ref.motion.easing-enter",
+      "dependencies": [
+        "ref.motion.easing-enter"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/dist/materials/token-sys.motion.easing-exit.json

@@ -0,0 +1,38 @@
+{
+  "role": "sys.motion.easing-exit",
+  "cssName": "--flood-sys-motion-easing-exit",
+  "description": "Short accelerating exit",
+  "contexts": [
+    {
+      "preset": "neutral",
+      "theme": "dark",
+      "id": "sys.motion.easing-exit",
+      "type": "cubicBezier",
+      "cssName": "--flood-sys-motion-easing-exit",
+      "description": "Short accelerating exit",
+      "status": "experimental",
+      "visibility": "public",
+      "owner": "foundations",
+      "since": "0.2.11",
+      "usage": {
+        "allowed": [
+          "Short accelerating exit"
+        ],
+        "avoid": [
+          "Using motion to delay focus or state changes"
+        ]
+      },
+      "value": [
+        0.4,
+        0,
+        1,
+        1
+      ],
+      "alias": "ref.motion.easing-exit",
+      "dependencies": [
+        "ref.motion.easing-exit"
+      ],
+      "dependents": []
+    }
+  ]
+}

package/knowledge.json

@@ -29,10 +29,11 @@
     {
       "id": "motion",
       "name": "Motion",
-      "description": "Existing motion tokens; page-transition workflows are not provided."
+      "description": "Component motion roles, transition recipes and reduced-motion verification."
     }
   ],
   "workflows": {
+    "motion": ["motion", "quality"],
     "composition": [
       "composition"
     ],
@@ -208,6 +209,17 @@
       ],
       "name": "Record metadata decisions",
       "description": "Contextual list/detail, comparison, category/state, priority and timestamp decisions across different tasks."
+    },
+    {
+      "id": "reference:component-families",
+      "source": "references/component-families.md",
+      "groups": [
+        "composition",
+        "foundations",
+        "quality"
+      ],
+      "name": "Component family authoring",
+      "description": "Build reusable components that share Flood anatomy, sizing, geometry and state contracts; compare rendered siblings before introducing a new recipe."
     }
   ],
   "componentGroups": {
@@ -252,8 +264,13 @@
     {
       "id": "component-motion-tokens",
       "status": "available",
-      "description": "Existing short-transition and reduced-motion tokens; not a route-transition implementation.",
+      "description": "Semantic timing, easing, travel and reduced-motion roles for component states.",
       "materials": [
+        "workflow:motion",
+        "token:sys.motion.duration-press",
+        "token:sys.motion.duration-enter",
+        "token:sys.motion.duration-layer",
+        "token:sys.motion.duration-exit",
         "token:sys.motion.duration-fast",
         "token:sys.motion.duration-normal",
         "token:sys.motion.duration-reduced",
@@ -271,9 +288,48 @@
       "status": "not-provided",
       "description": "The new foundations profile provides dark only; legacy light controls do not add another foundation theme.",
       "materials": []
+    },
+    {
+      "id": "manual-search-collections",
+      "status": "available",
+      "description": "Host-owned query/results identity, pending/error/retry and retained selection; no network client.",
+      "materials": [
+        "component:combobox",
+        "component:multi-select",
+        "component:autocomplete"
+      ]
+    },
+    {
+      "id": "server-table-pages",
+      "status": "available",
+      "description": "Explicit controlled page/sort and selection scope for supplied server pages; host owns fetching and authorization.",
+      "materials": [
+        "component:data-table",
+        "recipe:record-workspace"
+      ]
+    },
+    {
+      "id": "collection-view-recipe",
+      "status": "available",
+      "description": "Typed host recipe for local query drafts and persisted enum-filter/sort views, shared by a table and file list; no new runtime export or remote query service.",
+      "materials": [
+        "recipe:collection-views"
+      ]
+    },
+    {
+      "id": "navigation-workspace-recipe",
+      "status": "available",
+      "description": "Host composition of Sidebar profiles for global modules and contextual pages, independent visibility and scoped focus/query state; no additional GlobalRail runtime export.",
+      "materials": [
+        "component:sidebar",
+        "recipe:navigation-workspace",
+        "workflow:navigation"
+      ]
     }
   ],
   "documentGroups": {
+    "recipes/record-management.md": ["data-feedback", "composition"],
+    "recipes/settings-workspace.md": ["interaction", "composition"],
     "README.md": [
       "composition"
     ],
@@ -286,6 +342,7 @@
     "foundations.md": [
       "foundations"
     ],
+    "motion.md": ["foundations", "motion"],
     "layout.md": [
       "composition"
     ],
@@ -343,6 +400,22 @@
     "recipes/grouped-form.md": [
       "composition",
       "interaction"
+    ],
+    "recipes/record-workspace.md": [
+      "composition",
+      "data-feedback",
+      "quality"
+    ],
+    "recipes/collection-views.md": [
+      "composition",
+      "data-feedback",
+      "interaction",
+      "quality"
+    ],
+    "recipes/navigation-workspace.md": [
+      "composition",
+      "interaction",
+      "quality"
     ]
   },
   "prerequisites": {
@@ -404,6 +477,46 @@
       "workflow:composition",
       "workflow:interface-content",
       "workflow:hierarchy"
+    ],
+    "recipe:record-management": [
+      "workflow:records",
+      "workflow:overlays",
+      "workflow:forms"
+    ],
+    "recipe:settings-workspace": [
+      "workflow:composition",
+      "workflow:forms",
+      "workflow:feedback"
+    ],
+    "recipe:record-workspace": [
+      "workflow:composition",
+      "workflow:hierarchy",
+      "workflow:forms",
+      "workflow:navigation",
+      "workflow:feedback",
+      "workflow:data-display",
+      "workflow:interface-content"
+    ],
+    "reference:component-families": [
+      "workflow:composition",
+      "workflow:foundations",
+      "workflow:spacing"
+    ],
+    "recipe:collection-views": [
+      "workflow:composition",
+      "workflow:forms",
+      "workflow:overlays",
+      "workflow:data-display",
+      "workflow:records",
+      "workflow:feedback",
+      "workflow:interface-content"
+    ],
+    "recipe:navigation-workspace": [
+      "workflow:composition",
+      "workflow:navigation",
+      "workflow:spacing",
+      "workflow:accessibility",
+      "workflow:interface-content"
     ]
   }
 }

package/lib/inspect.mjs

@@ -51,6 +51,17 @@ export function inspectRenderedUI(options = {}) {
     return matches.slice(0, limit);
   };
   if(root===document&&document.documentElement.scrollWidth>innerWidth+1)addIssue({id:'layout.page-overflow',target:{tag:'html',id:document.documentElement.id||null,className:document.documentElement.getAttribute('class')||'',label:'Document'},offset:document.documentElement.scrollWidth-innerWidth,message:'The document extends beyond the viewport. Review the actual overflow owner at this text size; dense content can scroll locally. Hiding page overflow does not repair the layout.'});
+  const documentGutter = innerWidth - document.documentElement.clientWidth;
+  const scrollOwner = document.scrollingElement;
+  if (documentGutter > 1 && scrollOwner && scrollOwner.scrollHeight > scrollOwner.clientHeight + 1) {
+    const table = select('.flood-data-table').find(visible);
+    if (table) addIssue({
+      id: 'layout.record-scroll-owner',
+      target: target(table),
+      offset: documentGutter,
+      message: 'A document scrollbar consumes width on this record view. Compare full and filtered views with classic scrollbars. For a full-window workspace, use AppShell content scrolling so changes in row count keep the table edges in place.',
+    });
+  }
   for (const button of select('button.flood-button, button.flood-icon-button')) {
     // Text is inspected outside real icon slots, SVGs and visually hidden names.
     const walker = document.createTreeWalker(button, NodeFilter.SHOW_TEXT);

package/manifest.json

@@ -72,6 +72,11 @@
       "target": ".agents/skills/flood-ui/references/flood-spacing/SKILL.md",
       "kind": "skill"
     },
+    {
+      "source": "references/flood-motion/SKILL.md",
+      "target": ".agents/skills/flood-ui/references/flood-motion/SKILL.md",
+      "kind": "skill"
+    },
     {
       "source": "references/flood-foundations/SKILL.md",
       "target": ".agents/skills/flood-ui/references/flood-foundations/SKILL.md",
@@ -146,9 +151,14 @@
       "source": "references/record-decisions.md",
       "target": ".agents/skills/flood-ui/references/record-decisions.md",
       "kind": "reference"
+    },
+    {
+      "source": "references/component-families.md",
+      "target": ".agents/skills/flood-ui/references/component-families.md",
+      "kind": "reference"
     }
   ],
-  "version": "0.2.10",
+  "version": "0.2.12",
   "installedEntry": ".agents/skills/flood-ui/SKILL.md",
   "pathBase": "source is package-relative; target is relative to the host project root"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flood-md/agent",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "type": "module",
   "description": "Versioned Flood design instructions for coding agents.",
   "license": "MIT",
@@ -22,8 +22,14 @@
     "README.md"
   ],
   "exports": {
-    "./inspect": {"types":"./lib/inspect.d.ts","import":"./lib/inspect.mjs"},
-    ".": {"types":"./lib/index.d.ts","import":"./lib/index.mjs"},
+    "./inspect": {
+      "types": "./lib/inspect.d.ts",
+      "import": "./lib/inspect.mjs"
+    },
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs"
+    },
     "./dist/*": "./dist/*",
     "./DESIGN.md": "./DESIGN.md",
     "./SKILL.md": "./SKILL.md",