base party and related DSL and livebook

Author: matt-beanland

.vscode/launch.json

@@ -183,5 +183,55 @@ Target: `Diffo.Provider.Instance.Characteristic`
 
 
 
+## parties
+List of Instance Party roles
+
+### Nested DSLs
+ * [party](#parties-party)
+
+
+### Examples
+```
+parties do
+  party :facilitated_by, MyApp.Rsp
+  party :overseen_by, MyApp.Person
+end
+
+```
+
+
+
+
+### parties.party
+```elixir
+party role, party_type
+```
+
+
+Declares a party role on this Instance
+
+
+
+
+
+### Arguments
+
+| Name | Type | Default | Docs |
+|------|------|---------|------|
+| [`role`](#parties-party-role){: #parties-party-role .spark-required} | `atom` |  | The role name, an atom |
+| [`party_type`](#parties-party-party_type){: #parties-party-party_type } | `any` |  | The module of the Party kind. An atom module name such as a BaseParty-derived resource. |
+
+
+
+
+
+
+### Introspection
+
+Target: `Diffo.Provider.Instance.Extension.PartyDeclaration`
+
+
+
+
 
 <style type="text/css">.spark-required::after { content: "*"; color: red !important; }</style>

documentation/dsls/DSL-Diffo.Provider.Instance.Extension.md

@@ -0,0 +1,108 @@
+<!--
+This file was generated by Spark. Do not edit it by hand.
+-->
+# Diffo.Provider.Party.Extension
+
+DSL Extension customising a Party
+
+
+## instance
+Declares the roles this Party kind plays with respect to Instances
+
+### Nested DSLs
+ * [role](#instance-role)
+
+
+### Examples
+```
+instance do
+  role :facilitates, MyApp.AccessService
+end
+
+```
+
+
+
+
+### instance.role
+```elixir
+role role, party_type
+```
+
+
+Declares a role this Party kind plays
+
+
+
+
+
+### Arguments
+
+| Name | Type | Default | Docs |
+|------|------|---------|------|
+| [`role`](#instance-role-role){: #instance-role-role .spark-required} | `atom` |  | The role name, an atom |
+| [`party_type`](#instance-role-party_type){: #instance-role-party_type } | `any` |  | The module of the related resource |
+
+
+
+
+
+
+### Introspection
+
+Target: `Diffo.Provider.Party.Extension.InstanceRole`
+
+
+
+
+## party
+Declares the roles this Party kind plays with respect to other Parties
+
+### Nested DSLs
+ * [role](#party-role)
+
+
+### Examples
+```
+party do
+  role :managed_by, MyApp.Person
+end
+
+```
+
+
+
+
+### party.role
+```elixir
+role role, party_type
+```
+
+
+Declares a role this Party kind plays with respect to other Parties
+
+
+
+
+
+### Arguments
+
+| Name | Type | Default | Docs |
+|------|------|---------|------|
+| [`role`](#party-role-role){: #party-role-role .spark-required} | `atom` |  | The role name, an atom |
+| [`party_type`](#party-role-party_type){: #party-role-party_type } | `any` |  | The module of the related Party kind |
+
+
+
+
+
+
+### Introspection
+
+Target: `Diffo.Provider.Party.Extension.PartyRole`
+
+
+
+
+
+<style type="text/css">.spark-required::after { content: "*"; color: red !important; }</style>

documentation/dsls/DSL-Diffo.Provider.Party.Extension.md

@@ -0,0 +1,3 @@
+SPDX-FileCopyrightText: 2025 diffo contributors <https://github.com/diffo-dev/diffo/graphs.contributors>
+
+SPDX-License-Identifier: MIT