@ohtaman/washi 0.1.0 → 0.1.1

package/README.ja.md

@@ -14,7 +14,8 @@
     <a href="./README.zh-CN.md">简体中文</a>
   </p>
   <p>
-    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/demo-online-brightgreen" alt="live demo" /></a>
+    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/docs-online-blue" alt="docs" /></a>
+    <a href="https://ohtaman.github.io/washi/demo/"><img src="https://img.shields.io/badge/demo-playground-brightgreen" alt="live demo" /></a>
     <a href="https://www.npmjs.com/package/@ohtaman/washi"><img src="https://img.shields.io/npm/v/@ohtaman/washi?color=crimson&label=npm" alt="npm version" /></a>
     <a href="https://bundlephobia.com/package/@ohtaman/washi"><img src="https://img.shields.io/badge/bundle%20size-7.2%20kB%20(gzip)-blue" alt="bundle size" /></a>
     <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license" /></a>
@@ -297,6 +298,44 @@ console.log(`x = ${value(x)}, y = ${value(y)}`);
 
 ---
 
+## 🌐 ブラウザ & Web Worker での利用方法
+
+WaSHI は、モダンなブラウザ、フロントエンドフレームワーク（Vite, Next.js, React, Vue, Svelte）、および Web Worker 上でゼロコンフィグで動作するように設計されています。
+
+### 1. ゼロコンフィグ動作（公式 CDN 自動フォールバック）
+ブラウザ環境において、オリジンルートに `highs.wasm` が配置されていない場合、WaSHI は自動的に公式 jsDelivr CDN から安全にバイナリを取得します。追加の設定コードやファイルコピーは一切不要です：
+
+```typescript
+import { Model } from "@ohtaman/washi";
+
+const model = new Model();
+// ... 変数・制約の定義
+await model.solve(); // 設定なしで即座に動作！
+```
+
+### 2. モダンバンドラーでの自前アセット管理（Vite / Webpack / Rollup）
+`highs.wasm` を自分のアプリケーションの静的アセット（ハッシュ付き配信）として自前ホストしたい場合：
+
+```typescript
+import wasmUrl from "@ohtaman/washi/highs.wasm?url";
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// アプリ起動時に一度だけ設定
+setHighsWasmUrl(wasmUrl);
+```
+
+### 3. 社内イントラ・完全オフライン（Air-gapped）環境での利用
+外部 CDN への通信が禁止されている社内イントラやオフライン環境の場合：
+
+```typescript
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// 自前の静的ファイル配信パスを指定（外部 CDN へのフォールバックは完全無効化されます）
+setHighsWasmUrl("/static/highs.wasm");
+```
+
+---
+
 ## 💻 サンプルスクリプト & インタラクティブ Web デモ
 
 `examples/node/` 配下に実行可能なスタンドアロンスクリプトを用意しています：
@@ -314,7 +353,8 @@ npx tsx examples/node/06-pulp-compatibility.ts
 
 ```bash
 npm run dev
-# ブラウザで http://localhost:5173/ を開きます
+# ドキュメント: http://localhost:5173/
+# インタラクティブデモ: http://localhost:5173/demo/
 ```
 
 ---

package/README.md

@@ -14,7 +14,8 @@
     <a href="./README.zh-CN.md">简体中文</a>
   </p>
   <p>
-    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/demo-online-brightgreen" alt="live demo" /></a>
+    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/docs-online-blue" alt="docs" /></a>
+    <a href="https://ohtaman.github.io/washi/demo/"><img src="https://img.shields.io/badge/demo-playground-brightgreen" alt="live demo" /></a>
     <a href="https://www.npmjs.com/package/@ohtaman/washi"><img src="https://img.shields.io/npm/v/@ohtaman/washi?color=crimson&label=npm" alt="npm version" /></a>
     <a href="https://bundlephobia.com/package/@ohtaman/washi"><img src="https://img.shields.io/badge/bundle%20size-7.2%20kB%20(gzip)-blue" alt="bundle size" /></a>
     <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license" /></a>
@@ -297,6 +298,44 @@ console.log(`x = ${value(x)}, y = ${value(y)}`);
 
 ---
 
+## 🌐 Browser & Web Worker Usage
+
+WaSHI is engineered for seamless execution in modern browsers, frontend frameworks (Vite, Next.js, React, Vue, Svelte), and Web Workers.
+
+### 1. Zero-Config Mode (Automatic CDN Fallback)
+In browser environments, if `highs.wasm` is not found on your local origin, WaSHI automatically falls back to the official jsDelivr CDN. You can optimize without copying files or writing boilerplate:
+
+```typescript
+import { Model } from "@ohtaman/washi";
+
+const model = new Model();
+// ... define variables & constraints
+await model.solve(); // Works instantly with zero setup!
+```
+
+### 2. Bundler-Native Asset Hosting (Vite / Webpack / Rollup)
+To bundle and self-host `highs.wasm` as a versioned, hashed static asset with your application:
+
+```typescript
+import wasmUrl from "@ohtaman/washi/highs.wasm?url";
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// Configure once at app startup
+setHighsWasmUrl(wasmUrl);
+```
+
+### 3. Air-Gapped & Enterprise Offline Environments
+In strict enterprise intranet or air-gapped environments where external CDN network access is disallowed:
+
+```typescript
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// Point strictly to your internal assets (completely disables CDN fallback)
+setHighsWasmUrl("/static/highs.wasm");
+```
+
+---
+
 ## 💻 CLI & Interactive Demos
 
 Ready-to-run standalone examples are available in `examples/node/`:
@@ -314,7 +353,8 @@ To run the interactive browser showcase (`examples/web-demo`):
 
 ```bash
 npm run dev
-# Open http://localhost:5173/ in your browser
+# Documentation: http://localhost:5173/
+# Interactive Demo: http://localhost:5173/demo/
 ```
 
 ---

package/README.zh-CN.md

@@ -14,7 +14,8 @@
     <a href="./README.zh-CN.md">简体中文</a>
   </p>
   <p>
-    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/demo-online-brightgreen" alt="live demo" /></a>
+    <a href="https://ohtaman.github.io/washi/"><img src="https://img.shields.io/badge/docs-online-blue" alt="docs" /></a>
+    <a href="https://ohtaman.github.io/washi/demo/"><img src="https://img.shields.io/badge/demo-playground-brightgreen" alt="live demo" /></a>
     <a href="https://www.npmjs.com/package/@ohtaman/washi"><img src="https://img.shields.io/npm/v/@ohtaman/washi?color=crimson&label=npm" alt="npm version" /></a>
     <a href="https://bundlephobia.com/package/@ohtaman/washi"><img src="https://img.shields.io/badge/bundle%20size-7.2%20kB%20(gzip)-blue" alt="bundle size" /></a>
     <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license" /></a>
@@ -297,6 +298,44 @@ console.log(`x = ${value(x)}, y = ${value(y)}`);
 
 ---
 
+## 🌐 浏览器与 Web Worker 使用指南
+
+WaSHI 原生支持在现代网页浏览器、前端主流框架（Vite、Next.js、React、Vue、Svelte）以及 Web Worker 中运行。
+
+### 1. 零配置模式（官方 CDN 智能回退）
+在浏览器环境下，若当前域名根路径未部署 `highs.wasm`，WaSHI 会自动从官方 jsDelivr 高速 CDN 安全拉取二进制文件。您无需任何额外配置或文件复制：
+
+```typescript
+import { Model } from "@ohtaman/washi";
+
+const model = new Model();
+// ... 定义变量与约束
+await model.solve(); // 零配置即可直接运行！
+```
+
+### 2. 现代打包工具自托管（Vite / Webpack / Rollup）
+如果您希望将 `highs.wasm` 作为项目打包产物的一部分进行自托管与版本哈希管理：
+
+```typescript
+import wasmUrl from "@ohtaman/washi/highs.wasm?url";
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// 在应用入口处配置一次
+setHighsWasmUrl(wasmUrl);
+```
+
+### 3. 企业内网与完全离线（Air-gapped）环境
+针对严禁外部 CDN 请求的企业内网或纯离线环境：
+
+```typescript
+import { setHighsWasmUrl } from "@ohtaman/washi";
+
+// 指定内部静态资源路径（将完全禁用外部 CDN 回退）
+setHighsWasmUrl("/static/highs.wasm");
+```
+
+---
+
 ## 💻 本地脚本与交互式 Web 演示
 
 在 `examples/node/` 中提供了即开即用的独立脚本：
@@ -314,7 +353,8 @@ npx tsx examples/node/06-pulp-compatibility.ts
 
 ```bash
 npm run dev
-# 在浏览器中访问 http://localhost:5173/
+# 文档主页: http://localhost:5173/
+# 交互式 Demo: http://localhost:5173/demo/
 ```
 
 ---