@kubohiroya/turbowarp-structured-data 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md CHANGED
@@ -4,6 +4,9 @@
4
4
 
5
5
  名前付き構造化データ、安全なJSON/YAML codec、決定的なpath操作、上限付き反復、server compiler契約を提供するTurboWarp機能拡張です。
6
6
 
7
+ 編集metadataとpure owner検証は`./editor-metadata`で公開し、編集用Schema compileとAjvは共通GUIが担当します。
8
+ 再生用JSには編集エンジンを同梱しません。[編集とruntimeの境界](docs/editor-runtime-boundary.ja.md)を参照してください。
9
+
7
10
  ## できること
8
11
 
9
12
  - JSONまたはYAMLをtarget-localな名前付きnamespaceへparse
@@ -20,6 +23,8 @@ namespaceとloop contextがTurboWarp BlockUtilityのtarget/thread identityを使
20
23
 
21
24
  JSON/YAML入力は256 KiB、深さ64、50,000 valueまでです。YAML alias、warning、unknown tag、duplicate key、string以外のmap key、未対応scalarは拒否します。
22
25
 
26
+ structured-data providerはnamed-data 0.4.0を介してbindingの任意の`schemaRef`を伝播できます。IDは`^[a-z][a-z0-9.-]{0,127}$`に一致し、versionは完全なSemVerである必要があります。Schema identityの解決は起動時固定で、明示的に有効化するまで既定OFFです。provider読み込み前に`globalThis.__TW_NAMED_DATA_FEATURE_FLAGS__ = {NAMED_DATA_SCHEMA_REF: true}`を設定します。参照はbindingの安定IDと完全なSemVer versionに一致する必要があります。providerはSchema本体を保持せず、別versionへのfallbackもしません。consumerは自身のSchema catalogでidentityを解決し、既存のJSON Schema実装で値を検証します。合意するsubsetは`type`、`properties`、`required`、Boolean形式の`additionalProperties`、`items`、`enum`、`const`、数値範囲、文字列/配列の長さ制約です。未対応keywordは検証動作を追加しません。flagをOFFにすればschema identityなしのmetadataへ即時に戻せます。
27
+
23
28
  ## クイックスタート
24
29
 
25
30
  ```text
package/README.md CHANGED
@@ -4,6 +4,8 @@
4
4
 
5
5
  Named structured data with safe JSON/YAML codecs, deterministic path operations, bounded iteration, and a server compiler contract.
6
6
 
7
+ Editor metadata and pure owner validation are available through `./editor-metadata`; the common GUI owns Schema compilation and Ajv. See [the runtime/editor boundary](docs/editor-runtime-boundary.ja.md) for compatibility and rollback details.
8
+
7
9
  ## What it does
8
10
 
9
11
  - parses JSON or YAML into a target-local named namespace;
@@ -20,10 +22,22 @@ The `STRUCTURED_DATA_MVP` feature flag is fixed at extension startup and default
20
22
 
21
23
  JSON and YAML input is limited to 256 KiB, nesting depth 64, and 50,000 values. YAML aliases, warnings, unknown tags, duplicate keys, non-string map keys, and unsupported scalar types are rejected.
22
24
 
25
+ The structured-data provider can carry a binding's optional `schemaRef` through named-data 0.4.0.
26
+ The ID must match `^[a-z][a-z0-9.-]{0,127}$` and the version must be a complete SemVer version.
27
+ Schema identity resolution is a startup-fixed opt-in and defaults to `false`; configure
28
+ `globalThis.__TW_NAMED_DATA_FEATURE_FLAGS__ = {NAMED_DATA_SCHEMA_REF: true}` before loading the
29
+ provider. A request must match the binding's stable ID and full SemVer version exactly. The
30
+ provider does not store schema documents or choose a fallback version. Consumers resolve the
31
+ identity in their own schema catalog and validate the returned value with their existing JSON
32
+ Schema implementation. The agreed subset is `type`, `properties`, `required`,
33
+ `additionalProperties` (boolean), `items`, `enum`, `const`, numeric bounds, and string/array
34
+ length bounds; unsupported keywords do not add validation behavior. Turn the flag off to
35
+ immediately return to metadata without schema identities.
36
+
23
37
  ## Installation
24
38
 
25
39
  ```bash
26
- pnpm add --save-exact @kubohiroya/turbowarp-structured-data@0.6.1
40
+ pnpm add --save-exact @kubohiroya/turbowarp-structured-data@0.6.3
27
41
  ```
28
42
 
29
43
  ## Quick start
@@ -9,6 +9,15 @@ Copyright Hiroya Kubo
9
9
  Licensed under the Mozilla Public License 2.0. The canonical source and package are available at
10
10
  <https://github.com/kubohiroya/turbowarp-named-data>.
11
11
 
12
+ ## @kubohiroya/turbowarp-extension-data-editor (pure helpers)
13
+
14
+ Copyright Hiroya Kubo
15
+
16
+ The JSON value Schema declaration and fixed numeric input parser are inlined from this package.
17
+ Licensed under the Mozilla Public License 2.0. Canonical source:
18
+ <https://github.com/kubohiroya/turbowarp-extension-data-editor>.
19
+ The editor engine, Ajv and React/RJSF are excluded from the playback and metadata bundles.
20
+
12
21
  ## yaml
13
22
 
14
23
  Copyright Eemeli Aro <eemeli@gmail.com>