orynn 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rajveer
+
+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

@@ -0,0 +1,71 @@
+# orynn
+
+> A small, strongly-typed, JSON-driven form library for React.
+
+`orynn` gives you a `<Fieldset>` that renders a form from a config object, plus `<Input>` and
+`<Dropdown>` controls you can use entirely on their own. V1 is intentionally small — a clean
+foundation designed so validation, theming, and new field types can grow later without breaking
+the public API.
+
+- **JSON-driven** — describe fields in a strongly-typed config, get an accessible responsive form.
+- **Standalone controls** — `<Input>` and `<Dropdown>` work without `<Fieldset>`.
+- **Extensible by design** — field registry, pluggable validation resolver, CSS-variable tokens.
+- **Zero runtime dependencies** — `react` is the only peer. ESM + CJS. Tree-shakeable.
+
+> Status: `0.x`. The core API (`Fieldset`, `Input`, `Dropdown`, `useFieldsetState`) is stable in
+> intent; APIs marked `@experimental` (the field registry, `registerRule`) may change before `1.0`.
+
+## Install
+
+```bash
+npm install orynn
+```
+
+```tsx
+import { Fieldset } from "orynn";
+import "orynn/styles.css";
+```
+
+## Quick start
+
+```tsx
+import { Fieldset, type FieldsetConfig } from "orynn";
+import "orynn/styles.css";
+
+const config: FieldsetConfig = {
+  legend: "Personal details",
+  fields: [
+    { name: "firstName", type: "input", label: "First name", validation: { required: true, minLength: 2 } },
+    { name: "country", type: "dropdown", label: "Country", validation: { required: true },
+      options: [{ label: "India", value: "IN" }, { label: "Indonesia", value: "ID" }] },
+  ],
+};
+
+export function Form() {
+  return <Fieldset config={config} onChange={(values) => console.log(values)} />;
+}
+```
+
+Standalone:
+
+```tsx
+import { Input, Dropdown } from "orynn";
+
+<Input label="Name" value={name} onChange={setName} required />
+<Dropdown label="Country" value={country} onChange={setCountry} options={options} />
+```
+
+## Docs
+
+- [Getting started](docs/getting-started.md)
+- [`Fieldset`](docs/fieldset.md) · [`Input`](docs/input.md) · [`Dropdown`](docs/dropdown.md)
+- [JSON configuration](docs/json-config.md)
+- [Validation](docs/validation.md)
+- [Layout](docs/layout.md)
+- [Extensibility](docs/extensibility.md)
+- [Accessibility](docs/accessibility.md)
+- [Architecture](ARCHITECTURE.md) · [Roadmap / postponed](FUTURE.md)
+
+## License
+
+MIT