@directus/app 9.0.0-rc.99 → 9.0.0

package/dist/assets/{fields.4933da97.js → fields.238d924d.js}

@@ -1,4 +1,4 @@
-import{r as i,p as c,q as h,w as s,B as e,t as n,P as l}from"./vendor.a626ab9c.js";const d={class:"markdown-body"},p={class:"two-up"},u={class:"left"},f=l("Fields are individual pieces of content within an item. They are mapped to columns in the database. "),_=l("Learn more about Fields"),g=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-field-object"},"The Field Object")]),e("li",null,[e("a",{href:"#list-all-fields"},"List All Fields")]),e("li",null,[e("a",{href:"#list-fields-in-collection"},"List Fields in Collection")]),e("li",null,[e("a",{href:"#retrieve-a-field"},"Retrieve a Field")]),e("li",null,[e("a",{href:"#create-a-field"},"Create a Field")]),e("li",null,[e("a",{href:"#update-a-field"},"Update a Field")]),e("li",null,[e("a",{href:"#delete-a-field"},"Delete a Field")])])])])],-1),j=e("hr",null,null,-1),y=e("h2",{id:"the-field-object"},[l("The Field Object "),e("a",{class:"header-anchor",href:"#the-field-object"},"#")],-1),b={class:"two-up"},v={class:"left"},q={class:"definitions"},T=e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection the field resides in.")],-1),w=e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" The identifier of the field. This matches the table column name.")],-1),x=e("code",null,"type",-1),A=l(),k=e("strong",null,"string",-1),E=e("br",null,null,-1),S=l(" The Directus data type of the field. See "),P=l("Types"),F=l(" for possible options."),R=e("h4",{id:"meta"},[l("Meta "),e("a",{class:"header-anchor",href:"#meta"},"#")],-1),L=e("p",null,"Directus metadata, primarily used in the Admin App. Meta is optional.",-1),Q={class:"definitions"},C=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_fields"),l(".")],-1),I=e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" The name of the collection this field resides in.")],-1),D=e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" Identifier of the field. Matches the column name in the database.")],-1),G=e("code",null,"special",-1),O=l(),W=e("strong",null,"string",-1),B=e("br",null,null,-1),H=l(" Any special transform flags that apply to this field. See "),M=l("Field Transforms"),N=l(" for more information."),U=e("p",null,[e("code",null,"interface"),l(),e("strong",null,"string"),e("br"),l(" The interface used for this field.")],-1),V=e("p",null,[e("code",null,"options"),l(),e("strong",null,"object"),e("br"),l(" The interface options configured for this field. The structure is based on the interface used.")],-1),z=e("p",null,[e("code",null,"display"),l(),e("strong",null,"string"),e("br"),l(" The display used for this field.")],-1),J=e("p",null,[e("code",null,"display_options"),l(),e("strong",null,"string"),e("br"),l(" The configured options for the used display.")],-1),K=e("p",null,[e("code",null,"readonly"),l(),e("strong",null,"boolean"),e("br"),l(" If the field is considered readonly in the Admin App.")],-1),X=e("p",null,[e("code",null,"hidden"),l(),e("strong",null,"boolean"),e("br"),l(" If the field is hidden from the edit page in the Admin App.")],-1),Y=e("p",null,[e("code",null,"sort"),l(),e("strong",null,"integer"),e("br"),l(" Where this field is shown on the edit page in the Admin App.")],-1),Z=e("p",null,[e("code",null,"width"),l(),e("strong",null,"string"),e("br"),l(" How wide the interface is rendered on the edit page in the Admin App. One of "),e("code",null,"half"),l(", "),e("code",null,"half-left"),l(", "),e("code",null,"half-right"),l(", "),e("code",null,"half-space"),l(", "),e("code",null,"full"),l(", "),e("code",null,"fill"),l(".")],-1),$=e("p",null,[e("code",null,"translations"),l(),e("strong",null,"array"),e("br"),l(" How this field\u2019s name is displayed in the different languages in the Admin App.")],-1),ee=e("p",null,[e("code",null,"note"),l(),e("strong",null,"string"),e("br"),l(" Short description displayed in the Admin App.")],-1),le=e("h4",{id:"schema"},[l("Schema "),e("a",{class:"header-anchor",href:"#schema"},"#")],-1),se=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. Note: schema is optional. If a field exist in directus_fields, but not in the database, it\u2019s an alias commonly used for relational (o2m) or presentation purposes in the Admin App.",-1),te=e("div",{class:"definitions"},[e("p",null,[e("code",null,"name"),l(),e("strong",null,"string"),e("br"),l(" Identifier of the field. Matches the column name in the database.")]),e("p",null,[e("code",null,"table"),l(),e("strong",null,"string"),e("br"),l(" Name of the table the column resides in.")]),e("p",null,[e("code",null,"data_type"),l(),e("strong",null,"string"),e("br"),l(" The datatype as used in the database. Note: this value is database vendor specific.")]),e("p",null,[e("code",null,"default_value"),l(),e("strong",null,"any"),e("br"),l(" The configured default value for the column.")]),e("p",null,[e("code",null,"max_length"),l(),e("strong",null,"integer"),e("br"),l(" Configured length for varchar-type columns.")]),e("p",null,[e("code",null,"numeric_precision"),l(),e("strong",null,"integer"),e("br"),l(" Precision for integer/float/decimal type fields.")]),e("p",null,[e("code",null,"numeric_scale"),l(),e("strong",null,"integer"),e("br"),l(" Scale for integer/float/decimal type fields.")]),e("p",null,[e("code",null,"is_nullable"),l(),e("strong",null,"boolean"),e("br"),l(" Whether or not the column is nullable. This is what is used as the \u201Crequired\u201D state in Directus.")]),e("p",null,[e("code",null,"is_primary_key"),l(),e("strong",null,"boolean"),e("br"),l(" Whether or not the field is the primary key of the table.")]),e("p",null,[e("code",null,"foreign_key_column"),l(),e("strong",null,"string"),e("br"),l(" If the current column has a foreign key constraint, this points to the related column.")]),e("p",null,[e("code",null,"foreign_key_table"),l(),e("strong",null,"string"),e("br"),l(" If the current column has a foreign key constraint, this points to the related table.")]),e("p",null,[e("code",null,"comment"),l(),e("strong",null,"string"),e("br"),l(" Comment as stored in the database.")])],-1),ne=e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[l(`{
+import{p as i,q as c,C as h,v as s,M as e,u as a,D as l}from"./vendor.299bc11c.js";const d={class:"markdown-body"},p={class:"two-up"},u={class:"left"},f=l("Fields are individual pieces of content within an item. They are mapped to columns in the database. "),_=l("Learn more about Fields"),g=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-field-object"},"The Field Object")]),e("li",null,[e("a",{href:"#list-all-fields"},"List All Fields")]),e("li",null,[e("a",{href:"#list-fields-in-collection"},"List Fields in Collection")]),e("li",null,[e("a",{href:"#retrieve-a-field"},"Retrieve a Field")]),e("li",null,[e("a",{href:"#create-a-field"},"Create a Field")]),e("li",null,[e("a",{href:"#update-a-field"},"Update a Field")]),e("li",null,[e("a",{href:"#delete-a-field"},"Delete a Field")])])])])],-1),j=e("hr",null,null,-1),y=e("h2",{id:"the-field-object"},[l("The Field Object "),e("a",{class:"header-anchor",href:"#the-field-object"},"#")],-1),b={class:"two-up"},v={class:"left"},q={class:"definitions"},T=e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" Name of the collection the field resides in.")],-1),w=e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" The identifier of the field. This matches the table column name.")],-1),x=e("code",null,"type",-1),A=l(),k=e("strong",null,"string",-1),E=e("br",null,null,-1),S=l(" The Directus data type of the field. See "),P=l("Types"),F=l(" for possible options."),R=e("h4",{id:"meta"},[l("Meta "),e("a",{class:"header-anchor",href:"#meta"},"#")],-1),L=e("p",null,"Directus metadata, primarily used in the Admin App. Meta is optional.",-1),C={class:"definitions"},Q=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_fields"),l(".")],-1),D=e("p",null,[e("code",null,"collection"),l(),e("strong",null,"string"),e("br"),l(" The name of the collection this field resides in.")],-1),I=e("p",null,[e("code",null,"field"),l(),e("strong",null,"string"),e("br"),l(" Identifier of the field. Matches the column name in the database.")],-1),G=e("code",null,"special",-1),O=l(),W=e("strong",null,"string",-1),H=e("br",null,null,-1),M=l(" Any special transform flags that apply to this field. See "),B=l("Field Transforms"),N=l(" for more information."),U=e("p",null,[e("code",null,"interface"),l(),e("strong",null,"string"),e("br"),l(" The interface used for this field.")],-1),V=e("p",null,[e("code",null,"options"),l(),e("strong",null,"object"),e("br"),l(" The interface options configured for this field. The structure is based on the interface used.")],-1),z=e("p",null,[e("code",null,"display"),l(),e("strong",null,"string"),e("br"),l(" The display used for this field.")],-1),J=e("p",null,[e("code",null,"display_options"),l(),e("strong",null,"string"),e("br"),l(" The configured options for the used display.")],-1),K=e("p",null,[e("code",null,"readonly"),l(),e("strong",null,"boolean"),e("br"),l(" If the field is considered readonly in the Admin App.")],-1),X=e("p",null,[e("code",null,"hidden"),l(),e("strong",null,"boolean"),e("br"),l(" If the field is hidden from the edit page in the Admin App.")],-1),Y=e("p",null,[e("code",null,"sort"),l(),e("strong",null,"integer"),e("br"),l(" Where this field is shown on the edit page in the Admin App.")],-1),Z=e("p",null,[e("code",null,"width"),l(),e("strong",null,"string"),e("br"),l(" How wide the interface is rendered on the edit page in the Admin App. One of "),e("code",null,"half"),l(", "),e("code",null,"half-left"),l(", "),e("code",null,"half-right"),l(", "),e("code",null,"half-space"),l(", "),e("code",null,"full"),l(", "),e("code",null,"fill"),l(".")],-1),$=e("p",null,[e("code",null,"translations"),l(),e("strong",null,"array"),e("br"),l(" How this field\u2019s name is displayed in the different languages in the Admin App.")],-1),ee=e("p",null,[e("code",null,"note"),l(),e("strong",null,"string"),e("br"),l(" Short description displayed in the Admin App.")],-1),le=e("h4",{id:"schema"},[l("Schema "),e("a",{class:"header-anchor",href:"#schema"},"#")],-1),se=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. Note: schema is optional. If a field exist in directus_fields, but not in the database, it\u2019s an alias commonly used for relational (o2m) or presentation purposes in the Admin App.",-1),te=e("div",{class:"definitions"},[e("p",null,[e("code",null,"name"),l(),e("strong",null,"string"),e("br"),l(" Identifier of the field. Matches the column name in the database.")]),e("p",null,[e("code",null,"table"),l(),e("strong",null,"string"),e("br"),l(" Name of the table the column resides in.")]),e("p",null,[e("code",null,"data_type"),l(),e("strong",null,"string"),e("br"),l(" The datatype as used in the database. Note: this value is database vendor specific.")]),e("p",null,[e("code",null,"default_value"),l(),e("strong",null,"any"),e("br"),l(" The configured default value for the column.")]),e("p",null,[e("code",null,"max_length"),l(),e("strong",null,"integer"),e("br"),l(" Configured length for varchar-type columns.")]),e("p",null,[e("code",null,"numeric_precision"),l(),e("strong",null,"integer"),e("br"),l(" Precision for integer/float/decimal type fields.")]),e("p",null,[e("code",null,"numeric_scale"),l(),e("strong",null,"integer"),e("br"),l(" Scale for integer/float/decimal type fields.")]),e("p",null,[e("code",null,"is_nullable"),l(),e("strong",null,"boolean"),e("br"),l(" Whether or not the column is nullable. This is what is used as the \u201Crequired\u201D state in Directus.")]),e("p",null,[e("code",null,"is_primary_key"),l(),e("strong",null,"boolean"),e("br"),l(" Whether or not the field is the primary key of the table.")]),e("p",null,[e("code",null,"foreign_key_column"),l(),e("strong",null,"string"),e("br"),l(" If the current column has a foreign key constraint, this points to the related column.")]),e("p",null,[e("code",null,"foreign_key_table"),l(),e("strong",null,"string"),e("br"),l(" If the current column has a foreign key constraint, this points to the related table.")]),e("p",null,[e("code",null,"comment"),l(),e("strong",null,"string"),e("br"),l(" Comment as stored in the database.")])],-1),ae=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"},'"articles"'),l(`,
 	`),e("span",{class:"hljs-attr"},'"field"'),l(": "),e("span",{class:"hljs-string"},'"id"'),l(`,
 	`),e("span",{class:"hljs-attr"},'"type"'),l(": "),e("span",{class:"hljs-string"},'"integer"'),l(`,
@@ -34,7 +34,7 @@ import{r as i,p as c,q as h,w as s,B as e,t as n,P as l}from"./vendor.a626ab9c.j
 		`),e("span",{class:"hljs-attr"},'"comment"'),l(": "),e("span",{class:"hljs-literal"},"null"),l(`
 	}
 }
-`)])])],-1),ae=e("hr",null,null,-1),ie=e("h2",{id:"list-all-fields"},[l("List All Fields "),e("a",{class:"header-anchor",href:"#list-all-fields"},"#")],-1),re=e("p",null,"List the available fields.",-1),oe=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"query-parameters"},[l("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters"},"#")]),e("p",null,"This endpoint doesn\u2019t currently support any query parameters."),e("h3",{id:"returns"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns"},"#")]),e("p",null,[l("An array of "),e("a",{href:"#the-field-object"},"field objects"),l(".")])]),e("div",{class:"right"},[e("h3",{id:"rest-api"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api"},"#")]),e("pre",null,[e("code",null,`GET /fields
+`)])])],-1),ne=e("hr",null,null,-1),ie=e("h2",{id:"list-all-fields"},[l("List All Fields "),e("a",{class:"header-anchor",href:"#list-all-fields"},"#")],-1),re=e("p",null,"List the available fields.",-1),oe=e("div",{class:"two-up"},[e("div",{class:"left"},[e("h3",{id:"query-parameters"},[l("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters"},"#")]),e("p",null,"This endpoint doesn\u2019t currently support any query parameters."),e("h3",{id:"returns"},[l("Returns "),e("a",{class:"header-anchor",href:"#returns"},"#")]),e("p",null,[l("An array of "),e("a",{href:"#the-field-object"},"field objects"),l(".")])]),e("div",{class:"right"},[e("h3",{id:"rest-api"},[l("REST API "),e("a",{class:"header-anchor",href:"#rest-api"},"#")]),e("pre",null,[e("code",null,`GET /fields
 `)]),e("h3",{id:"graphql"},[l("GraphQL "),e("a",{class:"header-anchor",href:"#graphql"},"#")]),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"}," Query"),l(` {
 	fields: [directus_fields]
@@ -132,4 +132,4 @@ import{r as i,p as c,q as h,w as s,B as e,t as n,P as l}from"./vendor.a626ab9c.j
 		field
 	}
 }
-`)])])])],-1),Le={setup(Se,{expose:r}){const a={title:"Fields",modularExtension:!1,pageClass:"page-reference"};return r({frontmatter:a}),(Pe,Fe)=>{const t=i("router-link"),o=i("DocsWrapper");return c(),h(o,{frontmatter:a},{default:s(()=>[e("div",d,[e("div",p,[e("div",u,[e("blockquote",null,[e("p",null,[f,n(t,{to:"/docs/concepts/fields/"},{default:s(()=>[_]),_:1}),g])])]),m]),j,y,e("div",b,[e("div",v,[e("div",q,[T,w,e("p",null,[x,A,k,E,S,n(t,{to:"/docs/concepts/types/"},{default:s(()=>[P]),_:1}),F])]),R,L,e("div",Q,[C,I,D,e("p",null,[G,O,W,B,H,n(t,{to:"/docs/reference/field-transforms/"},{default:s(()=>[M]),_:1}),N]),U,V,z,J,K,X,Y,Z,$,ee]),le,se,te]),ne]),ae,ie,re,oe,ce,he,de,pe,ue,fe,_e,ge,me,je,ye,be,ve,qe,Te,we,xe,Ae,ke,Ee])]),_:1})}}};export{Le as default};
+`)])])])],-1),Le={setup(Se,{expose:r}){const n={title:"Fields",modularExtension:!1,pageClass:"page-reference"};return r({frontmatter:n}),(Pe,Fe)=>{const t=i("router-link"),o=i("DocsWrapper");return c(),h(o,{frontmatter:n},{default:s(()=>[e("div",d,[e("div",p,[e("div",u,[e("blockquote",null,[e("p",null,[f,a(t,{to:"/docs/getting-started/glossary/#fields"},{default:s(()=>[_]),_:1}),g])])]),m]),j,y,e("div",b,[e("div",v,[e("div",q,[T,w,e("p",null,[x,A,k,E,S,a(t,{to:"/docs/getting-started/glossary/#app"},{default:s(()=>[P]),_:1}),F])]),R,L,e("div",C,[Q,D,I,e("p",null,[G,O,W,H,M,a(t,{to:"/docs/reference/field-transforms/"},{default:s(()=>[B]),_:1}),N]),U,V,z,J,K,X,Y,Z,$,ee]),le,se,te]),ae]),ne,ie,re,oe,ce,he,de,pe,ue,fe,_e,ge,me,je,ye,be,ve,qe,Te,we,xe,Ae,ke,Ee])]),_:1})}}};export{Le as default};

package/dist/assets/file-library.d7ca55fc.js

@@ -0,0 +1 @@
+import{p as o,q as d,C as h,v as l,M as e,u as a,D as t}from"./vendor.299bc11c.js";const u={class:"markdown-body"},c=e("blockquote",null,[e("p",null,"Directus includes a full-featured Digital Asset Management (DAM) system for storing, organizing, browsing, and transforming your various files and assets.")],-1),g=e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#browsing-files"},"Browsing Files")]),e("li",null,[e("a",{href:"#viewing-or-editing-a-file"},"Viewing or Editing a File")]),e("li",null,[e("a",{href:"#editing-an-image"},"Editing an Image")]),e("li",null,[e("a",{href:"#replacing-a-file"},"Replacing a File")]),e("li",null,[e("a",{href:"#uploading-a-file"},"Uploading a File")])])])],-1),f=e("h2",{id:"browsing-files"},[t("Browsing Files "),e("a",{class:"header-anchor",href:"#browsing-files"},"#")],-1),p=t("This module aggregates all files within the project into one consolidated library. This listing page has the same features and functionality as the "),m=t("Collection Page"),_=t("."),w=e("h2",{id:"viewing-or-editing-a-file"},[t("Viewing or Editing a File "),e("a",{class:"header-anchor",href:"#viewing-or-editing-a-file"},"#")],-1),y=t("Provides a custom form for viewing assets and embeds, with core fields included out-of-the-box (see below), and the ability for administrators to add additional custom fields. This page has the same features and functionality as the "),b=t("Item Page"),v=t("."),F=e("h4",{id:"file-info"},[t("File Info "),e("a",{class:"header-anchor",href:"#file-info"},"#")],-1),k=e("ul",null,[e("li",null,[e("strong",null,"Preview"),t(" \u2014 A preview of the image or file")]),e("li",null,[e("strong",null,"Title"),t(" \u2014 A title for the file")]),e("li",null,[e("strong",null,"Description"),t(" \u2014 A description of the file")]),e("li",null,[e("strong",null,"Tags"),t(" \u2014 Keywords used for searchability")]),e("li",null,[e("strong",null,"Location"),t(" \u2014 An optional location, eg: where a photo was taken")]),e("li",null,[e("strong",null,"Storage"),t(" \u2014 Which storage adapter is used to store the file asset")]),e("li",null,[e("strong",null,"Filename (Disk)"),t(" \u2014 LOCKED, this is the actual name of the file in storage")]),e("li",null,[e("strong",null,"Filename (Download)"),t(" \u2014 This allows you to set the name of the file when it is downloaded")])],-1),T=e("p",null,"The file sidebar also includes the following details:",-1),D=e("ul",null,[e("li",null,[e("strong",null,"Type"),t(" \u2014 The MIME type of the file, displayed in the App as a formatted media type")]),e("li",null,[e("strong",null,"Dimensions"),t(" \u2014 (Images Only) The width and height of the image in pixels")]),e("li",null,[e("strong",null,"Size"),t(" \u2014 The file-size the asset takes up within the storage adapter")]),e("li",null,[e("strong",null,"Created"),t(" \u2014 The timestamp of when the file was uploaded to the project")]),e("li",null,[e("strong",null,"Owner"),t(" \u2014 The Directus user that uploaded the file to the project")]),e("li",null,[e("strong",null,"Folder"),t(" \u2014 The current parent folder that contains the file")]),e("li",null,[e("strong",null,"Metadata"),t(" \u2014 Metadata JSON dump of the file\u2019s EXIF, IPTC, and ICC information")])],-1),C=e("h4",{id:"action-buttons"},[t("Action Buttons "),e("a",{class:"header-anchor",href:"#action-buttons"},"#")],-1),I=e("ul",null,[e("li",null,[e("strong",null,"Save"),t(" \u2014 Saves any edits made to the page")]),e("li",null,[e("strong",null,"Edit"),t(" \u2014 Saves any edits made to the page")]),e("li",null,[e("strong",null,"Download"),t(" \u2014 Saves any edits made to the page")]),e("li",null,[e("strong",null,"Move Folder"),t(" \u2014 Saves any edits made to the page")]),e("li",null,[e("strong",null,"Delete"),t(" \u2014 Permanently removes this file and its metadata. This action is permanent and can not be undone.")])],-1),E=e("h2",{id:"editing-an-image"},[t("Editing an Image "),e("a",{class:"header-anchor",href:"#editing-an-image"},"#")],-1),A=e("p",null,"Clicking the \u201CEdit\u201D action button on the File Detail opens an image editor for rotating, cropping, or mirroring the file.",-1),M=e("ol",null,[e("li",null,[t("From the "),e("strong",null,"File Library"),t(", click a file to open it\u2019s detail page")]),e("li",null,"Click the edit button in the top right to open the image editor"),e("li",null,"Make your changes and hit save in the top right to save the updates to the file")],-1),x=e("h2",{id:"replacing-a-file"},[t("Replacing a File "),e("a",{class:"header-anchor",href:"#replacing-a-file"},"#")],-1),S=e("p",null,"Clicking the image Preview on the File Detail page opens a modal where you can replace the file. This is useful if you want to change the file, but keep existing file info and maintain all of the file\u2019s relationships.",-1),P=e("h2",{id:"uploading-a-file"},[t("Uploading a File "),e("a",{class:"header-anchor",href:"#uploading-a-file"},"#")],-1),B=e("p",null,"There are many ways that a file can be uploaded into Directus via the App. We\u2019ll cover the primary method below, but keep in mind that files can also be added directly through different interfaces.",-1),L=e("ol",null,[e("li",null,[t("From the "),e("strong",null,"File Library"),t(", click on the "),e("strong",null,"\u201CCreate Item\u201D"),t(" (+ icon) button located in the header")]),e("li",null,[e("strong",null,"Upload"),t(" the file by: "),e("ul",null,[e("li",null,"Dragging a file from your desktop to the modal"),e("li",null,"Click the modal area to manually select a file from your device"),e("li",null,"Clicking the \u201C\u2026\u201D icon and choosing \u201CImport from URL\u201D")])])],-1),U={setup(V,{expose:s}){const i={title:"File Library",modularExtension:!1};return s({frontmatter:i}),(j,N)=>{const n=o("router-link"),r=o("DocsWrapper");return d(),h(r,{frontmatter:i},{default:l(()=>[e("div",u,[c,g,f,e("p",null,[p,a(n,{to:"/docs/app/content-collections/"},{default:l(()=>[m]),_:1}),_]),w,e("p",null,[y,a(n,{to:"/docs/getting-started/glossary/#items"},{default:l(()=>[b]),_:1}),v]),F,k,T,D,C,I,E,A,M,x,S,P,B,L])]),_:1})}}};export{U as default};

package/dist/assets/files.9e4ff8ed.js

@@ -0,0 +1,187 @@
+import{p as o,q as c,C as h,v as l,M as e,u as a,D as s}from"./vendor.299bc11c.js";var d="assets/original.888775a8.jpg",u="data:image/jpeg;base64,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",p="assets/200-200-cover-50.b5c757be.jpg",f="assets/200-200-cover-75.5e0d9ff8.jpg",_="assets/200-200-cover-100.6a119754.jpg";const g={class:"markdown-body"},m=e("div",{class:"two-up"},[e("div",{class:"left"},[e("blockquote",null,[e("p",null,[s("Every file managed by the platform is uploaded to the configured storage adapter, and its associated metadata is tracked within the "),e("code",null,"directus_files"),s(" system collection. Any requested file transformations are handled on the fly, and are only saved to storage.")])])]),e("div",{class:"right"},[e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#accessing-an-file"},"Accessing an File")]),e("li",null,[e("a",{href:"#downloading-a-file"},"Downloading a File")]),e("li",null,[e("a",{href:"#requesting-a-thumbnail"},"Requesting a Thumbnail")]),e("li",null,[e("a",{href:"#the-file-object"},"The File Object")]),e("li",null,[e("a",{href:"#list-files"},"List Files")]),e("li",null,[e("a",{href:"#retrieve-a-file"},"Retrieve a File")]),e("li",null,[e("a",{href:"#upload-a-file"},"Upload a File")]),e("li",null,[e("a",{href:"#import-a-file"},"Import a File")]),e("li",null,[e("a",{href:"#update-a-file"},"Update a File")]),e("li",null,[e("a",{href:"#update-multiple-files"},"Update Multiple Files")]),e("li",null,[e("a",{href:"#delete-a-file"},"Delete a File")]),e("li",null,[e("a",{href:"#delete-multiple-files"},"Delete Multiple Files")])])])])])],-1),y=e("hr",null,null,-1),j=e("h2",{id:"accessing-an-file"},[s("Accessing an File "),e("a",{class:"header-anchor",href:"#accessing-an-file"},"#")],-1),b=e("div",{class:"two-up"},[e("div",{class:"left"},[e("p",null,"The location of your actual file originals is based on the project\u2019s configuration, but you can consistently access them via the API using the following URL."),e("pre",null,[e("code",null,`example.com/assets/<file-id>
+example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4
+`)]),e("div",{class:"warning hint"},[e("div",{class:"hint-title"},"Direct File Access"),e("p",null,[s("While you may "),e("em",null,"technically"),s(" be able to expose your storage adapters root filesystem and access your raw files through there, it is recommended that you always use the Directus API. This is the only way that you can take advantage of file permissions and other built-in features.")])])]),e("div",{class:"right"},[e("p",null,[e("img",{src:d,alt:"Original File"}),s(),e("em",null,"Original File Used \u2014 602KB and 1800x1200")])])],-1),A=e("hr",null,null,-1),q=e("h2",{id:"downloading-a-file"},[s("Downloading a File "),e("a",{class:"header-anchor",href:"#downloading-a-file"},"#")],-1),x=e("div",{class:"two-up"},[e("div",{class:"left"},[e("p",null,[s("To download an asset with the correct filename, you need to add the "),e("code",null,"?download"),s(" query parameter to the request and the "),e("code",null,"download"),s(" attribute to your anchor tag. This will ensure the appropriate "),e("a",{href:"https://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html",target:"_blank",rel:"noopener noreferrer"},"Content-Disposition"),s(" headers are added. Without this, the download will work on the "),e("em",null,"same"),s(" domain, however it will have the file\u2019s \u201Cid\u201D as the filename for cross-origin requests.")])]),e("div",{class:"right"},[e("h3",{id:"example"},[s("Example "),e("a",{class:"header-anchor",href:"#example"},"#")]),e("pre",null,[e("code",{class:"language-html"},[e("span",{class:"hljs-tag"},[s("<"),e("span",{class:"hljs-name"},"a"),s(),e("span",{class:"hljs-attr"},"href"),s("="),e("span",{class:"hljs-string"},'"https://your-directus.com/assets/<file-id>?download"'),s(),e("span",{class:"hljs-attr"},"target"),s("="),e("span",{class:"hljs-string"},'"_blank"'),s(),e("span",{class:"hljs-attr"},"download"),s("="),e("span",{class:"hljs-string"},'"Your File.pdf"'),s(">")]),s("Download"),e("span",{class:"hljs-tag"},[s("</"),e("span",{class:"hljs-name"},"a"),s(">")]),s(`
+`)])])])],-1),w=e("hr",null,null,-1),T=e("h2",{id:"requesting-a-thumbnail"},[s("Requesting a Thumbnail "),e("a",{class:"header-anchor",href:"#requesting-a-thumbnail"},"#")],-1),R={class:"two-up"},v={class:"left"},U=e("p",null,[s("Fetching thumbnails is as easy as adding a "),e("code",null,"key"),s(" query parameter to the original file\u2019s URL. In the Admin App, you can configure different asset presets that control the output of any given image. If a requested thumbnail doesn\u2019t yet exist, it is dynamically generated and immediately returned.")],-1),k=e("h3",{id:"preset-transformations"},[s("Preset Transformations "),e("a",{class:"header-anchor",href:"#preset-transformations"},"#")],-1),B=e("strong",null,[e("code",null,"key")],-1),E=s(" \u2014 This "),I=e("strong",null,"key",-1),Q=s(" of the "),S=s("Storage Asset Preset"),D=s(", a shortcut for the below parameters"),F=e("h3",{id:"custom-transformations"},[s("Custom Transformations "),e("a",{class:"header-anchor",href:"#custom-transformations"},"#")],-1),O=e("p",null,"Alternatively, if you have \u201CStorage Asset Transform\u201D set to all, you can use the following parameters for more fine grained control:",-1),C=e("ul",null,[e("li",null,[e("strong",null,[e("code",null,"fit")]),s(" \u2014 The "),e("strong",null,"fit"),s(" of the thumbnail while always preserving the aspect ratio, can be any of the following options: "),e("ul",null,[e("li",null,[e("code",null,"cover"),s(" \u2014 Covers both width/height by cropping/clipping to fit")]),e("li",null,[e("code",null,"contain"),s(" \u2014 Contain within both width/height using \u201Cletterboxing\u201D as needed")]),e("li",null,[e("code",null,"inside"),s(" \u2014 Resize to be as large as possible, ensuring dimensions are less than or equal to the requested width and height")]),e("li",null,[e("code",null,"outside"),s(" \u2014 Resize to be as small as possible, ensuring dimensions are greater than or equal to the requested width and height")])])]),e("li",null,[e("strong",null,[e("code",null,"width")]),s(" \u2014 The "),e("strong",null,"width"),s(" of the thumbnail in pixels")]),e("li",null,[e("strong",null,[e("code",null,"height")]),s(" \u2014 The "),e("strong",null,"height"),s(" of the thumbnail in pixels")]),e("li",null,[e("strong",null,[e("code",null,"quality")]),s(" \u2014 The optional "),e("strong",null,"quality"),s(" of the thumbnail ("),e("code",null,"1"),s(" to "),e("code",null,"100"),s(")")]),e("li",null,[e("strong",null,[e("code",null,"withoutEnlargement")]),s(" \u2014 Disable image up-scaling")]),e("li",null,[e("strong",null,[e("code",null,"format")]),s(" \u2014 What file format to return the thumbnail in. One of "),e("code",null,"jpg"),s(", "),e("code",null,"png"),s(", "),e("code",null,"webp"),s(", "),e("code",null,"tiff")])],-1),G=e("h3",{id:"advanced-transformations"},[s("Advanced Transformations "),e("a",{class:"header-anchor",href:"#advanced-transformations"},"#")],-1),Y=e("p",null,[s("For even more advanced control over the file generation, Directus exposes "),e("a",{href:"https://sharp.pixelplumbing.com/api-operation",target:"_blank",rel:"noopener noreferrer"},[s("the full "),e("code",null,"sharp"),s(" API")]),s(" through the "),e("code",null,"transforms"),s(" query parameter. This parameter accepts a two-dimensional array with the format "),e("code",null,"[Operation, ...arguments]"),s(".")],-1),M=e("h3",{id:"quality-vs-filesize"},[s("Quality vs Filesize "),e("a",{class:"header-anchor",href:"#quality-vs-filesize"},"#")],-1),P=e("p",null,[s("The quality parameter can be any integer from "),e("code",null,"0-100"),s(". Qualities closer to "),e("code",null,"0"),s(" have lower filesizes, but also poor image quality due to compression artifacts. Values closer to "),e("code",null,"100"),s(" have larger filesizes, but better image quality. Below are four possible qualities (200x200 cover) to visually compare the balance between compression and filesize.")],-1),K=e("table",null,[e("thead",null,[e("tr",null,[e("th",null,"25%"),e("th",null,"50%"),e("th",null,"75%"),e("th",null,"100%")])]),e("tbody",null,[e("tr",null,[e("td",null,[e("img",{src:u,alt:"25%"}),e("br"),e("em",null,"4KB")]),e("td",null,[e("img",{src:p,alt:"50%"}),e("br"),e("em",null,"6KB")]),e("td",null,[e("img",{src:f,alt:"75%"}),e("br"),e("em",null,"8KB")]),e("td",null,[e("img",{src:_,alt:"100%"}),e("br"),e("em",null,"38KB")])])])],-1),H=e("div",{class:"right"},[e("h3",{id:"preset"},[s("Preset "),e("a",{class:"header-anchor",href:"#preset"},"#")]),e("pre",null,[e("code",null,`example.com/assets/<file-id>?key=<key>
+`)]),e("h3",{id:"custom"},[s("Custom "),e("a",{class:"header-anchor",href:"#custom"},"#")]),e("pre",null,[e("code",null,`example.com/assets/<file-id>?fit=<fit>&width=<width>&height=<height>&quality=<quality>
+example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4?fit=cover&width=200&height=200&quality=80
+`)]),e("h3",{id:"advanced"},[s("Advanced "),e("a",{class:"header-anchor",href:"#advanced"},"#")]),e("pre",null,[e("code",null,`?transforms=[
+	["blur", 45],
+	["tint", "rgb(255, 0, 0)"],
+	["expand", { "right": 200, "bottom": 150 }]
+]
+`)])],-1),J=e("hr",null,null,-1),W=e("h2",{id:"the-file-object"},[s("The File Object "),e("a",{class:"header-anchor",href:"#the-file-object"},"#")],-1),L={class:"two-up"},N={class:"left"},V={class:"definitions"},z=e("p",null,[e("code",null,"id"),s(),e("strong",null,"uuid"),e("br"),s(" Primary key of the file")],-1),X=e("p",null,[e("code",null,"storage"),s(),e("strong",null,"string"),e("br"),s(" Storage adapter used for the file.")],-1),Z=e("p",null,[e("code",null,"filename_disk"),s(),e("strong",null,"string"),e("br"),s(" Name of the file as saved on the storage adapter.")],-1),$=e("p",null,[e("code",null,"filename_download"),s(),e("strong",null,"string"),e("br"),s(" Preferred filename when file is downloaded.")],-1),ee=e("p",null,[e("code",null,"title"),s(),e("strong",null,"string"),e("br"),s(" Title for the file.")],-1),se=e("p",null,[e("code",null,"type"),s(),e("strong",null,"string"),e("br"),s(" Mimetype of the file.")],-1),le=e("code",null,"folder",-1),te=s(),ae=e("strong",null,"many-to-one",-1),ne=e("br",null,null,-1),oe=s(" What (virtual) folder the file is in. Many-to-one to "),ie=s("folders"),re=s("."),ce=e("code",null,"uploaded_by",-1),he=s(),de=e("strong",null,"many-to-one",-1),ue=e("br",null,null,-1),pe=s(" Who uploaded the file. Many-to-one to "),fe=s("users"),_e=s("."),ge=e("p",null,[e("code",null,"uploaded_on"),s(),e("strong",null,"datetime"),e("br"),s(" When the file was uploaded.")],-1),me=e("code",null,"modified_by",-1),ye=s(),je=e("strong",null,"many-to-one",-1),be=e("br",null,null,-1),Ae=s(" Who updated the file last. Many-to-one to "),qe=s("users"),xe=s("."),we=e("p",null,[e("code",null,"filesize"),s(),e("strong",null,"number"),e("br"),s(" Size of the file in bytes.")],-1),Te=e("p",null,[e("code",null,"width"),s(),e("strong",null,"number"),e("br"),s(" If the file is a(n) image/video, it\u2019s the width in px.")],-1),Re=e("p",null,[e("code",null,"height"),s(),e("strong",null,"number"),e("br"),s(" If the file is a(n) image/video, it\u2019s the height in px.")],-1),ve=e("p",null,[e("code",null,"duration"),s(),e("strong",null,"number"),e("br"),s(" If the file contains audio/video, it\u2019s the duration in milliseconds.")],-1),Ue=e("p",null,[e("code",null,"description"),s(),e("strong",null,"string"),e("br"),s(" Description of the file.")],-1),ke=e("p",null,[e("code",null,"location"),s(),e("strong",null,"string"),e("br"),s(" Location of the file.")],-1),Be=e("p",null,[e("code",null,"tags"),s(),e("strong",null,"array"),e("br"),s(" Tags for the file.")],-1),Ee=e("p",null,[e("code",null,"metadata"),s(),e("strong",null,"object"),e("br"),s(" Any additional metadata Directus was able to scrape from the file. For images, this includes EXIF, IPTC, and ICC information.")],-1),Ie=e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[s(`{
+	`),e("span",{class:"hljs-attr"},'"id"'),s(": "),e("span",{class:"hljs-string"},'"4f4b14fa-a43a-46d0-b7ad-90af5919bebb"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"storage"'),s(": "),e("span",{class:"hljs-string"},'"local"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"filename_disk"'),s(": "),e("span",{class:"hljs-string"},'"4f4b14fa-a43a-46d0-b7ad-90af5919bebb.jpeg"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"filename_download"'),s(": "),e("span",{class:"hljs-string"},'"paulo-silva-vSRgXtQuns8-unsplash.jpg"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"title"'),s(": "),e("span",{class:"hljs-string"},'"Paulo Silva (via Unsplash)"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"type"'),s(": "),e("span",{class:"hljs-string"},'"image/jpeg"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"folder"'),s(": "),e("span",{class:"hljs-literal"},"null"),s(`,
+	`),e("span",{class:"hljs-attr"},'"uploaded_by"'),s(": "),e("span",{class:"hljs-string"},'"0bc7b36a-9ba9-4ce0-83f0-0a526f354e07"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"uploaded_on"'),s(": "),e("span",{class:"hljs-string"},'"2021-02-04T11:37:41-05:00"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"modified_by"'),s(": "),e("span",{class:"hljs-literal"},"null"),s(`,
+	`),e("span",{class:"hljs-attr"},'"modified_on"'),s(": "),e("span",{class:"hljs-string"},'"2021-02-04T11:37:42-05:00"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"filesize"'),s(": "),e("span",{class:"hljs-number"},"3442252"),s(`,
+	`),e("span",{class:"hljs-attr"},'"width"'),s(": "),e("span",{class:"hljs-number"},"3456"),s(`,
+	`),e("span",{class:"hljs-attr"},'"height"'),s(": "),e("span",{class:"hljs-number"},"5184"),s(`,
+	`),e("span",{class:"hljs-attr"},'"duration"'),s(": "),e("span",{class:"hljs-literal"},"null"),s(`,
+	`),e("span",{class:"hljs-attr"},'"description"'),s(": "),e("span",{class:"hljs-literal"},"null"),s(`,
+	`),e("span",{class:"hljs-attr"},'"location"'),s(": "),e("span",{class:"hljs-literal"},"null"),s(`,
+	`),e("span",{class:"hljs-attr"},'"tags"'),s(": ["),e("span",{class:"hljs-string"},'"photo"'),s(", "),e("span",{class:"hljs-string"},'"pretty"'),s(`],
+	`),e("span",{class:"hljs-attr"},'"metadata"'),s(`: {
+		`),e("span",{class:"hljs-attr"},'"icc"'),s(`: {
+			`),e("span",{class:"hljs-attr"},'"version"'),s(": "),e("span",{class:"hljs-string"},'"2.1"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"intent"'),s(": "),e("span",{class:"hljs-string"},'"Perceptual"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"cmm"'),s(": "),e("span",{class:"hljs-string"},'"lcms"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"deviceClass"'),s(": "),e("span",{class:"hljs-string"},'"Monitor"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"colorSpace"'),s(": "),e("span",{class:"hljs-string"},'"RGB"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"connectionSpace"'),s(": "),e("span",{class:"hljs-string"},'"XYZ"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"platform"'),s(": "),e("span",{class:"hljs-string"},'"Apple"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"creator"'),s(": "),e("span",{class:"hljs-string"},'"lcms"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"description"'),s(": "),e("span",{class:"hljs-string"},'"c2"'),s(`,
+			`),e("span",{class:"hljs-attr"},'"copyright"'),s(": "),e("span",{class:"hljs-string"},'""'),s(`
+		}
+	}
+}
+`)])])],-1),Qe=e("hr",null,null,-1),Se=e("h2",{id:"list-files"},[s("List Files "),e("a",{class:"header-anchor",href:"#list-files"},"#")],-1),De=e("p",null,"List all files that exist in Directus.",-1),Fe={class:"two-up"},Oe={class:"left"},Ce=e("h3",{id:"query-parameters"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters"},"#")],-1),Ge=s("Supports all "),Ye=s("global query parameters"),Me=s("."),Pe=e("h3",{id:"returns"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns"},"#")],-1),Ke=s("An array of up to "),He=s("limit"),Je=s(),We=e("a",{href:"#the-file-object"},"file objects",-1),Le=s(". If no items are available, data will be an empty array."),Ne={class:"right"},Ve=e("h3",{id:"rest-api"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api"},"#")],-1),ze=e("pre",null,[e("code",null,`GET /files
+SEARCH /files
+`)],-1),Xe=s("Learn more about SEARCH ->"),Ze=e("h3",{id:"graphql"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql"},"#")],-1),$e=e("pre",null,[e("code",null,`POST /graphql/system
+`)],-1),es=e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"type"),e("span",{class:"hljs-type"}," Query"),s(` {
+	files: [directus_files]
+}
+`)])],-1),ss=e("h5",{id:"example-2"},[s("Example "),e("a",{class:"header-anchor",href:"#example-2"},"#")],-1),ls=e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"query"),s(` {
+	files {
+		id
+		filename_disk
+	}
+}
+`)])],-1),ts=e("hr",null,null,-1),as=e("h2",{id:"retrieve-a-file"},[s("Retrieve a File "),e("a",{class:"header-anchor",href:"#retrieve-a-file"},"#")],-1),ns=e("p",null,"Retrieve a single file by primary key.",-1),os={class:"two-up"},is={class:"left"},rs=e("h3",{id:"query-parameters-2"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-2"},"#")],-1),cs=s("Supports all "),hs=s("global query parameters"),ds=s("."),us=e("h3",{id:"returns-2"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-2"},"#")],-1),ps=e("p",null,[s("Returns a "),e("a",{href:"#the-file-object"},"file object"),s(" if a valid primary key was provided.")],-1),fs=e("div",{class:"right"},[e("h3",{id:"rest-api-2"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-2"},"#")]),e("pre",null,[e("code",null,`GET /files/:id
+`)]),e("h5",{id:"example-3"},[s("Example "),e("a",{class:"header-anchor",href:"#example-3"},"#")]),e("pre",null,[e("code",null,`GET /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d
+`)]),e("h3",{id:"graphql-2"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-2"},"#")]),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"}," Query"),s(` {
+	files_by_id(id:`),e("span",{class:"hljs-literal"}," ID"),s(`!): directus_files
+}
+`)])]),e("h5",{id:"example-4"},[s("Example "),e("a",{class:"header-anchor",href:"#example-4"},"#")]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"query"),s(` {
+	files_by_id(id: `),e("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),s(`) {
+		id
+		filename_disk
+	}
+}
+`)])])],-1),_s=e("h2",{id:"upload-a-file"},[s("Upload a File "),e("a",{class:"header-anchor",href:"#upload-a-file"},"#")],-1),gs=e("p",null,"Upload/create a new file.",-1),ms={class:"two-up"},ys={class:"left"},js=e("p",null,[s("To upload a file, use "),e("code",null,"multipart/form-data"),s(" as the encoding type, instead of JSON.")],-1),bs=e("p",null,[s("The file contents has to to be provided in a part called "),e("code",null,"file"),s(". All other properties of "),e("a",{href:"#the-file-object"},"the file object"),s(" can be provided as parts as well.")],-1),As=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Order Matters"),e("p",null,[s("Make sure to define the non-file properties "),e("em",null,"first"),s(". This ensures that the file metadata is associated with the correct file.")])],-1),qs=e("p",null,"You can upload multiple files at a time by repeating the payload with different contents, for example:",-1),xs=e("pre",null,[e("code",null,`--__X_BOUNDARY__
+Content-Disposition: form-data; name="title"
+
+Example
+--__X_BOUNDARY__
+Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
+Content-Type: image/jpeg
+
+// binary data
+
+--__X_BOUNDARY__
+Content-Disposition: form-data; name="title"
+
+Another Title
+--__X_BOUNDARY__
+Content-Disposition: form-data; name="file"; filename="mae-mu-GFhqNX1gE9E-unsplash.jpg"
+Content-Type: image/jpeg
+
+// binary data
+`)],-1),ws=e("p",null,[s("In JavaScript, this can be achieved using the native "),e("code",null,"FormData"),s(" class:")],-1),Ts=e("pre",null,[e("code",{class:"language-js"},[e("span",{class:"hljs-keyword"},"import"),s(" axios "),e("span",{class:"hljs-keyword"},"from"),s(),e("span",{class:"hljs-string"},"'axios'"),s(`;
+
+`),e("span",{class:"hljs-keyword"},"const"),s(" fileInput = "),e("span",{class:"hljs-built_in"},"document"),s(".querySelector("),e("span",{class:"hljs-string"},`'input[type="file"]'`),s(`);
+`),e("span",{class:"hljs-keyword"},"const"),s(" formData = "),e("span",{class:"hljs-keyword"},"new"),s(` FormData();
+
+formData.append(`),e("span",{class:"hljs-string"},"'title'"),s(", "),e("span",{class:"hljs-string"},"'My First File'"),s(`);
+formData.append(`),e("span",{class:"hljs-string"},"'file'"),s(", fileInput.files["),e("span",{class:"hljs-number"},"0"),s(`]);
+
+`),e("span",{class:"hljs-keyword"},"await"),s(" axios.post("),e("span",{class:"hljs-string"},"'/files'"),s(`, formData);
+`)])],-1),Rs=e("h3",{id:"query-parameters-3"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-3"},"#")],-1),vs=s("Supports all "),Us=s("global query parameters"),ks=s("."),Bs=e("h3",{id:"returns-3"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-3"},"#")],-1),Es=e("p",null,[s("Returns the "),e("a",{href:"#the-file-object"},"file object"),s(" for the uploaded file, or an array of "),e("a",{href:"#the-file-object"},"file objects"),s(" if multiple files were uploaded at once.")],-1),Is=e("div",{class:"right"},[e("pre",null,[e("code",null,`POST /files
+`)]),e("pre",null,[e("code",null,`// Request
+
+Content-Type: multipart/form-data; charset=utf-8; boundary=__X_BOUNDARY__
+Content-Length: 3442422
+
+--__X_BOUNDARY__
+Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
+Content-Type: image/jpeg
+
+\xFF\xD8\xFF\xE0JFIF


HH\xFF\xE2ICC_PROFILE

\flcmsmntrRGB XYZ \x07\xDC
)9acspAPPL\xF6\xD6
\xD3-lcms
+desc\xFC^cprt
\\\vwtpt
hbkpt
|rXYZ
\x90gXYZ
\xA4bXYZ
\xB8rTRC
\xCC@gTRC
\xCC@bTRC
\xCC@descc2textIXXYZ \xF6\xD6
\xD3-XYZ 3\xA4XYZ o\xA28\xF5\x90XYZ b\x99\xB7\x85\xDAXYZ $\xA0\x84\xB6\xCFcurv\xCB
\xC9c\x92\bk\v\xF6?Q4!\xF1)\x902;\x92FQw]\xEDkpz\x89\xB1\x9A|\xACi\xBF}\xD3\xC3\xE90\xFF\xFF\xFF\xDB\x84\b\b\x07\x07
+`)])],-1),Qs=e("hr",null,null,-1),Ss=e("h2",{id:"import-a-file"},[s("Import a File "),e("a",{class:"header-anchor",href:"#import-a-file"},"#")],-1),Ds=e("p",null,"Import a file from the web",-1),Fs={class:"two-up"},Os={class:"left"},Cs=e("h3",{id:"query-parameters-4"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-4"},"#")],-1),Gs=s("Supports all "),Ys=s("global query parameters"),Ms=s("."),Ps=e("h3",{id:"request-body"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body"},"#")],-1),Ks=e("div",{class:"definitions"},[e("p",null,[e("code",null,"url"),s(),e("strong",null,"Required"),e("br"),s(" The URL to download the file from.")]),e("p",null,[e("code",null,"data"),e("br"),s(" Any of "),e("a",{href:"#the-file-object"},"the file object"),s("\u2019s properties.")])],-1),Hs=e("h3",{id:"returns-4"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-4"},"#")],-1),Js=e("p",null,[s("Returns the "),e("a",{href:"#the-file-object"},"file object"),s(" for the imported file.")],-1),Ws=e("div",{class:"right"},[e("h3",{id:"rest-api-3"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-3"},"#")]),e("pre",null,[e("code",null,`POST /files/import
+`)]),e("h5",{id:"example-5"},[s("Example "),e("a",{class:"header-anchor",href:"#example-5"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// POST /files/import"),s(`
+
+{
+	`),e("span",{class:"hljs-attr"},'"url"'),s(": "),e("span",{class:"hljs-string"},'"https://source.unsplash.com/random"'),s(`,
+	`),e("span",{class:"hljs-attr"},'"data"'),s(`: {
+		`),e("span",{class:"hljs-attr"},'"title"'),s(": "),e("span",{class:"hljs-string"},'"Example"'),s(`
+	}
+}
+`)])]),e("h3",{id:"graphql-3"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-3"},"#")]),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"),s(` {
+	import_file(url:`),e("span",{class:"hljs-type"}," String"),s(`!, data: create_directus_files_input!): directus_files
+}
+`)])]),e("h5",{id:"example-6"},[s("Example "),e("a",{class:"header-anchor",href:"#example-6"},"#")]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"mutation"),s(` {
+	import_file(url: `),e("span",{class:"hljs-string"},'"https://source.unsplash.com/random"'),s(", data: { title: "),e("span",{class:"hljs-string"},'"Example"'),s(` }) {
+		id
+	}
+}
+`)])])],-1),Ls=e("hr",null,null,-1),Ns=e("h2",{id:"update-a-file"},[s("Update a File "),e("a",{class:"header-anchor",href:"#update-a-file"},"#")],-1),Vs=e("p",null,"Update an existing file, and/or replace it\u2019s file contents.",-1),zs={class:"two-up"},Xs={class:"left"},Zs=e("h3",{id:"query-parameters-5"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-5"},"#")],-1),$s=s("Supports all "),el=s("global query parameters"),sl=s("."),ll=e("h3",{id:"request-body-2"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body-2"},"#")],-1),tl=e("p",null,[s("You can either submit a JSON object consisting of a partial "),e("a",{href:"#the-file-object"},"file object"),s(" to update the file meta, or send a multipart/form-data request to replace the file contents on disk. See "),e("a",{href:"#upload-a-file"},"Upload a File"),s(" for more information on the structure of this "),e("code",null,"multipart/form-data"),s(" request.")],-1),al=e("h3",{id:"returns-5"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-5"},"#")],-1),nl=e("p",null,[s("Returns the "),e("a",{href:"#the-file-object"},"file object"),s(" for the updated file.")],-1),ol=e("div",{class:"right"},[e("h3",{id:"rest-api-4"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-4"},"#")]),e("pre",null,[e("code",null,`PATCH /files/:id
+`)]),e("h5",{id:"example-7"},[s("Example "),e("a",{class:"header-anchor",href:"#example-7"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// PATCH /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d"),s(`
+
+{
+	`),e("span",{class:"hljs-attr"},'"title"'),s(": "),e("span",{class:"hljs-string"},'"Example"'),s(`
+}
+`)])]),e("h3",{id:"graphql-4"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-4"},"#")]),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"),s(` {
+	update_files_item(id:`),e("span",{class:"hljs-literal"}," ID"),s(`!, data: update_directus_files_input!): directus_files
+}
+`)])]),e("h5",{id:"example-8"},[s("Example "),e("a",{class:"header-anchor",href:"#example-8"},"#")]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"mutation"),s(` {
+	update_files_item(id: `),e("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),s(", data: { title: "),e("span",{class:"hljs-string"},'"Example"'),s(` }) {
+		id
+		title
+	}
+}
+`)])])],-1),il=e("hr",null,null,-1),rl=e("h2",{id:"update-multiple-files"},[s("Update Multiple Files "),e("a",{class:"header-anchor",href:"#update-multiple-files"},"#")],-1),cl=e("p",null,"Update multiple files at the same time.",-1),hl={class:"two-up"},dl={class:"left"},ul=e("h3",{id:"query-parameters-6"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-6"},"#")],-1),pl=s("Supports all "),fl=s("global query parameters"),_l=s("."),gl=e("h3",{id:"request-body-3"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body-3"},"#")],-1),ml=e("div",{class:"definitions"},[e("p",null,[e("code",null,"keys"),s(),e("strong",null,"Required"),e("br"),s(" Array of primary keys of the files you\u2019d like to update.")]),e("p",null,[e("code",null,"data"),s(),e("strong",null,"Required"),e("br"),s(" Any of "),e("a",{href:"#the-file-object"},"the file object"),s("\u2019s properties.")])],-1),yl=e("h3",{id:"returns-6"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-6"},"#")],-1),jl=e("p",null,[s("Returns the "),e("a",{href:"#the-file-object"},"file objects"),s(" for the updated files.")],-1),bl=e("div",{class:"right"},[e("h3",{id:"rest-api-5"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),e("pre",null,[e("code",null,`PATCH /files
+`)]),e("h5",{id:"example-9"},[s("Example "),e("a",{class:"header-anchor",href:"#example-9"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// PATCH /files"),s(`
+
+{
+	`),e("span",{class:"hljs-attr"},'"keys"'),s(": ["),e("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s(", "),e("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s(`],
+	`),e("span",{class:"hljs-attr"},'"data"'),s(`: {
+		`),e("span",{class:"hljs-attr"},'"tags"'),s(": ["),e("span",{class:"hljs-string"},'"cities"'),s(`]
+	}
+}
+`)])]),e("h3",{id:"graphql-5"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-5"},"#")]),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"),s(` {
+	update_files_items(ids: `),e("span",{class:"hljs-literal"},"[ID"),s(`!]!, data: update_directus_files!): [directus_files]
+}
+`)])]),e("h5",{id:"example-10"},[s("Example "),e("a",{class:"header-anchor",href:"#example-10"},"#")]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"mutation"),s(` {
+	update_files_items(
+		ids: [`),e("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s(", "),e("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s(`]
+		data: { tags: [`),e("span",{class:"hljs-string"},'"cities"'),s(`] }
+	)
+}
+`)])])],-1),Al=e("hr",null,null,-1),ql=e("h2",{id:"delete-a-file"},[s("Delete a File "),e("a",{class:"header-anchor",href:"#delete-a-file"},"#")],-1),xl=e("p",null,"Delete an existing file.",-1),wl={class:"two-up"},Tl={class:"left"},Rl=e("div",{class:"danger hint"},[e("div",{class:"hint-title"},"Destructive"),e("p",null,"This will also delete the file from disk.")],-1),vl=e("h3",{id:"query-parameters-7"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-7"},"#")],-1),Ul=s("Supports all "),kl=s("global query parameters"),Bl=s("."),El=e("h3",{id:"returns-7"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-7"},"#")],-1),Il=e("p",null,"Empty response.",-1),Ql=e("div",{class:"right"},[e("h3",{id:"rest-api-6"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-6"},"#")]),e("pre",null,[e("code",null,`DELETE /files/:id
+`)]),e("h5",{id:"example-11"},[s("Example "),e("a",{class:"header-anchor",href:"#example-11"},"#")]),e("pre",null,[e("code",null,`DELETE /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d
+`)]),e("h3",{id:"graphql-6"},[s("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"),s(` {
+	delete_files_item(id:`),e("span",{class:"hljs-literal"}," ID"),s(`!): delete_one
+}
+`)])]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"mutation"),s(` {
+	delete_files_item(id: `),e("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),s(`) {
+		id
+	}
+}
+`)])])],-1),Sl=e("hr",null,null,-1),Dl=e("h2",{id:"delete-multiple-files"},[s("Delete Multiple Files "),e("a",{class:"header-anchor",href:"#delete-multiple-files"},"#")],-1),Fl=e("p",null,"Delete multiple files at once.",-1),Ol=e("div",{class:"two-up"},[e("div",{class:"left"},[e("div",{class:"danger hint"},[e("div",{class:"hint-title"},"Destructive"),e("p",null,"This will also delete the files from disk.")]),e("h3",{id:"request-body-4"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body-4"},"#")]),e("p",null,"Array of file primary keys"),e("h3",{id:"returns-8"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-8"},"#")]),e("p",null,"Empty response.")]),e("div",{class:"right"},[e("h3",{id:"rest-api-7"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-7"},"#")]),e("pre",null,[e("code",null,`DELETE /files
+`)]),e("h5",{id:"example-12"},[s("Example "),e("a",{class:"header-anchor",href:"#example-12"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// DELETE /files"),s(`
+
+[`),e("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s(", "),e("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s(`]
+`)])]),e("h3",{id:"graphql-7"},[s("GraphQL "),e("a",{class:"header-anchor",href:"#graphql-7"},"#")]),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"),s(` {
+	delete_files_items(ids: `),e("span",{class:"hljs-literal"},"[ID"),s(`!]!): delete_many
+}
+`)])]),e("h5",{id:"example-13"},[s("Example "),e("a",{class:"header-anchor",href:"#example-13"},"#")]),e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"mutation"),s(` {
+	delete_files_items(ids: [`),e("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s(", "),e("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s(`]) {
+		ids
+	}
+}
+`)])])])],-1),Pl={setup(Cl,{expose:i}){const n={title:"Accessing Files",modularExtension:!1,pageClass:"page-reference"};return i({frontmatter:n}),(Gl,Yl)=>{const t=o("router-link"),r=o("DocsWrapper");return c(),h(r,{frontmatter:n},{default:l(()=>[e("div",g,[m,y,j,b,A,q,x,w,T,e("div",R,[e("div",v,[U,k,e("ul",null,[e("li",null,[B,E,I,Q,a(t,{to:"/docs/configuration/project-settings/#files-thumbnails"},{default:l(()=>[S]),_:1}),D])]),F,O,C,G,Y,M,P,K]),H]),J,W,e("div",L,[e("div",N,[e("div",V,[z,X,Z,$,ee,se,e("p",null,[le,te,ae,ne,oe,a(t,{to:"/docs/reference/system/folders/"},{default:l(()=>[ie]),_:1}),re]),e("p",null,[ce,he,de,ue,pe,a(t,{to:"/docs/reference/system/users/"},{default:l(()=>[fe]),_:1}),_e]),ge,e("p",null,[me,ye,je,be,Ae,a(t,{to:"/docs/reference/system/users/"},{default:l(()=>[qe]),_:1}),xe]),we,Te,Re,ve,Ue,ke,Be,Ee])]),Ie]),Qe,Se,De,e("div",Fe,[e("div",Oe,[Ce,e("p",null,[Ge,a(t,{to:"/docs/reference/query"},{default:l(()=>[Ye]),_:1}),Me]),Pe,e("p",null,[Ke,a(t,{to:"/docs/reference/query/#limit"},{default:l(()=>[He]),_:1}),Je,We,Le])]),e("div",Ne,[Ve,ze,e("p",null,[a(t,{to:"/docs/reference/introduction/#search-http-method"},{default:l(()=>[Xe]),_:1})]),Ze,$e,es,ss,ls])]),ts,as,ns,e("div",os,[e("div",is,[rs,e("p",null,[cs,a(t,{to:"/docs/reference/query"},{default:l(()=>[hs]),_:1}),ds]),us,ps]),fs]),_s,gs,e("div",ms,[e("div",ys,[js,bs,As,qs,xs,ws,Ts,Rs,e("p",null,[vs,a(t,{to:"/docs/reference/query"},{default:l(()=>[Us]),_:1}),ks]),Bs,Es]),Is]),Qs,Ss,Ds,e("div",Fs,[e("div",Os,[Cs,e("p",null,[Gs,a(t,{to:"/docs/reference/query"},{default:l(()=>[Ys]),_:1}),Ms]),Ps,Ks,Hs,Js]),Ws]),Ls,Ns,Vs,e("div",zs,[e("div",Xs,[Zs,e("p",null,[$s,a(t,{to:"/docs/reference/query"},{default:l(()=>[el]),_:1}),sl]),ll,tl,al,nl]),ol]),il,rl,cl,e("div",hl,[e("div",dl,[ul,e("p",null,[pl,a(t,{to:"/docs/reference/query"},{default:l(()=>[fl]),_:1}),_l]),gl,ml,yl,jl]),bl]),Al,ql,xl,e("div",wl,[e("div",Tl,[Rl,vl,e("p",null,[Ul,a(t,{to:"/docs/reference/query"},{default:l(()=>[kl]),_:1}),Bl]),El,Il]),Ql]),Sl,Dl,Fl,Ol])]),_:1})}}};export{Pl as default};

package/dist/assets/filter-rules.339629f8.js

@@ -0,0 +1,60 @@
+import{p as s,q as r,C as u,v as o,M as l,D as t}from"./vendor.299bc11c.js";const i=l("div",{class:"markdown-body"},[l("blockquote",null,[l("p",null,[t("Permissions, validation, and the API\u2019s "),l("code",null,"filter"),t(" parameter all rely on a specific JSON structure to define their rules. This page describes the syntax for creating flat, relational, or complex filter rules.")])]),l("p",null,[l("div",{class:"table-of-contents"},[l("ul",null,[l("li",null,[l("a",{href:"#syntax"},"Syntax")]),l("li",null,[l("a",{href:"#filter-operators"},"Filter Operators")]),l("li",null,[l("a",{href:"#relational"},"Relational")]),l("li",null,[l("a",{href:"#logical-operators"},"Logical Operators")]),l("li",null,[l("a",{href:"#dynamic-variables"},"Dynamic Variables")])])])]),l("h2",{id:"syntax"},[t("Syntax "),l("a",{class:"header-anchor",href:"#syntax"},"#")]),l("ul",null,[l("li",null,[l("strong",null,"Field"),t(" \u2014 Any valid root field, "),l("a",{href:"#relational"},"relational field"),t(", or "),l("a",{href:"#logical-operators"},"logical operator")]),l("li",null,[l("strong",null,"Operator"),t(" \u2014 Any valid "),l("a",{href:"#supported-operators"},"API operator"),t(" prefaced with an underscore")]),l("li",null,[l("strong",null,"Value"),t(" \u2014 Any valid static value, or "),l("a",{href:"#dynamic-variables"},"dynamic variable")])]),l("pre",null,[l("code",null,`{
+	<field>: {
+		<operator>: <value>
+	}
+}
+`)]),l("h3",{id:"examples"},[t("Examples "),l("a",{class:"header-anchor",href:"#examples"},"#")]),l("pre",null,[l("code",{class:"language-json"},[t(`{
+	`),l("span",{class:"hljs-attr"},'"title"'),t(`: {
+		`),l("span",{class:"hljs-attr"},'"_contains"'),t(": "),l("span",{class:"hljs-string"},'"Directus"'),t(`
+	}
+}
+`)])]),l("pre",null,[l("code",{class:"language-json"},[t(`{
+	`),l("span",{class:"hljs-attr"},'"owner"'),t(`: {
+		`),l("span",{class:"hljs-attr"},'"_eq"'),t(": "),l("span",{class:"hljs-string"},'"$CURRENT_USER"'),t(`
+	}
+}
+`)])]),l("pre",null,[l("code",{class:"language-json"},[t(`{
+	`),l("span",{class:"hljs-attr"},'"datetime"'),t(`: {
+		`),l("span",{class:"hljs-attr"},'"_lte"'),t(": "),l("span",{class:"hljs-string"},'"$NOW"'),t(`
+	}
+}
+`)])]),l("h2",{id:"filter-operators"},[t("Filter Operators "),l("a",{class:"header-anchor",href:"#filter-operators"},"#")]),l("table",null,[l("thead",null,[l("tr",null,[l("th",null,"Operator"),l("th",null,"Description")])]),l("tbody",null,[l("tr",null,[l("td",null,[l("code",null,"_eq")]),l("td",null,"Equal to")]),l("tr",null,[l("td",null,[l("code",null,"_neq")]),l("td",null,"Not equal to")]),l("tr",null,[l("td",null,[l("code",null,"_lt")]),l("td",null,"Less than")]),l("tr",null,[l("td",null,[l("code",null,"_lte")]),l("td",null,"Less than or equal to")]),l("tr",null,[l("td",null,[l("code",null,"_gt")]),l("td",null,"Greater than")]),l("tr",null,[l("td",null,[l("code",null,"_gte")]),l("td",null,"Greater than or equal to")]),l("tr",null,[l("td",null,[l("code",null,"_in")]),l("td",null,"Matches any of the values")]),l("tr",null,[l("td",null,[l("code",null,"_nin")]),l("td",null,"Doesn\u2019t match any of the values")]),l("tr",null,[l("td",null,[l("code",null,"_null")]),l("td",null,[t("Is "),l("code",null,"null")])]),l("tr",null,[l("td",null,[l("code",null,"_nnull")]),l("td",null,[t("Is not "),l("code",null,"null")])]),l("tr",null,[l("td",null,[l("code",null,"_contains")]),l("td",null,"Contains the substring")]),l("tr",null,[l("td",null,[l("code",null,"_ncontains")]),l("td",null,"Doesn\u2019t contain the substring")]),l("tr",null,[l("td",null,[l("code",null,"_starts_with")]),l("td",null,"Starts with")]),l("tr",null,[l("td",null,[l("code",null,"_nstarts_with")]),l("td",null,"Doesn\u2019t start with")]),l("tr",null,[l("td",null,[l("code",null,"_ends_with")]),l("td",null,"Ends with")]),l("tr",null,[l("td",null,[l("code",null,"_nends_with")]),l("td",null,"Doesn\u2019t end with")]),l("tr",null,[l("td",null,[l("code",null,"_between")]),l("td",null,"Is between two values (inclusive)")]),l("tr",null,[l("td",null,[l("code",null,"_nbetween")]),l("td",null,"Is not between two values (inclusive)")]),l("tr",null,[l("td",null,[l("code",null,"_empty")]),l("td",null,[t("Is empty ("),l("code",null,"null"),t(" or falsy)")])]),l("tr",null,[l("td",null,[l("code",null,"_nempty")]),l("td",null,[t("Is not empty ("),l("code",null,"null"),t(" or falsy)")])]),l("tr",null,[l("td",null,[l("code",null,"_intersects"),t(),l("sup",null,"[1]")]),l("td",null,"Value intersects a given point")]),l("tr",null,[l("td",null,[l("code",null,"_nintersects"),t(),l("sup",null,"[1]")]),l("td",null,"Value does not intersect a given point")]),l("tr",null,[l("td",null,[l("code",null,"_intersects_bbox"),t(),l("sup",null,"[1]")]),l("td",null,"Value is in a bounding box")]),l("tr",null,[l("td",null,[l("code",null,"_nintersects_bbox"),t(),l("sup",null,"[1]")]),l("td",null,"Value is not in a bounding box")])])]),l("p",null,[t("The following operators are "),l("strong",null,"only available in validation permissions"),t(":")]),l("table",null,[l("thead",null,[l("tr",null,[l("th",null,"Operator"),l("th",null,"Description")])]),l("tbody",null,[l("tr",null,[l("td",null,[l("code",null,"_submitted")]),l("td",null,"Field has to be submitted")]),l("tr",null,[l("td",null,[l("code",null,"_regex"),t(),l("sup",null,"[2]")]),l("td",null,"Field has to match regex")])])]),l("p",null,[l("sup",null,"[1]"),t(" Only available on Geometry types"),l("br"),l("sup",null,"[2]"),t(" JavaScript \u201Cflavor\u201D regex. Make sure to escape backslashes.")]),l("h2",{id:"relational"},[t("Relational "),l("a",{class:"header-anchor",href:"#relational"},"#")]),l("p",null,[t("You can target related values by nesting field names. For example, if you have a relational Many-to-One "),l("code",null,"author"),t(" field, you can set a rule for the "),l("code",null,"author.name"),t(" field using the following syntax.")]),l("pre",null,[l("code",{class:"language-json"},[t(`{
+	`),l("span",{class:"hljs-attr"},'"author"'),t(`: {
+		`),l("span",{class:"hljs-attr"},'"name"'),t(`: {
+			`),l("span",{class:"hljs-attr"},'"_eq"'),t(": "),l("span",{class:"hljs-string"},'"Rijk van Zanten"'),t(`
+		}
+	}
+}
+`)])]),l("h2",{id:"logical-operators"},[t("Logical Operators "),l("a",{class:"header-anchor",href:"#logical-operators"},"#")]),l("p",null,[t("You can nest or group multiple rules using the "),l("code",null,"_and"),t(" or "),l("code",null,"_or"),t(" logical operators. Each operator holds an array of rules, allowing for more complex filtering.")]),l("pre",null,[l("code",{class:"language-json"},[t(`{
+	`),l("span",{class:"hljs-attr"},'"_or"'),t(`: [
+		{
+			`),l("span",{class:"hljs-attr"},'"_and"'),t(`: [
+				{
+					`),l("span",{class:"hljs-attr"},'"owner"'),t(`: {
+						`),l("span",{class:"hljs-attr"},'"_eq"'),t(": "),l("span",{class:"hljs-string"},'"$CURRENT_USER"'),t(`
+					}
+				},
+				{
+					`),l("span",{class:"hljs-attr"},'"status"'),t(`: {
+						`),l("span",{class:"hljs-attr"},'"_in"'),t(": ["),l("span",{class:"hljs-string"},'"published"'),t(", "),l("span",{class:"hljs-string"},'"draft"'),t(`]
+					}
+				}
+			]
+		},
+		{
+			`),l("span",{class:"hljs-attr"},'"_and"'),t(`: [
+				{
+					`),l("span",{class:"hljs-attr"},'"owner"'),t(`: {
+						`),l("span",{class:"hljs-attr"},'"_neq"'),t(": "),l("span",{class:"hljs-string"},'"$CURRENT_USER"'),t(`
+					}
+				},
+				{
+					`),l("span",{class:"hljs-attr"},'"status"'),t(`: {
+						`),l("span",{class:"hljs-attr"},'"_in"'),t(": ["),l("span",{class:"hljs-string"},'"published"'),t(`]
+					}
+				}
+			]
+		}
+	]
+}
+`)])]),l("h2",{id:"dynamic-variables"},[t("Dynamic Variables "),l("a",{class:"header-anchor",href:"#dynamic-variables"},"#")]),l("p",null,[t("In addition to static values, you can also filter against "),l("em",null,"dynamic"),t(" values using the following variables.")]),l("ul",null,[l("li",null,[l("code",null,"$CURRENT_USER"),t(" \u2014 The primary key of the currently authenticated user")]),l("li",null,[l("code",null,"$CURRENT_ROLE"),t(" \u2014 The primary key of the role for the currently authenticated user")]),l("li",null,[l("code",null,"$NOW"),t(" \u2014 The current timestamp")]),l("li",null,[l("code",null,"$NOW(<adjustment>)"),t(" - The current timestamp plus/minus a given distance, for example "),l("code",null,"$NOW(-1 year)"),t(", "),l("code",null,"$NOW(+2 hours)")])]),l("div",{class:"tip hint"},[l("div",{class:"hint-title"},"Nested User / Role variables in Permissions"),l("p",null,[t("When configuring permissions, "),l("code",null,"$CURRENT_USER"),t(" and "),l("code",null,"$CURRENT_ROLE"),t(" allow you to specify any (nested) field under the current user/role as well as the root ID. For example: "),l("code",null,"$CURRENT_ROLE.name"),t(" or "),l("code",null,"$CURRENT_USER.avatar.filesize"),t(". This includes custom fields that were added to the directus_users/directus_roles tables.")]),l("p",null,"Note: This feature is only available for permissions, validation, and presets. Regular filters and conditional fields currently only support the root ID.")])],-1),f={setup(d,{expose:e}){const n={title:"Filter Rules",modularExtension:!1};return e({frontmatter:n}),(c,h)=>{const a=s("DocsWrapper");return r(),u(a,{frontmatter:n},{default:o(()=>[i]),_:1})}}};export{f as default};

package/dist/assets/{folders.a05410b5.js → folders.54e223af.js}

@@ -1,4 +1,4 @@
-import{r as n,p as h,q as c,w as a,B as e,t,P as s}from"./vendor.a626ab9c.js";const i={class:"markdown-body"},p=e("div",{class:"two-up"},[e("div",{class:"left"},[e("blockquote",null,[e("p",null,"Folders can be used to organize files within the platform. Folders are virtual, and aren\u2019t mirrored within the storage adapter.")])]),e("div",{class:"right"},[e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#the-folder-object"},"The Folder Object")]),e("li",null,[e("a",{href:"#list-folders"},"List Folders")]),e("li",null,[e("a",{href:"#retrieve-a-folder"},"Retrieve a Folder")]),e("li",null,[e("a",{href:"#create-a-folder"},"Create a Folder")]),e("li",null,[e("a",{href:"#create-multiple-folders"},"Create Multiple Folders")]),e("li",null,[e("a",{href:"#update-a-folder"},"Update a Folder")]),e("li",null,[e("a",{href:"#update-multiple-folders"},"Update Multiple Folders")]),e("li",null,[e("a",{href:"#delete-a-folder"},"Delete a Folder")]),e("li",null,[e("a",{href:"#delete-multiple-folders"},"Delete Multiple Folders")])])])])])],-1),u=e("hr",null,null,-1),_=e("h2",{id:"the-folder-object"},[s("The Folder Object "),e("a",{class:"header-anchor",href:"#the-folder-object"},"#")],-1),f=e("div",{class:"two-up"},[e("div",{class:"left"},[e("div",{class:"definitions"},[e("p",null,[e("code",null,"id"),s(),e("strong",null,"uuid"),e("br"),s(" Primary key of the folder.")]),e("p",null,[e("code",null,"name"),s(),e("strong",null,"string"),e("br"),s(" Name of the folder.")]),e("p",null,[e("code",null,"parent"),s(),e("strong",null,"many-to-one"),e("br"),s(" Parent folder. Many-to-one to folders (recursive).")])])]),e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[s(`{
+import{p as n,q as h,C as c,v as a,M as e,u as t,D as s}from"./vendor.299bc11c.js";const i={class:"markdown-body"},p=e("div",{class:"two-up"},[e("div",{class:"left"},[e("blockquote",null,[e("p",null,"Folders can be used to organize files within the platform. Folders are virtual, and aren\u2019t mirrored within the storage adapter.")])]),e("div",{class:"right"},[e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#the-folder-object"},"The Folder Object")]),e("li",null,[e("a",{href:"#list-folders"},"List Folders")]),e("li",null,[e("a",{href:"#retrieve-a-folder"},"Retrieve a Folder")]),e("li",null,[e("a",{href:"#create-a-folder"},"Create a Folder")]),e("li",null,[e("a",{href:"#create-multiple-folders"},"Create Multiple Folders")]),e("li",null,[e("a",{href:"#update-a-folder"},"Update a Folder")]),e("li",null,[e("a",{href:"#update-multiple-folders"},"Update Multiple Folders")]),e("li",null,[e("a",{href:"#delete-a-folder"},"Delete a Folder")]),e("li",null,[e("a",{href:"#delete-multiple-folders"},"Delete Multiple Folders")])])])])])],-1),u=e("hr",null,null,-1),_=e("h2",{id:"the-folder-object"},[s("The Folder Object "),e("a",{class:"header-anchor",href:"#the-folder-object"},"#")],-1),f=e("div",{class:"two-up"},[e("div",{class:"left"},[e("div",{class:"definitions"},[e("p",null,[e("code",null,"id"),s(),e("strong",null,"uuid"),e("br"),s(" Primary key of the folder.")]),e("p",null,[e("code",null,"name"),s(),e("strong",null,"string"),e("br"),s(" Name of the folder.")]),e("p",null,[e("code",null,"parent"),s(),e("strong",null,"many-to-one"),e("br"),s(" Parent folder. Many-to-one to folders (recursive).")])])]),e("div",{class:"right"},[e("pre",null,[e("code",{class:"language-json"},[s(`{
 	`),e("span",{class:"hljs-attr"},'"data"'),s(`: {
 		`),e("span",{class:"hljs-attr"},'"id"'),s(": "),e("span",{class:"hljs-string"},'"fc02d733-95b8-4e27-bd4b-08a32cbe4e66"'),s(`,
 		`),e("span",{class:"hljs-attr"},'"name"'),s(": "),e("span",{class:"hljs-string"},'"Test"'),s(`,
@@ -11,7 +11,7 @@ SEARCH /folders
 `)],-1),I=e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"type"),e("span",{class:"hljs-type"}," Query"),s(` {
 	folders: directus_folders
 }
-`)])],-1),O=e("h5",{id:"example"},[s("Example "),e("a",{class:"header-anchor",href:"#example"},"#")],-1),M=e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"query"),s(` {
+`)])],-1),M=e("h5",{id:"example"},[s("Example "),e("a",{class:"header-anchor",href:"#example"},"#")],-1),O=e("pre",null,[e("code",{class:"language-graphql"},[e("span",{class:"hljs-keyword"},"query"),s(` {
 	folders {
 		name
 	}
@@ -64,7 +64,7 @@ SEARCH /folders
 		name
 	}
 }
-`)])])],-1),Te=e("hr",null,null,-1),Pe=e("h2",{id:"update-a-folder"},[s("Update a Folder "),e("a",{class:"header-anchor",href:"#update-a-folder"},"#")],-1),Re=e("p",null,"Update an existing folder.",-1),ke={class:"two-up"},Se={class:"left"},Ae=e("h3",{id:"query-parameters-5"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-5"},"#")],-1),Fe=s("Supports all "),De=s("global query parameters"),Ce=s("."),Le=e("h3",{id:"request-body-3"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body-3"},"#")],-1),Qe=e("p",null,[s("A partial "),e("a",{href:"#the-folder-object"},"folder object"),s(".")],-1),Ie=e("h3",{id:"returns-5"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-5"},"#")],-1),Oe=e("p",null,[s("Returns the "),e("a",{href:"#the-folder-object"},"folder object"),s(" of the folder that was updated.")],-1),Me=e("div",{class:"right"},[e("h3",{id:"rest-api-5"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),e("pre",null,[e("code",null,`PATCH /folders/:id
+`)])])],-1),Te=e("hr",null,null,-1),Pe=e("h2",{id:"update-a-folder"},[s("Update a Folder "),e("a",{class:"header-anchor",href:"#update-a-folder"},"#")],-1),Re=e("p",null,"Update an existing folder.",-1),ke={class:"two-up"},Se={class:"left"},Ae=e("h3",{id:"query-parameters-5"},[s("Query Parameters "),e("a",{class:"header-anchor",href:"#query-parameters-5"},"#")],-1),Fe=s("Supports all "),De=s("global query parameters"),Ce=s("."),Le=e("h3",{id:"request-body-3"},[s("Request Body "),e("a",{class:"header-anchor",href:"#request-body-3"},"#")],-1),Qe=e("p",null,[s("A partial "),e("a",{href:"#the-folder-object"},"folder object"),s(".")],-1),Ie=e("h3",{id:"returns-5"},[s("Returns "),e("a",{class:"header-anchor",href:"#returns-5"},"#")],-1),Me=e("p",null,[s("Returns the "),e("a",{href:"#the-folder-object"},"folder object"),s(" of the folder that was updated.")],-1),Oe=e("div",{class:"right"},[e("h3",{id:"rest-api-5"},[s("REST API "),e("a",{class:"header-anchor",href:"#rest-api-5"},"#")]),e("pre",null,[e("code",null,`PATCH /folders/:id
 `)]),e("h5",{id:"example-8"},[s("Example "),e("a",{class:"header-anchor",href:"#example-8"},"#")]),e("pre",null,[e("code",{class:"language-json"},[e("span",{class:"hljs-comment"},"// PATCH /folders/fac21847-d5ce-4e4b-a288-9abafbdfbc87"),s(`
 
 {
@@ -129,4 +129,4 @@ SEARCH /folders
 		ids
 	}
 }
-`)])])])],-1),ps={setup(os,{expose:d}){const r={title:"Folders",modularExtension:!1,pageClass:"page-reference"};return d({frontmatter:r}),(hs,cs)=>{const l=n("router-link"),o=n("DocsWrapper");return h(),c(o,{frontmatter:r},{default:a(()=>[e("div",i,[p,u,_,f,m,g,y,e("div",b,[e("div",j,[q,e("p",null,[x,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[v]),_:1}),E]),w,e("p",null,[T,t(l,{to:"/docs/reference/api/query/#limit"},{default:a(()=>[P]),_:1}),R,k,S])]),e("div",A,[F,D,e("p",null,[t(l,{to:"/docs/reference/api/introduction/#search-http-method"},{default:a(()=>[C]),_:1})]),L,Q,I,O,M])]),G,B,N,e("div",H,[e("div",U,[V,e("p",null,[W,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[z]),_:1}),J]),K,X]),Y]),Z,$,ee,e("div",se,[e("div",ae,[le,e("p",null,[te,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[re]),_:1}),ne]),de,oe,he,ce]),ie]),pe,ue,_e,e("div",fe,[e("div",me,[ge,e("p",null,[ye,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[be]),_:1}),je]),qe,xe,ve,Ee]),we]),Te,Pe,Re,e("div",ke,[e("div",Se,[Ae,e("p",null,[Fe,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[De]),_:1}),Ce]),Le,Qe,Ie,Oe]),Me]),Ge,Be,Ne,e("div",He,[e("div",Ue,[Ve,e("p",null,[We,t(l,{to:"/docs/reference/api/query"},{default:a(()=>[ze]),_:1}),Je]),Ke,Xe,Ye,Ze]),$e]),es,ss,as,ls,ts,rs,ns,ds])]),_:1})}}};export{ps as default};
+`)])])])],-1),ps={setup(os,{expose:d}){const r={title:"Folders",modularExtension:!1,pageClass:"page-reference"};return d({frontmatter:r}),(hs,cs)=>{const l=n("router-link"),o=n("DocsWrapper");return h(),c(o,{frontmatter:r},{default:a(()=>[e("div",i,[p,u,_,f,m,g,y,e("div",b,[e("div",j,[q,e("p",null,[x,t(l,{to:"/docs/reference/query"},{default:a(()=>[v]),_:1}),E]),w,e("p",null,[T,t(l,{to:"/docs/reference/query/#limit"},{default:a(()=>[P]),_:1}),R,k,S])]),e("div",A,[F,D,e("p",null,[t(l,{to:"/docs/reference/introduction/#search-http-method"},{default:a(()=>[C]),_:1})]),L,Q,I,M,O])]),G,B,N,e("div",H,[e("div",U,[V,e("p",null,[W,t(l,{to:"/docs/reference/query"},{default:a(()=>[z]),_:1}),J]),K,X]),Y]),Z,$,ee,e("div",se,[e("div",ae,[le,e("p",null,[te,t(l,{to:"/docs/reference/query"},{default:a(()=>[re]),_:1}),ne]),de,oe,he,ce]),ie]),pe,ue,_e,e("div",fe,[e("div",me,[ge,e("p",null,[ye,t(l,{to:"/docs/reference/query"},{default:a(()=>[be]),_:1}),je]),qe,xe,ve,Ee]),we]),Te,Pe,Re,e("div",ke,[e("div",Se,[Ae,e("p",null,[Fe,t(l,{to:"/docs/reference/query"},{default:a(()=>[De]),_:1}),Ce]),Le,Qe,Ie,Me]),Oe]),Ge,Be,Ne,e("div",He,[e("div",Ue,[Ve,e("p",null,[We,t(l,{to:"/docs/reference/query"},{default:a(()=>[ze]),_:1}),Je]),Ke,Xe,Ye,Ze]),$e]),es,ss,as,ls,ts,rs,ns,ds])]),_:1})}}};export{ps as default};

package/dist/assets/forth.5c226e69.js

@@ -0,0 +1 @@
+import{bF as S}from"./vendor.299bc11c.js";function T(f,O){return O.forEach(function(E){E&&typeof E!="string"&&!Array.isArray(E)&&Object.keys(E).forEach(function(n){if(n!=="default"&&!(n in f)){var R=Object.getOwnPropertyDescriptor(E,n);Object.defineProperty(f,n,R.get?R:{enumerable:!0,get:function(){return E[n]}})}})}),Object.freeze(f)}var u={exports:{}};(function(f,O){(function(E){E(S.exports)})(function(E){function n(i){var r=[];return i.split(" ").forEach(function(e){r.push({name:e})}),r}var R=n("INVERT AND OR XOR 2* 2/ LSHIFT RSHIFT 0= = 0< < > U< MIN MAX 2DROP 2DUP 2OVER 2SWAP ?DUP DEPTH DROP DUP OVER ROT SWAP >R R> R@ + - 1+ 1- ABS NEGATE S>D * M* UM* FM/MOD SM/REM UM/MOD */ */MOD / /MOD MOD HERE , @ ! CELL+ CELLS C, C@ C! CHARS 2@ 2! ALIGN ALIGNED +! ALLOT CHAR [CHAR] [ ] BL FIND EXECUTE IMMEDIATE COUNT LITERAL STATE ; DOES> >BODY EVALUATE SOURCE >IN <# # #S #> HOLD SIGN BASE >NUMBER HEX DECIMAL FILL MOVE . CR EMIT SPACE SPACES TYPE U. .R U.R ACCEPT TRUE FALSE <> U> 0<> 0> NIP TUCK ROLL PICK 2>R 2R@ 2R> WITHIN UNUSED MARKER I J TO COMPILE, [COMPILE] SAVE-INPUT RESTORE-INPUT PAD ERASE 2LITERAL DNEGATE D- D+ D0< D0= D2* D2/ D< D= DMAX DMIN D>S DABS M+ M*/ D. D.R 2ROT DU< CATCH THROW FREE RESIZE ALLOCATE CS-PICK CS-ROLL GET-CURRENT SET-CURRENT FORTH-WORDLIST GET-ORDER SET-ORDER PREVIOUS SEARCH-WORDLIST WORDLIST FIND ALSO ONLY FORTH DEFINITIONS ORDER -TRAILING /STRING SEARCH COMPARE CMOVE CMOVE> BLANK SLITERAL"),a=n("IF ELSE THEN BEGIN WHILE REPEAT UNTIL RECURSE [IF] [ELSE] [THEN] ?DO DO LOOP +LOOP UNLOOP LEAVE EXIT AGAIN CASE OF ENDOF ENDCASE");E.defineMode("forth",function(){function i(r,e){var t;for(t=r.length-1;t>=0;t--)if(r[t].name===e.toUpperCase())return r[t]}return{startState:function(){return{state:"",base:10,coreWordList:R,immediateWordList:a,wordList:[]}},token:function(r,e){var t;if(r.eatSpace())return null;if(e.state===""){if(r.match(/^(\]|:NONAME)(\s|$)/i))return e.state=" compilation","builtin compilation";if(t=r.match(/^(\:)\s+(\S+)(\s|$)+/),t)return e.wordList.push({name:t[2].toUpperCase()}),e.state=" compilation","def"+e.state;if(t=r.match(/^(VARIABLE|2VARIABLE|CONSTANT|2CONSTANT|CREATE|POSTPONE|VALUE|WORD)\s+(\S+)(\s|$)+/i),t)return e.wordList.push({name:t[2].toUpperCase()}),"def"+e.state;if(t=r.match(/^(\'|\[\'\])\s+(\S+)(\s|$)+/),t)return"builtin"+e.state}else{if(r.match(/^(\;|\[)(\s)/))return e.state="",r.backUp(1),"builtin compilation";if(r.match(/^(\;|\[)($)/))return e.state="","builtin compilation";if(r.match(/^(POSTPONE)\s+\S+(\s|$)+/))return"builtin"}if(t=r.match(/^(\S+)(\s+|$)/),t)return i(e.wordList,t[1])!==void 0?"variable"+e.state:t[1]==="\\"?(r.skipToEnd(),"comment"+e.state):i(e.coreWordList,t[1])!==void 0?"builtin"+e.state:i(e.immediateWordList,t[1])!==void 0?"keyword"+e.state:t[1]==="("?(r.eatWhile(function(o){return o!==")"}),r.eat(")"),"comment"+e.state):t[1]===".("?(r.eatWhile(function(o){return o!==")"}),r.eat(")"),"string"+e.state):t[1]==='S"'||t[1]==='."'||t[1]==='C"'?(r.eatWhile(function(o){return o!=='"'}),r.eat('"'),"string"+e.state):t[1]-68719476735?"number"+e.state:"atom"+e.state}}}),E.defineMIME("text/x-forth","forth")})})();var A=u.exports,D=Object.freeze(T({__proto__:null,[Symbol.toStringTag]:"Module",default:A},[u.exports]));export{D as f};

package/dist/assets/fortran.a1e621fd.js

@@ -0,0 +1 @@
+import{bF as h}from"./vendor.299bc11c.js";function x(o,s){return s.forEach(function(n){n&&typeof n!="string"&&!Array.isArray(n)&&Object.keys(n).forEach(function(i){if(i!=="default"&&!(i in o)){var c=Object.getOwnPropertyDescriptor(n,i);Object.defineProperty(o,i,c.get?c:{enumerable:!0,get:function(){return n[i]}})}})}),Object.freeze(o)}var u={exports:{}};(function(o,s){(function(n){n(h.exports)})(function(n){n.defineMode("fortran",function(){function i(t){for(var r={},e=0;e<t.length;++e)r[t[e]]=!0;return r}var c=i(["abstract","accept","allocatable","allocate","array","assign","asynchronous","backspace","bind","block","byte","call","case","class","close","common","contains","continue","cycle","data","deallocate","decode","deferred","dimension","do","elemental","else","encode","end","endif","entry","enumerator","equivalence","exit","external","extrinsic","final","forall","format","function","generic","go","goto","if","implicit","import","include","inquire","intent","interface","intrinsic","module","namelist","non_intrinsic","non_overridable","none","nopass","nullify","open","optional","options","parameter","pass","pause","pointer","print","private","program","protected","public","pure","read","recursive","result","return","rewind","save","select","sequence","stop","subroutine","target","then","to","type","use","value","volatile","where","while","write"]),f=i(["abort","abs","access","achar","acos","adjustl","adjustr","aimag","aint","alarm","all","allocated","alog","amax","amin","amod","and","anint","any","asin","associated","atan","besj","besjn","besy","besyn","bit_size","btest","cabs","ccos","ceiling","cexp","char","chdir","chmod","clog","cmplx","command_argument_count","complex","conjg","cos","cosh","count","cpu_time","cshift","csin","csqrt","ctime","c_funloc","c_loc","c_associated","c_null_ptr","c_null_funptr","c_f_pointer","c_null_char","c_alert","c_backspace","c_form_feed","c_new_line","c_carriage_return","c_horizontal_tab","c_vertical_tab","dabs","dacos","dasin","datan","date_and_time","dbesj","dbesj","dbesjn","dbesy","dbesy","dbesyn","dble","dcos","dcosh","ddim","derf","derfc","dexp","digits","dim","dint","dlog","dlog","dmax","dmin","dmod","dnint","dot_product","dprod","dsign","dsinh","dsin","dsqrt","dtanh","dtan","dtime","eoshift","epsilon","erf","erfc","etime","exit","exp","exponent","extends_type_of","fdate","fget","fgetc","float","floor","flush","fnum","fputc","fput","fraction","fseek","fstat","ftell","gerror","getarg","get_command","get_command_argument","get_environment_variable","getcwd","getenv","getgid","getlog","getpid","getuid","gmtime","hostnm","huge","iabs","iachar","iand","iargc","ibclr","ibits","ibset","ichar","idate","idim","idint","idnint","ieor","ierrno","ifix","imag","imagpart","index","int","ior","irand","isatty","ishft","ishftc","isign","iso_c_binding","is_iostat_end","is_iostat_eor","itime","kill","kind","lbound","len","len_trim","lge","lgt","link","lle","llt","lnblnk","loc","log","logical","long","lshift","lstat","ltime","matmul","max","maxexponent","maxloc","maxval","mclock","merge","move_alloc","min","minexponent","minloc","minval","mod","modulo","mvbits","nearest","new_line","nint","not","or","pack","perror","precision","present","product","radix","rand","random_number","random_seed","range","real","realpart","rename","repeat","reshape","rrspacing","rshift","same_type_as","scale","scan","second","selected_int_kind","selected_real_kind","set_exponent","shape","short","sign","signal","sinh","sin","sleep","sngl","spacing","spread","sqrt","srand","stat","sum","symlnk","system","system_clock","tan","tanh","time","tiny","transfer","transpose","trim","ttynam","ubound","umask","unlink","unpack","verify","xor","zabs","zcos","zexp","zlog","zsin","zsqrt"]),m=i(["c_bool","c_char","c_double","c_double_complex","c_float","c_float_complex","c_funptr","c_int","c_int16_t","c_int32_t","c_int64_t","c_int8_t","c_int_fast16_t","c_int_fast32_t","c_int_fast64_t","c_int_fast8_t","c_int_least16_t","c_int_least32_t","c_int_least64_t","c_int_least8_t","c_intmax_t","c_intptr_t","c_long","c_long_double","c_long_double_complex","c_long_long","c_ptr","c_short","c_signed_char","c_size_t","character","complex","double","integer","logical","real"]),d=/[+\-*&=<>\/\:]/,p=new RegExp("(.and.|.or.|.eq.|.lt.|.le.|.gt.|.ge.|.ne.|.not.|.eqv.|.neqv.)","i");function g(t,r){if(t.match(p))return"operator";var e=t.next();if(e=="!")return t.skipToEnd(),"comment";if(e=='"'||e=="'")return r.tokenize=b(e),r.tokenize(t,r);if(/[\[\]\(\),]/.test(e))return null;if(/\d/.test(e))return t.eatWhile(/[\w\.]/),"number";if(d.test(e))return t.eatWhile(d),"operator";t.eatWhile(/[\w\$_]/);var a=t.current().toLowerCase();return c.hasOwnProperty(a)?"keyword":f.hasOwnProperty(a)||m.hasOwnProperty(a)?"builtin":"variable"}function b(t){return function(r,e){for(var a=!1,l,_=!1;(l=r.next())!=null;){if(l==t&&!a){_=!0;break}a=!a&&l=="\\"}return(_||!a)&&(e.tokenize=null),"string"}}return{startState:function(){return{tokenize:null}},token:function(t,r){if(t.eatSpace())return null;var e=(r.tokenize||g)(t,r);return e=="comment"||e=="meta",e}}}),n.defineMIME("text/x-fortran","fortran")})})();var y=u.exports,k=Object.freeze(x({__proto__:null,[Symbol.toStringTag]:"Module",default:y},[u.exports]));export{k as f};