Complete standalone PackML runtime and native async transition support

.azurepipelines/expected-packages.txt

@@ -108,6 +108,8 @@ OPCFoundation.NetStandard.Opc.Ua.OpenUsd.Connector
 OPCFoundation.NetStandard.Opc.Ua.OpenUsd.Connector.Viewer
 OPCFoundation.NetStandard.Opc.Ua.OpenUsd.Server
 OPCFoundation.NetStandard.Opc.Ua.PackML
+OPCFoundation.NetStandard.Opc.Ua.PackML.Client
+OPCFoundation.NetStandard.Opc.Ua.PackML.Server
 OPCFoundation.NetStandard.Opc.Ua.PADIM
 OPCFoundation.NetStandard.Opc.Ua.PADIM.Client
 OPCFoundation.NetStandard.Opc.Ua.PADIM.Server

README.md

@@ -62,7 +62,8 @@ across industrial control, manufacturing, energy, and IoT systems.
   OPC 40223 (Pumps and Vacuum Pumps),
   OPC 30010 ([AutoID Devices](docs/AutoID.md)),
   OPC 30500-1 ([Laboratory and Analytical Devices](docs/LADS.md)),
-  OPC 40200 (Weighing Technology) with OPC 30050 (PackML).
+  OPC 40200 (Weighing Technology) with OPC 30050
+  ([PackML](docs/PackML.md), also available as standalone provider-backed units).
 - **Hosting and code generation** — `Microsoft.Extensions.DependencyInjection`
   hosting (`services.AddOpcUa()`), fluent server + client builders,
   source-generated NodeManagers and DataTypes, and an MCP server so

UA.slnx

@@ -72,6 +72,9 @@
     <Project Path="samples/Scales/ScalesServer/ScalesServer.csproj" />
     <Project Path="samples/Scales/ScalesClient/ScalesClient.csproj" />
   </Folder>
+  <Folder Name="/samples/PackML/">
+    <Project Path="samples/PackML/PackMLSample/PackMLSample.csproj" />
+  </Folder>
   <Folder Name="/samples/IA/">
     <File Path="samples/IA/README.md" />
     <Project Path="samples/IA/IndustrialAutomationSample.csproj" />
@@ -196,6 +199,8 @@
     <Project Path="src/Opc.Ua.PADIM.Client/Opc.Ua.PADIM.Client.csproj" />
     <Project Path="src/Opc.Ua.PADIM.Server/Opc.Ua.PADIM.Server.csproj" />
     <Project Path="src/Opc.Ua.PackML/Opc.Ua.PackML.csproj" />
+    <Project Path="src/Opc.Ua.PackML.Client/Opc.Ua.PackML.Client.csproj" />
+    <Project Path="src/Opc.Ua.PackML.Server/Opc.Ua.PackML.Server.csproj" />
     <Project Path="src/Opc.Ua.Machinery/Opc.Ua.Machinery.csproj" />
     <Project Path="src/Opc.Ua.Machinery.Jobs/Opc.Ua.Machinery.Jobs.csproj" />
     <Project Path="src/Opc.Ua.Machinery.Result/Opc.Ua.Machinery.Result.csproj" />
@@ -453,6 +458,7 @@
     <Project Path="tests/Opc.Ua.ECM.IntegrationTests/Opc.Ua.ECM.Integration.Tests.csproj" />
     <Project Path="tests/Opc.Ua.PADIM.Tests/Opc.Ua.PADIM.Tests.csproj" />
     <Project Path="tests/Opc.Ua.Scales.Tests/Opc.Ua.Scales.Tests.csproj" />
+    <Project Path="tests/Opc.Ua.PackML.Tests/Opc.Ua.PackML.Tests.csproj" />
     <Project Path="tests/Opc.Ua.AMB.Tests/Opc.Ua.AMB.Tests.csproj" />
     <Project Path="tests/Opc.Ua.AutoID.Tests/Opc.Ua.AutoID.Tests.csproj" />
     <Project Path="tests/Opc.Ua.LADS.Tests/Opc.Ua.LADS.Tests.csproj" />

docs/DeviceIntegration.md

@@ -678,8 +678,9 @@ Runtimes use these public `DiNodeManager` members:
   atomically with its last batch; later registrations throw `ObjectDisposedException`.
   An ordinary explicit drain leaves registration open for new batches. The Machinery-named
   registration and disposal extensions forward to these neutral members.
-- `RegisterRootNotifierAsync` registers an event source and attaches existing
-  event subscriptions.
+- `RegisterRootNotifierAsync`, inherited from `AsyncCustomNodeManager`,
+  registers an event source as a Server root and attaches existing event
+  subscriptions. Deleting the node removes the registration.
 - `TryOrganizeUnder` adds both directions of an `Organizes` reference and
   returns `false` when the folder is not owned. Resolve
   `Machinery.ObjectIds.Machines` through the namespace table; a matching BrowseName

docs/NodeManagers.md

@@ -1732,6 +1732,24 @@ fails; that failure cannot restore the prior routing view. This path supports th
 ownership model of `AsyncCustomNodeManager` and adapted `CustomNodeManager2`; a custom external
 reference store is rejected before the decision.
 
+For an indexed node owned by an `AsyncCustomNodeManager`, use
+`AddExternalReferenceAsync` to link an externally owned source to it:
+
+```csharp
+await manager.AddExternalReferenceAsync(
+    node, ObjectIds.ObjectsFolder, ReferenceTypeIds.Organizes, isInverse: false,
+    cancellationToken: ct);
+```
+
+The method adds the reciprocal reference on `node`. For a private candidate it
+stages the external reference until publication; for a published manager it
+adds the reference through the master. The external source must exist by
+publication; a missing source rejects the commit before its durable decision.
+Deleting or replacing the target before publication discards its staged
+reference. Deleting a target from a published lifecycle manager also removes
+its contribution, so a later publication does not restore the reference. Finish
+changes to the candidate before starting its commit.
+
 #### Change notifications
 
 Every committed lifecycle transaction emits one compressed model-change notification. Reload also
@@ -3024,6 +3042,15 @@ builder.Boilers.Boiler__1.DrumX001
 
 The `Server` Object (`i=2253`) is the aggregate event subscription point
 (OPC UA Part 5 [8.3.2](https://reference.opcfoundation.org/Core/Part5/v105/docs/8.3.2)).
+Use `await manager.RegisterRootNotifierAsync(node, ct)` to register a node
+without a parent notifier as a Server event root. For a published manager, the
+call publishes the Server object's `HasNotifier` reference and attempts to
+attach existing Server-event monitored items. While a lifecycle candidate is
+private, including after preparation returns, the reference is staged and
+existing subscriptions are attached during reconciliation after publication.
+Check the lifecycle result for reconciliation failures. Deleting the node
+through its manager removes the registration, so there is no removal API. If
+registration throws, delete the node to discard any partial registration.
 Server-wide fan-out treats an individual root or manager's `BadNotSupported` as
 non-participation, not as a failure of every other source. Root registration
 does not silently set `EventNotifier.SubscribeToEvents`; declare the capability