Show HN: WebBase-III – dBASE IIIをブラウザで再構築、独自のインタプリタ付き
Show HN: WebBase-III – dBASE III rebuilt in the browser with its own interpreter (github.com)
要約
WebBase-IIIは、1980年代のデータベースシステムdBASE IIIをブラウザ上で再現する現代的なウェブアプリケーションです。 TypeScriptで書かれた独自のインタプリタを搭載し、Node.js、WebSockets、SQLiteをバックエンドに利用しています。 コマンドラインインターフェース、データ表示、インデックス作成、BROWSEグリッド編集、プログラムエディタ、フォームエンジンなど、dBASE IIIの主要な機能をウェブ上で提供します。
全文翻訳
WebBase-III
dBASE IIIが復活。あなたのブラウザで。1984年のように USE customers と入力してください。
[画像: WebBase-III デモ — USE, LIST, SEEK, BROWSE, および LOOKUP 列のドロップダウン]
ドットプロンプトを覚えていますか?SQLが勝利する前、ORMが登場する前、誰も「フルスタック」という言葉を口にする前 — dBASE IIIがありました。あなたは USE customers と入力し、次に LIST と入力すると、データがそこにあったのです。WebBase-IIIは、その世界全体を復活させます:ターミナル、言語、BROWSE、@ SAY GET フォーム、.prg プログラム、インデックス、レポート — これらすべてを、TypeScriptによる独自のインタプリタを備えたモダンなWebアプリケーションとしてゼロから再構築しました。バックエンドはNode.js、WebSockets、SQLiteです。
ワンクリックで試せます — インストール不要:
Codespaceは依存関係をインストールし、開発サーバーを自動的に起動します。転送されたポート 5173 を開くと、ドットプロンプトが表示されます。
スクリーンショット
ターミナル REPL
コマンドインターフェース — W3Script を入力し、結果を即座に確認できます。
LIST — 表形式のレコード表示
LIST はアクティブなインデックス順にすべてのレコードを表示します。ステータスバーにはアクティブなデータベースとテーブルが表示されます。
インデックスと SEEK
INDEX ON name TO BYNAME はSQLiteインデックスを作成し、それをアクティブにします — その後の LIST 出力はアルファベット順にソートされます。SEEK "Delta NV" は O(log n) で最初のマッチにレコードポインタをジャンプさせます。
BROWSE — 編集可能なグリッド
BROWSE はスプレッドシートスタイルのグリッドを開きます。レコードはアクティブなインデックス順に表示されます。Tab/Enter でセルを編集、Ctrl+N で新しい行、Delete で行を削除、Esc でターミナルに戻ります。
プログラムエディタ
EDIT <name> は組み込みの .prg ソースエディタを開きます。プログラムは完全なW3Script言語をサポートします: DO CASE/ENDCASE、DO WHILE/ENDDO、IF/ENDIF、フォームレイアウト、およびすべてのデータコマンド。Ctrl+S で保存、Esc でキャンセルします。
フォームエンジン — @ SAY GET / READ
@ row,col SAY "label" GET variable は文字セルフォームフィールドを配置します。READ はそれらをライブフォームとしてレンダリングし、ユーザーが値を入力して送信するのを待ちます。
アシスタント — サイドバー
カテゴリピッカーとアクションボタンを備えた、常に表示される左側のサイドバーです。
アシスタント — 新規テーブルウィザード
ウィザードはメインエリアに開き、ライブW3Scriptプレビューを表示します。
アシスタント — 構造変更ウィザード
MODIFY STRUCTURE(またはサイドバーのアクション)は、現在のスキーマが事前入力された列エディタを開きます — 列の名前変更、型の変更、追加、削除を行い、ワンクリックで適用します。
BROWSE — セルごとの検証
グリッドでの編集は、コミットされる前に列の宣言された型に対してチェックされます。無効な値はセルを編集モードのままにし、赤で囲み、理由を表示します。エラーは修正するとすぐにクリアされ、Esc で編集を中止します。ここでは TIME(15) 列が 08:07 を拒否しています。
[画像: BROWSE が無効な TIME(15) セル編集を拒否]
LOOKUP 列 — 入力ではなく値を選択
LOOKUP <table>.<column> DISPLAY <column> と宣言された列は、BROWSE とフォームの両方でドロップダウンを通じて編集できます — より分かりやすいラベルを表示し、コードを保存します。ここでは SCHEDID が SCHEDULES.SCHEDID に制約され、DESCR を表示します。
[画像: BROWSE で LOOKUP 列をドロップダウン経由で編集]
フィールドにバインドされた @ SAY GET(名前がテーブル列と一致するもの)も同じピッカーをレンダリングします:
[画像: LOOKUP 列にバインドされたフォームフィールド]
集計コマンドと dBASE III の互換性
SUM、AVERAGE、? ROUND(…), ? MAX(…), SORT ON … TO — 数値集計とソートされたコピーで、アクティブなフィルターを尊重します。
[画像: 互換性コマンド — SUM AVERAGE ROUND MAX SORT]
CSV のインポート/エクスポート
COPY TO <file>.csv は現在のテーブルをエクスポートします(ブラウザダウンロード)。APPEND FROM <file>.csv はファイルピッカー経由でインポートします。
機能
| 機能 | 詳細 |
|---|---|
| W3Script インタプリタ | dBASE III コマンド方言: ナビゲーション、フィルター、変数、ループ、条件分岐、フォーム、プログラム |
| BROWSE グリッド | インラインセル編集、キーボードナビゲーション、インデックス順表示 |
| フォームエンジン | @ ROW,COL SAY … GET 文字セルレイアウトと READ |
| インデックス | INDEX ON、SEEK、FIND — アクティブなインデックスがすべてのレコード順を制御 |
| DO CASE | マルチブランチ条件分岐、OTHERWISE フォールバック |
| 組み込み関数 | EOF()、BOF()、FOUND()、RECNO()、SUBSTR()、STR()、AT()、CTOD()、DTOC() など |
| プログラムファイル | .prg スクリプトを DO / EDIT で保存、編集、実行 |
| アシスタント | 永続的な左サイドバー — データベースを開く/テーブル、ブラウズ、フィルター、CSVインポート/エクスポート、ソート、合計/平均、インデックス作成、検索、インデックス再作成、パック、レポート設計、プログラム実行 |
| マルチユーザー | 各 WebSocket 接続は独自の独立したインタプリタセッションを取得 |
| ライブ伝播 | あるセッションでレコードを編集すると、そのテーブルをブラウズしている他のすべてのセッションが自動的にリフレッシュされます — 再クエリ不要 |
| 永続ストレージ | better-sqlite3 (WALモード付き) — データベースはサーバー再起動後も存続 |
アシスタント
左側のサイドバーは、タイピングなしで全てを操作します:データベースやテーブルを開く・作成する、データをブラウズ・フィルターする、CSVをインポート・エクスポートする、新しいテーブルにソートする、数値フィールドの合計・平均を計算する、インデックスを作成する、検索する、インデックスを再作成する、データベースをパックする、レポートを設計・実行する、プログラムを実行する、テーブル構造を変更する。クリックするたびに実際のW3Scriptコマンドが生成され、ターミナルにエコーされます — それを見て言語を学びましょう。ウィザード(新規テーブル、フィルター、ソート、合計/平均、構造変更、レポートデザイナなど)はメインエリアに開き、実行されるコマンドのライブプレビューを表示します。新規テーブルと構造変更の両方で、オプションの列ごとの「ルックアップ」フィールドが提供されます — LOOKUP を生の構文を入力せずに使用できます。
クイックスタート
npm install
npm run dev # http://localhost:5173
本番環境:
npm run serve # ビルド後、http://localhost:3000 ですべてを提供
LAN / Tailscale: サーバーは 0.0.0.0 にバインドされるため、http://<tailscale-ip>:3000 がそのまま機能します。
サンプルセッション
USE DATABASE mydb
CREATE TABLE customers (name CHAR(40), phone CHAR(20), country CHAR(30))
USE customers
APPEND RECORD
REPLACE name WITH "Acme Corp", phone WITH "555-1234", country WITH "BE"
APPEND RECORD
REPLACE name WITH "Zeta Ltd", phone WITH "555-5678", country WITH "NL"
INDEX ON name TO BYNAME
LIST * sorted A→Z
SEEK "Zeta Ltd" * jump to record instantly
BROWSE * open editable grid
SET FILTER TO country == "BE"
LIST * filtered view
SET FILTER TO * clear filter
W3Script コマンドリファレンス
ワークエリア
WebBase-III は無制限のワークエリアをサポートします — 各エリアは独立してテーブル、レコードポインタ、フィルター、インデックスを保持します。キーフィールドでエリアをリンクするには SET RELATION TO を使用してリレーショナルデータアクセスを行います。エリアをまたぐフィールドアクセスは alias.field ドット表記を使用します。
注意: dBASE III は最大10個のワークエリア(DOSファイルハンドル制限)をサポートしていました。WebBase-III にはそのような制限はありません。dBASE III は
alias->fieldアロー構文を使用していましたが、WebBase-III はモダンなalias.fieldドット表記を使用します。
| コマンド | 説明 |
|---|---|
SELECT <alias> | ワークエリアを名前でアクティブ化(または作成) |
USE <table> [ALIAS <name>] | アクティブなエリアにテーブルを開きます。エイリアスの上書きはオプション |
SET RELATION TO <expr> INTO <alias> | アクティブなエリアを別のエリアにリンクします。すべてのナビゲーションで自動的にシークします |
SET RELATION TO | アクティブなエリアのリレーションをクリア |
LIST [col, alias.col, ...] | レコードをリストします。エリアをまたぐフィールドを含むオプションの列リスト |
LIST AREAS | 開いているすべてのワークエリア、ポインタ、インデックス、リレーションを表示 |
CLOSE | アクティブなエリアのテーブルを閉じます |
CLOSE ALL | すべてのワークエリアを閉じ、単一の空のエリア 1 にリセットします |
エリアをまたぐフィールドアクセス: 式が受け入れられる場所ならどこでも alias.field ドット表記を使用できます — SET FILTER TO、IF、REPLACE、LIST、INDEX ON。
データとナビゲーション
| コマンド | 説明 |
|---|---|
USE <table> | テーブルを選択します。保存されているアクティブなインデックスを復元します |
USE DATABASE <name> | 名前付きSQLiteデータベースを開きます |
LIST | アクティブなインデックス順にレコードを表示します(最大500件) |
LIST STRUCTURE | 列スキーマを表示します |
LIST TABLES | レコード数と共にすべてのテーブルを表示します |
LIST DATABASES | ディスク上のすべてのデータベースを表示します(エイリアス: LIST DBS) |
BROWSE | 編集可能なグリッドを開きます |
CLEAR | ターミナル出力をクリアします |
CREATE TABLE <n> (col TYPE, ...) | テーブルを作成します |
DROP TABLE <name> | テーブルを削除します |
APPEND RECORD | 空の行を挿入します |
DELETE / DELETE ALL | 現在のレコードまたはすべてのレコードを削除します |
PACK | SQLiteファイルをVACUUMします |
GO TOP / GO BOTTOM / GO <n> | レコードポインタを移動します |
SKIP <n> | ポインタを前後に移動します |
REPLACE <field> WITH <val>, ... | 現在の行のフィールドを更新します |
REPLACE ALL <field> WITH <val>, ... | すべての(フィルターされた)行を更新します |
SET FILTER TO <expr> | WHERE句を設定します。空にするとクリアされます |
SUM <field> [FOR <cond>] [TO <var>] | 現在のテーブルの数値フィールドを合計します(アクティブなフィルターを尊重)。TO <var> は結果を印刷する代わりに変数に格納します |
AVERAGE <field> [FOR <cond>] [TO <var>] | 現在のテーブルの数値フィールドの平均を計算します(アクティブなフィルターを尊重)。TO <var> は結果を印刷する代わりに変数に格納します |
COPY TO <file>.csv | 現在のテーブルをCSVダウンロードとしてエクスポートします(フィルターとインデックス順を尊重) |
APPEND FROM <file>.csv | CSVを現在のテーブルにインポートします(ブラウザファイルピッカー) |
MODIFY STRUCTURE | アクティブなテーブルの構造変更ウィザードを開きます |
ALTER TABLE <t> ADD <col> <type> | テーブルに列を追加します |
ALTER TABLE <t> DROP <col> | テーブルから列を削除します |
ALTER TABLE <t> RENAME <col> TO <new> | 列の名前を変更します |
ALTER TABLE <t> ALTER <col> <type> | 列の型を変更します(テーブルコピーダンス、データは保持されます) |
インデックスを無効にする可能性のある列操作(DROP、RENAME、ALTER type)は、テーブルのすべてのインデックスを削除し、
INDEX ONで再構築するように警告します。
CREATE TABLEは、不正な列リスト(カンマ抜け、型抜け、括弧閉じ忘れ、3番目の型引数)を、問題の列名を指定したパースエラーで拒否し、何も作成しません。
列の型: CHAR(n)(エイリアス CHARACTER/VARCHAR/STRING/MEMO)、NUM/NUM(p,s)(NUMERIC/FLOAT/DOUBLE/DECIMAL)、INT/INTEGER、LOGICAL/BOOLEAN、DATE、TIME/TIME(n)。TIME は HH:MM(24時間制)を格納します。オプションの TIME(n) 修飾子(例: TIME(15))は、分が n の倍数であることを要求します。REPLACE ... WITH は、不正な形式または粒度の TIME 値をサイレントに強制するのではなく拒否し、LIST STRUCTURE は宣言された型(NUM(8,2)、TIME(15))をSQLiteのストレージクラスではなく表示します。
LOOKUP 列 — 列を有効な値に制約する
任意の列に、型宣言の後に LOOKUP 句を追加して、保持できる値を宣言できます。
CREATE TABLE EMPLOYEES (EMPID CHAR(4), NAME CHAR(30),
SCHEDID CHAR(4) LOOKUP SCHEDULES.SCHEDID DISPLAY DESCR)
CREATE TABLE DEALS (STAGE CHAR(12) LOOKUP ("Lead","Qualified","Proposal","Won","Lost"))
2つの形式があります: LOOKUP <table>.<column> [DISPLAY <column>] は別のテーブルからライブ値を検索します(オプションでより分かりやすいラベルを表示し、コードを保存します)、または LOOKUP ("a","b",...) は固定リストです。CREATE TABLE/ALTER TABLE ADD/ALTER TABLE ALTER はすべてこれを受け入れます。
BROWSE はルックアップ列をドロップダウンとしてレンダリングします — 編集中は DISPLAY ラベル、コミット後は保存されたコードが表示され、LIST/レポート出力と一致します。REPLACE と BROWSE 編集の両方で、リスト外の値は拒否され、書き込みごとにライブデータベースに対して新しくチェックされます(合法になったばかりの値、または合法でなくなったばかりの値は正しく評価されます — キャッシュされた古いリストは決してありません)。解決できないルックアップ(ソーステーブルが削除された、空、または1000を超える一意の値がある)は、列をロックする代わりに警告付きの自由入力に低下します。
dBASE III からの逸脱:
LOOKUPには dBASE III の祖先はありません — dBASE III+ はPICTURE "@M a,b,c"というリテラル値リストのみを提供し、スペースバーで循環し、テーブル駆動型フォームや表示ラベルはありませんでした。これはWebBase-IIIの拡張であり、無制限のワークエリアやalias.fieldドット表記と同じ精神です。フィールドにバインドされたGETは、本物のdBASE IIIの動作です — WebBase-III独自のメモリ変数のみのフォームは逸脱でしたが、現在は修正されています。CSV形式 (
COPY TO/APPEND FROM): dBASE III のヘッダーなし、位置指定のDELIMITED/SDF形式とは異なり、WebBase-III はモダンなヘッダーベースのCSV(RFC-4180、列名でマッピング)を使用します。エクスポートはブラウザ経由でダウンロードされ、アクティブなフィルターとインデックス順を尊重します。インポートはファイルピッカーを開き、寛容です:最大10行の不正な行はスキップされ報告されます(行番号と理由)。10行を超える場合は中止され、何も追加されません。制限: インポート5MB、エクスポート50,000行。
インデックスと検索
| コマンド | 説明 |
|---|---|
INDEX ON <expr> TO <tag> | 式に基づいてインデックスを作成します。すぐにアクティブになります |
SET INDEX TO <tag> | 事前に作成されたインデックスをアクティブにします |
SET INDEX TO | アクティブなインデックスをクリアします — 自然な挿入順を復元します |
REINDEX | 現在のテーブルのSQLiteインデックスを再構築します |
LIST INDEXES | 現在のテーブルのすべてのインデックスを * アクティブマーカー付きで表示します |
SEEK <expr> | 最初のインデックスマッチにレコードポインタを配置します |
FIND <string> | SEEK のエイリアス(引用符なしの文字列 — dBASE III レガシー形式) |
SORT ON <field>[/D] TO <newtable> | テーブルのソートされたコピーを新しいテーブルに書き込みます。/D = 降順。アクティブなフィルターを尊重します |
JOIN WITH <alias> TO <file> FOR <cond> [FIELDS <list>] | アクティブなエリアと <alias> を結合してスナップショットテーブルをマテリアライズします。アクティブなフィルターを尊重します |
JOINはクラシック dBASE III とは異なります:FORは必須です(dBASE は省略を許可しました)。エリアをまたぐフィールドはalias.fieldドット構文を使用します(alias->fieldではありません)。FORはSQL述語です(SET FILTERのように)。結合はO(n×m)のネストループではなく、SQLiteのプランナーで実行されます。列名の衝突の場合、アクティブなテーブルが優先され、重複は警告付きで削除されます(dBASE はサイレントに削除しました)。そして、128フィールド/10文字名の制限はありません。制限: ソースエリアに
SET FILTERがアクティブな場合、その述語は結合クエリに適用されます。両方の結合テーブルに存在する列を参照するフィルターは曖昧になる可能性があります — それを修飾するか、JOIN の前にフィルターをクリアしてください。
レポート
| コマンド | 説明 |
|---|---|
CREATE REPORT <name> | 新しいレポート定義を作成します(JSONエディタを開きます) |
MODIFY REPORT <name> | 既存のレポート定義を編集します |
REPORT FORM <name> | レポートを実行します — ターミナルへのASCII出力 + HTMLプレビューパネル |
LIST REPORTS | 保存されているすべてのレポート定義をリストします |
DELETE REPORT <name> | レポート定義を削除します |
プログラム
| コマンド | 説明 |
|---|---|
DO <name> | 保存されている .prg プログラムを実行します |
EDIT <name> | .prg ソースエディタを開きます |
LIST PROGRAMS | 保存されているすべてのプログラムを表示します |
デモプログラムは
demos/*.prgにあり、唯一の真実の情報源です:サーバー起動ごとにプログラムストアにシードされ、ストアのコピーを上書きします。対応するレポート定義はdemos/reports/*.jsonにあり、同様にシードされます。そのうち3つは、使用可能なサンプルアプリケーションとして、これを基に構築できます — それらを実行し、
EDITして適応させてください:
DO crm— ミニCRM: 会社、連絡先、およびパイプライン合計(SUM … FOR)、トップディールソート、グループ化されたレポート、CSVエクスポート、会社+ディールのJOIN。DO inventory— 在庫管理: カテゴリ、製品(再注文レベル付き)、および在庫移動台帳、評価合計、低在庫レポート、ソート、CSVエクスポート、製品+カテゴリJOIN。DO overtime— 残業追跡: 従業員ごとの週次スケジュール、検証済みグリッドで編集するTIME(15)タイムシート、WEEK()/DATEADD()による週処理、ライブ残業バランス(繰越マイナス休暇取得)、グループ化されたレポート、CSVエクスポート。これらはマルチワークエリアリレーション(
alias.field)、インデックス、および@ SAY … GET/READフォームに依存しており、ライブマルチユーザー伝播を監視するために2番目のウィンドウを開くことを推奨します。
変数とI/O
| コマンド | 説明 |
|---|---|
? <expr>[, <expr>...] | 式を評価して結果を表示します(数値は右寄せ。単独の ? は空行を表示。?? も受け入れられます) |
STORE <val> TO <var> | 変数に値を代入します |
INPUT "prompt" TO <var> | キーボード入力を収集します |
@ r,c SAY "text" GET <var> | フォームフィールドを定義します。アクティブなテーブルの列と一致する名前は、その列にバインドされます(ルックアップ列はピッカーをレンダリングします) |
READ | フォームを表示し、送信を待ちます |
制御フロー
| コマンド | 説明 |
|---|---|
IF <cond> … ENDIF | 条件分岐ブロック |
DO WHILE <cond> … ENDDO | ループ |
DO CASE … ENDCASE | マルチブランチ条件分岐(CASE、OTHERWISE) |
HELP | コマンドリファレンスを表示します |
QUIT | 終了します |
組み込み関数
関数は、式が受け入れられる場所ならどこでも機能します — IF、DO WHILE、STORE、REPLACE、INDEX ON、SET FILTER TO など。
| 関数 | 返り値 |
|---|---|
EOF() | レコードポインタが最後のレコードを過ぎている場合は真 |
BOF() | レコードポインタが最初のレコードの前にある場合は真 |
FOUND() | 最後の SEEK / FIND が一致した場合は真 |
RECNO() | 現在のレコード番号 |
RECCOUNT() | 現在のテーブルの総レコード数 |
UPPER(str) | 大文字に変換 |
LOWER(str) | 小文字に変換 |
TRIM(str) | 前後の空白を削除 |
LTRIM(str) | 先頭の空白のみを削除 |
SUBSTR(str, start, len) | 部分文字列 — 1ベース。len はオプション(末尾まで) |
LEN(str) | 文字列長 |
AT(needle, haystack) | 1ベースの位置。見つからない場合は0(大文字小文字を区別) |
STR(num, len, dec) | 数値を右寄せ文字列に変換。デフォルト len=10, dec=0 |
VAL(str) | 文字列を数値に変換。数字以外は 0 |
INT(n) | ゼロに向かって切り捨て |
ABS(n) | 絶対値 |
SPACE(n) | n個のスペースの文字列 |
REPLICATE(str, n) | 文字列をn回繰り返す |
DATE() | 今日の日付を MM/DD/YY 形式で返す |
DTOC(date) | 日付を MM/DD/YY の表示文字列に変換 |
CTOD(str) | 表示文字列 MM/DD/YY をISO日付に変換 |
ROUND(num, dec) | 数値を dec 桁に丸める(デフォルトは0) |
MOD(a, b) | a を b で割った余り |
MAX(a, b) | a と b の最大値 |
MIN(a, b) | a と b の最小値 |
TIME() | 現在時刻を HH:MM:SS 形式で返す |
YEAR(date) | ISO日付文字列から年を数値で返す |
MONTH(date) | ISO日付文字列から月を数値で返す |
DAY(date) | ISO日付文字列から日を数値で返す |
WEEK(date) | ISO-8601週番号(1~53)。月曜日始まりの週で、週1は年の最初の木曜日を含む週 |
DATEADD(date, n) | ISO日付から n 日後の日付を返す(n は負の値も可)。無効な日付の場合は '' |
ブール値リテラル
W3Script は両方のスタイルをサポートします:
| 構文 | 値 |
|---|---|
TRUE / FALSE | ブール値の真/偽 |
.T. / .TRUE. | ブール値の真(dBASE III スタイル) |
.F. / .FALSE. | ブール値の偽(dBASE III スタイル) |
ブール値は、dBASE の慣習に合わせるため、出力では .T. / .F. として表示されます。
論理演算子も両方のスタイルで受け入れられます: NOT / .NOT.、AND / .AND.、OR / .OR.(例: DO WHILE .NOT. EOF())。
BROWSE グリッド キーボードショートカット
| キー | アクション |
|---|---|
| 矢印キー | セル間を移動 |
| Enter / F2 | 選択したセルを編集 |
| Tab / Shift+Tab | 右/左に移動 |
| Ctrl+N | 新しい行 |
| Delete | 現在の行を削除 |
| F5 | DBからリフレッシュ |
| Esc | グリッドを終了し、ターミナルに戻る |
セル検証。 編集は、コミットされる前に列の宣言された型に対してチェックされます。無効な値はセルを編集モードのままにし、赤で囲み、理由を表示します(
HH:MM、15の倍数、小数点以下2桁まで、有効な日付ではありません)。エラーは修正するとすぐにクリアされ、Escで編集を中止します。DATE、TIME/TIME(n)、NUM(p,s)、INT、LOGICALは検証されます。CHAR/MEMOは検証されません。サーバーは各編集を独立して再チェックします。
アーキテクチャ
server/
index.ts Node.js HTTP + WebSocket サーバー (ポート 3000)
Session.ts 接続ごとのセッション: コマンドを解析し、Executor を駆動
SessionManager.ts アクティブなすべてのセッションを追跡
ServerDatabaseBridge.ts better-sqlite3 をラップした IDatabaseBridge 実装
ProgramStore.ts data/system.sqlite3 内の .prg プログラムストレージ
IndexStore.ts data/system.sqlite3 内のインデックスメタデータ + アクティブインデックス
src/
interpreter/
Lexer.ts W3Script 入力をトークン化(大文字小文字を区別しない)
Parser.ts 再帰下降 AST ビルダー
Executor.ts 非同期 AST ランナー; db/table/filter/vars/rowPtr/activeIndex を管理
Builtins.ts ステートレスな組み込み関数実装
terminal/
Terminal.ts REPL UI — コマンド履歴、複数行ブロックの累積
ui/
Grid.ts BROWSE スプレッドシート — インラインセル編集、キーボードナビゲーション
FormLayout.ts @ SAY GET フォームエンジン — 文字セル座標
ProgramEditor.ts .prg ソースエディタ UI
ws/
WsClient.ts ブラウザ WebSocket クライアント
テストの実行
npm test # 単体テスト + 統合テスト (Vitest)
npx playwright test # エンドツーエンドブラウザテスト (開発サーバーを自動起動)
Playwright スイートは、実行中のアプリケーションに対して実際のブラウザを操作し、REPL、フィルター、インデックス、プログラム、フォーム、BROWSE、アシスタントウィザード、マルチワークエリア、互換性コマンド(?/??、SUM/AVERAGE、SORT ON … TO)、およびCSV COPY TO/APPEND FROM をカバーします。CI はすべての PR で Vitest と Playwright の両方を実行します。
貢献
貢献を歓迎します!WebBase-III は GitFlow を使用しています — リポジトリをフォークし、main ではなく、アクティブな release/vX.Y.Z ブランチ(オープンなマイルストーン)に対して PR を開いてください。完全なフォーク → リリースブランチワークフローと完了の定義については、CONTRIBUTING.md を参照してください。
貢献者
WebBase-III の拡張に協力してくれたすべての人に多大な感謝を:
- @kas2804 (Kasturi Rajarampatil) —
ROUND、MOD、MAX、MIN、TIME、YEAR、MONTH、DAYの組み込み関数を追加しました(#4、PR #17) — クリーンで十分にテストされた作業により、W3Script 式エンジンは完全なdBASE III互換性に近づきました。🙌
ライセンス
AGPL-3.0 — LICENSE.md を参照してください。
AGPL なぜ? WebBase-III はおもちゃであり、ライセンスはそのように保ちます:誰でもそれを使用、フォーク、学習できますが、誰もそれをクローズドにしてホストサービスとして販売し、変更を還元しないことはできません。実行したい、ハックしたい、または dBASE の思い出から機能をリリースしたい — それはまさにそれのためのものです。