egatari 0.0.0-stage → 0.6.4

package/vendor/egatari-spec/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gendo Kumoi
+
+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/vendor/egatari-spec/SOURCE.json

@@ -0,0 +1,7 @@
+{
+  "repository": "https://github.com/egatari/egatari-spec",
+  "commit": "a5bfbe5d95e18de26210b4230b4022d7f37caa1c",
+  "snapshot": "wd-2026-11-03",
+  "files": 48,
+  "note": "Copied by tools/sync-spec.mjs. Do not edit; change the spec repository and sync again."
+}

package/vendor/egatari-spec/schema/deck-audio.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://egatari.org/schema/deck-audio.schema.json",
+  "title": "Egatari 1.0 runtime audio (#deck-audio)",
+  "type": "object",
+  "propertyNames": {
+    "$ref": "egatari-index.schema.json#/$defs/stepKey"
+  },
+  "additionalProperties": {
+    "type": "object",
+    "required": [
+      "src",
+      "dur",
+      "cues"
+    ],
+    "properties": {
+      "src": {
+        "type": "string",
+        "pattern": "^(data:audio/[a-z0-9.+-]+;base64,|egatari:[A-Za-z0-9_]{1,32}$)"
+      },
+      "dur": {
+        "type": "number",
+        "exclusiveMinimum": 0
+      },
+      "cues": {
+        "type": "array",
+        "items": {
+          "type": "number",
+          "minimum": 0
+        }
+      },
+      "sync": {
+        "enum": [
+          "auto",
+          "manual",
+          "none"
+        ],
+        "default": "auto"
+      },
+      "mime": {
+        "type": "string",
+        "pattern": "^audio/[a-z0-9.+-]+$"
+      },
+      "startOffset": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
+      "kind": {
+        "enum": [
+          "tts",
+          "recorded",
+          "imported"
+        ],
+        "description": "How the audio was made, copied from the audio record (§5.2); lets players mark synthesized narration (§7.3)."
+      }
+    },
+    "if": {
+      "properties": {
+        "sync": {
+          "const": "none"
+        }
+      },
+      "required": [
+        "sync"
+      ]
+    },
+    "then": {
+      "properties": {
+        "cues": {
+          "maxItems": 0
+        }
+      }
+    }
+  }
+}

package/vendor/egatari-spec/schema/deck-meta.schema.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://egatari.org/schema/deck-meta.schema.json",
+  "title": "Egatari 1.0 runtime metadata (#deck-meta)",
+  "type": "object",
+  "required": [
+    "format",
+    "version",
+    "contracts",
+    "player",
+    "generator",
+    "docId",
+    "title",
+    "lang",
+    "portable",
+    "tracking"
+  ],
+  "properties": {
+    "format": {
+      "const": "egatari"
+    },
+    "version": {
+      "$ref": "egatari-index.schema.json#/properties/version"
+    },
+    "contracts": {
+      "$ref": "egatari-index.schema.json#/properties/contracts"
+    },
+    "player": {
+      "$ref": "egatari-index.schema.json#/properties/player"
+    },
+    "generator": {
+      "$ref": "egatari-index.schema.json#/properties/generator"
+    },
+    "sourceSha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "portable": {
+      "type": "boolean"
+    },
+    "docId": {
+      "$ref": "egatari-index.schema.json#/properties/docId"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lang": {
+      "$ref": "egatari-metadata.schema.json#/properties/lang"
+    },
+    "completion": {
+      "$ref": "egatari-metadata.schema.json#/properties/completion"
+    },
+    "tracking": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9-]+$"
+      }
+    },
+    "license": {
+      "type": "string"
+    },
+    "copyright": {
+      "type": "string"
+    },
+    "attribution": {
+      "type": "string"
+    },
+    "offer": {
+      "type": "object",
+      "properties": {
+        "modes": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "talk",
+              "learn",
+              "video"
+            ]
+          }
+        },
+        "faces": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "talk",
+              "read"
+            ]
+          }
+        },
+        "open": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "enum": [
+                "talk",
+                "learn",
+                "video"
+              ]
+            },
+            "face": {
+              "enum": [
+                "talk",
+                "read"
+              ]
+            }
+          }
+        }
+      },
+      "description": "Modes and faces the author offers, and where the lesson opens (§1.2). The author's intent, not access control."
+    }
+  },
+  "if": {
+    "properties": {
+      "portable": {
+        "const": true
+      }
+    }
+  },
+  "then": {
+    "required": [
+      "sourceSha256"
+    ]
+  }
+}

package/vendor/egatari-spec/schema/egatari-audio.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://egatari.org/schema/egatari-audio.schema.json",
+  "title": "Egatari 1.0 audio record (index.audio[stepKey])",
+  "type": "object",
+  "required": [
+    "file",
+    "dur",
+    "cues",
+    "kind",
+    "inputHash"
+  ],
+  "properties": {
+    "file": {
+      "allOf": [
+        {
+          "$ref": "egatari-index.schema.json#/$defs/archivePath"
+        },
+        {
+          "type": "string",
+          "pattern": "^audio/"
+        }
+      ]
+    },
+    "dur": {
+      "type": "number",
+      "exclusiveMinimum": 0
+    },
+    "cues": {
+      "type": "array",
+      "description": "Time (s) of every boundary of the step, in order. Non-decreasing and <= dur (validators check order).",
+      "items": {
+        "type": "number",
+        "minimum": 0
+      }
+    },
+    "sync": {
+      "enum": [
+        "auto",
+        "manual",
+        "none"
+      ],
+      "description": "auto: cues derived during synthesis; manual: placed by a person; none: cues not yet placed (players treat as unsynchronized)",
+      "default": "auto"
+    },
+    "kind": {
+      "enum": [
+        "tts",
+        "recorded",
+        "imported"
+      ]
+    },
+    "inputHash": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^[0-9a-f]{64}$",
+      "description": "null = unknown, treated as stale"
+    },
+    "recipe": {
+      "type": "object",
+      "required": [
+        "engine",
+        "model",
+        "voice",
+        "processing"
+      ],
+      "properties": {
+        "engine": {
+          "type": "string"
+        },
+        "model": {
+          "type": "string"
+        },
+        "voice": {
+          "description": "Public voice identifiers by role, never file-system paths",
+          "type": "object",
+          "propertyNames": {
+            "enum": [
+              "expert",
+              "novice"
+            ]
+          },
+          "additionalProperties": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+          }
+        },
+        "seed": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "dictionary": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "SHA-256 of the effective reading dictionary"
+        },
+        "processing": {
+          "type": "string",
+          "description": "Identifier of the post-processing profile, e.g. trim-45-loud-20-v1"
+        }
+      }
+    },
+    "recipeDigest": {
+      "type": "string"
+    },
+    "alternatives": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "file",
+          "mime",
+          "startOffset"
+        ],
+        "properties": {
+          "file": {
+            "allOf": [
+              {
+                "$ref": "egatari-index.schema.json#/$defs/archivePath"
+              },
+              {
+                "type": "string",
+                "pattern": "^audio/"
+              }
+            ]
+          },
+          "mime": {
+            "type": "string"
+          },
+          "startOffset": {
+            "type": "number",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "startOffset": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "processing": {
+      "type": "string"
+    },
+    "watermark": {
+      "type": "object",
+      "required": [
+        "scheme"
+      ],
+      "properties": {
+        "scheme": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]{1,32}$"
+        },
+        "embeddedBy": {
+          "type": "string",
+          "maxLength": 64
+        }
+      },
+      "description": "An audio watermark the producer knows the take carries (§5.2, draft)."
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "tts"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "recipe"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "sync": {
+            "const": "none"
+          }
+        },
+        "required": [
+          "sync"
+        ]
+      },
+      "then": {
+        "properties": {
+          "cues": {
+            "maxItems": 0
+          }
+        }
+      }
+    }
+  ]
+}