@flood-md/agent 0.0.0-stage → 0.1.1

package/DESIGN.md

@@ -0,0 +1,57 @@
+# Flood design system · 0.1.1
+
+React + TypeScript. Next.js App Router is supported. Flood owns its components,
+tokens, CSS and installer. Do not introduce another UI library or copy external components.
+
+## Connect
+
+Import `@flood-md/react/styles.css` once in the application entry or Next root layout.
+Use `Button, Input, Textarea, Checkbox, Radio, Switch, Field, Link` from `@flood-md/react`.
+Add `"use client"` to Next components that pass callbacks or use state. Flood's React
+entry already has a client boundary. Keep server data fetching in server components.
+
+## Compose
+
+- Read installed `flood.json`; use docs matching its version. Run `flood doctor` if uncertain.
+- Use semantic `--flood-*` tokens. Primitive values are authored in the tokens package.
+- Parent layout owns gaps: 4/8 for controls, 12/16 within groups, 24 between groups,
+  32/48 between sections. Avoid redundant cards and containers.
+- One clear primary action per task. Use solid, outline and ghost button variants.
+- Use a real link for navigation, a button for actions. Button defaults to type=button;
+  set type=submit deliberately in forms.
+- Labels are visible. Use Field's render callback to pass id, aria-describedby and
+  aria-invalid to Input/Textarea. Checkbox, Radio and Switch require their label prop.
+- Field takes a function child, so compose it inside a client component in Next.
+- Radio groups share a name and have a fieldset/legend. Native inputs keep form semantics.
+- Use `data-flood-theme="dark"` or `"light"` on the root; default follows system theme.
+- Preserve focus, long content, native form submission and disabled behavior.
+- Loading buttons keep meaningful text; loading disables the action and sets aria-busy.
+- Never use color alone for state. Include an error message and a recovery action.
+- Theme-specific customization uses semantic CSS variable overrides after the Flood import.
+
+## Verify
+
+Check keyboard use, labels, focus, empty/loading/error/disabled states, narrow screens,
+light/dark themes and reduced motion. Do not fabricate a working command or release.
+Never overwrite existing project instructions. Keep application data and side effects
+in the host project; Flood provides UI only.
+
+## Example (client component)
+
+```tsx
+"use client";
+import { Button, Field, Input } from "@flood-md/react";
+
+export function Profile() {
+  return (
+    <form onSubmit={(event) => event.preventDefault()}>
+      <Field label="Name" hint="Shown on your profile">
+        {(props) => (
+          <Input {...props} name="name" autoComplete="name" required />
+        )}
+      </Field>
+      <Button type="submit">Save changes</Button>
+    </form>
+  );
+}
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleg (tillwithered)
+
+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/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @flood-md/agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Version-matched DESIGN.md and SKILL.md for Flood React/Next.js projects. The CLI
+copies these into owned project files. Read the installed guide before composing
+screens. These files grant no authority to publish or modify external services.

package/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: flood-ui
+description: Build React and Next.js interfaces with the installed Flood design system. Use for Flood components, themes, forms and layout composition.
+---
+
+Read `flood.json` and `flood/DESIGN.md` from the project root first. Run
+`npx @flood-md/cli doctor` to check versions. Import only published APIs from
+`@flood-md/react`; use its styles once in the application entry. Follow the installed
+design guide for composition, accessible forms and Next.js client boundaries.
+Do not replace project instructions or introduce another UI library.

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "@flood-md/agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Versioned Flood design instructions for coding agents.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tillwithered/flood.md.git",
+    "directory": "packages/agent"
+  },
+  "files": [
+    "DESIGN.md",
+    "SKILL.md",
+    "README.md"
+  ],
+  "exports": {
+    "./DESIGN.md": "./DESIGN.md",
+    "./SKILL.md": "./SKILL.md"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}