@directus/app 9.0.0-rc.99 → 9.0.0

package/dist/assets/{relations.30bf1e5e.js → relations.7edadd3b.js}

@@ -1,4 +1,4 @@
-import{r as s,p as i,q as c,w as t,B as e,t as h,P as l}from"./vendor.a626ab9c.js";const d={class:"markdown-body"},p={class:"two-up"},u={class:"left"},_=l("What data is linked to what other data. Allows you to assign authors to articles, products to sales, and whatever other structures you can think of. "),g=l("Learn more about Relationships"),f=l("."),m=e("div",{class:"right"},[e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#the-relation-object"},"The Relation Object")]),e("li",null,[e("a",{href:"#list-relations"},"List relations")]),e("li",null,[e("a",{href:"#list-relations-in-collection"},"List relations in collection")]),e("li",null,[e("a",{href:"#retrieve-a-relation"},"Retrieve a relation")]),e("li",null,[e("a",{href:"#create-a-relation"},"Create a Relation")]),e("li",null,[e("a",{href:"#update-a-relation"},"Update a Relation")]),e("li",null,[e("a",{href:"#delete-a-relation"},"Delete a Relation")])])])])],-1),y=e("hr",null,null,-1),j=e("h2",{id:"the-relation-object"},[l("The Relation Object "),e("a",{class:"header-anchor",href:"#the-relation-object"},"#")],-1),b=e("div",{class:"two-up"},[e("div",{class:"left"},[e("div",{class:"definitions"},[e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection. This matches the table name in the database.")]),e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" Name of the field that holds the related primary key. This matches the column name in the database.")]),e("p",null,[e("code",null,"related_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the related collection. This matches the table name in the database.")])]),e("h4",{id:"meta"},[l("Meta "),e("a",{class:"header-anchor",href:"#meta"},"#")]),e("p",null,"Directus metadata. Used to enable non-database relationship types"),e("div",{class:"definitions"},[e("p",null,[e("code",null,"id"),l(),e("strong",null,"integer"),e("br"),l(" Primary key of the metadata row in "),e("code",null,"directus_relations"),l(".")]),e("p",null,[e("code",null,"many_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection. Matches the top level "),e("code",null,"collection"),l(" field.")]),e("p",null,[e("code",null,"many_field"),l(),e("strong",null,"string"),e("br"),l(" Name of the field. Matches the top level "),e("code",null,"field"),l(" field.")]),e("p",null,[e("code",null,"one_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the related collection. Matches the top level "),e("code",null,"related_collection"),l(" field.")]),e("p",null,[e("code",null,"one_field"),l(),e("strong",null,"string"),e("br"),l(" Name of the one to many field on the other side of the relation.")]),e("p",null,[e("code",null,"one_allowed_collections"),l(),e("strong",null,"string"),e("br"),l(" What collections are allowed to be used in a many-to-any context.")]),e("p",null,[e("code",null,"one_collection_field"),l(),e("strong",null,"string"),e("br"),l(" Field that holds the collection name in a many-to-any context.")]),e("p",null,[e("code",null,"one_deselect_action"),l(),e("strong",null,"nullify | delete"),e("br"),l(" Whether to nullify or delete related one-to-many records.")]),e("p",null,[e("code",null,"sort_field"),l(),e("strong",null,"string"),e("br"),l(" What field is used to hold the sort field.")]),e("p",null,[e("code",null,"junction_field"),l(),e("strong",null,"string"),e("br"),l(" What field connects two relations in a many-to-many (o2m-m2o) context.")])]),e("h4",{id:"schema"},[l("Schema "),e("a",{class:"header-anchor",href:"#schema"},"#")]),e("p",null,"\u201CRaw\u201D database information. Based on the database vendor used, different information might be returned. The following are available for all drivers."),e("div",{class:"definitions"},[e("p",null,[e("code",null,"table"),l(),e("strong",null,"string"),e("br"),l(" The table name.")]),e("p",null,[e("code",null,"column"),l(),e("strong",null,"string"),e("br"),l(" The column name.")]),e("p",null,[e("code",null,"foreign_key_table"),l(),e("strong",null,"string"),e("br"),l(" Related table name.")]),e("p",null,[e("code",null,"foreign_key_column"),l(),e("strong",null,"string"),e("br"),l(" Related column name.")]),e("p",null,[e("code",null,"constraint_name"),l(),e("strong",null,"string"),e("br"),l(" Name for the foreign key constraint.")]),e("p",null,[e("code",null,"on_update"),l(),e("strong",null,"string"),e("br"),l(" Update trigger for the foreign key constraint.")]),e("p",null,[e("code",null,"on_delete"),l(),e("strong",null,"string"),e("br"),l(" Delete trigger for the foreign key constraint.")])])]),e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[l(`{
+import{p as s,q as i,C as c,v as t,M as e,u as h,D as l}from"./vendor.299bc11c.js";const d={class:"markdown-body"},p={class:"two-up"},u={class:"left"},_=l("What data is linked to what other data. Allows you to assign authors to articles, products to sales, and whatever other structures you can think of. "),g=l("Learn more about Relationships"),f=l("."),m=e("div",{class:"right"},[e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#the-relation-object"},"The Relation Object")]),e("li",null,[e("a",{href:"#list-relations"},"List relations")]),e("li",null,[e("a",{href:"#list-relations-in-collection"},"List relations in collection")]),e("li",null,[e("a",{href:"#retrieve-a-relation"},"Retrieve a relation")]),e("li",null,[e("a",{href:"#create-a-relation"},"Create a Relation")]),e("li",null,[e("a",{href:"#update-a-relation"},"Update a Relation")]),e("li",null,[e("a",{href:"#delete-a-relation"},"Delete a Relation")])])])])],-1),y=e("hr",null,null,-1),j=e("h2",{id:"the-relation-object"},[l("The Relation Object "),e("a",{class:"header-anchor",href:"#the-relation-object"},"#")],-1),b=e("div",{class:"two-up"},[e("div",{class:"left"},[e("div",{class:"definitions"},[e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection. This matches the table name in the database.")]),e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" Name of the field that holds the related primary key. This matches the column name in the database.")]),e("p",null,[e("code",null,"related_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the related collection. This matches the table name in the database.")])]),e("h4",{id:"meta"},[l("Meta "),e("a",{class:"header-anchor",href:"#meta"},"#")]),e("p",null,"Directus metadata. Used to enable non-database relationship types"),e("div",{class:"definitions"},[e("p",null,[e("code",null,"id"),l(),e("strong",null,"integer"),e("br"),l(" Primary key of the metadata row in "),e("code",null,"directus_relations"),l(".")]),e("p",null,[e("code",null,"many_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection. Matches the top level "),e("code",null,"collection"),l(" field.")]),e("p",null,[e("code",null,"many_field"),l(),e("strong",null,"string"),e("br"),l(" Name of the field. Matches the top level "),e("code",null,"field"),l(" field.")]),e("p",null,[e("code",null,"one_collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the related collection. Matches the top level "),e("code",null,"related_collection"),l(" field.")]),e("p",null,[e("code",null,"one_field"),l(),e("strong",null,"string"),e("br"),l(" Name of the one to many field on the other side of the relation.")]),e("p",null,[e("code",null,"one_allowed_collections"),l(),e("strong",null,"string"),e("br"),l(" What collections are allowed to be used in a many-to-any context.")]),e("p",null,[e("code",null,"one_collection_field"),l(),e("strong",null,"string"),e("br"),l(" Field that holds the collection name in a many-to-any context.")]),e("p",null,[e("code",null,"one_deselect_action"),l(),e("strong",null,"nullify | delete"),e("br"),l(" Whether to nullify or delete related one-to-many records.")]),e("p",null,[e("code",null,"sort_field"),l(),e("strong",null,"string"),e("br"),l(" What field is used to hold the sort field.")]),e("p",null,[e("code",null,"junction_field"),l(),e("strong",null,"string"),e("br"),l(" What field connects two relations in a many-to-many (o2m-m2o) context.")])]),e("h4",{id:"schema"},[l("Schema "),e("a",{class:"header-anchor",href:"#schema"},"#")]),e("p",null,"\u201CRaw\u201D database information. Based on the database vendor used, different information might be returned. The following are available for all drivers."),e("div",{class:"definitions"},[e("p",null,[e("code",null,"table"),l(),e("strong",null,"string"),e("br"),l(" The table name.")]),e("p",null,[e("code",null,"column"),l(),e("strong",null,"string"),e("br"),l(" The column name.")]),e("p",null,[e("code",null,"foreign_key_table"),l(),e("strong",null,"string"),e("br"),l(" Related table name.")]),e("p",null,[e("code",null,"foreign_key_column"),l(),e("strong",null,"string"),e("br"),l(" Related column name.")]),e("p",null,[e("code",null,"constraint_name"),l(),e("strong",null,"string"),e("br"),l(" Name for the foreign key constraint.")]),e("p",null,[e("code",null,"on_update"),l(),e("strong",null,"string"),e("br"),l(" Update trigger for the foreign key constraint.")]),e("p",null,[e("code",null,"on_delete"),l(),e("strong",null,"string"),e("br"),l(" Delete trigger for the foreign key constraint.")])])]),e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[l(`{
 	`),e("span",{class:"hljs-attr"},'"collection"'),l(": "),e("span",{class:"hljs-string"},'"about_us"'),l(`,
 	`),e("span",{class:"hljs-attr"},'"field"'),l(": "),e("span",{class:"hljs-string"},'"logo"'),l(`,
 	`),e("span",{class:"hljs-attr"},'"related_collection"'),l(": "),e("span",{class:"hljs-string"},'"directus_files"'),l(`,
@@ -81,7 +81,7 @@ import{r as s,p as i,q as c,w as t,B as e,t as h,P as l}from"./vendor.a626ab9c.j
 		related_collection
 	}
 }
-`)])])])],-1),G=e("hr",null,null,-1),C=e("h2",{id:"update-a-relation"},[l("Update a Relation "),e("a",{class:"header-anchor",href:"#update-a-relation"},"#")],-1),I=e("p",null,"Update an existing relation.",-1),B=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"query-parameters-5"},[l("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-5"},"#")]),e("p",null,"Doesn\u2019t support any query parameters."),e("h3",{id:"request-body-2"},[l("Request Body "),e("a",{class:"header-anchor",href:"#request-body-2"},"#")]),e("p",null,[l("A partial "),e("a",{href:"#the-relation-object"},"relation object"),l(".")]),e("h3",{id:"returns-5"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns-5"},"#")]),e("p",null,[l("Returns the "),e("a",{href:"#the-relation-object"},"relation object"),l(" for the created relation.")])]),e("div",{class:"right"},[e("h3",{id:"rest-api-5"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),e("pre",null,[e("code",null,`PATCH /relations/:collection/:field
+`)])])])],-1),G=e("hr",null,null,-1),C=e("h2",{id:"update-a-relation"},[l("Update a Relation "),e("a",{class:"header-anchor",href:"#update-a-relation"},"#")],-1),I=e("p",null,"Update an existing relation.",-1),M=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"query-parameters-5"},[l("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-5"},"#")]),e("p",null,"Doesn\u2019t support any query parameters."),e("h3",{id:"request-body-2"},[l("Request Body "),e("a",{class:"header-anchor",href:"#request-body-2"},"#")]),e("p",null,[l("A partial "),e("a",{href:"#the-relation-object"},"relation object"),l(".")]),e("h3",{id:"returns-5"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns-5"},"#")]),e("p",null,[l("Returns the "),e("a",{href:"#the-relation-object"},"relation object"),l(" for the created relation.")])]),e("div",{class:"right"},[e("h3",{id:"rest-api-5"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),e("pre",null,[e("code",null,`PATCH /relations/:collection/:field
 `)]),e("h5",{id:"example-8"},[l("Example "),e("a",{class:"header-anchor",href:"#example-8"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// PATCH /relations/articles/author"),l(`
 
 {
@@ -100,7 +100,7 @@ import{r as s,p as i,q as c,w as t,B as e,t as h,P as l}from"./vendor.a626ab9c.j
 		related_collection
 	}
 }
-`)])])])],-1),M=e("hr",null,null,-1),W=e("h2",{id:"delete-a-relation"},[l("Delete a Relation "),e("a",{class:"header-anchor",href:"#delete-a-relation"},"#")],-1),U=e("p",null,"Delete an existing relation.",-1),F=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"returns-6"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns-6"},"#")]),e("p",null,"Empty body.")]),e("div",{class:"right"},[e("h3",{id:"rest-api-6"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api-6"},"#")]),e("pre",null,[e("code",null,`DELETE /relations/:collection/:field
+`)])])])],-1),W=e("hr",null,null,-1),B=e("h2",{id:"delete-a-relation"},[l("Delete a Relation "),e("a",{class:"header-anchor",href:"#delete-a-relation"},"#")],-1),U=e("p",null,"Delete an existing relation.",-1),F=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"returns-6"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns-6"},"#")]),e("p",null,"Empty body.")]),e("div",{class:"right"},[e("h3",{id:"rest-api-6"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api-6"},"#")]),e("pre",null,[e("code",null,`DELETE /relations/:collection/:field
 `)]),e("h5",{id:"example-10"},[l("Example "),e("a",{class:"header-anchor",href:"#example-10"},"#")]),e("pre",null,[e("code",null,`DELETE /relations/articles/author
 `)]),e("h3",{id:"graphql-6"},[l("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-6"},"#")]),e("pre",null,[e("code",null,`POST /graphql/system
 `)]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"type"),e("span",{class:"hljs-type"}," Mutation"),l(` {
@@ -112,4 +112,4 @@ import{r as s,p as i,q as c,w as t,B as e,t as h,P as l}from"./vendor.a626ab9c.j
 		field
 	}
 }
-`)])])])],-1),K={setup(V,{expose:n}){const a={title:"Relations",modularExtension:!1,pageClass:"page-reference"};return n({frontmatter:a}),(H,z)=>{const r=s("router-link"),o=s("DocsWrapper");return i(),c(o,{frontmatter:a},{default:t(()=>[e("div",d,[e("div",p,[e("div",u,[e("blockquote",null,[e("p",null,[_,h(r,{to:"/docs/concepts/relationships/"},{default:t(()=>[g]),_:1}),f])])]),m]),y,j,b,q,v,x,w,T,R,E,k,P,S,L,D,A,N,Q,O,G,C,I,B,M,W,U,F])]),_:1})}}};export{K as default};
+`)])])])],-1),K={setup(V,{expose:n}){const a={title:"Relations",modularExtension:!1,pageClass:"page-reference"};return n({frontmatter:a}),(H,z)=>{const r=s("router-link"),o=s("DocsWrapper");return i(),c(o,{frontmatter:a},{default:t(()=>[e("div",d,[e("div",p,[e("div",u,[e("blockquote",null,[e("p",null,[_,h(r,{to:"/docs/getting-started/glossary/#relationships"},{default:t(()=>[g]),_:1}),f])])]),m]),y,j,b,q,v,x,w,T,R,E,k,P,S,L,D,A,N,Q,O,G,C,I,M,W,B,U,F])]),_:1})}}};export{K as default};

package/dist/assets/relationships.eb259609.js

@@ -0,0 +1,58 @@
+import{p as s,q as c,C as h,v as n,M as e,u as l,D as t}from"./vendor.299bc11c.js";var d="assets/m2o.ac02ed03.png",u="assets/o2m.339378e0.png",f="assets/translations.2f0017a9.png",m="assets/translations-2.29d07342.png",_="assets/m2m.07bed843.png",p="assets/m2a.347ed339.png";const y={class:"markdown-body"},g=e("blockquote",null,[e("p",null,[t("As you might have guessed, relationships are a crucial part of any relational database. Directus supports all standard relationship types, as well as a few more "),e("em",null,"compound"),t(" types that offer greater flexibility.")])],-1),w=e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#many-to-one-(m2o)"},"Many-to-One (M2O)")]),e("li",null,[e("a",{href:"#one-to-many-(o2m)"},"One-to-Many (O2M)")]),e("li",null,[e("a",{href:"#translations-(o2m)"},"Translations (O2M)")]),e("li",null,[e("a",{href:"#many-to-many-(m2m)"},"Many-to-Many (M2M)")]),e("li",null,[e("a",{href:"#many-to-any-(m2a)"},"Many-to-Any (M2A)")]),e("li",null,[e("a",{href:"#one-to-one-(o2o)"},"One-to-One (O2O)")])])])],-1),M=e("h3",{id:"introduction"},[t("Introduction "),e("a",{class:"header-anchor",href:"#introduction"},"#")],-1),b=e("p",null,"While it may seem complex at first, relational data is actually quite straightforward once you understand what\u2019s happening behind the sometimes confusing terminology. Before diving into the details of each type, let\u2019s first cover a few basics that will help you better visualize them in your mind\u2019s eye.",-1),v=e("h3",{id:"primary-and-foreign-keys"},[t("Primary and Foreign Keys "),e("a",{class:"header-anchor",href:"#primary-and-foreign-keys"},"#")],-1),O=t("Every "),k=t("Item"),T=t(" in a relational database has a unique "),C=t("Primary Key"),x=t(" (or \u201CPK\u201D) that identifies it within its "),P=t("Collection"),j=t(". Because it\u2019s required, the key is the first "),A=t("field"),I=t(" created within a collection, typically storing an \u201Cauto-increment\u201D number, an automatically generated unique hash, or a manually entered value. They are often abbreviated to \u201CPK\u201D (Primary Key), \u201CID\u201D (Identifier), \u201CUID\u201D (Unique Identifier), or \u201CUUID\u201D (Universally Unique Identifier), depending on the type of value they store. After it\u2019s created, the value of an item\u2019s PK should "),D=e("em",null,"never",-1),K=t(" change."),S=e("p",null,[t("To link items together relationally, you simply save a reference to an item\u2019s PK in a different field. That "),e("em",null,"reference"),t(" is called a Foreign Key (FK). If the primary key is a "),e("em",null,"person"),t(", the foreign key is like their "),e("em",null,"business card"),t(". It references the actual person, providing just enough information to find them.")],-1),F=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Composite & Compound Keys"),e("p",null,[t("In the above explanation we\u2019ve ignored "),e("em",null,"composite"),t(" and "),e("em",null,"compound"),t(" keys, which are essentially unique keys created by combining "),e("em",null,"multiple"),t(" field/column values.")])],-1),R=e("h3",{id:"perspective-matters"},[t("Perspective Matters "),e("a",{class:"header-anchor",href:"#perspective-matters"},"#")],-1),q=e("p",null,"Just like primary and foreign keys, relationships are always described relative to their \u201Cparent\u201D collection. Looking at the same relationship/key from the perspective of the opposite collection would reverse it. This means that a many-to-one relationship can also be seen as a one-to-many relationship, it just depends on which collection is considered the parent.",-1),N=e("h2",{id:"many-to-one-(m2o)"},[t("Many-to-One (M2O) "),e("a",{class:"header-anchor",href:"#many-to-one-(m2o)"},"#")],-1),J=e("p",null,[t("The Many-to-One is the only relationship type with an actual field on the parent Collection. This field saves the foreign key to a single related item. For example, a "),e("em",null,"city"),t(" can only be in one "),e("em",null,"country"),t(", but a "),e("em",null,"country"),t(" can have many "),e("em",null,"cities"),t(".")],-1),W=e("p",null,"Below is an example of a M2O relationship:",-1),B=e("pre",null,[e("code",null,`cities (the "Many" Collection)
+- id (Primary Key)
+- name
+- country (the M2O field that stores the country key)
+
+countries (the "One" Collection)
+- id (Primary Key)
+- name
+`)],-1),Y=e("h3",{id:"setup"},[t("Setup "),e("a",{class:"header-anchor",href:"#setup"},"#")],-1),U=e("p",null,[e("img",{src:d,alt:"M2O"})],-1),L=e("p",null,"The parent collection and field are already known (it\u2019s the field you\u2019re currently creating), so configuring those are disabled. All you need to configure is the related collection and its primary key field.",-1),E=e("p",null,[t("If you select or enter an "),e("strong",null,"existing"),t(" Related Collection (highlights green) then the primary key field is known and automatically selected. If you enter the name of a "),e("strong",null,"new"),t(" Related Collection (doesn\u2019t already exist), you will also be prompted to enter the name of its primary key field, which will default to an auto-increment integer type.")],-1),H=e("p",null,[t("You also have the option to create a "),e("strong",null,"Corresponding Field"),t(" during this process. This allows you to more easily create the O2M alias (see below) that pairs with with this M2O.")],-1),V=e("p",null,[e("strong",null,"Relational Triggers"),t(" allow for control over what happens when a relationship is broken. There is one option:")],-1),z=e("ul",null,[e("li",null,[e("strong",null,"On Delete of [Related Collection]"),t(" \u2014 When the related item (O2M) is deleted\u2026 "),e("ul",null,[e("li",null,"Nullify the parent M2O field (default)"),e("li",null,"Set the parent M2O field to its default value"),e("li",null,"Delete the parent collection\u2019s item (cascade)"),e("li",null,"Prevent the deletion")])])],-1),G=e("h2",{id:"one-to-many-(o2m)"},[t("One-to-Many (O2M) "),e("a",{class:"header-anchor",href:"#one-to-many-(o2m)"},"#")],-1),Q=t("The One-to-Many relationship is the "),X=e("strong",null,"exact same relationship",-1),Z=t(" as a Many-to-One (above), just seen from the opposite collection\u2019s perspective. The O2M is stored as an "),$=t("Alias"),ee=t(" field on its parent Collection that dynamically lists all items connected via the opposite Many-to-One. So, while the M2O will show a single country for the parent city, the O2M shows all cities for the parent country."),te=e("p",null,"Below is an example of a O2M relationship:",-1),ne=e("pre",null,[e("code",null,`countries (the "One" Collection)
+- id (Primary Key)
+- name
+- *cities* (the O2M alias field that lists references from "cities.country")
+
+cities (the "Many" Collection)
+- id (Primary Key)
+- name
+- country (the M2O field that stores the country key)
+`)],-1),oe=e("h3",{id:"setup-2"},[t("Setup "),e("a",{class:"header-anchor",href:"#setup-2"},"#")],-1),le=e("p",null,[e("img",{src:u,alt:"O2M"})],-1),ie=e("p",null,"The parent collection and field are already known (it\u2019s the field you\u2019re currently creating), so configuring those are disabled. All you need to configure is the related collection and its M2O field.",-1),se=e("p",null,[t("You can select or enter an "),e("strong",null,"existing"),t(" Related Collection (highlights green) or create a "),e("strong",null,"new"),t(" one by entering a unique collection name. Next, you can select an existing field (highlights green) or create a new one by entering a field name unique to its collection.")],-1),ae=e("p",null,"The related field will store the value of this collection\u2019s primary key field, so both must have the same type. For this reason, when selecting existing fields, options will be disabled if they don\u2019t have a matching type.",-1),re=e("p",null,[t("You also have the option to create a "),e("strong",null,"Corresponding Field"),t(" during this process. This allows you to more easily create the M2O field (see above) that pairs with with this O2M.")],-1),ce=e("p",null,[t("The optional "),e("strong",null,"Sort Field"),t(" can be used enable manual reordering of items within this O2M field. This is configured by selecting an existing numeric type field (highlights green) from the Related Collection, or entering the name of a new field to be created.")],-1),he=e("p",null,[e("strong",null,"Relational Triggers"),t(" allow for control over what happens when a relationship is broken. There are two options:")],-1),de=e("ul",null,[e("li",null,[e("strong",null,"On Deselect of [Related Collection]"),t(" \u2014 When the value of the M2O is deselected\u2026 "),e("ul",null,[e("li",null,"Nullify the M2O field value (default)"),e("li",null,"Delete the M2O item (cascade)")])]),e("li",null,[e("strong",null,"On Delete of [Parent Collection Item]"),t(" \u2014 When this O2M item is deleted\u2026 "),e("ul",null,[e("li",null,"Nullify the related M2O field (default)"),e("li",null,"Set the related M2O field to its default value"),e("li",null,"Delete the related collection\u2019s item (cascade)"),e("li",null,"Prevent the deletion")])])],-1),ue=e("h2",{id:"translations-(o2m)"},[t("Translations (O2M) "),e("a",{class:"header-anchor",href:"#translations-(o2m)"},"#")],-1),fe=t("The Translations relationship is just a special version of the standard O2M. Just like the O2M, it creates an "),me=t("Alias"),_e=t(" field that is used to list all related items (the translations). Translations themselves are stored in a separate collection, which is then further related to "),pe=e("em",null,"third",-1),ye=t(" collection that stores all languages."),ge=e("h3",{id:"setup-3"},[t("Setup "),e("a",{class:"header-anchor",href:"#setup-3"},"#")],-1),we=e("p",null,[e("img",{src:f,alt:"Translations"})],-1),Me=e("p",null,"The easiest way to add translations is to use the wizard, which only asks for the Translation field name. All required fields and relationships will then be automatically created and configured.",-1),be=e("p",null,[e("img",{src:m,alt:"Translations"})],-1),ve=e("p",null,[t("If you choose to switch to "),e("strong",null,"manual setup"),t(", you will be presented with a similar relationship setup to O2M or M2M. The parent collection and primary key are know, so those fields are disabled.")],-1),Oe=e("p",null,"Next, we configure the Translation Collection. Set to \u201CAuto Fill\u201D by default, this will enter intelligent naming based on related names, and disables all fields. Disabling Auto Fill will enable all fields, allowing you to name the collection that holds the translations, as well as the two fields (each a M2O) that store foreign keys to the parent item and language.",-1),ke=e("p",null,[t("Lastly, you would select/create the Languages collection, which stores the languages available for this translations field. It is common practice to reuse a single languages collection throughout your project, unless translation fields need to support different language sets. For the language "),e("code",null,"code"),t(" we recommend using the IETF language tag (eg: "),e("code",null,"en-US"),t(") which combines the ISO 639-1 and ISO 3166\u20111 standards, but anything can be used (eg: "),e("code",null,"english"),t(").")],-1),Te=e("h2",{id:"many-to-many-(m2m)"},[t("Many-to-Many (M2M) "),e("a",{class:"header-anchor",href:"#many-to-many-(m2m)"},"#")],-1),Ce=t("The Many-to-Many relationship is actually just "),xe=e("strong",null,"two relationships combined",-1),Pe=t(" (O2M+M2O) that join together three different collections. The M2M is stored as an "),je=t("Alias"),Ae=t(" field on its parent Collection that dynamically lists all items connected via a "),Ie=t("junction collection"),De=t(". For example, a "),Ke=e("em",null,"recipe",-1),Se=t(" can have many "),Fe=e("em",null,"ingredients",-1),Re=t(", and "),qe=e("em",null,"ingredients",-1),Ne=t(" can be in many "),Je=e("em",null,"recipes",-1),We=t("."),Be=e("p",null,"Below is an example of a M2M relationship:",-1),Ye=e("pre",null,[e("code",null,`recipes (Collection)
+- id (Primary Key)
+- name
+- *ingredients* (M2M/O2M alias field that lists references from "recipe_ingredients")
+
+ingredients (Collection)
+- id (Primary Key)
+- name
+- *recipes* (M2M/O2M alias field that lists references from "recipe_ingredients")
+
+recipe_ingredients (Junction Collection)
+- id (Primary Key)
+- recipe (stores the recipe key)
+- ingredient (stores ingredient key)
+- quantity (other optional data on the connection)
+`)],-1),Ue=e("p",null,[t("Notice that the example above also has a "),e("code",null,"quantity"),t(" field on the Junction Collection, which tracks how much of each ingredient is needed for the recipe. You can add any other "),e("em",null,"contextual"),t(" fields to the junction, and they will also be included at the top of the App\u2019s relational Item Page form.")],-1),Le=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Self-Referencing"),e("p",null,[t("You can also have a M2M relationship that connects items within the "),e("em",null,"same"),t(" collection. An example of this is \u201CRelated Articles\u201D, where an article might relate to many other articles.")])],-1),Ee=e("h3",{id:"setup-4"},[t("Setup "),e("a",{class:"header-anchor",href:"#setup-4"},"#")],-1),He=e("p",null,[e("img",{src:_,alt:"M2M"})],-1),Ve=e("p",null,"The parent collection and field are already known (it\u2019s the field you\u2019re currently creating), so configuring those are disabled.",-1),ze=e("p",null,[t("Next you should configure the Related Collection. If you select or enter an "),e("strong",null,"existing"),t(" Related Collection (highlights green) then the primary key field is known and automatically selected. If you enter the name of a "),e("strong",null,"new"),t(" Related Collection (doesn\u2019t already exist), you will also be prompted to enter the name of its primary key field, which will default to an auto-increment integer type.")],-1),Ge=t("Lastly, we configure the "),Qe=t("Junction Collection"),Xe=t(", which sits between the two related collections, storing all links between the two. You can leave this set to \u201CAuto-Fill\u201D, which sets intelligent naming defaults, or disable it to select existing options or enter custom names."),Ze=e("p",null,[t("You also have the option to create a "),e("strong",null,"Corresponding Field"),t(" during this process. This allows you to more easily create the reverse M2M field on the "),e("em",null,"related"),t(" collection.")],-1),$e=e("p",null,[t("The optional "),e("strong",null,"Sort Field"),t(" can be used enable manual reordering of items within this O2M field. This is configured by selecting an existing numeric type field (highlights green) from the Junction Collection, or entering the name of a new field to be created.")],-1),et=e("p",null,[e("strong",null,"Relational Triggers"),t(" allow for control over what happens when a relationship is broken. There are three options:")],-1),tt=e("ul",null,[e("li",null,[e("strong",null,"On Deselect of [Junction Collection]"),t(" \u2014 When the value of this M2M is deselected\u2026 "),e("ul",null,[e("li",null,"Nullify the junction field (default)"),e("li",null,"Delete the junction item (cascade)")])]),e("li",null,[e("strong",null,"On Delete of [Parent Collection Item]"),t(" \u2014 When this M2M item is deleted\u2026 "),e("ul",null,[e("li",null,"Nullify the junction field (default)"),e("li",null,"Set the junction field to its default value"),e("li",null,"Delete the related junction item (cascade)"),e("li",null,"Prevent the deletion")])]),e("li",null,[e("strong",null,"On Delete of [Related Collection Item]"),t(" \u2014 When the related M2M item is deleted\u2026 "),e("ul",null,[e("li",null,"Nullify the junction field (default)"),e("li",null,"Set the junction field to its default value"),e("li",null,"Delete the related junction item (cascade)"),e("li",null,"Prevent the deletion")])])],-1),nt=e("h2",{id:"many-to-any-(m2a)"},[t("Many-to-Any (M2A) "),e("a",{class:"header-anchor",href:"#many-to-any-(m2a)"},"#")],-1),ot=t("Sometimes called a \u201Cmatrix field\u201D or \u201Creplicator\u201D. Like the M2M, the M2A is stored as an "),lt=t("Alias"),it=t(" field on its parent Collection that dynamically lists all items connected via a "),st=t("junction collection"),at=t(". However, there is one key difference: one side of the junction also stores a "),rt=e("strong",null,"collection key",-1),ct=t(". This combination of collection name and primary key means that you can effectively store a reference to "),ht=e("em",null,"any",-1),dt=t(" item in the database. You can then artificially limit which collections are valid through an related collections \u201Callow list\u201D."),ut=e("p",null,[t("An common example of a M2A is a \u201CPage Builder\u201D, which has a "),e("em",null,"Pages"),t(" collection that includes any number of different \u201Csection\u201D Collections, such as: \u201CHeading\u201D, \u201CText\u201D, and \u201CImage\u201D. In this example the junction table will link different sections (from different collections) with a page, creating relational layouts.")],-1),ft=e("p",null,"Below is an example of a M2A relationship:",-1),mt=e("pre",null,[e("code",null,`pages (Collection)
+- id (Primary Key)
+- name
+- *sections* (O2M/M2A alias field that lists references from "sections")
+
+headings (Collection)
+- id (Primary Key)
+- title
+- *section* (alias field that lists references from "sections")
+
+text (Collection)
+- id (Primary Key)
+- text
+- *section* (alias field that lists references from "sections")
+
+images (Collection)
+- id (Primary Key)
+- file
+- *section* (alias field that lists references from "sections")
+
+page_sections (Junction Collection)
+- id (Primary Key)
+- page (stores the page key)
+- section (stores section key)
+- section_collection (determines which collection the section_id belongs to)
+`)],-1),_t=e("h3",{id:"setup-5"},[t("Setup "),e("a",{class:"header-anchor",href:"#setup-5"},"#")],-1),pt=e("p",null,[e("img",{src:p,alt:"M2A"})],-1),yt=e("p",null,"The parent collection and field are already known (it\u2019s the field you\u2019re currently creating), so configuring those are disabled.",-1),gt=t("Next, we configure the "),wt=t("Junction Collection"),Mt=t(", which sits between the related collections, storing all links between them. You can leave this set to \u201CAuto-Fill\u201D, which sets intelligent naming defaults, or disable it to select existing options or enter custom names."),bt=e("p",null,[t("Lastly, you should select any desired Related Collections. Unlike other relationships, you can\u2019t "),e("em",null,"create"),t(" these related collections here, so ensure all related collections you need are created before hand.")],-1),vt=e("p",null,[t("The optional "),e("strong",null,"Sort Field"),t(" can be used enable manual reordering of items within this M2A field. This is configured by selecting an existing numeric type field (highlights green) from the Junction Collection, or entering the name of a new field to be created.")],-1),Ot=e("p",null,[e("strong",null,"Relational Triggers"),t(" allow for control over what happens when a relationship is broken. There are three options:")],-1),kt=e("ul",null,[e("li",null,[e("strong",null,"On Delete of [Parent Collection Item]"),t(" \u2014 When a M2A item is deleted\u2026 "),e("ul",null,[e("li",null,"Nullify the junction field (default)"),e("li",null,"Set the junction field to its default value"),e("li",null,"Delete the related junction item (cascade)"),e("li",null,"Prevent the deletion")])]),e("li",null,[e("strong",null,"On Deselect of [Junction Collection]"),t(" \u2014 When the value of this M2A is deselected\u2026 "),e("ul",null,[e("li",null,"Nullify the junction field (default)"),e("li",null,"Delete the junction item (cascade)")])])],-1),Tt=e("h2",{id:"one-to-one-(o2o)"},[t("One-to-One (O2O) "),e("a",{class:"header-anchor",href:"#one-to-one-(o2o)"},"#")],-1),Ct=t("Directus does not include a dedicated One-to-One (O2O) relationship type or interface. However, O2O is essentially the same as a M2O (storing a foreign key). The only difference is that a O2O enforces the cardinality. In other words, selecting a relational item in a O2O means that item can not be selected elsewhere (it can only be used once). This functionality can be added by checking and constraining uniqueness via a "),xt=t("custom event hook"),Pt=t(" or "),jt=t("custom interface"),At=t("."),It=e("p",null,[t("An example of this is a "),e("em",null,"person"),t(" only has one unique set of "),e("em",null,"fingerprints"),t(", and those "),e("em",null,"fingerprints"),t(" only belong to one "),e("em",null,"person"),t(".")],-1),Rt={setup(Dt,{expose:a}){const i={title:"Relationships",modularExtension:!1};return a({frontmatter:i}),(Kt,St)=>{const o=s("router-link"),r=s("DocsWrapper");return c(),h(r,{frontmatter:i},{default:n(()=>[e("div",y,[g,w,M,b,v,e("p",null,[O,l(o,{to:"/docs/getting-started/glossary/#items"},{default:n(()=>[k]),_:1}),T,l(o,{to:"/docs/getting-started/glossary/#primary-key-pk"},{default:n(()=>[C]),_:1}),x,l(o,{to:"/docs/getting-started/glossary/#collections"},{default:n(()=>[P]),_:1}),j,l(o,{to:"/docs/getting-started/glossary/#fields"},{default:n(()=>[A]),_:1}),I,D,K]),S,F,R,q,N,J,W,B,Y,U,L,E,H,V,z,G,e("p",null,[Q,X,Z,l(o,{to:"/docs/getting-started/glossary/#alias"},{default:n(()=>[$]),_:1}),ee]),te,ne,oe,le,ie,se,ae,re,ce,he,de,ue,e("p",null,[fe,l(o,{to:"/docs/getting-started/glossary/#alias"},{default:n(()=>[me]),_:1}),_e,pe,ye]),ge,we,Me,be,ve,Oe,ke,Te,e("p",null,[Ce,xe,Pe,l(o,{to:"/docs/getting-started/glossary/#alias"},{default:n(()=>[je]),_:1}),Ae,l(o,{to:"/docs/getting-started/glossary/#junction-collections"},{default:n(()=>[Ie]),_:1}),De,Ke,Se,Fe,Re,qe,Ne,Je,We]),Be,Ye,Ue,Le,Ee,He,Ve,ze,e("p",null,[Ge,l(o,{to:"/docs/getting-started/glossary/#junction-collections"},{default:n(()=>[Qe]),_:1}),Xe]),Ze,$e,et,tt,nt,e("p",null,[ot,l(o,{to:"/docs/getting-started/glossary/#alias"},{default:n(()=>[lt]),_:1}),it,l(o,{to:"/docs/getting-started/glossary/#junction-collections"},{default:n(()=>[st]),_:1}),at,rt,ct,ht,dt]),ut,ft,mt,_t,pt,yt,e("p",null,[gt,l(o,{to:"/docs/getting-started/glossary/#junction-collections"},{default:n(()=>[wt]),_:1}),Mt]),bt,vt,Ot,kt,Tt,e("p",null,[Ct,l(o,{to:"/docs/extensions/hooks/"},{default:n(()=>[xt]),_:1}),Pt,l(o,{to:"/docs/extensions/interfaces/"},{default:n(()=>[jt]),_:1}),At]),It])]),_:1})}}};export{Rt as default};

package/dist/assets/{revisions.78c66006.js → revisions.9a70b1ec.js}

@@ -1,4 +1,4 @@
-import{r as l,p as c,q as h,w as t,B as s,t as o,P as e}from"./vendor.a626ab9c.js";const d={class:"markdown-body"},_={class:"two-up"},p={class:"left"},u=e("Revisions are individual changes to items made. Directus keeps track of changes made, so you\u2019re able to revert to a previous state at will. "),v=e("Learn more about Revisions"),m=e("."),f=s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#the-revision-object"},"The Revision Object")]),s("li",null,[s("a",{href:"#list-revisions"},"List revisions")]),s("li",null,[s("a",{href:"#retrieve-a-revision"},"Retrieve a revision")])])])])],-1),y=s("hr",null,null,-1),g=s("h2",{id:"the-revision-object"},[e("The Revision Object "),s("a",{class:"header-anchor",href:"#the-revision-object"},"#")],-1),b={class:"two-up"},j={class:"left"},q={class:"definitions"},x=s("p",null,[s("code",null,"id"),e(),s("strong",null,"integer"),s("br"),e(" Primary key of the revision.")],-1),w=s("code",null,"activity",-1),k=e(),R=s("strong",null,"many-to-one",-1),E=s("br",null,null,-1),P=e(" Related activity record. Many-to-one to "),T=e("activity"),S=e("."),L=s("p",null,[s("code",null,"collection"),e(),s("strong",null,"string"),s("br"),e(" Collection in which this revision happened.")],-1),C=s("p",null,[s("code",null,"item"),e(),s("strong",null,"string"),s("br"),e(" Primary key of the item that was changed.")],-1),D=s("p",null,[s("code",null,"data"),e(),s("strong",null,"object"),s("br"),e(" Snapshot of the top-level item data.")],-1),Q=s("p",null,[s("code",null,"delta"),e(),s("strong",null,"object"),s("br"),e(" Snapshot of the changes made in this revision.")],-1),A=s("p",null,[s("code",null,"parent"),e(),s("strong",null,"many-to-one"),s("br"),e(" Parent revision that triggered this revision. Many-to-one to revisions (recursive).")],-1),G=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[e(`{
+import{p as l,q as c,C as h,v as t,M as s,u as o,D as e}from"./vendor.299bc11c.js";const d={class:"markdown-body"},_={class:"two-up"},p={class:"left"},u=e("Revisions are individual changes to items made. Directus keeps track of changes made, so you\u2019re able to revert to a previous state at will. "),v=e("Learn more about Revisions"),m=e("."),f=s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#the-revision-object"},"The Revision Object")]),s("li",null,[s("a",{href:"#list-revisions"},"List revisions")]),s("li",null,[s("a",{href:"#retrieve-a-revision"},"Retrieve a revision")])])])])],-1),g=s("hr",null,null,-1),y=s("h2",{id:"the-revision-object"},[e("The Revision Object "),s("a",{class:"header-anchor",href:"#the-revision-object"},"#")],-1),b={class:"two-up"},j={class:"left"},q={class:"definitions"},x=s("p",null,[s("code",null,"id"),e(),s("strong",null,"integer"),s("br"),e(" Primary key of the revision.")],-1),k=s("code",null,"activity",-1),w=e(),R=s("strong",null,"many-to-one",-1),E=s("br",null,null,-1),T=e(" Related activity record. Many-to-one to "),P=e("activity"),S=e("."),L=s("p",null,[s("code",null,"collection"),e(),s("strong",null,"string"),s("br"),e(" Collection in which this revision happened.")],-1),C=s("p",null,[s("code",null,"item"),e(),s("strong",null,"string"),s("br"),e(" Primary key of the item that was changed.")],-1),D=s("p",null,[s("code",null,"data"),e(),s("strong",null,"object"),s("br"),e(" Snapshot of the top-level item data.")],-1),Q=s("p",null,[s("code",null,"delta"),e(),s("strong",null,"object"),s("br"),e(" Snapshot of the changes made in this revision.")],-1),A=s("p",null,[s("code",null,"parent"),e(),s("strong",null,"many-to-one"),s("br"),e(" Parent revision that triggered this revision. Many-to-one to revisions (recursive).")],-1),G=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[e(`{
 	`),s("span",{class:"hljs-attr"},'"id"'),e(": "),s("span",{class:"hljs-number"},"368"),e(`,
 	`),s("span",{class:"hljs-attr"},'"activity"'),e(": "),s("span",{class:"hljs-number"},"438"),e(`,
 	`),s("span",{class:"hljs-attr"},'"collection"'),e(": "),s("span",{class:"hljs-string"},'"articles"'),e(`,
@@ -11,20 +11,20 @@ import{r as l,p as c,q as h,w as t,B as s,t as o,P as e}from"./vendor.a626ab9c.j
 	},
 	`),s("span",{class:"hljs-attr"},'"parent"'),e(": "),s("span",{class:"hljs-literal"},"null"),e(`
 }
-`)])])],-1),B=s("hr",null,null,-1),H=s("h2",{id:"list-revisions"},[e("List revisions "),s("a",{class:"header-anchor",href:"#list-revisions"},"#")],-1),I=s("p",null,"List all revisions that exist in Directus.",-1),O={class:"two-up"},N={class:"left"},V=s("div",{class:"tip hint"},[s("div",{class:"hint-title"},"Permissions"),s("p",null,"The data returned in this endpoint will be filtered based on the user\u2019s permissions. For example, revisions that apply to a collection that the current user doesn\u2019t have access to are stripped out.")],-1),W=s("h3",{id:"query-parameters"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters"},"#")],-1),M=e("Supports all "),F=e("global query parameters"),z=e("."),J=s("h3",{id:"returns"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns"},"#")],-1),K=e("An array of up to "),U=e("limit"),X=e(),Y=s("a",{href:"#the-revision-object"},"revision objects",-1),Z=e(". If no items are available, data will be an empty array."),$={class:"right"},ss=s("h3",{id:"rest-api"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api"},"#")],-1),es=s("pre",null,[s("code",null,`GET /revisions
+`)])])],-1),H=s("hr",null,null,-1),I=s("h2",{id:"list-revisions"},[e("List revisions "),s("a",{class:"header-anchor",href:"#list-revisions"},"#")],-1),O=s("p",null,"List all revisions that exist in Directus.",-1),B={class:"two-up"},M={class:"left"},N=s("div",{class:"tip hint"},[s("div",{class:"hint-title"},"Permissions"),s("p",null,"The data returned in this endpoint will be filtered based on the user\u2019s permissions. For example, revisions that apply to a collection that the current user doesn\u2019t have access to are stripped out.")],-1),V=s("h3",{id:"query-parameters"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters"},"#")],-1),W=e("Supports all "),F=e("global query parameters"),z=e("."),J=s("h3",{id:"returns"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns"},"#")],-1),K=e("An array of up to "),U=e("limit"),X=e(),Y=s("a",{href:"#the-revision-object"},"revision objects",-1),Z=e(". If no items are available, data will be an empty array."),$={class:"right"},ss=s("h3",{id:"rest-api"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api"},"#")],-1),es=s("pre",null,[s("code",null,`GET /revisions
 SEARCH /revisions
 `)],-1),ts=e("Learn more about SEARCH ->"),ns=s("h3",{id:"graphql"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql"},"#")],-1),os=s("pre",null,[s("code",null,`POST /graphql/system
 `)],-1),as=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
 	revisions: [directus_revisions]
 }
-`)])],-1),ls=s("h5",{id:"examples"},[e("Examples "),s("a",{class:"header-anchor",href:"#examples"},"#")],-1),is=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
+`)])],-1),ls=s("h5",{id:"examples"},[e("Examples "),s("a",{class:"header-anchor",href:"#examples"},"#")],-1),rs=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
 	revisions {
 		id
 		data
 		delta
 	}
 }
-`)])],-1),rs=s("hr",null,null,-1),cs=s("h2",{id:"retrieve-a-revision"},[e("Retrieve a revision "),s("a",{class:"header-anchor",href:"#retrieve-a-revision"},"#")],-1),hs=s("p",null,"List an existing revision by primary key.",-1),ds={class:"two-up"},_s={class:"left"},ps=s("h3",{id:"query-parameters-2"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-2"},"#")],-1),us=e("Supports all "),vs=e("global query parameters"),ms=e("."),fs=s("h3",{id:"returns-2"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-2"},"#")],-1),ys=s("p",null,[e("Returns the requested "),s("a",{href:"#the-revision-object"},"revision object"),e(".")],-1),gs=s("div",{class:"right"},[s("h3",{id:"rest-api-2"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-2"},"#")]),s("pre",null,[s("code",null,`GET /revisions/:id
+`)])],-1),is=s("hr",null,null,-1),cs=s("h2",{id:"retrieve-a-revision"},[e("Retrieve a revision "),s("a",{class:"header-anchor",href:"#retrieve-a-revision"},"#")],-1),hs=s("p",null,"List an existing revision by primary key.",-1),ds={class:"two-up"},_s={class:"left"},ps=s("h3",{id:"query-parameters-2"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-2"},"#")],-1),us=e("Supports all "),vs=e("global query parameters"),ms=e("."),fs=s("h3",{id:"returns-2"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-2"},"#")],-1),gs=s("p",null,[e("Returns the requested "),s("a",{href:"#the-revision-object"},"revision object"),e(".")],-1),ys=s("div",{class:"right"},[s("h3",{id:"rest-api-2"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-2"},"#")]),s("pre",null,[s("code",null,`GET /revisions/:id
 `)]),s("h5",{id:"example"},[e("Example "),s("a",{class:"header-anchor",href:"#example"},"#")]),s("pre",null,[s("code",null,`GET /revisions/322
 `)]),s("h3",{id:"graphql-2"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql-2"},"#")]),s("pre",null,[s("code",null,`POST /graphql/system
 `)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
@@ -37,4 +37,4 @@ SEARCH /revisions
 		delta
 	}
 }
-`)])])],-1),ws={setup(bs,{expose:i}){const a={title:"Revisions",modularExtension:!1,pageClass:"page-reference"};return i({frontmatter:a}),(js,qs)=>{const n=l("router-link"),r=l("DocsWrapper");return c(),h(r,{frontmatter:a},{default:t(()=>[s("div",d,[s("div",_,[s("div",p,[s("blockquote",null,[s("p",null,[u,o(n,{to:"/docs/concepts/revisions/"},{default:t(()=>[v]),_:1}),m])])]),f]),y,g,s("div",b,[s("div",j,[s("div",q,[x,s("p",null,[w,k,R,E,P,o(n,{to:"/docs/reference/api/system/activity/"},{default:t(()=>[T]),_:1}),S]),L,C,D,Q,A])]),G]),B,H,I,s("div",O,[s("div",N,[V,W,s("p",null,[M,o(n,{to:"/docs/reference/api/query"},{default:t(()=>[F]),_:1}),z]),J,s("p",null,[K,o(n,{to:"/docs/reference/api/query/#limit"},{default:t(()=>[U]),_:1}),X,Y,Z])]),s("div",$,[ss,es,s("p",null,[o(n,{to:"/docs/reference/api/introduction/#search-http-method"},{default:t(()=>[ts]),_:1})]),ns,os,as,ls,is])]),rs,cs,hs,s("div",ds,[s("div",_s,[ps,s("p",null,[us,o(n,{to:"/docs/reference/api/query"},{default:t(()=>[vs]),_:1}),ms]),fs,ys]),gs])])]),_:1})}}};export{ws as default};
+`)])])],-1),ks={setup(bs,{expose:r}){const a={title:"Revisions",modularExtension:!1,pageClass:"page-reference"};return r({frontmatter:a}),(js,qs)=>{const n=l("router-link"),i=l("DocsWrapper");return c(),h(i,{frontmatter:a},{default:t(()=>[s("div",d,[s("div",_,[s("div",p,[s("blockquote",null,[s("p",null,[u,o(n,{to:"/docs/getting-started/glossary/#revisions"},{default:t(()=>[v]),_:1}),m])])]),f]),g,y,s("div",b,[s("div",j,[s("div",q,[x,s("p",null,[k,w,R,E,T,o(n,{to:"/docs/reference/system/activity/"},{default:t(()=>[P]),_:1}),S]),L,C,D,Q,A])]),G]),H,I,O,s("div",B,[s("div",M,[N,V,s("p",null,[W,o(n,{to:"/docs/reference/query"},{default:t(()=>[F]),_:1}),z]),J,s("p",null,[K,o(n,{to:"/docs/reference/query/#limit"},{default:t(()=>[U]),_:1}),X,Y,Z])]),s("div",$,[ss,es,s("p",null,[o(n,{to:"/docs/reference/introduction/#search-http-method"},{default:t(()=>[ts]),_:1})]),ns,os,as,ls,rs])]),is,cs,hs,s("div",ds,[s("div",_s,[ps,s("p",null,[us,o(n,{to:"/docs/reference/query"},{default:t(()=>[vs]),_:1}),ms]),fs,gs]),ys])])]),_:1})}}};export{ks as default};

package/dist/assets/ro.1786958f.js

@@ -1 +1 @@
-function u(e,a){return a.forEach(function(r){Object.keys(r).forEach(function(t){if(t!=="default"&&!(t in e)){var n=Object.getOwnPropertyDescriptor(r,t);Object.defineProperty(e,t,n.get?n:{enumerable:!0,get:function(){return r[t]}})}})}),Object.freeze(e)}var o={};Object.defineProperty(o,"__esModule",{value:!0});var i={code:"ro",week:{dow:1,doy:7},buttonText:{prev:"precedent\u0103",next:"urm\u0103toare",today:"Azi",month:"Lun\u0103",week:"S\u0103pt\u0103m\xE2n\u0103",day:"Zi",list:"Agend\u0103"},weekText:"S\u0103pt",allDayText:"Toat\u0103 ziua",moreLinkText:function(e){return"+alte "+e},noEventsText:"Nu exist\u0103 evenimente de afi\u0219at"},c=o.default=i,f=Object.freeze(u({__proto__:null,[Symbol.toStringTag]:"Module",default:c},[o]));export{f as r};
+function u(t,a){return a.forEach(function(e){e&&typeof e!="string"&&!Array.isArray(e)&&Object.keys(e).forEach(function(r){if(r!=="default"&&!(r in t)){var n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:function(){return e[r]}})}})}),Object.freeze(t)}var o={};Object.defineProperty(o,"__esModule",{value:!0});var i={code:"ro",week:{dow:1,doy:7},buttonText:{prev:"precedent\u0103",next:"urm\u0103toare",today:"Azi",month:"Lun\u0103",week:"S\u0103pt\u0103m\xE2n\u0103",day:"Zi",list:"Agend\u0103"},weekText:"S\u0103pt",allDayText:"Toat\u0103 ziua",moreLinkText:function(t){return"+alte "+t},noEventsText:"Nu exist\u0103 evenimente de afi\u0219at"},f=o.default=i,c=Object.freeze(u({__proto__:null,[Symbol.toStringTag]:"Module",default:f},[o]));export{c as r};

package/dist/assets/{roles.b691aabb.js → roles.f017240c.js}

@@ -1,22 +1,21 @@
-import{r,p as h,q as i,w as l,B as s,t,P as e}from"./vendor.a626ab9c.js";const d={class:"markdown-body"},p={class:"two-up"},u={class:"left"},_=e("Roles define a specific set of access permissions, and are the primary organizational structure for Users within the platform. "),f=e("Learn more about Roles"),m=e("."),g=s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#the-role-object"},"The Role Object")]),s("li",null,[s("a",{href:"#list-roles"},"List Roles")]),s("li",null,[s("a",{href:"#retrieve-a-role"},"Retrieve a Role")]),s("li",null,[s("a",{href:"#create-a-role"},"Create a Role")]),s("li",null,[s("a",{href:"#create-multiple-roles"},"Create Multiple Roles")]),s("li",null,[s("a",{href:"#update-a-role"},"Update a Role")]),s("li",null,[s("a",{href:"#update-multiple-roles"},"Update Multiple Roles")]),s("li",null,[s("a",{href:"#delete-a-role"},"Delete a Role")]),s("li",null,[s("a",{href:"#delete-multiple-roles"},"Delete Multiple Roles")])])])])],-1),j=s("hr",null,null,-1),y=s("h2",{id:"the-role-object"},[e("The Role Object "),s("a",{class:"header-anchor",href:"#the-role-object"},"#")],-1),b={class:"two-up"},q={class:"left"},x={class:"definitions"},v=s("p",null,[s("code",null,"id"),e(),s("strong",null,"uuid"),s("br"),e(" Primary key of the role.")],-1),R=s("p",null,[s("code",null,"name"),e(),s("strong",null,"string"),s("br"),e(" Name of the role.")],-1),E=s("p",null,[s("code",null,"icon"),e(),s("strong",null,"string"),s("br"),e(" Icon for the role. Displayed in the Admin App.")],-1),T=s("p",null,[s("code",null,"description"),e(),s("strong",null,"string"),s("br"),e(" Description for the role. Displayed in the Admin App.")],-1),w=s("p",null,[s("code",null,"ip_access"),e(),s("strong",null,"csv"),s("br"),e(" CSV of IP addresses that have access to this role. Allows you to configure an allowlist of IP addresses.")],-1),P=s("p",null,[s("code",null,"enforce_tfa"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not Two-Factor Authentication is required for users in this role.")],-1),A=s("p",null,[s("code",null,"collection_list"),e(),s("strong",null,"object"),s("br"),e(" Override for the collection listing in the navigation of the collections module in the Admin App.")],-1),k=s("p",null,[s("code",null,"admin_access"),e(),s("strong",null,"boolean"),s("br"),e(" If this role is considered an admin role. This means that users in this role have full permissions to everything.")],-1),S=s("p",null,[s("code",null,"app_access"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not users in this role have access to use the Admin App.")],-1),I=s("code",null,"users",-1),D=e(),C=s("strong",null,"one-to-many",-1),L=s("br",null,null,-1),O=e(" The users in this role. One-to-many to "),Q=e("users"),M=e("."),G=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[e(`{
+import{p as r,q as h,C as d,v as l,M as s,u as t,D as e}from"./vendor.299bc11c.js";const i={class:"markdown-body"},p={class:"two-up"},u={class:"left"},_=e("Roles define a specific set of access permissions, and are the primary organizational structure for Users within the platform. "),f=e("Learn more about Roles"),m=e("."),g=s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#the-role-object"},"The Role Object")]),s("li",null,[s("a",{href:"#list-roles"},"List Roles")]),s("li",null,[s("a",{href:"#retrieve-a-role"},"Retrieve a Role")]),s("li",null,[s("a",{href:"#create-a-role"},"Create a Role")]),s("li",null,[s("a",{href:"#create-multiple-roles"},"Create Multiple Roles")]),s("li",null,[s("a",{href:"#update-a-role"},"Update a Role")]),s("li",null,[s("a",{href:"#update-multiple-roles"},"Update Multiple Roles")]),s("li",null,[s("a",{href:"#delete-a-role"},"Delete a Role")]),s("li",null,[s("a",{href:"#delete-multiple-roles"},"Delete Multiple Roles")])])])])],-1),j=s("hr",null,null,-1),y=s("h2",{id:"the-role-object"},[e("The Role Object "),s("a",{class:"header-anchor",href:"#the-role-object"},"#")],-1),b={class:"two-up"},q={class:"left"},x={class:"definitions"},v=s("p",null,[s("code",null,"id"),e(),s("strong",null,"uuid"),s("br"),e(" Primary key of the role.")],-1),R=s("p",null,[s("code",null,"name"),e(),s("strong",null,"string"),s("br"),e(" Name of the role.")],-1),E=s("p",null,[s("code",null,"icon"),e(),s("strong",null,"string"),s("br"),e(" Icon for the role. Displayed in the Admin App.")],-1),T=s("p",null,[s("code",null,"description"),e(),s("strong",null,"string"),s("br"),e(" Description for the role. Displayed in the Admin App.")],-1),w=s("p",null,[s("code",null,"ip_access"),e(),s("strong",null,"csv"),s("br"),e(" CSV of IP addresses that have access to this role. Allows you to configure an allowlist of IP addresses.")],-1),P=s("p",null,[s("code",null,"enforce_tfa"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not Two-Factor Authentication is required for users in this role.")],-1),A=s("p",null,[s("code",null,"admin_access"),e(),s("strong",null,"boolean"),s("br"),e(" If this role is considered an admin role. This means that users in this role have full permissions to everything.")],-1),k=s("p",null,[s("code",null,"app_access"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not users in this role have access to use the Admin App.")],-1),S=s("code",null,"users",-1),D=e(),I=s("strong",null,"one-to-many",-1),C=s("br",null,null,-1),L=e(" The users in this role. One-to-many to "),Q=e("users"),O=e("."),M=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[e(`{
 	`),s("span",{class:"hljs-attr"},'"id"'),e(": "),s("span",{class:"hljs-string"},'"653925a9-970e-487a-bfc0-ab6c96affcdc"'),e(`,
 	`),s("span",{class:"hljs-attr"},'"name"'),e(": "),s("span",{class:"hljs-string"},'"Admin"'),e(`,
 	`),s("span",{class:"hljs-attr"},'"icon"'),e(": "),s("span",{class:"hljs-string"},'"supervised_user_circle"'),e(`,
 	`),s("span",{class:"hljs-attr"},'"description"'),e(": "),s("span",{class:"hljs-literal"},"null"),e(`,
 	`),s("span",{class:"hljs-attr"},'"ip_access"'),e(": "),s("span",{class:"hljs-literal"},"null"),e(`,
 	`),s("span",{class:"hljs-attr"},'"enforce_tfa"'),e(": "),s("span",{class:"hljs-literal"},"false"),e(`,
-	`),s("span",{class:"hljs-attr"},'"collection_list"'),e(": "),s("span",{class:"hljs-literal"},"null"),e(`,
 	`),s("span",{class:"hljs-attr"},'"admin_access"'),e(": "),s("span",{class:"hljs-literal"},"true"),e(`,
 	`),s("span",{class:"hljs-attr"},'"app_access"'),e(": "),s("span",{class:"hljs-literal"},"true"),e(`,
 	`),s("span",{class:"hljs-attr"},'"users"'),e(": ["),s("span",{class:"hljs-string"},'"0bc7b36a-9ba9-4ce0-83f0-0a526f354e07"'),e(`]
 }
-`)])])],-1),B=s("hr",null,null,-1),U=s("h2",{id:"list-roles"},[e("List Roles "),s("a",{class:"header-anchor",href:"#list-roles"},"#")],-1),H=s("p",null,"List all roles that exist in Directus.",-1),N={class:"two-up"},V={class:"left"},W=s("h3",{id:"query-parameters"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters"},"#")],-1),z=e("Supports all "),F=e("global query parameters"),J=e("."),K=s("h3",{id:"returns"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns"},"#")],-1),X=e("An array of up to "),Y=e("limit"),Z=e(),$=s("a",{href:"#the-role-object"},"role objects",-1),ss=e(". If no items are available, data will be an empty array."),es={class:"right"},ls=s("h3",{id:"rest-api"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api"},"#")],-1),as=s("pre",null,[s("code",null,`GET /roles
+`)])])],-1),G=s("hr",null,null,-1),B=s("h2",{id:"list-roles"},[e("List Roles "),s("a",{class:"header-anchor",href:"#list-roles"},"#")],-1),U=s("p",null,"List all roles that exist in Directus.",-1),H={class:"two-up"},N={class:"left"},V=s("h3",{id:"query-parameters"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters"},"#")],-1),W=e("Supports all "),z=e("global query parameters"),F=e("."),J=s("h3",{id:"returns"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns"},"#")],-1),K=e("An array of up to "),X=e("limit"),Y=e(),Z=s("a",{href:"#the-role-object"},"role objects",-1),$=e(". If no items are available, data will be an empty array."),ss={class:"right"},es=s("h3",{id:"rest-api"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api"},"#")],-1),ls=s("pre",null,[s("code",null,`GET /roles
 SEARCH /roles
-`)],-1),ts=e("Learn more about SEARCH ->"),ns=s("h3",{id:"graphql"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql"},"#")],-1),rs=s("pre",null,[s("code",null,`POST /graphql/system
-`)],-1),os=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
+`)],-1),as=e("Learn more about SEARCH ->"),ts=s("h3",{id:"graphql"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql"},"#")],-1),ns=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),rs=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
 	roles: [directus_roles]
 }
-`)])],-1),cs=s("h5",{id:"example"},[e("Example "),s("a",{class:"header-anchor",href:"#example"},"#")],-1),hs=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
+`)])],-1),os=s("h5",{id:"example"},[e("Example "),s("a",{class:"header-anchor",href:"#example"},"#")],-1),cs=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
 	roles {
 		id
 		name
@@ -25,7 +24,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])],-1),is=s("hr",null,null,-1),ds=s("h2",{id:"retrieve-a-role"},[e("Retrieve a Role "),s("a",{class:"header-anchor",href:"#retrieve-a-role"},"#")],-1),ps=s("p",null,"List an existing role by primary key.",-1),us={class:"two-up"},_s={class:"left"},fs=s("h3",{id:"query-parameters-2"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-2"},"#")],-1),ms=e("Supports all "),gs=e("global query parameters"),js=e("."),ys=s("h3",{id:"returns-2"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-2"},"#")],-1),bs=s("p",null,[e("Returns the requested "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),qs=s("div",{class:"right"},[s("h3",{id:"rest-api-2"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-2"},"#")]),s("pre",null,[s("code",null,`GET /roles/:id
+`)])],-1),hs=s("hr",null,null,-1),ds=s("h2",{id:"retrieve-a-role"},[e("Retrieve a Role "),s("a",{class:"header-anchor",href:"#retrieve-a-role"},"#")],-1),is=s("p",null,"List an existing role by primary key.",-1),ps={class:"two-up"},us={class:"left"},_s=s("h3",{id:"query-parameters-2"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-2"},"#")],-1),fs=e("Supports all "),ms=e("global query parameters"),gs=e("."),js=s("h3",{id:"returns-2"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-2"},"#")],-1),ys=s("p",null,[e("Returns the requested "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),bs=s("div",{class:"right"},[s("h3",{id:"rest-api-2"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-2"},"#")]),s("pre",null,[s("code",null,`GET /roles/:id
 `)]),s("h5",{id:"example-2"},[e("Example "),s("a",{class:"header-anchor",href:"#example-2"},"#")]),s("pre",null,[s("code",null,`GET /roles/b4cb3b64-8580-4ad9-a099-eade6da24302
 `)]),s("h3",{id:"graphql-2"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql-2"},"#")]),s("pre",null,[s("code",null,`POST /graphql/system
 `)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
@@ -40,7 +39,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])])],-1),xs=s("hr",null,null,-1),vs=s("h2",{id:"create-a-role"},[e("Create a Role "),s("a",{class:"header-anchor",href:"#create-a-role"},"#")],-1),Rs=s("p",null,"Create a new role.",-1),Es={class:"two-up"},Ts={class:"left"},ws=s("h3",{id:"query-parameters-3"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-3"},"#")],-1),Ps=e("Supports all "),As=e("global query parameters"),ks=e("."),Ss=s("h3",{id:"request-body"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body"},"#")],-1),Is=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),Ds=s("h3",{id:"returns-3"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-3"},"#")],-1),Cs=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the created role.")],-1),Ls=s("div",{class:"right"},[s("h3",{id:"rest-api-3"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-3"},"#")]),s("pre",null,[s("code",null,`POST /roles
+`)])])],-1),qs=s("hr",null,null,-1),xs=s("h2",{id:"create-a-role"},[e("Create a Role "),s("a",{class:"header-anchor",href:"#create-a-role"},"#")],-1),vs=s("p",null,"Create a new role.",-1),Rs={class:"two-up"},Es={class:"left"},Ts=s("h3",{id:"query-parameters-3"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-3"},"#")],-1),ws=e("Supports all "),Ps=e("global query parameters"),As=e("."),ks=s("h3",{id:"request-body"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body"},"#")],-1),Ss=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),Ds=s("h3",{id:"returns-3"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-3"},"#")],-1),Is=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the created role.")],-1),Cs=s("div",{class:"right"},[s("h3",{id:"rest-api-3"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-3"},"#")]),s("pre",null,[s("code",null,`POST /roles
 `)]),s("h5",{id:"example-4"},[e("Example "),s("a",{class:"header-anchor",href:"#example-4"},"#")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /roles"),e(`
 
 {
@@ -65,7 +64,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])])],-1),Os=s("hr",null,null,-1),Qs=s("h2",{id:"create-multiple-roles"},[e("Create Multiple Roles "),s("a",{class:"header-anchor",href:"#create-multiple-roles"},"#")],-1),Ms=s("p",null,"Create multiple new roles.",-1),Gs={class:"two-up"},Bs={class:"left"},Us=s("h3",{id:"query-parameters-4"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-4"},"#")],-1),Hs=e("Supports all "),Ns=e("global query parameters"),Vs=e("."),Ws=s("h3",{id:"request-body-2"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-2"},"#")],-1),zs=s("p",null,[e("An array of partial "),s("a",{href:"#the-role-object"},"role objects"),e(".")],-1),Fs=s("h3",{id:"returns-4"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-4"},"#")],-1),Js=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the created roles.")],-1),Ks=s("div",{class:"right"},[s("h3",{id:"rest-api-4"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-4"},"#")]),s("pre",null,[s("code",null,`POST /roles
+`)])])],-1),Ls=s("hr",null,null,-1),Qs=s("h2",{id:"create-multiple-roles"},[e("Create Multiple Roles "),s("a",{class:"header-anchor",href:"#create-multiple-roles"},"#")],-1),Os=s("p",null,"Create multiple new roles.",-1),Ms={class:"two-up"},Gs={class:"left"},Bs=s("h3",{id:"query-parameters-4"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-4"},"#")],-1),Us=e("Supports all "),Hs=e("global query parameters"),Ns=e("."),Vs=s("h3",{id:"request-body-2"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-2"},"#")],-1),Ws=s("p",null,[e("An array of partial "),s("a",{href:"#the-role-object"},"role objects"),e(".")],-1),zs=s("h3",{id:"returns-4"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-4"},"#")],-1),Fs=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the created roles.")],-1),Js=s("div",{class:"right"},[s("h3",{id:"rest-api-4"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-4"},"#")]),s("pre",null,[s("code",null,`POST /roles
 `)]),s("h5",{id:"example-6"},[e("Example "),s("a",{class:"header-anchor",href:"#example-6"},"#")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /roles"),e(`
 
 [
@@ -102,7 +101,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])])],-1),Xs=s("hr",null,null,-1),Ys=s("h2",{id:"update-a-role"},[e("Update a Role "),s("a",{class:"header-anchor",href:"#update-a-role"},"#")],-1),Zs=s("p",null,"Update an existing role.",-1),$s={class:"two-up"},se={class:"left"},ee=s("h3",{id:"query-parameters-5"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-5"},"#")],-1),le=e("Supports all "),ae=e("global query parameters"),te=e("."),ne=s("h3",{id:"request-body-3"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-3"},"#")],-1),re=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),oe=s("h3",{id:"returns-5"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-5"},"#")],-1),ce=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the updated role.")],-1),he=s("div",{class:"right"},[s("h3",{id:"rest-api-5"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),s("pre",null,[s("code",null,`PATCH /roles/:id
+`)])])],-1),Ks=s("hr",null,null,-1),Xs=s("h2",{id:"update-a-role"},[e("Update a Role "),s("a",{class:"header-anchor",href:"#update-a-role"},"#")],-1),Ys=s("p",null,"Update an existing role.",-1),Zs={class:"two-up"},$s={class:"left"},se=s("h3",{id:"query-parameters-5"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-5"},"#")],-1),ee=e("Supports all "),le=e("global query parameters"),ae=e("."),te=s("h3",{id:"request-body-3"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-3"},"#")],-1),ne=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),re=s("h3",{id:"returns-5"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-5"},"#")],-1),oe=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the updated role.")],-1),ce=s("div",{class:"right"},[s("h3",{id:"rest-api-5"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),s("pre",null,[s("code",null,`PATCH /roles/:id
 `)]),s("h5",{id:"example-8"},[e("Example "),s("a",{class:"header-anchor",href:"#example-8"},"#")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /roles/c86c2761-65d3-43c3-897f-6f74ad6a5bd7"),e(`
 
 {
@@ -121,7 +120,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])])],-1),ie=s("hr",null,null,-1),de=s("h2",{id:"update-multiple-roles"},[e("Update Multiple Roles "),s("a",{class:"header-anchor",href:"#update-multiple-roles"},"#")],-1),pe=s("p",null,"Update multiple existing roles.",-1),ue={class:"two-up"},_e={class:"left"},fe=s("h3",{id:"query-parameters-6"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-6"},"#")],-1),me=e("Supports all "),ge=e("global query parameters"),je=e("."),ye=s("h3",{id:"request-body-4"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-4"},"#")],-1),be=s("div",{class:"definitions"},[s("p",null,[s("code",null,"keys"),e(),s("strong",null,"Required"),s("br"),e(" Array of primary keys of the roles you\u2019d like to update.")]),s("p",null,[s("code",null,"data"),e(),s("strong",null,"Required"),s("br"),e(" Any of "),s("a",{href:"#the-role-object"},"the role object"),e("\u2019s properties.")])],-1),qe=s("h3",{id:"returns-6"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-6"},"#")],-1),xe=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the updated roles.")],-1),ve=s("div",{class:"right"},[s("h3",{id:"rest-api-6"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-6"},"#")]),s("pre",null,[s("code",null,`PATCH /roles
+`)])])],-1),he=s("hr",null,null,-1),de=s("h2",{id:"update-multiple-roles"},[e("Update Multiple Roles "),s("a",{class:"header-anchor",href:"#update-multiple-roles"},"#")],-1),ie=s("p",null,"Update multiple existing roles.",-1),pe={class:"two-up"},ue={class:"left"},_e=s("h3",{id:"query-parameters-6"},[e("Query Parameters "),s("a",{class:"header-anchor",href:"#query-parameters-6"},"#")],-1),fe=e("Supports all "),me=e("global query parameters"),ge=e("."),je=s("h3",{id:"request-body-4"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-4"},"#")],-1),ye=s("div",{class:"definitions"},[s("p",null,[s("code",null,"keys"),e(),s("strong",null,"Required"),s("br"),e(" Array of primary keys of the roles you\u2019d like to update.")]),s("p",null,[s("code",null,"data"),e(),s("strong",null,"Required"),s("br"),e(" Any of "),s("a",{href:"#the-role-object"},"the role object"),e("\u2019s properties.")])],-1),be=s("h3",{id:"returns-6"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-6"},"#")],-1),qe=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the updated roles.")],-1),xe=s("div",{class:"right"},[s("h3",{id:"rest-api-6"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-6"},"#")]),s("pre",null,[s("code",null,`PATCH /roles
 `)]),s("h5",{id:"example-10"},[e("Example "),s("a",{class:"header-anchor",href:"#example-10"},"#")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /roles"),e(`
 
 {
@@ -146,7 +145,7 @@ SEARCH /roles
 		}
 	}
 }
-`)])])],-1),Re=s("hr",null,null,-1),Ee=s("h2",{id:"delete-a-role"},[e("Delete a Role "),s("a",{class:"header-anchor",href:"#delete-a-role"},"#")],-1),Te=s("p",null,"Delete an existing role.",-1),we=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"returns-7"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-7"},"#")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-7"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-7"},"#")]),s("pre",null,[s("code",null,`DELETE /roles/:id
+`)])])],-1),ve=s("hr",null,null,-1),Re=s("h2",{id:"delete-a-role"},[e("Delete a Role "),s("a",{class:"header-anchor",href:"#delete-a-role"},"#")],-1),Ee=s("p",null,"Delete an existing role.",-1),Te=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"returns-7"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-7"},"#")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-7"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-7"},"#")]),s("pre",null,[s("code",null,`DELETE /roles/:id
 `)]),s("h5",{id:"example-12"},[e("Example "),s("a",{class:"header-anchor",href:"#example-12"},"#")]),s("pre",null,[s("code",null,`DELETE /roles/c86c2761-65d3-43c3-897f-6f74ad6a5bd7
 `)]),s("h3",{id:"graphql-7"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql-7"},"#")]),s("pre",null,[s("code",null,`POST /graphql/system
 `)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
@@ -157,7 +156,7 @@ SEARCH /roles
 		id
 	}
 }
-`)])])])],-1),Pe=s("hr",null,null,-1),Ae=s("h2",{id:"delete-multiple-roles"},[e("Delete Multiple Roles "),s("a",{class:"header-anchor",href:"#delete-multiple-roles"},"#")],-1),ke=s("p",null,"Delete multiple existing roles.",-1),Se=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"request-body-5"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-5"},"#")]),s("p",null,"An array of role primary keys"),s("h3",{id:"returns-8"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-8"},"#")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-8"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-8"},"#")]),s("pre",null,[s("code",null,`DELETE /roles
+`)])])])],-1),we=s("hr",null,null,-1),Pe=s("h2",{id:"delete-multiple-roles"},[e("Delete Multiple Roles "),s("a",{class:"header-anchor",href:"#delete-multiple-roles"},"#")],-1),Ae=s("p",null,"Delete multiple existing roles.",-1),ke=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"request-body-5"},[e("Request Body "),s("a",{class:"header-anchor",href:"#request-body-5"},"#")]),s("p",null,"An array of role primary keys"),s("h3",{id:"returns-8"},[e("Returns "),s("a",{class:"header-anchor",href:"#returns-8"},"#")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-8"},[e("REST API "),s("a",{class:"header-anchor",href:"#rest-api-8"},"#")]),s("pre",null,[s("code",null,`DELETE /roles
 `)]),s("h5",{id:"example-14"},[e("Example "),s("a",{class:"header-anchor",href:"#example-14"},"#")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// DELETE /roles"),e(`
 [`),s("span",{class:"hljs-string"},'"653925a9-970e-487a-bfc0-ab6c96affcdc"'),e(", "),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),e(`]
 `)])]),s("h3",{id:"graphql-8"},[e("GraphQL "),s("a",{class:"header-anchor",href:"#graphql-8"},"#")]),s("pre",null,[s("code",null,`POST /graphql/system
@@ -169,4 +168,4 @@ SEARCH /roles
 		ids
 	}
 }
-`)])])])],-1),Ie=s("hr",null,null,-1),Qe={setup(De,{expose:o}){const n={title:"Roles",modularExtension:!1,pageClass:"page-reference"};return o({frontmatter:n}),(Ce,Le)=>{const a=r("router-link"),c=r("DocsWrapper");return h(),i(c,{frontmatter:n},{default:l(()=>[s("div",d,[s("div",p,[s("div",u,[s("blockquote",null,[s("p",null,[_,t(a,{to:"/docs/concepts/roles/"},{default:l(()=>[f]),_:1}),m])])]),g]),j,y,s("div",b,[s("div",q,[s("div",x,[v,R,E,T,w,P,A,k,S,s("p",null,[I,D,C,L,O,t(a,{to:"/docs/reference/api/system/users/"},{default:l(()=>[Q]),_:1}),M])])]),G]),B,U,H,s("div",N,[s("div",V,[W,s("p",null,[z,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[F]),_:1}),J]),K,s("p",null,[X,t(a,{to:"/docs/reference/api/query/#limit"},{default:l(()=>[Y]),_:1}),Z,$,ss])]),s("div",es,[ls,as,s("p",null,[t(a,{to:"/docs/reference/api/introduction/#search-http-method"},{default:l(()=>[ts]),_:1})]),ns,rs,os,cs,hs])]),is,ds,ps,s("div",us,[s("div",_s,[fs,s("p",null,[ms,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[gs]),_:1}),js]),ys,bs]),qs]),xs,vs,Rs,s("div",Es,[s("div",Ts,[ws,s("p",null,[Ps,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[As]),_:1}),ks]),Ss,Is,Ds,Cs]),Ls]),Os,Qs,Ms,s("div",Gs,[s("div",Bs,[Us,s("p",null,[Hs,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[Ns]),_:1}),Vs]),Ws,zs,Fs,Js]),Ks]),Xs,Ys,Zs,s("div",$s,[s("div",se,[ee,s("p",null,[le,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[ae]),_:1}),te]),ne,re,oe,ce]),he]),ie,de,pe,s("div",ue,[s("div",_e,[fe,s("p",null,[me,t(a,{to:"/docs/reference/api/query"},{default:l(()=>[ge]),_:1}),je]),ye,be,qe,xe]),ve]),Re,Ee,Te,we,Pe,Ae,ke,Se,Ie])]),_:1})}}};export{Qe as default};
+`)])])])],-1),Se=s("hr",null,null,-1),Qe={setup(De,{expose:o}){const n={title:"Roles",modularExtension:!1,pageClass:"page-reference"};return o({frontmatter:n}),(Ie,Ce)=>{const a=r("router-link"),c=r("DocsWrapper");return h(),d(c,{frontmatter:n},{default:l(()=>[s("div",i,[s("div",p,[s("div",u,[s("blockquote",null,[s("p",null,[_,t(a,{to:"/docs/getting-started/glossary/#roles"},{default:l(()=>[f]),_:1}),m])])]),g]),j,y,s("div",b,[s("div",q,[s("div",x,[v,R,E,T,w,P,A,k,s("p",null,[S,D,I,C,L,t(a,{to:"/docs/reference/system/users/"},{default:l(()=>[Q]),_:1}),O])])]),M]),G,B,U,s("div",H,[s("div",N,[V,s("p",null,[W,t(a,{to:"/docs/reference/query"},{default:l(()=>[z]),_:1}),F]),J,s("p",null,[K,t(a,{to:"/docs/reference/query/#limit"},{default:l(()=>[X]),_:1}),Y,Z,$])]),s("div",ss,[es,ls,s("p",null,[t(a,{to:"/docs/reference/introduction/#search-http-method"},{default:l(()=>[as]),_:1})]),ts,ns,rs,os,cs])]),hs,ds,is,s("div",ps,[s("div",us,[_s,s("p",null,[fs,t(a,{to:"/docs/reference/query"},{default:l(()=>[ms]),_:1}),gs]),js,ys]),bs]),qs,xs,vs,s("div",Rs,[s("div",Es,[Ts,s("p",null,[ws,t(a,{to:"/docs/reference/query"},{default:l(()=>[Ps]),_:1}),As]),ks,Ss,Ds,Is]),Cs]),Ls,Qs,Os,s("div",Ms,[s("div",Gs,[Bs,s("p",null,[Us,t(a,{to:"/docs/reference/query"},{default:l(()=>[Hs]),_:1}),Ns]),Vs,Ws,zs,Fs]),Js]),Ks,Xs,Ys,s("div",Zs,[s("div",$s,[se,s("p",null,[ee,t(a,{to:"/docs/reference/query"},{default:l(()=>[le]),_:1}),ae]),te,ne,re,oe]),ce]),he,de,ie,s("div",pe,[s("div",ue,[_e,s("p",null,[fe,t(a,{to:"/docs/reference/query"},{default:l(()=>[me]),_:1}),ge]),je,ye,be,qe]),xe]),ve,Re,Ee,Te,we,Pe,Ae,ke,Se])]),_:1})}}};export{Qe as default};

package/dist/assets/rpm.f0a7ad70.js

@@ -0,0 +1 @@
+import{bF as d}from"./vendor.299bc11c.js";function m(i,f){return f.forEach(function(e){e&&typeof e!="string"&&!Array.isArray(e)&&Object.keys(e).forEach(function(n){if(n!=="default"&&!(n in i)){var c=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(i,n,c.get?c:{enumerable:!0,get:function(){return e[n]}})}})}),Object.freeze(i)}var p={exports:{}};(function(i,f){(function(e){e(d.exports)})(function(e){e.defineMode("rpm-changes",function(){var n=/^-+$/,c=/^(Mon|Tue|Wed|Thu|Fri|Sat|Sun) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)  ?\d{1,2} \d{2}:\d{2}(:\d{2})? [A-Z]{3,4} \d{4} - /,a=/^[\w+.-]+@[\w.-]+/;return{token:function(o){return o.sol()&&(o.match(n)||o.match(c))?"tag":o.match(a)?"string":(o.next(),null)}}}),e.defineMIME("text/x-rpm-changes","rpm-changes"),e.defineMode("rpm-spec",function(){var n=/^(i386|i586|i686|x86_64|ppc64le|ppc64|ppc|ia64|s390x|s390|sparc64|sparcv9|sparc|noarch|alphaev6|alpha|hppa|mipsel)/,c=/^[a-zA-Z0-9()]+:/,a=/^%(debug_package|package|description|prep|build|install|files|clean|changelog|preinstall|preun|postinstall|postun|pretrans|posttrans|pre|post|triggerin|triggerun|verifyscript|check|triggerpostun|triggerprein|trigger)/,o=/^%(ifnarch|ifarch|if)/,u=/^%(else|endif)/,l=/^(\!|\?|\<\=|\<|\>\=|\>|\=\=|\&\&|\|\|)/;return{startState:function(){return{controlFlow:!1,macroParameters:!1,section:!1}},token:function(r,t){var h=r.peek();if(h=="#")return r.skipToEnd(),"comment";if(r.sol()){if(r.match(c))return"header";if(r.match(a))return"atom"}if(r.match(/^\$\w+/)||r.match(/^\$\{\w+\}/))return"def";if(r.match(u))return"keyword";if(r.match(o))return t.controlFlow=!0,"keyword";if(t.controlFlow){if(r.match(l))return"operator";if(r.match(/^(\d+)/))return"number";r.eol()&&(t.controlFlow=!1)}if(r.match(n))return r.eol()&&(t.controlFlow=!1),"number";if(r.match(/^%[\w]+/))return r.match("(")&&(t.macroParameters=!0),"keyword";if(t.macroParameters){if(r.match(/^\d+/))return"number";if(r.match(")"))return t.macroParameters=!1,"keyword"}return r.match(/^%\{\??[\w \-\:\!]+\}/)?(r.eol()&&(t.controlFlow=!1),"def"):(r.next(),null)}}}),e.defineMIME("text/x-rpm-spec","rpm-spec")})})();var s=p.exports,v=Object.freeze(m({__proto__:null,[Symbol.toStringTag]:"Module",default:s},[p.exports]));export{v as r};

package/dist/assets/rst.f0464fbc.js

@@ -0,0 +1 @@
+import{bF as oe}from"./vendor.299bc11c.js";import{a as ae}from"./python.ce0163fc.js";import{a as ie}from"./stex.8fe110b6.js";import{o as le}from"./overlay.ff3e2ac4.js";function fe(A,P){return P.forEach(function(l){l&&typeof l!="string"&&!Array.isArray(l)&&Object.keys(l).forEach(function(p){if(p!=="default"&&!(p in A)){var i=Object.getOwnPropertyDescriptor(l,p);Object.defineProperty(A,p,i.get?i:{enumerable:!0,get:function(){return l[p]}})}})}),Object.freeze(A)}var F={exports:{}};(function(A,P){(function(l){l(oe.exports,ae.exports,ie.exports,le.exports)})(function(l){l.defineMode("rst",function(p,i){var v=/^\*\*[^\*\s](?:[^\*]*[^\*\s])?\*\*/,b=/^\*[^\*\s](?:[^\*]*[^\*\s])?\*/,w=/^``[^`\s](?:[^`]*[^`\s])``/,u=/^(?:[\d]+(?:[\.,]\d+)*)/,E=/^(?:\s\+[\d]+(?:[\.,]\d+)*)/,_=/^(?:\s\-[\d]+(?:[\.,]\d+)*)/,T="[Hh][Tt][Tt][Pp][Ss]?://",q="(?:[\\d\\w.-]+)\\.(?:\\w{2,6})",x="(?:/[\\d\\w\\#\\%\\&\\-\\.\\,\\/\\:\\=\\?\\~]+)*",y=new RegExp("^"+T+q+x),R={token:function(f){if(f.match(v)&&f.match(/\W+|$/,!1))return"strong";if(f.match(b)&&f.match(/\W+|$/,!1))return"em";if(f.match(w)&&f.match(/\W+|$/,!1))return"string-2";if(f.match(u))return"number";if(f.match(E))return"positive";if(f.match(_))return"negative";if(f.match(y))return"link";for(;f.next()!=null&&!(f.match(v,!1)||f.match(b,!1)||f.match(w,!1)||f.match(u,!1)||f.match(E,!1)||f.match(_,!1)||f.match(y,!1)););return null}},W=l.getMode(p,i.backdrop||"rst-base");return l.overlayMode(W,R,!0)},"python","stex"),l.defineMode("rst-base",function(p){function i(c){var e=Array.prototype.slice.call(arguments,1);return c.replace(/{(\d+)}/g,function(r,N){return typeof e[N]!="undefined"?e[N]:r})}var v=l.getMode(p,"python"),b=l.getMode(p,"stex"),w="\\s+",u="(?:\\s*|\\W|$)",E=new RegExp(i("^{0}",u)),_=`(?:[^\\W\\d_](?:[\\w!"#$%&'()\\*\\+,\\-\\./:;<=>\\?]*[^\\W_])?)`,T=new RegExp(i("^{0}",_)),q=`(?:[^\\W\\d_](?:[\\w\\s!"#$%&'()\\*\\+,\\-\\./:;<=>\\?]*[^\\W_])?)`,x=i("(?:{0}|`{1}`)",_,q),y="(?:[^\\s\\|](?:[^\\|]*[^\\s\\|])?)",R="(?:[^\\`]+)",W=new RegExp(i("^{0}",R)),f=new RegExp("^([!'#$%&\"()*+,-./:;<=>?@\\[\\\\\\]^_`{|}~])\\1{3,}\\s*$"),L=new RegExp(i("^\\.\\.{0}",w)),j=new RegExp(i("^_{0}:{1}|^__:{1}",x,u)),s=new RegExp(i("^{0}::{1}",x,u)),S=new RegExp(i("^\\|{0}\\|{1}{2}::{3}",y,w,x,u)),M=new RegExp(i("^\\[(?:\\d+|#{0}?|\\*)]{1}",x,u)),D=new RegExp(i("^\\[{0}\\]{1}",x,u)),O=new RegExp(i("^\\|{0}\\|",y)),H=new RegExp(i("^\\[(?:\\d+|#{0}?|\\*)]_",x)),B=new RegExp(i("^\\[{0}\\]_",x)),G=new RegExp(i("^{0}__?",x)),g=new RegExp(i("^`{0}`_",R)),h=new RegExp(i("^:{0}:`{1}`{2}",_,R,u)),m=new RegExp(i("^`{1}`:{0}:{2}",_,R,u)),$=new RegExp(i("^:{0}:{1}",_,u)),J=new RegExp(i("^{0}",x)),K=new RegExp(i("^::{0}",u)),X=new RegExp(i("^\\|{0}\\|",y)),Q=new RegExp(i("^{0}",w)),U=new RegExp(i("^{0}",x)),V=new RegExp(i("^::{0}",u)),Y=new RegExp("^_"),Z=new RegExp(i("^{0}|_",x)),C=new RegExp(i("^:{0}",u)),ee=new RegExp("^::\\s*$"),ce=new RegExp("^\\s+(?:>>>|In \\[\\d+\\]:)\\s");function o(c,e){var r=null;if(c.sol()&&c.match(ce,!1))n(e,I,{mode:v,local:l.startState(v)});else if(c.sol()&&c.match(L))n(e,t),r="meta";else if(c.sol()&&c.match(f))n(e,o),r="header";else if(k(e)==h||c.match(h,!1))switch(d(e)){case 0:n(e,o,a(h,1)),c.match(/^:/),r="meta";break;case 1:n(e,o,a(h,2)),c.match(T),r="keyword",c.current().match(/^(?:math|latex)/)&&(e.tmp_stex=!0);break;case 2:n(e,o,a(h,3)),c.match(/^:`/),r="meta";break;case 3:if(e.tmp_stex&&(e.tmp_stex=void 0,e.tmp={mode:b,local:l.startState(b)}),e.tmp){if(c.peek()=="`"){n(e,o,a(h,4)),e.tmp=void 0;break}r=e.tmp.mode.token(c,e.tmp.local);break}n(e,o,a(h,4)),c.match(W),r="string";break;case 4:n(e,o,a(h,5)),c.match(/^`/),r="meta";break;case 5:n(e,o,a(h,6)),c.match(E);break;default:n(e,o)}else if(k(e)==m||c.match(m,!1))switch(d(e)){case 0:n(e,o,a(m,1)),c.match(/^`/),r="meta";break;case 1:n(e,o,a(m,2)),c.match(W),r="string";break;case 2:n(e,o,a(m,3)),c.match(/^`:/),r="meta";break;case 3:n(e,o,a(m,4)),c.match(T),r="keyword";break;case 4:n(e,o,a(m,5)),c.match(/^:/),r="meta";break;case 5:n(e,o,a(m,6)),c.match(E);break;default:n(e,o)}else if(k(e)==$||c.match($,!1))switch(d(e)){case 0:n(e,o,a($,1)),c.match(/^:/),r="meta";break;case 1:n(e,o,a($,2)),c.match(T),r="keyword";break;case 2:n(e,o,a($,3)),c.match(/^:/),r="meta";break;case 3:n(e,o,a($,4)),c.match(E);break;default:n(e,o)}else if(k(e)==O||c.match(O,!1))switch(d(e)){case 0:n(e,o,a(O,1)),c.match(X),r="variable-2";break;case 1:n(e,o,a(O,2)),c.match(/^_?_?/)&&(r="link");break;default:n(e,o)}else if(c.match(H))n(e,o),r="quote";else if(c.match(B))n(e,o),r="quote";else if(c.match(G))n(e,o),(!c.peek()||c.peek().match(/^\W$/))&&(r="link");else if(k(e)==g||c.match(g,!1))switch(d(e)){case 0:!c.peek()||c.peek().match(/^\W$/)?n(e,o,a(g,1)):c.match(g);break;case 1:n(e,o,a(g,2)),c.match(/^`/),r="link";break;case 2:n(e,o,a(g,3)),c.match(W);break;case 3:n(e,o,a(g,4)),c.match(/^`_/),r="link";break;default:n(e,o)}else c.match(ee)?n(e,re):c.next()&&n(e,o);return r}function t(c,e){var r=null;if(k(e)==S||c.match(S,!1))switch(d(e)){case 0:n(e,t,a(S,1)),c.match(X),r="variable-2";break;case 1:n(e,t,a(S,2)),c.match(Q);break;case 2:n(e,t,a(S,3)),c.match(U),r="keyword";break;case 3:n(e,t,a(S,4)),c.match(V),r="meta";break;default:n(e,o)}else if(k(e)==s||c.match(s,!1))switch(d(e)){case 0:n(e,t,a(s,1)),c.match(J),r="keyword",c.current().match(/^(?:math|latex)/)?e.tmp_stex=!0:c.current().match(/^python/)&&(e.tmp_py=!0);break;case 1:n(e,t,a(s,2)),c.match(K),r="meta",(c.match(/^latex\s*$/)||e.tmp_stex)&&(e.tmp_stex=void 0,n(e,I,{mode:b,local:l.startState(b)}));break;case 2:n(e,t,a(s,3)),(c.match(/^python\s*$/)||e.tmp_py)&&(e.tmp_py=void 0,n(e,I,{mode:v,local:l.startState(v)}));break;default:n(e,o)}else if(k(e)==j||c.match(j,!1))switch(d(e)){case 0:n(e,t,a(j,1)),c.match(Y),c.match(Z),r="link";break;case 1:n(e,t,a(j,2)),c.match(C),r="meta";break;default:n(e,o)}else c.match(M)||c.match(D)?(n(e,o),r="quote"):(c.eatSpace(),c.eol()?n(e,o):(c.skipToEnd(),n(e,ne),r="comment"));return r}function ne(c,e){return z(c,e,"comment")}function re(c,e){return z(c,e,"meta")}function z(c,e,r){return c.eol()||c.eatSpace()?(c.skipToEnd(),r):(n(e,o),null)}function I(c,e){return e.ctx.mode&&e.ctx.local?c.sol()?(c.eatSpace()||n(e,o),null):e.ctx.mode.token(c,e.ctx.local):(n(e,o),null)}function a(c,e,r,N){return{phase:c,stage:e,mode:r,local:N}}function n(c,e,r){c.tok=e,c.ctx=r||{}}function d(c){return c.ctx.stage||0}function k(c){return c.ctx.phase}return{startState:function(){return{tok:o,ctx:a(void 0,0)}},copyState:function(c){var e=c.ctx,r=c.tmp;return e.local&&(e={mode:e.mode,local:l.copyState(e.mode,e.local)}),r&&(r={mode:r.mode,local:l.copyState(r.mode,r.local)}),{tok:c.tok,ctx:e,tmp:r}},innerMode:function(c){return c.tmp?{state:c.tmp.local,mode:c.tmp.mode}:c.ctx.mode?{state:c.ctx.local,mode:c.ctx.mode}:null},token:function(c,e){return e.tok(c,e)}}},"python","stex"),l.defineMIME("text/x-rst","rst")})})();var ue=F.exports,_e=Object.freeze(fe({__proto__:null,[Symbol.toStringTag]:"Module",default:ue},[F.exports]));export{_e as r};