[{"data":1,"prerenderedAt":990},["ShallowReactive",2],{"navigation_docs":3,"-concepts-elements-categories":194,"-concepts-elements-categories-surround":985},[4,22,82,124,146,168,190],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/getting-started","1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/getting-started/mcp-quickstart","1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/getting-started/rest-quickstart","1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/getting-started/ui-quickstart","1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25,"children":26},"MCP server","/mcp","2.mcp/0.index",[27,28,32,36,40],{"title":23,"path":24,"stem":25},{"title":29,"path":30,"stem":31},"Connecting","/mcp/connection","2.mcp/1.connection",{"title":33,"path":34,"stem":35},"Envelope","/mcp/envelope","2.mcp/2.envelope",{"title":37,"path":38,"stem":39},"Resources","/mcp/resources","2.mcp/3.resources",{"title":41,"path":42,"stem":43,"children":44},"Tools","/mcp/tools","2.mcp/4.tools/0.index",[45,46,50,54,58,62,66,70,74,78],{"title":41,"path":42,"stem":43},{"title":47,"path":48,"stem":49},"list_schema_versions","/mcp/tools/list-schema-versions","2.mcp/4.tools/1.list-schema-versions",{"title":51,"path":52,"stem":53},"get_schema","/mcp/tools/get-schema","2.mcp/4.tools/2.get-schema",{"title":55,"path":56,"stem":57},"list_categories","/mcp/tools/list-categories","2.mcp/4.tools/3.list-categories",{"title":59,"path":60,"stem":61},"list_elements","/mcp/tools/list-elements","2.mcp/4.tools/4.list-elements",{"title":63,"path":64,"stem":65},"get_element","/mcp/tools/get-element","2.mcp/4.tools/5.get-element",{"title":67,"path":68,"stem":69},"get_elements","/mcp/tools/get-elements","2.mcp/4.tools/6.get-elements",{"title":71,"path":72,"stem":73},"validate_datachain","/mcp/tools/validate-datachain","2.mcp/4.tools/7.validate-datachain",{"title":75,"path":76,"stem":77},"render_datachain","/mcp/tools/render-datachain","2.mcp/4.tools/8.render-datachain",{"title":79,"path":80,"stem":81},"get_icon_url","/mcp/tools/get-icon-url","2.mcp/4.tools/9.get-icon-url",{"title":83,"path":84,"stem":85,"children":86},"REST API (v2)","/rest","3.rest/0.index",[87,88,92,96,100,104,108,112,116,120],{"title":83,"path":84,"stem":85},{"title":89,"path":90,"stem":91},"GET /schemas","/rest/schemas","3.rest/1.schemas",{"title":93,"path":94,"stem":95},"GET /schemas/:version/manifest","/rest/manifest","3.rest/2.manifest",{"title":97,"path":98,"stem":99},"GET /schemas/:version/categories","/rest/categories","3.rest/3.categories",{"title":101,"path":102,"stem":103},"GET /schemas/:version/elements","/rest/elements-list","3.rest/4.elements-list",{"title":105,"path":106,"stem":107},"GET /schemas/:version/elements/:element_id","/rest/element-detail","3.rest/5.element-detail",{"title":109,"path":110,"stem":111},"POST /schemas/:version/validate","/rest/validate","3.rest/6.validate",{"title":113,"path":114,"stem":115},"Icon routes","/rest/icons","3.rest/7.icons",{"title":117,"path":118,"stem":119},"Pagination & fields","/rest/pagination-and-fields","3.rest/8.pagination-and-fields",{"title":121,"path":122,"stem":123},"Errors","/rest/errors","3.rest/9.errors",{"title":125,"path":126,"stem":127,"children":128},"Icon composition","/icons","4.icons/0.index",[129,130,134,138,142],{"title":125,"path":126,"stem":127},{"title":131,"path":132,"stem":133},"Shapes","/icons/shapes","4.icons/1.shapes",{"title":135,"path":136,"stem":137},"Symbols","/icons/symbols","4.icons/2.symbols",{"title":139,"path":140,"stem":141},"Composed variants","/icons/composed-variants","4.icons/3.composed-variants",{"title":143,"path":144,"stem":145},"URLs","/icons/urls","4.icons/4.urls",{"title":147,"path":148,"stem":149,"children":150},"@dtpr/ui","/ui","5.ui/0.index",[151,152,156,160,164],{"title":147,"path":148,"stem":149},{"title":153,"path":154,"stem":155},"@dtpr/ui/core","/ui/core","5.ui/1.core",{"title":157,"path":158,"stem":159},"@dtpr/ui/vue","/ui/vue","5.ui/2.vue",{"title":161,"path":162,"stem":163},"@dtpr/ui/html","/ui/html","5.ui/3.html",{"title":165,"path":166,"stem":167},"Theming","/ui/theming","5.ui/4.theming",{"title":169,"path":170,"stem":171,"children":172},"Concepts","/concepts","6.concepts/0.index",[173,174,178,182,186],{"title":169,"path":170,"stem":171},{"title":175,"path":176,"stem":177},"Datachains","/concepts/datachains","6.concepts/1.datachains",{"title":179,"path":180,"stem":181},"Elements & categories","/concepts/elements-categories","6.concepts/2.elements-categories",{"title":183,"path":184,"stem":185},"Versions & releases","/concepts/versions-and-releases","6.concepts/3.versions-and-releases",{"title":187,"path":188,"stem":189},"Content hash","/concepts/content-hash","6.concepts/4.content-hash",{"title":191,"path":192,"stem":193},"Changelog","/changelog","7.changelog",{"id":195,"title":179,"body":196,"description":978,"extension":979,"links":980,"meta":981,"navigation":982,"path":180,"seo":983,"stem":181,"__hash__":984},"docs/6.concepts/2.elements-categories.md",{"type":197,"value":198,"toc":972},"minimark",[199,203,217,222,226,278,564,576,580,583,631,914,930,934,941,945,968],[200,201,179],"h1",{"id":202},"elements-categories",[204,205,207,208,212,213,216],"callout",{"type":206},"info","An ",[209,210,211],"strong",{},"element"," is a single fact. A ",[209,214,215],{},"category"," groups related elements and carries the visual treatment shared across them.",[218,219,221],"h2",{"id":220},"categories","Categories",[223,224,225],"p",{},"A category is the top-level grouping — \"Purpose\", \"Data collected\", \"Data handling\". Every category declares:",[227,228,229,242,253,263],"ul",{},[230,231,232,233,237,238,241],"li",{},"an ",[234,235,236],"code",{},"id"," (stable, used as ",[234,239,240],{},"category_id"," on every element and placement),",[230,243,244,245,248,249,252],{},"localized ",[234,246,247],{},"name"," and ",[234,250,251],{},"description",",",[230,254,255,256,262],{},"a bundled ",[257,258,259],"a",{"href":132},[234,260,261],{},"shape"," primitive,",[230,264,265,266,269,270,273,274,277],{},"an optional ",[234,267,268],{},"context"," with ",[234,271,272],{},"values[]"," — used to produce ",[257,275,276],{"href":140},"colored icon variants",".",[279,280,285],"pre",{"className":281,"code":282,"language":283,"meta":284,"style":284},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": \"purpose\",\n  \"name\": [{ \"locale\": \"en\", \"value\": \"Purpose\" }],\n  \"shape\": \"hexagon\",\n  \"context\": {\n    \"values\": [\n      { \"id\": \"commercial\", \"color\": \"#0052CC\", \"label\": [...] },\n      { \"id\": \"civic\",      \"color\": \"#FFDD00\", \"label\": [...] }\n    ]\n  }\n}\n","json","",[234,286,287,296,323,375,395,409,425,489,546,552,558],{"__ignoreMap":284},[288,289,292],"span",{"class":290,"line":291},"line",1,[288,293,295],{"class":294},"sMK4o","{\n",[288,297,299,302,305,308,311,314,318,320],{"class":290,"line":298},2,[288,300,301],{"class":294},"  \"",[288,303,236],{"class":304},"spNyl",[288,306,307],{"class":294},"\"",[288,309,310],{"class":294},":",[288,312,313],{"class":294}," \"",[288,315,317],{"class":316},"sfazB","purpose",[288,319,307],{"class":294},[288,321,322],{"class":294},",\n",[288,324,326,328,330,332,334,337,339,343,345,347,349,352,354,356,358,361,363,365,367,370,372],{"class":290,"line":325},3,[288,327,301],{"class":294},[288,329,247],{"class":304},[288,331,307],{"class":294},[288,333,310],{"class":294},[288,335,336],{"class":294}," [{",[288,338,313],{"class":294},[288,340,342],{"class":341},"sBMFI","locale",[288,344,307],{"class":294},[288,346,310],{"class":294},[288,348,313],{"class":294},[288,350,351],{"class":316},"en",[288,353,307],{"class":294},[288,355,252],{"class":294},[288,357,313],{"class":294},[288,359,360],{"class":341},"value",[288,362,307],{"class":294},[288,364,310],{"class":294},[288,366,313],{"class":294},[288,368,369],{"class":316},"Purpose",[288,371,307],{"class":294},[288,373,374],{"class":294}," }],\n",[288,376,378,380,382,384,386,388,391,393],{"class":290,"line":377},4,[288,379,301],{"class":294},[288,381,261],{"class":304},[288,383,307],{"class":294},[288,385,310],{"class":294},[288,387,313],{"class":294},[288,389,390],{"class":316},"hexagon",[288,392,307],{"class":294},[288,394,322],{"class":294},[288,396,398,400,402,404,406],{"class":290,"line":397},5,[288,399,301],{"class":294},[288,401,268],{"class":304},[288,403,307],{"class":294},[288,405,310],{"class":294},[288,407,408],{"class":294}," {\n",[288,410,412,415,418,420,422],{"class":290,"line":411},6,[288,413,414],{"class":294},"    \"",[288,416,417],{"class":341},"values",[288,419,307],{"class":294},[288,421,310],{"class":294},[288,423,424],{"class":294}," [\n",[288,426,428,431,433,436,438,440,442,445,447,449,451,454,456,458,460,463,465,467,469,472,474,476,479,483,486],{"class":290,"line":427},7,[288,429,430],{"class":294},"      {",[288,432,313],{"class":294},[288,434,236],{"class":435},"sbssI",[288,437,307],{"class":294},[288,439,310],{"class":294},[288,441,313],{"class":294},[288,443,444],{"class":316},"commercial",[288,446,307],{"class":294},[288,448,252],{"class":294},[288,450,313],{"class":294},[288,452,453],{"class":435},"color",[288,455,307],{"class":294},[288,457,310],{"class":294},[288,459,313],{"class":294},[288,461,462],{"class":316},"#0052CC",[288,464,307],{"class":294},[288,466,252],{"class":294},[288,468,313],{"class":294},[288,470,471],{"class":435},"label",[288,473,307],{"class":294},[288,475,310],{"class":294},[288,477,478],{"class":294}," [",[288,480,482],{"class":481},"sTEyZ","...",[288,484,485],{"class":294},"]",[288,487,488],{"class":294}," },\n",[288,490,492,494,496,498,500,502,504,507,509,511,514,516,518,520,522,525,527,529,531,533,535,537,539,541,543],{"class":290,"line":491},8,[288,493,430],{"class":294},[288,495,313],{"class":294},[288,497,236],{"class":435},[288,499,307],{"class":294},[288,501,310],{"class":294},[288,503,313],{"class":294},[288,505,506],{"class":316},"civic",[288,508,307],{"class":294},[288,510,252],{"class":294},[288,512,513],{"class":294},"      \"",[288,515,453],{"class":435},[288,517,307],{"class":294},[288,519,310],{"class":294},[288,521,313],{"class":294},[288,523,524],{"class":316},"#FFDD00",[288,526,307],{"class":294},[288,528,252],{"class":294},[288,530,313],{"class":294},[288,532,471],{"class":435},[288,534,307],{"class":294},[288,536,310],{"class":294},[288,538,478],{"class":294},[288,540,482],{"class":481},[288,542,485],{"class":294},[288,544,545],{"class":294}," }\n",[288,547,549],{"class":290,"line":548},9,[288,550,551],{"class":294},"    ]\n",[288,553,555],{"class":290,"line":554},10,[288,556,557],{"class":294},"  }\n",[288,559,561],{"class":290,"line":560},11,[288,562,563],{"class":294},"}\n",[223,565,566,567,571,572,277],{},"Access via ",[257,568,569],{"href":56},[234,570,55],{}," or ",[257,573,574],{"href":98},[234,575,97],{},[218,577,579],{"id":578},"elements","Elements",[223,581,582],{},"An element is a single fact within a category:",[227,584,585,594,600,610,617,624],{},[230,586,232,587,589,590,593],{},[234,588,236],{}," (stable, often ",[234,591,592],{},"\u003Ccategory>.\u003Cname>","),",[230,595,596,597,599],{},"a ",[234,598,240],{}," pointing at a category,",[230,601,596,602,605,606,609],{},[234,603,604],{},"symbol_id"," pointing at the ",[257,607,608],{"href":136},"symbol"," SVG,",[230,611,244,612,248,615,252],{},[234,613,614],{},"title",[234,616,251],{},[230,618,619,620,623],{},"optional ",[234,621,622],{},"variables[]"," — values a datachain author fills in per placement,",[230,625,626,627,630],{},"a materialized ",[234,628,629],{},"icon_variants[]"," array listing every valid variant for composed-icon URLs.",[279,632,634],{"className":281,"code":633,"language":283,"meta":284,"style":284},"{\n  \"id\": \"purpose.example\",\n  \"category_id\": \"purpose\",\n  \"symbol_id\": \"example-symbol\",\n  \"title\": [{ \"locale\": \"en\", \"value\": \"Example purpose\" }],\n  \"description\": [{ \"locale\": \"en\", \"value\": \"Short description with {{partner}} variable.\" }],\n  \"variables\": [ { \"id\": \"partner\", \"label\": [...], \"type\": \"text\", \"required\": false } ],\n  \"icon_variants\": [\"default\", \"dark\", \"commercial\"]\n}\n",[234,635,636,640,659,677,696,741,786,870,910],{"__ignoreMap":284},[288,637,638],{"class":290,"line":291},[288,639,295],{"class":294},[288,641,642,644,646,648,650,652,655,657],{"class":290,"line":298},[288,643,301],{"class":294},[288,645,236],{"class":304},[288,647,307],{"class":294},[288,649,310],{"class":294},[288,651,313],{"class":294},[288,653,654],{"class":316},"purpose.example",[288,656,307],{"class":294},[288,658,322],{"class":294},[288,660,661,663,665,667,669,671,673,675],{"class":290,"line":325},[288,662,301],{"class":294},[288,664,240],{"class":304},[288,666,307],{"class":294},[288,668,310],{"class":294},[288,670,313],{"class":294},[288,672,317],{"class":316},[288,674,307],{"class":294},[288,676,322],{"class":294},[288,678,679,681,683,685,687,689,692,694],{"class":290,"line":377},[288,680,301],{"class":294},[288,682,604],{"class":304},[288,684,307],{"class":294},[288,686,310],{"class":294},[288,688,313],{"class":294},[288,690,691],{"class":316},"example-symbol",[288,693,307],{"class":294},[288,695,322],{"class":294},[288,697,698,700,702,704,706,708,710,712,714,716,718,720,722,724,726,728,730,732,734,737,739],{"class":290,"line":397},[288,699,301],{"class":294},[288,701,614],{"class":304},[288,703,307],{"class":294},[288,705,310],{"class":294},[288,707,336],{"class":294},[288,709,313],{"class":294},[288,711,342],{"class":341},[288,713,307],{"class":294},[288,715,310],{"class":294},[288,717,313],{"class":294},[288,719,351],{"class":316},[288,721,307],{"class":294},[288,723,252],{"class":294},[288,725,313],{"class":294},[288,727,360],{"class":341},[288,729,307],{"class":294},[288,731,310],{"class":294},[288,733,313],{"class":294},[288,735,736],{"class":316},"Example purpose",[288,738,307],{"class":294},[288,740,374],{"class":294},[288,742,743,745,747,749,751,753,755,757,759,761,763,765,767,769,771,773,775,777,779,782,784],{"class":290,"line":411},[288,744,301],{"class":294},[288,746,251],{"class":304},[288,748,307],{"class":294},[288,750,310],{"class":294},[288,752,336],{"class":294},[288,754,313],{"class":294},[288,756,342],{"class":341},[288,758,307],{"class":294},[288,760,310],{"class":294},[288,762,313],{"class":294},[288,764,351],{"class":316},[288,766,307],{"class":294},[288,768,252],{"class":294},[288,770,313],{"class":294},[288,772,360],{"class":341},[288,774,307],{"class":294},[288,776,310],{"class":294},[288,778,313],{"class":294},[288,780,781],{"class":316},"Short description with {{partner}} variable.",[288,783,307],{"class":294},[288,785,374],{"class":294},[288,787,788,790,793,795,797,799,802,804,806,808,810,812,815,817,819,821,823,825,827,829,831,834,836,839,841,843,845,848,850,852,854,857,859,861,864,867],{"class":290,"line":427},[288,789,301],{"class":294},[288,791,792],{"class":304},"variables",[288,794,307],{"class":294},[288,796,310],{"class":294},[288,798,478],{"class":294},[288,800,801],{"class":294}," {",[288,803,313],{"class":294},[288,805,236],{"class":341},[288,807,307],{"class":294},[288,809,310],{"class":294},[288,811,313],{"class":294},[288,813,814],{"class":316},"partner",[288,816,307],{"class":294},[288,818,252],{"class":294},[288,820,313],{"class":294},[288,822,471],{"class":341},[288,824,307],{"class":294},[288,826,310],{"class":294},[288,828,478],{"class":294},[288,830,482],{"class":481},[288,832,833],{"class":294},"],",[288,835,313],{"class":294},[288,837,838],{"class":341},"type",[288,840,307],{"class":294},[288,842,310],{"class":294},[288,844,313],{"class":294},[288,846,847],{"class":316},"text",[288,849,307],{"class":294},[288,851,252],{"class":294},[288,853,313],{"class":294},[288,855,856],{"class":341},"required",[288,858,307],{"class":294},[288,860,310],{"class":294},[288,862,863],{"class":294}," false",[288,865,866],{"class":294}," }",[288,868,869],{"class":294}," ],\n",[288,871,872,874,877,879,881,883,885,888,890,892,894,897,899,901,903,905,907],{"class":290,"line":491},[288,873,301],{"class":294},[288,875,876],{"class":304},"icon_variants",[288,878,307],{"class":294},[288,880,310],{"class":294},[288,882,478],{"class":294},[288,884,307],{"class":294},[288,886,887],{"class":316},"default",[288,889,307],{"class":294},[288,891,252],{"class":294},[288,893,313],{"class":294},[288,895,896],{"class":316},"dark",[288,898,307],{"class":294},[288,900,252],{"class":294},[288,902,313],{"class":294},[288,904,444],{"class":316},[288,906,307],{"class":294},[288,908,909],{"class":294},"]\n",[288,911,912],{"class":290,"line":548},[288,913,563],{"class":294},[223,915,566,916,920,921,925,926,277],{},[257,917,918],{"href":60},[234,919,59],{},", ",[257,922,923],{"href":64},[234,924,63],{},", or ",[257,927,928],{"href":102},[234,929,101],{},[218,931,933],{"id":932},"relationship","Relationship",[279,935,939],{"className":936,"code":938,"language":847},[937],"language-text","Category\n  ├── shape  ───► used by every element in the category\n  ├── context.values[] ───► produces colored icon variants per element\n  └── Elements[] (many-to-one)\n        ├── symbol_id ───► symbol SVG\n        ├── variables[] ───► filled per placement in a datachain instance\n        └── icon_variants[] ───► materialized (default + dark + context ids)\n",[234,940,938],{"__ignoreMap":284},[218,942,944],{"id":943},"see-also","See also",[227,946,947,951,955],{},[230,948,949],{},[257,950,175],{"href":176},[230,952,953],{},[257,954,125],{"href":126},[230,956,957,920,963],{},[257,958,959,960],{"href":102},"REST ",[234,961,962],{},"/elements",[257,964,959,965],{"href":98},[234,966,967],{},"/categories",[969,970,971],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":284,"searchDepth":298,"depth":298,"links":973},[974,975,976,977],{"id":220,"depth":298,"text":221},{"id":578,"depth":298,"text":579},{"id":932,"depth":298,"text":933},{"id":943,"depth":298,"text":944},"The two-level vocabulary DTPR uses to describe data-collecting technologies.","md",null,{},true,{"title":179,"description":978},"gEl1gFI9uqey_wSsZdmg0C5IqTEVNEW52mg0YDFQYho",[986,988],{"title":175,"path":176,"stem":177,"description":987,"children":-1},"The DTPR instance that describes a data-collecting technology.",{"title":183,"path":184,"stem":185,"description":989,"children":-1},"Canonical version ids, aliases, status, and what \"release\" means for DTPR.",1776525922453]