Schéma du socket Wasm describe d’Aggrega
Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.
Identifiant du schéma : https://aggrega.ai/schemas/wasm-describe-v1beta1.schema.json
La forme de transmission que tout plugin Wasm renvoie depuis son export describe() (PluginDescriptor). describe() est l’auto-déclaration du plugin, lue une fois par l’hôte lorsqu’il charge le plugin : la version de l’ABI à laquelle l’invité se lie, le type de plugin, les exports qu’il propose avec la déclaration de capacités de chaque export, une auto-description des capacités au niveau du plugin, un contrat facultatif de comportement de rendu du fournisseur, un contrat facultatif de reconnaissance de l’importeur, des commandes CLI facultatives, un schéma de réglages facultatif et des métadonnées de paternité facultatives. Une seule forme couvre tous les types de plugins — fournisseur, linter, étape de pipeline feature-recipe, gouvernance, CLI, parser et importeur. L’hôte lit describe() avant de distribuer tout autre export et refuse un descripteur qu’il ne peut pas admettre plutôt que d’invoquer le plugin de façon erronée lors de la distribution.
L’une des formes suivantes
PluginDescriptor
Définitions
PluginDescriptor
L’auto-déclaration complète d’un plugin, renvoyée par describe() et lue une seule fois au chargement. Elle porte le handshake de compatibilité ABI, le type de plugin, les exports proposés et les surfaces facultatives propres à chaque type (le contrat de comportement de rendu d’un fournisseur, le contrat de reconnaissance d’un importeur, les commandes d’un plugin CLI, un schéma de réglages, des métadonnées de paternité).
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
abi_version | const “v1beta1” | oui | L’ABI de plugin à laquelle l’invité se lie. L’hôte accepte exactement cette version ; un invité compilé pour toute autre ABI est refusé au chargement plutôt que d’être invoqué à tort lors de la distribution. Constante : "v1beta1" |
plugin_type | string (enum) | oui | Le type du plugin. Il sélectionne la règle d’export minimal que l’hôte valide et, avec le nom de l’export, le modèle de livraison des entrées par défaut. Un plugin de gouvernance sert les rôles de transformation et de verdict du pipeline de build ; c’est le rôle dans lequel il est rattaché — et non son type — qui fixe ce qu’il peut émettre. Valeurs autorisées : "provider", "linter", "pipeline-step", "governance", "cli", "parser", "importer" |
capabilities | string[] | non | Ce que le plugin sert. La liste est plate dans le format de transmission et le plugin_type requis adjacent fixe lequel des quatre sens porte chaque entrée : pour un fournisseur, les noms de capacités (comme helm ou compose) dont il rend la forme de sortie ; pour une étape de pipeline feature-recipe, les capacités de fournisseur avec lesquelles son étape est compatible ; pour un parser, les formats source qu’il transforme en un arbre structuré canonique, chacun écrit parse: |
exports | PluginExport[] | oui | Les exports que le plugin propose, dans l’ordre déclaré. L’hôte valide que l’export minimal propre au type est présent et lie la surface hôte de chaque export avant de l’invoquer. |
contract | ProviderContract | non | L’auto-description du comportement de rendu du fournisseur — les types d’entrée qu’il rend, la manière dont il assemble la sortie par nœud d’un groupe de distribution, et la paire de délimiteurs des templates d’artefact qu’il applique. Elle décrit le fournisseur dans son ensemble plutôt qu’un export en particulier. Absente pour un plugin qui ne déclare aucun contrat de comportement de rendu. |
importer | ImporterContract | non | L’auto-description d’un importeur indiquant comment une source des formats qu’il annonce est reconnue lorsqu’une importation ne nomme aucun format. Seul un plugin dont le plugin_type est importer peut la déclarer ; tout autre plugin qui la déclare est refusé au chargement. Absente pour un importeur qui ne déclare aucun moyen de reconnaître ses formats, lesquels ne sont alors atteints qu’en les nommant. |
description | string | non | La description propre du plugin, sur une ligne et lisible par un humain, de ce qu’il fait, distincte de la description d’un export et de la description des métadonnées de l’entité. Elle est informative ; l’hôte ne la valide pas et n’agit pas en fonction d’elle. |
commands | PluginCLICommand[] | non | Les verbes de commande aggrega de premier niveau qu’un plugin CLI apporte, chacun avec sa propre ligne d’aide courte. Un même plugin CLI peut apporter plusieurs commandes ; l’hôte enregistre une commande par entrée et achemine le nom de commande résolu vers l’invité lors de l’invocation. Un plugin non CLI la laisse vide. |
settings_schema | object | non | Un document JSON Schema facultatif qu’un plugin déclare pour typer les réglages fournis par l’opérateur que porte son rattachement. Lorsqu’il est présent, l’hôte le compile au chargement et valide par rapport à lui les réglages du rattachement lors de la distribution, avant d’invoquer le plugin ; des réglages non conformes arrêtent le build. Lorsqu’il est absent, le plugin ne déclare aucune forme et les réglages sont transmis tels quels. Le schéma est la déclaration propre et libre du plugin ; l’hôte exécute une validation JSON Schema générique par rapport à lui et n’interprète pas la signification des réglages. |
metadata | PluginDescriptorMeta | non | Informations facultatives de paternité et de provenance du build. Elles ne portent aucun contrat de comportement — l’hôte ne les valide pas et n’agit pas en fonction d’elles. |
Les propriétés supplémentaires ne sont pas autorisées.
PluginExport
Un export qu’un plugin propose, tel que déclaré dans describe(). L’hôte distribue vers l’export par son nom et lie la surface hôte à moindre privilège qu’exigent les fonctions hôte déclarées de l’export.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Le nom ABI de l’export — par exemple render_node, assemble_boundary, lint_rules ou step. L’hôte distribue vers l’export par ce nom. |
input_pattern | string (enum) | non | La manière dont l’hôte livre l’entrée de l’export : b livre le payload complet en ligne afin que l’invité effectue le rendu à partir du seul payload ; a livre un petit payload que l’invité enrichit au moyen de fonctions hôte. Un export qui omet ce champ prend la valeur par défaut de son type de plugin et de son nom. Valeurs autorisées : "a", "b" |
host_functions | string[] | non | Les noms des fonctions hôte que cet export importe. Chaque nom doit figurer dans la liste d’autorisation des fonctions hôte. La déclaration fait foi et est recoupée au chargement avec les fonctions que l’invité importe réellement depuis son module, de sorte qu’elle ne peut pas diverger des fonctions que l’invité appelle vraiment. |
description | string | non | Texte facultatif lisible par un humain qui décrit l’export. C’est de la documentation pour les lecteurs du catalogue ; l’hôte ne le valide pas et n’agit pas en fonction de lui. |
stability | string (enum) | non | Le niveau de stabilité de l’export. Une valeur omise ne porte aucune affirmation de stabilité. Valeurs autorisées : "stable", "experimental", "deprecated" |
operates | string (enum) | non | L’opération de pipeline que cet export effectue : patch modifie un document rendu existant, emit ajoute un nouveau document. La forme de la valeur est vérifiée au chargement ; le runtime la lit lors de la distribution de l’étape. Valeurs autorisées : "patch", "emit" |
scope | string (enum) | non | La racine documentaire sur laquelle cet export opère : own désigne les documents rendus propres au nœud, host les documents du composant auquel est rattachée une recette de feature de portée composant. La forme de la valeur est vérifiée au chargement ; le runtime résout les documents de la portée lors de la distribution. Valeurs autorisées : "own", "host" |
selector | string | non | Une description libre, lisible par un humain, de ce sur quoi l’export agit. C’est de la documentation pour les lecteurs du catalogue ; l’hôte ne valide pas son contenu et n’agit pas en fonction de lui. |
input | object | non | Un document JSON Schema facultatif qu’un export step déclare pour typer l’entrée locale à l’étape qu’une entrée de pipeline fournit par son bloc with. Lorsqu’il est présent, il décrit la forme que satisfait l’entrée with d’une étape ; lorsqu’il est absent, l’export ne déclare aucun contrat d’entrée. Le schéma est la déclaration propre et libre, par l’export, de la surface d’entrée que vise l’auteur d’un pipeline pour cet export. |
output | object | non | Un document JSON Schema facultatif qu’un export step déclare pour typer les sorties qu’il renvoie pour une étape — la forme des sorties adressables qu’une étape apporte pour qu’une étape ultérieure ou un template les lise. Lorsqu’il est présent, il décrit la forme de ces sorties renvoyées ; lorsqu’il est absent, l’export ne déclare aucun contrat de sortie. Le schéma est la déclaration propre et libre, par l’export, de la surface de sortie que produit cet export. |
Les propriétés supplémentaires ne sont pas autorisées.
PluginCLICommand
Un verbe de commande aggrega de premier niveau qu’un plugin CLI apporte, tel que déclaré dans describe(). L’hôte enregistre une commande par entrée et renvoie le nom de commande résolu à l’invité lors de l’invocation, de sorte qu’un même invité peut porter plusieurs commandes et choisir son comportement selon le nom.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Le verbe de commande que l’hôte enregistre — le jeton aggrega qu’un opérateur invoque et le discriminant que l’hôte transmet à l’invité pour qu’il puisse aiguiller selon la commande appelée. Chaque commande déclarée doit le nommer. |
description | string | non | Le texte d’aide courte de la commande, sur une ligne, affiché dans la liste des commandes et dans la sortie d’aide. C’est une documentation facultative ; l’hôte ne le valide pas et n’agit pas en fonction de lui. |
flags | PluginCommandFlag[] | non | Les flags de la commande, dans l’ordre déclaré. Chaque entrée apporte un flag que l’hôte enregistre sur la commande afin que aggrega help |
Les propriétés supplémentaires ne sont pas autorisées.
PluginCommandFlag
Un flag qu’un plugin CLI déclare sur une commande, tel que rapporté dans describe(). L’hôte l’enregistre sur la commande afin que aggrega help
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Le nom long du flag — le jeton —name qu’un opérateur passe sur la ligne de commande. Chaque flag déclaré doit l’indiquer. Au moins 1 caractère. |
shorthand | string | non | L’alias court facultatif d’un seul caractère du flag — la forme -x qu’un opérateur peut passer à la place du nom long. Absent signifie que le flag n’a pas d’alias court. |
description | string | non | Le texte d’aide d’une ligne du flag, affiché dans la sortie d’aide de la commande. C’est une documentation facultative ; l’hôte ne la valide pas et n’agit pas en fonction d’elle. |
type | string | non | Le type de valeur du flag — par exemple string, bool ou int. Absent, il ne porte aucune affirmation de type. |
default | string | non | La valeur par défaut du flag lorsque l’opérateur ne le passe pas, exprimée sous forme de chaîne. Absent signifie que le flag ne déclare aucune valeur par défaut. |
Les propriétés supplémentaires ne sont pas autorisées.
PluginDescriptorMeta
Métadonnées facultatives de paternité et de provenance du build qu’un plugin déclare dans describe(). Elles sont informatives ; l’hôte ne les valide pas et n’agit pas en fonction d’elles. Les champs version et commit sont la provenance du build estampillée dans l’invité au moment du build ; un build non estampillé les omet.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
author | string | non | L’auteur du plugin. |
repository | string | non | Le dépôt source du plugin. |
license | string | non | L’identifiant de licence du plugin. |
version | string | non | La version de provenance du build estampillée dans l’invité au moment du build. Omise par un build non estampillé. |
commit | string | non | Le commit court de provenance du build à partir duquel l’invité a été compilé. Omis par un build non estampillé. |
Les propriétés supplémentaires ne sont pas autorisées.
ProviderContract
L’auto-déclaration d’un fournisseur sur les comportements de rendu à la compilation qu’il effectue sur les nœuds qu’il rend — les types d’entrée qu’il accepte, si et comment il assemble la sortie par nœud d’un groupe de distribution en un artefact unique, la paire de délimiteurs de templates Go qu’il applique aux fichiers d’artefact importés, s’il accepte les fichiers qu’une Recipe apporte à la sortie partagée de sa frontière, et les fichiers que son écosystème ne livre jamais à côté d’une source. Elle décrit le fournisseur dans son ensemble, non un export en particulier. Le contrôle au chargement la recoupe avec l’affirmation rédigée de l’entité.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
input_kinds | InputKinds | oui | Lesquels des trois types d’entrée d’une Recipe le plugin rend : un ensemble de fichiers issu d’une source, un workload synthétisé et un nœud autonome composé uniquement d’artefacts. |
boundary_assembly | string (enum) | oui | La manière dont le plugin combine la sortie de rendu par nœud d’un groupe de distribution : none écrit la sortie de chaque nœud directement au chemin de distribution, merge fusionne les fragments par nœud en un seul document, et nest place la sortie de chaque nœud à sa propre position dans une structure parapluie. Une valeur vide ne porte aucune affirmation d’assemblage. Valeurs autorisées : "none", "merge", "nest", "" |
artifact_delimiters | ArtifactDelimiters | non | La paire de délimiteurs de templates Go que le plugin applique aux fichiers d’artefact importés. Absente, c’est la paire d’ouverture/fermeture par défaut qui s’applique ; un plugin dont la syntaxe cible entre en collision avec cette paire indique ici une paire alternative. |
assembly_name_annotation | AssemblyNameAnnotation | non | Une annotation de frontière dont la valeur résolue nomme l’artefact que le plugin assemble à partir d’un groupe de distribution. Absente, le plugin nomme son assemblage à partir du seul chemin de distribution. |
reusable_instance | booléen | non | Indique si une seule instance chargée du plugin peut servir chaque passage de rendu, d’assemblage et de validation du build plutôt qu’une instance neuve par passage. Un plugin le déclare true uniquement lorsqu’il ne conserve aucun état d’un passage à l’autre. Absent (false) est la valeur par défaut sûre : l’hôte charge une instance neuve par passage. |
cross_boundary_linking | booléen | non | Indique si le plugin câble les arêtes uses qui traversent la frontière — des arêtes dont les extrémités consommatrice et consommée s’assemblent dans des groupes de distribution différents — en produisant un câblage de références croisées natif du fournisseur au moyen de ses exports link_publish et link_resolve. Un plugin le déclare true uniquement lorsqu’il exporte les deux. Absent (false) est la valeur par défaut sûre : le plugin ne câble aucune arête qui traverse la frontière. |
omits | booléen | non | Indique si le plugin respecte les entrées omit que porte une entrée render_node : il exclut de tout ce qu’il renvoie chaque unité rendue à laquelle correspond une entrée, et indique dans le champ omitted de la sortie un décompte par entrée qui lui a été remise. Un plugin le déclare true uniquement lorsqu’il fait les deux. Absent (false) est la valeur par défaut sûre : le plugin ne prétend rien exclure. |
boundary_artifacts | booléen | non | Indique si la cible du plugin accepte les fichiers qu’une Recipe apporte à la sortie partagée de la frontière dans laquelle il effectue le rendu. L’hôte évalue ces fichiers et écrit chacun une seule fois, dans le répertoire contenant la sortie assemblée du groupe de distribution, à côté de ce qu’écrit l’assemblage du plugin ; aucun n’est remis au plugin et il n’en lit aucun, de sorte que l’affirmation déclare que sa cible traite un fichier placé là comme faisant partie de la sortie de la frontière. Absent (false) est la valeur par défaut sûre : une Recipe qui déclare de tels fichiers pour ce plugin est refusée avant que quoi que ce soit ne soit rendu. |
nest_segment | string | non | Le répertoire sous lequel la cible du plugin place le sous-répertoire propre à chaque contributeur, pour un plugin qui imbrique la sortie par nœud d’un groupe de distribution. L’hôte joint ce segment, le nom du contributeur au niveau de la rédaction et le chemin propre de chaque fichier. Lu uniquement lorsque boundary_assembly vaut nest. Absent, l’hôte place le sous-répertoire de chaque contributeur directement à la position de distribution, sans répertoire englobant. La valeur nomme un répertoire et jamais un chemin : une valeur contenant un séparateur de chemin, ou nommant le répertoire courant ou le répertoire parent, est refusée, car l’hôte y compose le nom du contributeur et un fragment de chemin placerait les fichiers d’un contributeur ailleurs que sous la position de distribution. |
source_ignore | SourceIgnore | non | Les fichiers que l’écosystème de ce plugin ne livre jamais à côté d’une source qu’il rend, déclarés sous forme de règles d’exclusion. L’hôte lit la déclaration lorsqu’un auteur épingle une Recipe ou une FeatureRecipe dont ce plugin sert la capacité pour lui : il compose ces règles avec le propre fichier d’exclusion de l’auteur, enregistre les règles composées dans le lock de l’entité à côté de l’entité, et dès lors chaque publication de l’entité, chaque comparaison de sa source locale et chaque rendu de celle-ci appliquent les règles enregistrées plutôt que d’interroger à nouveau un plugin. Ainsi, une Recipe publiée pour une capacité porte les fichiers que les règles de son éditeur ont conservés, et un plugin la rend lorsqu’il parle la même version d’ABI, que son contrat correspond à l’affirmation de son entité et qu’il n’a besoin d’aucun fichier hors de cet ensemble. Un plugin qui a besoin d’un fichier que l’ensemble a écarté doit faire échouer son build de manière explicite et nommer le fichier ; le rôle de l’hôte est de refuser un empaquetage ou une lecture d’un fichier que l’ensemble ne contient pas, en le nommant. Absent, aucune règle d’exclusion n’est déclarée, et une source que le plugin rend conserve alors chaque fichier que conservent les propres règles de l’auteur. |
Les propriétés supplémentaires ne sont pas autorisées.
SourceIgnore
Les règles d’exclusion qu’applique l’écosystème d’un plugin à un répertoire source, en syntaxe gitignore : un motif ne contenant aucune barre oblique, ou seulement une barre finale, correspond à un nom à n’importe quelle profondeur, un motif contenant toute autre barre oblique est lu depuis la racine du répertoire auquel il est limité, une barre oblique finale ne correspond qu’à un répertoire, et un ! initial rétablit ce qu’une règle antérieure a exclu. Les règles s’appliquent dans l’ordre et une correspondance ultérieure l’emporte sur une antérieure. Un répertoire qu’une règle exclut n’est pas parcouru, de sorte que rien de ce qu’il contient n’est rétabli à moins que le répertoire lui-même ne soit rétabli d’abord.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
patterns | string[] | non | Les motifs d’exclusion propres à l’écosystème, chacun limité à la racine du répertoire source local en cours de parcours, dans l’ordre où ils s’appliquent. Absent ou vide n’en déclare aucun. |
files | string[] | non | Les noms des fichiers d’exclusion que l’écosystème respecte à l’intérieur d’une source — .helmignore pour un chart, par exemple. Partout où le parcours d’une source trouve un fichier portant l’un de ces noms, ses lignes sont lues comme des motifs supplémentaires dans la même syntaxe, chacun limité au répertoire contenant le fichier, et ils s’appliquent après les motifs ci-dessus ; une ligne vide et une ligne commençant par # sont ignorées. Un fichier portant un tel nom est lui-même conservé à moins qu’une règle ne l’exclue. Absent ou vide n’en nomme aucun. |
Les propriétés supplémentaires ne sont pas autorisées.
InputKinds
Les types d’entrée de Recipe qu’un plugin rend. Chaque champ est une affirmation indépendante ; un plugin peut indiquer n’importe quelle combinaison.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
sourced | booléen | oui | Indique si le plugin rend un ensemble de fichiers issu d’une source (un chart, un module, un fichier compose). |
synthesized | booléen | oui | Indique si le plugin rend un workload synthétisé. |
artifacts_standalone | booléen | oui | Indique si le plugin rend un nœud autonome composé uniquement d’artefacts — un nœud qui porte des documents d’artefact importés et aucune source ni aucun workload. |
Les propriétés supplémentaires ne sont pas autorisées.
ArtifactDelimiters
La paire de délimiteurs de templates Go qu’un plugin applique aux fichiers d’artefact importés, indiquée lorsqu’elle diffère de la paire par défaut.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
left | string | oui | Le délimiteur ouvrant. |
right | string | oui | Le délimiteur fermant. |
Les propriétés supplémentaires ne sont pas autorisées.
AssemblyNameAnnotation
L’annotation de frontière dont la valeur résolue nomme l’artefact assemblé d’un plugin, indiquée lorsque le plugin regroupe les frontières contributrices d’un groupe de distribution en un seul assemblage nommé.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
annotation | string | oui | La clé d’annotation de frontière à partir de laquelle le plugin lit le nom de l’artefact assemblé. |
require_unique | booléen | non | Indique si chaque frontière qui contribue à un même groupe d’aiguillage doit s’accorder sur la valeur résolue de l’annotation. Lorsqu’il vaut true, un groupe dont les frontières contributrices résolvent l’annotation en valeurs différentes arrête le build ; lorsqu’il vaut false, le plugin accepte la première valeur résolue. |
Les propriétés supplémentaires ne sont pas autorisées.
ImporterContract
Ce qu’un importateur déclare sur ses formats au-delà de leur annonce : les signatures auxquelles on reconnaît une source de ces formats. Lorsqu’une importation ne nomme aucun format, l’hôte lit les signatures enregistrées par chaque importateur parmi lesquels l’importation choisit — les importateurs du catalogue de l’espace de travail et les importateurs du cœur du compilateur, dont le binaire embarque les entités Plugin — compare chacune à la source sans savoir ce qu’est aucun format, et lit la source comme le format de l’unique importateur dont la signature correspond. Une source à laquelle aucune signature ne correspond est refusée avec une demande du format, et une source à laquelle correspondent des signatures de plus d’un format est refusée en les nommant. L’entité Plugin enregistre la même liste, et l’hôte refuse un importateur dont le rapport describe() diffère de l’enregistrement.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
detect | DetectSignature[] | non | Les signatures qui reconnaissent une source des formats de cet importateur, dans l’ordre déclaré ; une source est reconnue lorsque l’une quelconque d’entre elles lui correspond. Une source reconnue par un importateur est reconnue comme chacun des formats que l’importateur annonce, de sorte qu’un importateur annonçant plus d’un format voit chaque correspondance refusée comme ambiguë, et qu’un importateur dont les sources doivent être reconnues annonce un seul format. Absent ou vide ne déclare aucune signature, et les formats de l’importateur ne sont atteints qu’en les nommant. |
Les propriétés supplémentaires ne sont pas autorisées.
DetectSignature
Une manière de reconnaître une source : la syntaxe dans laquelle la source est lue, les noms de fichiers auxquels la signature s’applique et les prédicats que l’arbre analysé doit satisfaire. Elle correspond à un fichier dont le nom correspond à l’un de ses motifs de fichier — ou, lorsqu’elle n’en déclare aucun, à une source constituée d’un seul fichier, quel que soit son nom — dont les octets s’analysent dans sa syntaxe et dont l’arbre analysé satisfait chacun de ses prédicats. Elle correspond à un répertoire lorsqu’elle correspond à l’un des fichiers du répertoire que ses motifs sélectionnent, de sorte qu’une signature ne déclarant aucun motif ne correspond à aucun répertoire.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
syntax | string | oui | Le format syntaxique dans lequel la source est analysée — json ou yaml, par exemple —, qui est le format qu’un plugin parser annonce sous la forme parse: |
files | string[] | non | Les motifs de noms de fichiers auxquels la signature s’applique, comparés à la fin du nom de la source dont les séparateurs sont lus comme des barres obliques : un motif d’un seul segment est comparé au nom propre du fichier, et un motif de plusieurs segments séparés par des barres obliques au même nombre de segments finaux de son chemin, de sorte que .vscode/mcp.json correspond à un fichier nommé mcp.json dans un répertoire nommé .vscode. À l’intérieur d’un segment, * correspond à toute suite de caractères, ? correspond à un caractère et […] correspond à un caractère d’une classe. La signature s’applique lorsqu’un motif quelconque correspond. Un motif mal formé est refusé au chargement. Absent ou vide applique la signature à une source constituée d’un seul fichier, quel que soit son nom, et à aucun fichier d’un répertoire. Les motifs des signatures d’un importateur sont aussi ce qui décide quels fichiers d’un répertoire une importation lui remet. |
match | PathMatch[] | non | Les prédicats que l’arbre analysé doit satisfaire, tous, dans l’ordre déclaré. Absent ou vide, il n’exige rien de l’arbre au-delà de son analyse dans la syntaxe. |
Les propriétés supplémentaires ne sont pas autorisées.
PathMatch
Un prédicat sur l’arbre analysé : la valeur qu’atteint un chemin, le type de valeur qu’elle doit être et, facultativement, une chaîne à laquelle elle doit être égale ou par laquelle elle doit commencer.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
path | string | oui | L’endroit de l’arbre où regarde le prédicat, écrit sous forme de clés reliées par des points depuis le sommet de l’arbre : data.nodes nomme le membre nodes de l’objet data de premier niveau. Un segment écrit sous forme de nombre entier, 0 ou plus, sélectionne cette position d’un tableau en comptant à partir de zéro, de sorte que nodes.0.type nomme le type du premier nœud ; tout autre segment sélectionne un membre d’un objet. Une clé qui contient elle-même un point ne peut pas être nommée. Au moins 1 caractère. |
is | string (enum) | oui | Ce que le chemin doit atteindre : present est vrai lorsqu’il atteint une valeur de n’importe quel type, null compris ; absent est vrai lorsqu’il n’atteint rien ; object, array, string, number et boolean sont chacun vrais lorsqu’il atteint une valeur de ce type. Valeurs autorisées : "present", "absent", "object", "array", "string", "number", "boolean" |
equals | string | non | Une chaîne à laquelle la valeur qu’atteint le chemin doit être exactement égale. Une valeur qui n’est pas une chaîne ne lui est jamais égale. Au plus l’un de equals et prefix est déclaré sur un prédicat, et un prédicat qui déclare les deux est refusé au chargement. Au moins 1 caractère. |
prefix | string | non | Une chaîne par laquelle la valeur qu’atteint le chemin doit commencer. Une valeur qui n’est pas une chaîne ne commence jamais par elle. Au plus l’un de equals et prefix est déclaré sur un prédicat, et un prédicat qui déclare les deux est refusé au chargement. Au moins 1 caractère. |
Les propriétés supplémentaires ne sont pas autorisées.