iconflow 1.0.0

Unified icon library for Rust GUI apps with 10+ embedded icon packs (Bootstrap, Heroicons, Phosphor, Lucide, Tabler). Type-safe API for egui, iced and more
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Iconflow Pack Definition",
  "description": "Icon pack definition: variants (TTF files) and icon mappings.",
  "type": "object",
  "required": ["pack_id", "variants", "icons"],
  "properties": {
    "pack_id": {
      "type": "string",
      "description": "Canonical pack ID (matches feature-flag suffix)."
    },
    "variants": {
      "type": "array",
      "description": "List of TTF variants (style/size combinations).",
      "items": {
        "type": "object",
        "required": ["id", "style", "size", "family", "ttf_asset_path"],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique variant ID inside pack, used for overrides."
          },
          "style": {
            "$ref": "#/$defs/style"
          },
          "size": {
            "oneOf": [
              { "$ref": "#/$defs/size" },
              {
                "type": "integer",
                "minimum": 1
              }
            ]
          },
          "feature": {
            "type": "string",
            "description": "Optional Cargo feature required to enable this variant."
          },
          "family": {
            "type": "string",
            "description": "Font family name as stored inside the TTF."
          },
          "ttf_asset_path": {
            "type": "string",
            "description": "Repo-root relative path to the TTF file."
          }
        }
      }
    },
    "icons": {
      "type": "array",
      "description": "Icon list with codepoints and per-variant overrides.",
      "items": {
        "type": "object",
        "required": ["name"],
        "properties": {
          "name": {
            "type": "string",
            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
            "description": "Canonical kebab-case name without style suffixes."
          },
          "codepoint": {
            "$ref": "#/$defs/codepoint",
            "description": "Default Unicode scalar value."
          },
          "overrides": {
            "type": "object",
            "description": "Per-variant codepoint overrides (variant_id -> codepoint).",
            "additionalProperties": {
              "$ref": "#/$defs/codepoint"
            }
          },
          "availability": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Whitelist of variants where the icon exists."
          }
        },
        "anyOf": [
          { "required": ["codepoint"] },
          { "required": ["overrides"] }
        ]
      }
    }
  },
  "$defs": {
    "style": {
      "type": "string",
      "enum": [
        "Regular",
        "Filled",
        "Outline",
        "Light",
        "Thin",
        "Bold",
        "Duotone",
        "Glyph",
        "Sharp",
        "Rounded"
      ]
    },
    "size": {
      "type": "string",
      "enum": ["Tiny", "Mini", "Regular", "Large"]
    },
    "codepoint": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1114111,
      "not": {
        "minimum": 55296,
        "maximum": 57343
      }
    }
  }
}