str-format 0.2.0

STR 结构化树资源格式（.str）的读写库、校验器与 CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://str-format.local/schema/v1/root-meta.schema.json",
  "title": "STR root `._meta`（ROOT 元数据）",
  "description": "对应 STR 规范 v1.8.0 第 4 章。校验对象是 `._meta`（TOML）归一化后的规范 JSON（见规范 4.1 / 4.9）。",
  "type": "object",
  "required": ["str", "spec", "kind", "id", "name", "revision", "created_at", "updated_at"],
  "additionalProperties": false,
  "properties": {
    "str": { "const": 1, "description": "格式主版本" },
    "spec": { "type": "string", "pattern": "^1\\.[0-9]+\\.[0-9]+$" },
    "kind": { "const": "root" },
    "id": { "type": "string", "format": "uuid" },
    "name": { "type": "string", "minLength": 1 },
    "type": { "type": "string", "minLength": 1 },
    "title": { "type": "string", "minLength": 1 },
    "summary": { "type": "string", "minLength": 1, "maxLength": 400 },
    "tags": { "type": "array", "items": { "type": "string", "minLength": 1 } },
    "revision": { "type": "integer", "minimum": 1 },
    "created_at": { "type": "string", "format": "date-time" },
    "updated_at": { "type": "string", "format": "date-time" },
    "schema": { "type": "string", "minLength": 1 },
    "authors": { "type": "array", "items": { "$ref": "#/$defs/author" } },
    "policies": { "$ref": "#/$defs/policies" },
    "refs": { "type": "array", "items": { "$ref": "#/$defs/ref" } },
    "entries": {
      "type": "array",
      "items": { "$ref": "#/$defs/entry" },
      "description": "ROOT 的 role=node 条目即一级分支结构"
    },
    "ext": { "type": "object" }
  },
  "$defs": {
    "policies": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "id_version": { "type": "integer", "enum": [4, 7] },
        "max_depth": { "type": "integer", "minimum": 1 },
        "manifest": { "type": "string", "enum": ["strict", "advisory"] },
        "sha256": { "type": "string", "enum": ["required", "optional", "off"] },
        "large_asset_bytes": { "type": "integer", "minimum": 0 },
        "deep_tree_warn": { "type": "integer", "minimum": 1 }
      }
    },
    "author": {
      "type": "object",
      "required": ["id", "role"],
      "additionalProperties": false,
      "properties": {
        "id": { "type": "string", "minLength": 1 },
        "name": { "type": "string" },
        "role": { "type": "string", "enum": ["owner", "editor", "viewer", "agent"] },
        "at": { "type": "string", "format": "date-time" }
      }
    },
    "ref": {
      "type": "object",
      "required": ["id", "target", "rel"],
      "additionalProperties": false,
      "properties": {
        "id": { "type": "string", "format": "uuid" },
        "target": { "type": "string", "format": "uuid" },
        "rel": { "type": "string", "pattern": "^(related|depends_on|instance_of|derived_from|ref|x-[a-z0-9-]+)$" },
        "title": { "type": "string" },
        "order": { "type": "integer", "minimum": 0 },
        "note": { "type": "string" }
      }
    },
    "entry": {
      "type": "object",
      "required": ["path", "role"],
      "additionalProperties": false,
      "properties": {
        "path": { "type": "string", "minLength": 1, "pattern": "^[^/]+$" },
        "role": { "type": "string", "enum": ["node", "payload", "asset", "dir", "bundle", "schema", "cache", "other"] },
        "id": { "type": "string", "format": "uuid" },
        "type": { "type": "string" },
        "title": { "type": "string" },
        "summary": { "type": "string" },
        "order": { "type": "integer", "minimum": 0 },
        "media_type": { "type": "string" },
        "size": { "type": "integer", "minimum": 0 },
        "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
        "count": { "type": "integer", "minimum": 0 },
        "schema": { "type": "string" },
        "optional": { "type": "boolean" },
        "note": { "type": "string" }
      },
      "allOf": [
        { "if": { "properties": { "role": { "const": "node" } } }, "then": { "required": ["id"] } }
      ]
    }
  }
}