periplus-map 0.2.1__py3-none-any.whl

periplus/packs/drupal_js_basic@0.0.1/attachment/attachment_in_php.yaml

@@ -0,0 +1,15 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# $x['#attached']['library'][] = 'module/library' in a method: the class attaches the library.
+- rule: library_attached_in_class
+  reads: file
+  in: [source]
+  match:
+    declaration: assignment_expression
+    name_child: right
+    filetype: php
+    where: [{name_matches: {child: left, pattern: '(?s).*\[\s*[''"]#attached[''"]\s*\]\s*\[\s*[''"]library[''"]\s*\]\s*\[\s*\]'}}]
+  id: {from: declared_name, pattern: '^[''"](?<library>[^''"]+)[''"]$', template: '{library}'}
+  emits: [{edge: {kind: attaches_library, from: enclosing_class, to: this_node}}]
+  confidence: declared

periplus/packs/drupal_js_basic@0.0.1/attachment/attachment_in_php_array.yaml

@@ -0,0 +1,52 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# '#attached' => ['library' => ['module/library', ...]] in a class file under src: each text in
+# the list is a library the class attaches. The id names both spans, so a text outside either
+# one makes nothing.
+- rule: library_attached_in_array
+  reads: file
+  in: [source]
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    text: '[\[,\s][''"](?<library>[A-Za-z0-9_]+/[\w.-]+)[''"]\s*[,\]]'
+  values:
+    in_attached: {from: {enclosing: attached, capture: mark}}
+    in_library: {from: {enclosing: library_list, capture: mark}}
+  id:
+    template: '{in_attached}|{in_library}|{library}'
+    normalize:
+    - {replace: '^.*\|', with: ''}
+  line: {capture: library}
+  emits:
+  - edge:
+      kind: attaches_library
+      from: {template: '{psr4_class}', types: [php.class]}
+      to: this_node
+  confidence: inferred
+# The same list in a function of a procedural file, such as a hook in a .module file: the
+# function attaches the library. Its node is the one php_basic makes for the function.
+- rule: library_attached_in_array_in_function
+  reads: file
+  in: [source]
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    ending: [module, theme, inc, install, profile]
+    text: '[\[,\s][''"](?<library>[A-Za-z0-9_]+/[\w.-]+)[''"]\s*[,\]]'
+  values:
+    in_attached: {from: {enclosing: attached, capture: mark}}
+    in_library: {from: {enclosing: library_list, capture: mark}}
+    fn: {from: {enclosing: function_body, capture: name}}
+  id:
+    template: '{in_attached}|{in_library}|{library}'
+    normalize:
+    - {replace: '^.*\|', with: ''}
+  line: {capture: library}
+  emits:
+  - edge:
+      kind: attaches_library
+      from: {template: '{fn}', types: [php.function]}
+      to: this_node
+  confidence: inferred

periplus/packs/drupal_js_basic@0.0.1/attachment/attachment_in_twig.yaml

@@ -0,0 +1,26 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# {{ attach_library('module/library') }}: the template attaches the library.
+- rule: library_attached_in_template
+  reads: file
+  in: [module_root, theme_root]
+  match:
+    file: '*.html'
+    filetype: drupal_template_text
+    text: 'attach_library\(\s*[''"](?<library>[^''"\s]+)[''"]\s*\)'
+  id: {template: '{template_name}'}
+  emits: [{edge: {kind: template_attaches_library, from: this_node, to: {from: {capture: library}}}}]
+  confidence: declared
+# {{ attach_library('module/library') }} in a component's <name>.twig: the component attaches the
+# library. A file with no component_name, such as a <name>.html.twig template, makes nothing.
+- rule: library_attached_in_component
+  reads: file
+  in: [module_root, theme_root]
+  match:
+    file: '*'
+    filetype: drupal_template_text
+    text: 'attach_library\(\s*[''"](?<library>[^''"\s]+)[''"]\s*\)'
+  id: {template: '{component_name}'}
+  emits: [{edge: {kind: component_attaches_library, from: this_node, to: {from: {capture: library}}}}]
+  confidence: declared

periplus/packs/drupal_js_basic@0.0.1/attachment/php_function_holder.yaml

@@ -0,0 +1,13 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# A PHP function holds what its body holds, as a class does. So an attachment written in a
+# function, such as a hook in a .module file, starts its edge at that function. The node is the
+# one php_basic already makes for the function.
+- rule: php_function_holds_body
+  reads: file
+  in: [source]
+  match: {declaration: function_definition, name_child: name, body_child: body, filetype: php}
+  id: {from: qualified_name}
+  emits: [{node: {type: php.function}}]
+  confidence: declared

periplus/packs/drupal_js_basic@0.0.1/behavior/behavior.yaml

@@ -0,0 +1,198 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+node_types:
+- name: drupal.js_behavior
+  id_namespace: drupal.js_behavior
+- name: css.file
+  id_namespace: css.file
+
+edge_kinds:
+- kind: attaches_behavior
+  from: drupal.js_behavior
+  to: drupal.js_behavior
+- kind: library_includes_script
+  from: drupal.library
+  to: js.file
+- kind: library_includes_stylesheet
+  from: drupal.library
+  to: css.file
+- kind: script_declares_behavior
+  from: js.file
+  to: drupal.js_behavior
+# drupal_basic's links_to_path cannot start at a script: drupal_basic does not depend on js_basic.
+- kind: script_links_to_path
+  from: js.file
+  to: drupal.url_path
+
+rules:
+# Drupal.behaviors.name = {...}: the behavior name. An arrow function or a function expression on
+# the right is read by the rules below; any other value, such as a variable, makes nothing.
+- rule: behavior_from_assignment
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: object}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{node: {type: drupal.js_behavior}}]
+  confidence: declared
+- rule: behavior_from_assignment_in_file
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: object}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{edge: {kind: script_declares_behavior, from: enclosing_file, to: this_node}}]
+  confidence: declared
+# Drupal.behaviors.name = (context) => {...}: the behavior name, as for an object.
+# body_child is object, not the function: a function body would end the enclosing-behavior walk
+# at every attach: function () {} or attach: () => {} pair, losing the edges inside it.
+- rule: behavior_from_arrow
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: arrow_function}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{node: {type: drupal.js_behavior}}]
+  confidence: declared
+- rule: behavior_from_arrow_in_file
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: arrow_function}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{edge: {kind: script_declares_behavior, from: enclosing_file, to: this_node}}]
+  confidence: declared
+# Drupal.behaviors.name = function (context) {...}: the behavior name, as for an object.
+- rule: behavior_from_function
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: function_expression}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{node: {type: drupal.js_behavior}}]
+  confidence: declared
+- rule: behavior_from_function_in_file
+  reads: file
+  in: [js_source]
+  match: {declaration: assignment_expression, name_child: left, body_child: object, filetype: javascript, where: [{has_child: function_expression}]}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)$', template: '{behavior}'}
+  emits: [{edge: {kind: script_declares_behavior, from: enclosing_file, to: this_node}}]
+  confidence: declared
+# Drupal.behaviors.other.attach(...) inside a behavior object: that behavior runs the other one.
+- rule: behavior_attach_call
+  reads: file
+  in: [js_source]
+  match: {declaration: call_expression, name_child: function, filetype: javascript}
+  id: {from: declared_name, pattern: '^Drupal\.behaviors\.(?<behavior>[A-Za-z_$][\w$]*)\.attach$', template: '{behavior}'}
+  emits: [{edge: {kind: attaches_behavior, from: enclosing_class, to: this_node}}]
+  confidence: declared
+# A local script a library lists under js:. The key is the script's path from the libraries file's
+# folder, so that folder joined with the key is the script's path from the project folder. A key
+# that starts with one /, such as /core/misc/drupal.js, is joined to the Drupal root instead, by a
+# second edge in this rule, so a library with no such key leaves no skipped row. A file outside the
+# mapped folders gets a referenced node. A URL, //host/x, makes nothing.
+- rule: library_script
+  reads: file
+  in:
+  - module_root
+  - theme_root
+  match:
+    file: '*.libraries'
+    filetype: yml
+    each: '*'
+  id:
+    from:
+    - file_stem
+    - key
+    template: '{file_stem}/{key}'
+    normalize:
+    - replace: \.libraries/
+      with: /
+  emits:
+  - edge:
+      kind: library_includes_script
+      from: this_node
+      to:
+        from:
+        - each: js.*
+        template: '{libraries_dir}/{key}'
+        where:
+        - not_matches: /*
+        - not_matches: http:*
+        - not_matches: https:*
+  - edge:
+      kind: library_includes_script
+      from: this_node
+      to:
+        from:
+        - each: js.*
+        template: '{drupal_root}{key}'
+        where:
+        - matches: /*
+        - not_matches: //*
+  confidence: declared
+# A local stylesheet a library lists under css:, in any group (base, layout, component, state,
+# theme). Read the same way as library_script; the id is the file's path from the project folder.
+- rule: library_stylesheet
+  reads: file
+  in:
+  - module_root
+  - theme_root
+  match:
+    file: '*.libraries'
+    filetype: yml
+    each: '*'
+  id:
+    from:
+    - file_stem
+    - key
+    template: '{file_stem}/{key}'
+    normalize:
+    - replace: \.libraries/
+      with: /
+  emits:
+  - edge:
+      kind: library_includes_stylesheet
+      from: this_node
+      to:
+        from:
+        - each: css.*.*
+        template: '{libraries_dir}/{key}'
+        where:
+        - not_matches: /*
+        - not_matches: http:*
+        - not_matches: https:*
+  - edge:
+      kind: library_includes_stylesheet
+      from: this_node
+      to:
+        from:
+        - each: css.*.*
+        template: '{drupal_root}{key}'
+        where:
+        - matches: /*
+        - not_matches: //*
+  confidence: declared
+# Each .css file in a module or theme, named by its path from the project folder: the id a
+# library's css: entry builds, so a listed file that exists is a mapped node.
+- rule: stylesheet_file
+  reads: file
+  in:
+  - module_root
+  - theme_root
+  match: {file: '*', filetype: css_text}
+  id: {template: '{stylesheet}'}
+  emits: [{node: {type: css.file}}]
+  confidence: declared
+# A path a script writes whole as a string, such as let endpoint = "/my/path" or fetch('/my/path'):
+# an edge to the drupal.url_path node route_serves_path meets (drupal_basic url/url.yaml). Read as
+# the type js_text. The string follows a space, (, [, comma, =, : or ?, starts with one / and holds
+# no space, quote, brace or $. So "/", "//cdn.example.com/x" and "/a b" make nothing, and
+# "/my/" + id or base + "/my/path", a URL joined by + on either side, makes nothing. The + before a
+# string, or before a ( that opens it, is refused at any distance, across a line break too. A string
+# inside a comment or a template literal makes nothing.
+- rule: path_in_script_string
+  reads: file
+  in: [js_source]
+  match:
+    file: '*'
+    filetype: js_text
+    text: '(?:(?<![+\s])\s*[(\[,=:?]\s*|(?<![+\s])\s+)["''](?<path>/[^/\s"''`{}$][^\s"''`{}$]*)["''](?!\s*\+)'
+  id: {template: '{script}'}
+  emits: [{edge: {kind: script_links_to_path, from: this_node, to: {from: {capture: path}}}}]
+  confidence: declared

periplus/packs/drupal_js_basic@0.0.1/pack.yaml

@@ -0,0 +1,153 @@
+$schema: "https://periplus.dev/schema/0/pack-manifest.schema.json"
+
+# Known gaps. This pack maps the Drupal side of a project's JavaScript and what joins it to
+# Drupal. Each line below was seen on real code or on a planted file.
+#
+# Behaviors. Drupal.behaviors.name = {...} is a node named by its name, and
+# Drupal.behaviors.other.attach(...) inside a behavior object is an edge to the other behavior.
+# - Any object assigned to Drupal.behaviors.name is a behavior, with or without an attach
+#   member: Drupal.behaviors.empty = {} gives a node.
+# - Drupal.behaviors['name'] = {...} and window.Drupal.behaviors.name = {...}: no node.
+# - An arrow function or a function expression gives the node, Drupal.behaviors.trapFocus =
+#   (element) => {...}; a value of any other kind, such as a variable, gives none.
+# - Two scripts that declare one behavior name give one node holding both locations. Drupal
+#   keeps only the one loaded last on a page.
+# - Drupal.behaviors.other.detach(...): no edge.
+# - once(), Drupal.t() and an Ajax call: no rule reads them.
+#
+# Settings. $build['#attached']['drupalSettings']['key'] = ... in PHP is a setting node named by
+# that first key, and drupalSettings.key inside a behavior object is an edge to it. A key that
+# no mapped PHP file attaches is a referenced node.
+# - Only the first name after drupalSettings is the key. drupalSettings.a.b reads the key a.
+# - drupalSettings['key'], and a read through the second parameter of attach,
+#   attach(context, settings) { settings.key }: no edge.
+#
+# The two text file types this pack reads, drupal_template_text and drupal_php_text, are declared
+# by drupal_basic, so every Drupal pack reads them the same way.
+#
+# Library attachments. In PHP, $build['#attached']['library'][] = 'module/library' is an edge
+# from the class or the function around it. The array form,
+# '#attached' => ['library' => ['module/library', ...]], is an edge from the class of its file,
+# one for each text in the list. In Twig, attach_library('module/library') in a
+# <name>.html.twig file is an edge from the template.
+# - The array form is read as text. Its class is named from the file's path, by Drupal's PSR-4
+#   layout: <module>/src/A/B.php is Drupal\<module>\A\B. So the rule is inferred, and a file
+#   whose class is named otherwise gets an edge from a class that does not exist. In a .module,
+#   .theme, .inc, .install or .profile file the edge starts at the function around the list.
+# - The array form with something between => and the array makes nothing:
+#   '#attached' => $flag ? ['library' => [...]] : [].
+# - A library named by a constant, a variable or a joined text: no edge.
+# - '#attached' => ['drupalSettings' => ['key' => ...]] is read as text the same way: a setting
+#   node for each first-level key, from the class or the function. A key named by a variable, or
+#   below the first level, makes nothing.
+# - A component's components/<name>/<name>.twig is an edge from drupal.component::<name>. Any
+#   other Twig file not named .html.twig: no edge.
+# - A call inside a Twig comment makes nothing. A call inside a quoted text or a verbatim block
+#   still gives an edge.
+# - A script a library lists under js: is an edge from the library to the script's js.file node.
+#   The script's path is the libraries file's folder joined with the key. A key that is a URL
+#   (http:, https: or //) makes no edge and no node. A key that starts with /, such as
+#   /core/misc/drupal.js, is read from the Drupal root, the folder above the first modules, themes
+#   or profiles folder; a file outside the mapped folders gets a referenced node. In a project
+#   whose top folder is the Drupal root itself, such a key makes no edge.
+#   Chain: library -> script -> behavior. A script is linked to each behavior object it assigns,
+#   by a script_declares_behavior edge from its js.file node.
+# - A stylesheet a library lists under css:, in any group, is an edge from the library to a
+#   css.file node named by the same joined path, with the same URL filter. Each .css file in a
+#   module or theme is a css.file node named by its path, so a listed file that does not exist
+#   gets a referenced node. A key that starts with / is read from the Drupal root, as for a script.
+# - A second pack that claims libraries files, by a file type of its own for the ending yml, is
+#   refused (exit 19: the ending yml is claimed by different file types), because libraries
+#   files are read through this pack's type yml and drupal_basic's library rules. A pack that
+#   declares the type yml again in full, under the same name and with a path value of its own,
+#   merges with it and keeps the library edges. Two themes or modules that keep a script at one
+#   path meet at one js.file node.
+#
+# An edge that starts at what is around a match needs a behavior object in JavaScript, and a
+# class or a function in PHP. A behavior call or a settings read outside a behavior object makes
+# no edge and is listed under skipped: no value for enclosing_class. In PHP an attachment in a
+# function, such as a hook in a .module file, starts at the function, and one in a method starts
+# at the class, not at the method. An attachment outside both makes no edge and is listed the
+# same way; its setting node is still made.
+pack: drupal_js_basic
+version: 0.0.1
+depends: [js_basic, drupal_basic]
+files:
+  types:
+    # yaml_basic's type yml, read as data, given the path value libraries_dir: the folder the file
+    # sits in, which a libraries file's js: keys are written from.
+    yml:
+      endings: [yml]
+      reader: data
+      format: yaml
+      path_values:
+        libraries_dir:
+          pattern: '^(?<dir>.+)/[^/]+$'
+          template: '{dir}'
+        # The folder above the first modules, themes or profiles folder: the Drupal root, which a
+        # js: or css: key that starts with / is written from. A file with no folder above it has
+        # no value.
+        drupal_root:
+          pattern: '^(?<root>.*?)/(?:modules|themes|profiles)/'
+          template: '{root}'
+    # drupal_basic's type drupal_template_text, given the path value component_name: the name of a
+    # single-directory component whose folder components/<name>/ holds the file <name>.twig.
+    drupal_template_text:
+      endings: [twig]
+      reader: text
+      path_values:
+        component_name:
+          pattern: '^(?:.*/)?components/(?<name>[^/]+)/(?P=name)\.twig$'
+          template: '{name}'
+    # drupal_basic's type drupal_php_text, given one more span: the array after each quoted,
+    # constant or variable key and =>, to any depth. The array-form setting rules read the keys
+    # around a match from it.
+    drupal_php_text:
+      endings: [php, module, theme, inc, install, profile]
+      reader: text
+      spans:
+      - name: keyed_array
+        open: '[\[,]\s*(?<key>[''"][\w.-]+[''"]|[^\s\[\](),''"=>|]+(?:\[[^\[\]]*\])*)\s*=>\s*(?=\[)'
+        balance: ['[', ']']
+      # The same name for an array that is not the whole value after =>, such as one inside a
+      # ternary, a call's argument or a list, and for old array( ). Its key is the character before
+      # the bracket, or the word array, so a key inside it is below the first level.
+      - name: keyed_array
+        open: '(?<key>[^\s\w$\]])(?<!=>)\s*(?=\[)'
+        balance: ['[', ']']
+      - name: keyed_array
+        open: '\b(?<key>array)\s*(?=\()'
+        balance: ['(', ')']
+    # A stylesheet, read as text only to be named by its path from the project folder.
+    css_text:
+      endings: [css]
+      reader: text
+      path_values:
+        stylesheet:
+          pattern: '^(?<file>.+)$'
+          template: '{file}'
+    # A script read as text, to find a path written whole in a string (behavior/behavior.yaml). Named
+    # by its path from the project folder, as js_basic names its js.file node.
+    js_text:
+      endings: [js]
+      reader: text
+      path_values:
+        script:
+          pattern: '^(?<file>.+)$'
+          template: '{file}'
+      sections:
+      - name: block_comment
+        open: '/\*'
+        close: '\*/'
+      - name: line_comment
+        open: '//'
+        close: '\n'
+      - name: string
+        open: ''''
+        close: '(?:[^''\\\n]|\\.)*'''
+      - name: string
+        open: '"'
+        close: '(?:[^"\\\n]|\\.)*"'
+      - name: template_string
+        open: '`'
+        close: '(?:[^`\\]|\\(?s:.))*`'

periplus/packs/drupal_js_basic@0.0.1/setting/setting.yaml

@@ -0,0 +1,13 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+node_types:
+- name: drupal.js_setting
+  id_namespace: drupal.js_setting
+
+edge_kinds:
+- kind: provides_setting
+  from: [php.class, php.function]
+  to: drupal.js_setting
+- kind: reads_setting
+  from: drupal.js_behavior
+  to: drupal.js_setting

periplus/packs/drupal_js_basic@0.0.1/setting/setting_in_js.yaml

@@ -0,0 +1,15 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# drupalSettings.key inside a behavior object: the behavior reads the setting.
+- rule: setting_read_in_behavior
+  reads: file
+  in: [js_source]
+  match:
+    declaration: member_expression
+    name_child: property
+    filetype: javascript
+    where: [{name_matches: {child: object, pattern: 'drupalSettings'}}]
+  id: {from: declared_name}
+  emits: [{edge: {kind: reads_setting, from: enclosing_class, to: this_node}}]
+  confidence: declared

periplus/packs/drupal_js_basic@0.0.1/setting/setting_in_php.yaml

@@ -0,0 +1,92 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+rules:
+# $x['#attached']['drupalSettings']['key'] = ..., with or without more keys after it: the
+# setting key the page gets.
+- rule: setting_attached
+  reads: file
+  in: [source]
+  match: {declaration: assignment_expression, name_child: left, filetype: php}
+  id: {from: declared_name, pattern: '\[\s*[''"]#attached[''"]\s*\]\s*\[\s*[''"]drupalSettings[''"]\s*\]\s*\[\s*[''"](?<key>[\w.-]+)[''"]\s*\]', template: '{key}'}
+  emits: [{node: {type: drupal.js_setting}}]
+  confidence: declared
+# The same assignment in a method: the class provides the setting.
+- rule: setting_attached_in_class
+  reads: file
+  in: [source]
+  match: {declaration: assignment_expression, name_child: left, filetype: php}
+  id: {from: declared_name, pattern: '\[\s*[''"]#attached[''"]\s*\]\s*\[\s*[''"]drupalSettings[''"]\s*\]\s*\[\s*[''"](?<key>[\w.-]+)[''"]\s*\]', template: '{key}'}
+  emits: [{edge: {kind: provides_setting, from: enclosing_class, to: this_node}}]
+  confidence: declared
+# '#attached' => ['drupalSettings' => ['key' => ...]]: each first-level key is a setting. level is
+# first only when the innermost keyed_array around the key is drupalSettings, or is the key's own
+# array value just inside it, so a key below the first level, at any depth, makes nothing.
+- rule: setting_attached_in_array
+  reads: file
+  in: [source]
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    text: '[\[,]\s*[''"](?<key>(?!drupalSettings[''"])[\w.-]+)[''"]\s*=>(?=\s*(?<arr>\[?))'
+  values:
+    in_attached: {from: {enclosing: attached, capture: mark}}
+    in_settings: {from: {enclosing: settings_list, capture: mark}}
+    chain: {from: {enclosing: keyed_array, capture: key}, join: '|'}
+    level: {template: '{chain}#{arr}', normalize: [{replace: '^(?:.*\|)?[''"]drupalSettings[''"](?:\|[^|]+#\[|#)$', with: first}, {replace: '^(?!first$).*', with: ''}]}
+  id:
+    template: '{in_attached}|{in_settings}|{level}|{key}'
+    normalize:
+    - {replace: '^.*\|', with: ''}
+  line: {capture: key}
+  emits: [{node: {type: drupal.js_setting}}]
+  confidence: declared
+# The same key in a class file under src: the class of its file provides the setting.
+- rule: setting_attached_in_array_in_class
+  reads: file
+  in: [source]
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    text: '[\[,]\s*[''"](?<key>(?!drupalSettings[''"])[\w.-]+)[''"]\s*=>(?=\s*(?<arr>\[?))'
+  values:
+    in_attached: {from: {enclosing: attached, capture: mark}}
+    in_settings: {from: {enclosing: settings_list, capture: mark}}
+    chain: {from: {enclosing: keyed_array, capture: key}, join: '|'}
+    level: {template: '{chain}#{arr}', normalize: [{replace: '^(?:.*\|)?[''"]drupalSettings[''"](?:\|[^|]+#\[|#)$', with: first}, {replace: '^(?!first$).*', with: ''}]}
+  id:
+    template: '{in_attached}|{in_settings}|{level}|{key}'
+    normalize:
+    - {replace: '^.*\|', with: ''}
+  line: {capture: key}
+  emits:
+  - edge:
+      kind: provides_setting
+      from: {template: '{psr4_class}', types: [php.class]}
+      to: this_node
+  confidence: inferred
+# The same key in a function of a procedural file: the function provides the setting.
+- rule: setting_attached_in_array_in_function
+  reads: file
+  in: [source]
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    ending: [module, theme, inc, install, profile]
+    text: '[\[,]\s*[''"](?<key>(?!drupalSettings[''"])[\w.-]+)[''"]\s*=>(?=\s*(?<arr>\[?))'
+  values:
+    in_attached: {from: {enclosing: attached, capture: mark}}
+    in_settings: {from: {enclosing: settings_list, capture: mark}}
+    chain: {from: {enclosing: keyed_array, capture: key}, join: '|'}
+    level: {template: '{chain}#{arr}', normalize: [{replace: '^(?:.*\|)?[''"]drupalSettings[''"](?:\|[^|]+#\[|#)$', with: first}, {replace: '^(?!first$).*', with: ''}]}
+    fn: {from: {enclosing: function_body, capture: name}}
+  id:
+    template: '{in_attached}|{in_settings}|{level}|{key}'
+    normalize:
+    - {replace: '^.*\|', with: ''}
+  line: {capture: key}
+  emits:
+  - edge:
+      kind: provides_setting
+      from: {template: '{fn}', types: [php.function]}
+      to: this_node
+  confidence: inferred

periplus/packs/drush_basic@0.0.1/command/command.yaml

@@ -0,0 +1,15 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# A Drush command, named by its name, and the method and class that run it.
+
+node_types:
+- name: drush.command
+  id_namespace: drush.command
+
+edge_kinds:
+- kind: command_method
+  from: drush.command
+  to: php.method
+- kind: command_class
+  from: drush.command
+  to: php.class

periplus/packs/drush_basic@0.0.1/command/command_annotation.yaml

@@ -0,0 +1,60 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# A Drush command declared by the @command tag in a method's docblock, read as text. The pattern
+# runs from the tag to the docblock's end, never past it, then past one-line attributes and
+# modifiers to the function's name. The node rule is declared; the edge rules name the class from
+# the file's path, so they are inferred.
+
+rules:
+- rule: command_from_annotation
+  reads: file
+  in:
+  - source
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    reads_sections: [block_comment]
+    text: '(?m)^[ \t]*\*[ \t]*@command[ \t]+(?<name>[\w:.-]+)'
+  id:
+    template: '{name}'
+  line: {capture: name}
+  emits:
+  - node:
+      type: drush.command
+  confidence: declared
+- rule: command_method_from_annotation
+  reads: file
+  in:
+  - source
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    reads_sections: [block_comment]
+    text: '(?m)^[ \t]*\*[ \t]*@command[ \t]+(?<name>[\w:.-]+)(?:[^*]|\*[^/])*\*/\s*(?:#\[[^\n]*\]\s*)*(?:(?:public|protected|private|static|final)\s+)*function\s+(?<method>\w+)'
+  id:
+    template: '{name}'
+  line: {capture: name}
+  emits:
+  - edge:
+      kind: command_method
+      from: this_node
+      to: {template: '{psr4_class}::{method}', types: [php.method], on_miss: unresolved}
+  confidence: inferred
+- rule: command_class_from_annotation
+  reads: file
+  in:
+  - source
+  match:
+    file: '**'
+    filetype: drupal_php_text
+    reads_sections: [block_comment]
+    text: '(?m)^[ \t]*\*[ \t]*@command[ \t]+(?<name>[\w:.-]+)'
+  id:
+    template: '{name}'
+  line: {capture: name}
+  emits:
+  - edge:
+      kind: command_class
+      from: this_node
+      to: {template: '{psr4_class}', types: [php.class], on_miss: unresolved}
+  confidence: inferred