periplus-map 0.2.1__py3-none-any.whl

periplus/packs/drupal@0.1.0/config/config_object.yaml

@@ -0,0 +1,65 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — declares the config object and the catch-all that finds every config file.
+#
+# The catch-all is the reason a gap is visible instead of silent. Every file in the config
+# folders becomes a node here, and the specific rules elsewhere refine the ones they
+# understand. Measured on a private Drupal site: 431 files in, 162 refined by a specific rule,
+# 269 left as plain drupal.config_object — present, named, not understood.
+#
+# The path used to be written into this rule as **/config/{install,sync}/*.yml. All three
+# real sites keep config somewhere else, so it matched nothing and 431 files vanished
+# without a word. That is exactly the failure the catch-all exists to prevent.
+
+node_types:
+- name: drupal.config_object
+  id_namespace: drupal.config
+edge_kinds:
+- kind: config_depends
+  from: drupal.config_object
+  to: drupal.config_object
+- kind: depends_on_module
+  from:
+  - drupal.module
+  - drupal.config_object
+  to: drupal.module
+rules:
+- rule: any_config_file
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: '*'
+    filetype: yaml
+  id: &id001
+    from: file_stem
+  emits:
+  - node:
+      type: drupal.config_object
+  confidence: declared
+- rule: any_config_file_edges
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: '*'
+    filetype: yaml
+  emits:
+  - edge:
+      kind: config_depends
+      from: this_node
+      to:
+        from:
+          key: dependencies.config
+        each: true
+  - edge:
+      kind: depends_on_module
+      from: this_node
+      to:
+        from:
+          key: dependencies.module
+        each: true
+  confidence: declared
+  id: *id001

periplus/packs/drupal@0.1.0/display/display.yaml

@@ -0,0 +1,32 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — declares entity displays. Finds nothing.
+#
+# A display says how a bundle is edited or rendered, one config object per mode. Two kinds,
+# and they are genuinely two: a form display and a view display of the same bundle and mode
+# carry the SAME internal id.
+#
+#   core.entity_form_display.block_content.block_ways_note.default.yml:9
+#   core.entity_view_display.block_content.block_ways_note.default.yml:9
+#     both:  id: block_content.block_ways_note.default
+#
+# That is the evidence for minting config ids from the file name rather than from the file's
+# own id key, and it was found by transcribing a map rather than by reading the schema.
+
+node_types:
+
+  - name: drupal.form_display
+    parent: drupal.config_object
+
+  - name: drupal.view_display
+    parent: drupal.config_object
+
+edge_kinds:
+
+  - kind: displays
+    from: [drupal.form_display, drupal.view_display]
+    to:   drupal.block_type
+
+  - kind: shows_field
+    from: [drupal.form_display, drupal.view_display]
+    to:   drupal.field_instance

periplus/packs/drupal@0.1.0/display/display_code.yaml

@@ -0,0 +1,53 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — displays built by PHP. One rule, and the one that does not fit the shape.
+#
+# Every other PHP rule in this pack matches a config entity class, ::create, and an array.
+# This one does not. A display is built through a service and a fluent chain:
+#
+#   block_type_ways.install:51   $display_repository = \Drupal::service('entity_display.repository');
+#   block_type_ways.install:53   $form_display = $display_repository->getFormDisplay('block_content', 'type_way_code');
+#   block_type_ways.install:54-58  ->setComponent(…)->setComponent(…)->save();
+#
+# So it is written here rather than folded into a shared ::create rule, and it is the
+# evidence that a single generic "config entity created in PHP" rule would not cover
+# everything.
+
+needs:
+  types:
+  - drupal.form_display
+  - drupal.view_display
+rules:
+- rule: display_from_code
+  reads: file
+  in:
+  - custom_module
+  match:
+    method_call: getFormDisplay
+    where:
+    - on_service: entity_display.repository
+  id: &id001
+    from:
+    - argument: 0
+    - argument: 1
+    template: core.entity_form_display.{0}.{1}.default
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.form_display
+  confidence: inferred
+- rule: display_from_code_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    method_call: getFormDisplay
+    where:
+    - on_service: entity_display.repository
+  emits:
+  - edge:
+      kind: declares
+      from: enclosing_callable
+      to: this_node
+  confidence: inferred
+  id: *id001

periplus/packs/drupal@0.1.0/display/display_config.yaml

@@ -0,0 +1,95 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — displays from config files. Two rules, one per kind.
+
+needs:
+  types:
+  - drupal.form_display
+  - drupal.view_display
+  - drupal.block_type
+  - drupal.field_instance
+rules:
+- rule: form_display_from_config
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: core.entity_form_display.*
+    filetype: yaml
+  id: &id001
+    from: file_stem
+  emits:
+  - node:
+      type: drupal.form_display
+  confidence: declared
+- rule: view_display_from_config
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: core.entity_view_display.*
+    filetype: yaml
+  id: &id002
+    from: file_stem
+  emits:
+  - node:
+      type: drupal.view_display
+  confidence: declared
+- rule: form_display_from_config_edges
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: core.entity_form_display.*
+    filetype: yaml
+  emits:
+  - edge:
+      kind: displays
+      from: this_node
+      to:
+        from:
+        - key: targetEntityType
+        - key: bundle
+        template: '{targetEntityType}.type.{bundle}'
+  - edge:
+      kind: shows_field
+      from: this_node
+      to:
+        from:
+        - key: targetEntityType
+        - key: bundle
+        - each: content.*
+        template: field.field.{targetEntityType}.{bundle}.{key}
+  confidence: declared
+  id: *id001
+- rule: view_display_from_config_edges
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: core.entity_view_display.*
+    filetype: yaml
+  emits:
+  - edge:
+      kind: displays
+      from: this_node
+      to:
+        from:
+        - key: targetEntityType
+        - key: bundle
+        template: '{targetEntityType}.type.{bundle}'
+  - edge:
+      kind: shows_field
+      from: this_node
+      to:
+        from:
+        - key: targetEntityType
+        - key: bundle
+        - each: content.*
+        template: field.field.{targetEntityType}.{bundle}.{key}
+  confidence: declared
+  id: *id002

periplus/packs/drupal@0.1.0/entity/entity.yaml

@@ -0,0 +1,33 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — declares the Entity API types and edges. Finds nothing.
+#
+# The entity type is NOT the class that implements it, and the file this replaces got that
+# wrong. It made the class the node and treated id = "redirect" as the class's identity.
+#
+# References say otherwise. Everything that names an entity type names the machine name:
+#   field.storage.node.body                     -> node
+#   core.entity_view_display.node.article.…     -> node
+# Nothing anywhere writes Drupal\node\Entity\Node. So the entity type is its own node, the
+# class is another, and an edge joins them — the same finding as block plugin versus block
+# class, which was made first and not carried across.
+
+node_types:
+- name: drupal.entity_type
+  id_namespace: drupal.entity_type
+- name: drupal.content_entity_type
+  parent: drupal.entity_type
+- name: drupal.config_entity_type
+  parent: drupal.entity_type
+- name: drupal.entity_class
+  parent: php.class
+- name: drupal.content_entity_class
+  parent: drupal.entity_class
+- name: drupal.config_entity_class
+  parent: drupal.entity_class
+- name: drupal.entity_save
+  parent: php.method
+edge_kinds:
+- kind: entity_class
+  from: drupal.entity_type
+  to: php.class

periplus/packs/drupal@0.1.0/entity/entity_class.yaml

@@ -0,0 +1,60 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — classifies a class as an entity class. One rule, and it reads the map.
+#
+# This is the rule that settled a question the old file got wrong by omission. It looks
+# like a rule about one file, and it is not.
+#
+# A class becomes an entity class because of what it extends, and the chain has to be
+# followed. In the common case that is one hop into a class the pack already describes:
+# all 19 custom entities in a private Drupal site write `extends ContentEntityBase` directly,
+# so the pack's own hierarchy table answers it without the map.
+#
+# But the same rule shape, applied to the rest of that codebase, chains through FIRST-PARTY
+# base classes:
+#   OrgScopedEntityAccessControlHandler   extended 7 times, itself first-party
+#   JobTypeBase                           extended 9 times
+#   ChatToolLoop                          extended 7 times
+# A class extending one of those cannot be classified until that base has been, and nothing
+# tells you in advance which case a file is.
+#
+# So transitive classification is ALWAYS a map rule. Not sometimes. The fixpoint sorts the
+# order out, and no pack author has to think about it.
+
+needs:
+  types: [drupal.entity_class, drupal.content_entity_class, drupal.config_entity_class]
+
+rules:
+
+  - rule: entity_class_content
+    reads: map
+    match:
+      node_type: php.class
+      where:
+        - ancestor_reaches: "Drupal\\Core\\Entity\\ContentEntityInterface"
+    emits:
+      - type: drupal.content_entity_class
+    confidence: declared
+    # Verified: a private Drupal site has 19 classes reaching this through ContentEntityBase,
+    # and not one of them writes `implements ContentEntityInterface` at its own declaration.
+    # A rule matching the written clause would match nothing real.
+
+  - rule: entity_class_config
+    reads: map
+    match:
+      node_type: php.class
+      where:
+        - ancestor_reaches: "Drupal\\Core\\Config\\Entity\\ConfigEntityInterface"
+    emits:
+      - type: drupal.config_entity_class
+    confidence: declared
+    # contrib pathauto PathautoPattern.php:74 extends ConfigEntityBase.
+
+# ------------------------------------------------------------------------------------
+# Deduplication is engine behaviour, not a switch.
+#
+# The old file carried `dedupe_paths: true` on one rule. It exists because EntityForm
+# reaches FormInterface twice — through FormBase, and through EntityFormInterface which
+# extends BaseFormIdInterface. Following both paths and counting the hit twice is never
+# what anyone wants, so the engine always dedupes and a pack never says so.
+# ------------------------------------------------------------------------------------

periplus/packs/drupal@0.1.0/entity/entity_save.yaml

@@ -0,0 +1,27 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — the entity save method. One rule, and it reads the map.
+#
+# The case that proves a rule cannot key on a name. Core has two methods called `save` that
+# differ only in what their containing class is:
+#   EntityBase.php:368  save()
+#   EntityForm.php:293  save(array $form, FormStateInterface $form_state)
+# A name-only rule matches both and distinguishes neither.
+
+needs:
+  types: [drupal.entity_class]
+
+rules:
+
+  - rule: entity_save
+    reads: map
+    match:
+      node_type: php.method
+      where:
+        - name: save
+        - contained_by_type: drupal.entity_class
+    emits:
+      - type: drupal.entity_save
+    confidence: declared
+    # `reads: map` because the containing class's type is what decides it, and that type is
+    # itself assigned by a map rule. Two passes, and the old file said neither.

periplus/packs/drupal@0.1.0/entity/entity_type_annotation.yaml

@@ -0,0 +1,85 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — entity type declared by a docblock annotation. One rule.
+#
+# Not a legacy tail, and the measurement that says so is the strongest argument in this
+# directory. A private Drupal site, a 2026 codebase:
+#
+#   20 files carry @ContentEntityType
+#    0 files carry #[ContentEntityType]
+#
+# A pack supporting attributes only would map that site's entire entity layer as nothing.
+
+needs:
+  types:
+  - drupal.content_entity_type
+  - drupal.config_entity_type
+rules:
+- rule: content_entity_type_from_annotation
+  reads: file
+  in:
+  - custom_module
+  match:
+    annotation: ContentEntityType
+    grammar: doctrine-annotation
+    where:
+    - applies_to: class_declaration
+  id: &id001
+    from:
+      annotation_key: id
+    must_be: string_literal
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.content_entity_type
+  confidence: declared
+- rule: config_entity_type_from_annotation
+  reads: file
+  in:
+  - custom_module
+  match:
+    annotation: ConfigEntityType
+    grammar: doctrine-annotation
+    where:
+    - applies_to: class_declaration
+  id: &id002
+    from:
+      annotation_key: id
+    must_be: string_literal
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.config_entity_type
+  confidence: declared
+- rule: content_entity_type_from_annotation_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    annotation: ContentEntityType
+    grammar: doctrine-annotation
+    where:
+    - applies_to: class_declaration
+  emits:
+  - edge:
+      kind: entity_class
+      from: this_node
+      to: enclosing_class
+  confidence: declared
+  id: *id001
+- rule: config_entity_type_from_annotation_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    annotation: ConfigEntityType
+    grammar: doctrine-annotation
+    where:
+    - applies_to: class_declaration
+  emits:
+  - edge:
+      kind: entity_class
+      from: this_node
+      to: enclosing_class
+  confidence: declared
+  id: *id002

periplus/packs/drupal@0.1.0/entity/entity_type_attribute.yaml

@@ -0,0 +1,76 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — entity type declared by a PHP attribute. One rule.
+#
+# The current core form. Supplementary to entity_type_annotation.yaml: a class carries one
+# or the other, both mint the same id, and neither needs the other.
+
+needs:
+  types:
+  - drupal.content_entity_type
+  - drupal.config_entity_type
+rules:
+- rule: content_entity_type_from_attribute
+  reads: file
+  in:
+  - custom_module
+  match:
+    attribute: Drupal\Core\Entity\Attribute\ContentEntityType
+    where:
+    - applies_to: class_declaration
+  id: &id001
+    from:
+      attribute_argument: id
+    must_be: string_literal
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.content_entity_type
+  confidence: declared
+- rule: config_entity_type_from_attribute
+  reads: file
+  in:
+  - custom_module
+  match:
+    attribute: Drupal\Core\Entity\Attribute\ConfigEntityType
+    where:
+    - applies_to: class_declaration
+  id: &id002
+    from:
+      attribute_argument: id
+    must_be: string_literal
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.config_entity_type
+  confidence: declared
+- rule: content_entity_type_from_attribute_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    attribute: Drupal\Core\Entity\Attribute\ContentEntityType
+    where:
+    - applies_to: class_declaration
+  emits:
+  - edge:
+      kind: entity_class
+      from: this_node
+      to: enclosing_class
+  confidence: declared
+  id: *id001
+- rule: config_entity_type_from_attribute_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    attribute: Drupal\Core\Entity\Attribute\ConfigEntityType
+    where:
+    - applies_to: class_declaration
+  emits:
+  - edge:
+      kind: entity_class
+      from: this_node
+      to: enclosing_class
+  confidence: declared
+  id: *id002

periplus/packs/drupal@0.1.0/field/field_instance_code.yaml

@@ -0,0 +1,40 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — field instance created by PHP. One rule.
+
+needs:
+  types:
+  - drupal.field_instance
+rules:
+- rule: field_instance_from_code
+  reads: file
+  in:
+  - custom_module
+  match:
+    static_call: Drupal\field\Entity\FieldConfig::create
+    argument: 0
+  id: &id001
+    from:
+    - argument_key: entity_type
+    - argument_key: bundle
+    - argument_key: field_name
+    template: field.field.{entity_type}.{bundle}.{field_name}
+    on_miss: unresolved
+  emits:
+  - node:
+      type: drupal.field_instance
+  confidence: declared
+- rule: field_instance_from_code_edges
+  reads: file
+  in:
+  - custom_module
+  match:
+    static_call: Drupal\field\Entity\FieldConfig::create
+    argument: 0
+  emits:
+  - edge:
+      kind: declares
+      from: enclosing_callable
+      to: this_node
+  confidence: declared
+  id: *id001

periplus/packs/drupal@0.1.0/field/field_instance_config.yaml

@@ -0,0 +1,58 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — field instance from a config file. One rule.
+#
+# The best example in the pack of a name carrying several facts at once, and so the case
+# that earns the regex.
+
+needs:
+  types:
+  - drupal.field_instance
+  - drupal.field_storage
+  - drupal.block_type
+rules:
+- rule: field_instance_from_config
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: field.field.*
+    filetype: yaml
+  id: &id001
+    from: file_stem
+  emits:
+  - node:
+      type: drupal.field_instance
+  - attribute:
+      name: label
+      from:
+        key: label
+  confidence: declared
+- rule: field_instance_from_config_edges
+  reads: file
+  in:
+  - config
+  - module_config
+  match:
+    file: field.field.*
+    filetype: yaml
+  emits:
+  - edge:
+      kind: stored_by
+      from: this_node
+      to:
+        from:
+          key: dependencies.config
+        where:
+        - matches: field.storage.*
+  - edge:
+      kind: field_of
+      from: this_node
+      to:
+        from:
+        - key: entity_type
+        - key: bundle
+        template: '{entity_type}.type.{bundle}'
+  confidence: declared
+  id: *id001

periplus/packs/drupal@0.1.0/field/field_storage.yaml

@@ -0,0 +1,37 @@
+$schema: "https://periplus.dev/schema/0/pack-file.schema.json"
+
+# drupal pack — declares field storage. Finds nothing.
+#
+# A storage is the field itself: its type, its cardinality, one per entity type. Many
+# bundles point at one storage, and the fan-in is information the individual files do not
+# carry.
+#
+# Verified in the export — one core storage, three instances, three different origins:
+#   field.storage.block_content.body            core's own (_core hash at line 8)
+#     field.field.block_content.basic.body            core's basic type
+#     field.field.block_content.block_ways_note.body  block_ways config/install
+#     field.field.block_content.type_way_code.body    added through the UI, label 'Body extra'
+#
+# The module's own storages are the opposite shape. field_tw_code_head has exactly one
+# instance, and so does every other field the three test modules create.
+
+node_types:
+
+  - name: drupal.field_storage
+    parent: drupal.config_object
+
+  - name: drupal.field_instance
+    parent: drupal.config_object
+
+edge_kinds:
+
+  - kind: stored_by
+    from: drupal.field_instance
+    to:   drupal.field_storage
+
+  - kind: field_of
+    from: drupal.field_instance
+    to:   drupal.block_type
+    # Narrow on purpose. The bundle a field belongs to is an entity bundle, and block types
+    # are the only bundles this pack currently declares. When node types and media types
+    # arrive the endpoint list widens; it must not be guessed ahead of them.