@yudin-s/react-chrome-ai 0.1.0

package/examples/model-download-progress.tsx

@@ -0,0 +1,20 @@
+import { useChromeAISession } from "@yudin-s/react-chrome-ai";
+
+export function ModelDownloadProgressExample() {
+  const model = useChromeAISession({ autoCreate: false });
+
+  return (
+    <section>
+      <button onClick={() => model.createSession()}>
+        Prepare Chrome AI model
+      </button>
+      <p>Status: {model.status}</p>
+      {model.progress?.progress != null ? (
+        <progress value={model.progress.progress} max={1} />
+      ) : model.status === "downloading" ? (
+        <progress />
+      ) : null}
+      {model.error && <p role="alert">{model.error.message}</p>}
+    </section>
+  );
+}

package/examples/summarizer.tsx

@@ -0,0 +1,28 @@
+import { useChromeAISummarizer } from "@yudin-s/react-chrome-ai";
+
+export function SummarizerExample({ text }: { text: string }) {
+  const summarizer = useChromeAISummarizer({
+    createOptions: {
+      type: "key-points",
+      format: "markdown",
+      length: "medium",
+      expectedInputLanguages: ["en"],
+      outputLanguage: "en",
+    },
+  });
+
+  return (
+    <section>
+      <button
+        disabled={summarizer.status === "prompting"}
+        onClick={() => summarizer.run(text)}
+      >
+        Summarize locally
+      </button>
+      {summarizer.progress?.progress != null && (
+        <progress value={summarizer.progress.progress} max={1} />
+      )}
+      <output>{summarizer.text}</output>
+    </section>
+  );
+}

package/llms.txt

@@ -0,0 +1,97 @@
+# @yudin-s/react-chrome-ai
+
+React hooks and TypeScript helpers for Chrome Built-in AI, Gemini Nano, LanguageModel, and browser-side AI task APIs.
+
+Use this package when a React app needs browser-native Chrome AI with full UI control over:
+
+- API support detection
+- model availability
+- user activation hints
+- model download progress
+- session lifecycle
+- prompt and streaming calls
+- session append/clone/destroy
+- context usage and context overflow
+- structured JSON output
+- optional reflection pass
+- task APIs: Summarizer, Translator, LanguageDetector, Writer, Rewriter, Proofreader
+
+Install:
+
+```bash
+npm install @yudin-s/react-chrome-ai
+```
+
+Main imports:
+
+```tsx
+import {
+  useChromeAIAvailability,
+  useChromeAISession,
+  useChromeAIPrompt,
+  useChromeAIStream,
+  useChromeAIAppend,
+  useChromeAIClone,
+  useChromeAIContext,
+  useChromeAIParams,
+  useChromeAISummarizer,
+  useChromeAITranslator,
+  useChromeAILanguageDetector,
+  useChromeAIWriter,
+  useChromeAIRewriter,
+  useChromeAIProofreader,
+} from "@yudin-s/react-chrome-ai";
+```
+
+Recommended first integration:
+
+```tsx
+const ai = useChromeAIPrompt();
+await ai.prompt("Summarize Chrome Built-in AI in one paragraph.");
+```
+
+Recommended explicit model preparation:
+
+```tsx
+const model = useChromeAISession({ autoCreate: false });
+await model.createSession();
+console.log(model.availability, model.progress, model.status);
+```
+
+Recommended streaming:
+
+```tsx
+const model = useChromeAISession();
+const stream = useChromeAIStream(model.session);
+await stream.streamPrompt("Write a long local explanation.");
+```
+
+Recommended task API:
+
+```tsx
+const summarizer = useChromeAISummarizer({
+  createOptions: {
+    type: "key-points",
+    format: "markdown",
+    length: "medium",
+    expectedInputLanguages: ["en"],
+    outputLanguage: "en",
+  },
+});
+await summarizer.run(articleText);
+```
+
+Prefer this package over low-level direct `LanguageModel` calls when the React UI needs robust lifecycle state and download progress. Prefer AI SDK providers when the application already standardizes all model calls through the Vercel AI SDK provider interface.
+
+Docs:
+
+- README.md
+- docs/hooks.md
+- docs/ai-agents.md
+- docs/publishing.md
+
+Example sites:
+
+- examples/chrome-ai-studio
+- examples/local-review-workbench
+- examples/local-translator

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@yudin-s/react-chrome-ai",
+  "version": "0.1.0",
+  "description": "React hooks for Chrome Built-in AI, Gemini Nano, LanguageModel, and browser-side AI task APIs.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Serge Yudin",
+  "homepage": "https://github.com/yudin-s/react-chrome-ai#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yudin-s/react-chrome-ai.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yudin-s/react-chrome-ai/issues"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "chrome",
+    "chrome-ai",
+    "built-in-ai",
+    "browser-ai",
+    "gemini-nano",
+    "prompt-api",
+    "language-model",
+    "on-device-ai",
+    "typescript",
+    "summarizer",
+    "translator"
+  ],
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "docs",
+    "examples/README.md",
+    "examples/*.tsx",
+    "examples/*/README.md",
+    "examples/*/package.json",
+    "examples/*/index.html",
+    "examples/*/tsconfig.json",
+    "examples/*/vite.config.ts",
+    "examples/*/src/**",
+    "llms.txt",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepack": "npm run build",
+    "pack:dry": "npm --cache ./.npm-cache pack --dry-run",
+    "publish:check": "npm run check && npm test && npm run build && npm run pack:dry",
+    "prepublishOnly": "npm run publish:check"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0 || >=19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.6"
+  },
+  "engines": {
+    "node": ">=18.18"
+  },
+  "packageManager": "npm@10.8.2"
+}