@qirtaas/react 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alrimaal
+
+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,49 @@
+# @qirtaas/react
+
+Idiomatic React components wrapping the [`@qirtaas/core`](https://www.npmjs.com/package/@qirtaas/core)
+embeddable rich-text editor. Vue is bundled in (a React host supplies none);
+only `react` and `react-dom` are peer dependencies.
+
+## Install
+
+```sh
+npm install @qirtaas/react
+```
+
+Requires React 18+.
+
+## Usage
+
+```tsx
+import { useRef } from "react";
+import { QirtaasEditor, type QirtaasEditorHandle } from "@qirtaas/react";
+import "@qirtaas/react/qirtaas.css";
+
+export default function App() {
+  const editorRef = useRef<QirtaasEditorHandle>(null);
+
+  return (
+    <QirtaasEditor
+      ref={editorRef}
+      apiUrl="https://api.example.com"
+      getToken={() => fetchEmbedJwt()} // required: called on init, before expiry, on 401
+      documentId="<uuid>"
+      locale="en"
+      theme="light"
+      onReady={() => console.log("ready")}
+      onChange={(json) => console.log(json)}
+      onSaveStateChange={(state) => console.log(state)}
+    />
+  );
+}
+```
+
+A read-only `QirtaasRenderer` is also exported, along with `createQirtaasClient`
+for imperative, mount-less operations (e.g. `deleteDocument` from a list view).
+
+The editor is a self-contained island — the host needs no Vue. The wrapper is
+StrictMode-safe (each cleanup fully destroys the editor).
+
+## License
+
+MIT