@dxos/app-graph 0.8.3 → 0.8.4-main.1c7ec43d41

package/dist/types/src/node-matcher.d.ts

@@ -0,0 +1,244 @@
+import * as Option from 'effect/Option';
+import type * as Schema from 'effect/Schema';
+import { type Entity, Obj, type Type } from '@dxos/echo';
+import * as Node from './node';
+/**
+ * Type for a node matcher function that returns an Option of the matched data.
+ * Matchers are used to filter and transform nodes in the app graph.
+ *
+ * @template TData - The type of data returned when the matcher succeeds.
+ *   Defaults to Node.Node, but can be a more specific type (e.g., an ECHO entity).
+ */
+export type NodeMatcher<TData = Node.Node> = (node: Node.Node) => Option.Option<TData>;
+/**
+ * Matches the root node of the graph.
+ *
+ * @returns Option.some(node) if the node is the root, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * GraphBuilder.createExtension({
+ *   id: 'my-extension',
+ *   match: NodeMatcher.whenRoot,
+ *   connector: (node) => Effect.succeed([...]),
+ * });
+ * ```
+ */
+export declare const whenRoot: (node: Node.Node) => Option.Option<Node.Node>;
+/**
+ * Matches a node by its exact ID.
+ *
+ * @param id - The node ID to match against.
+ * @returns A matcher that returns Option.some(node) if IDs match, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * GraphBuilder.createExtension({
+ *   id: 'spaces-extension',
+ *   match: NodeMatcher.whenId('spaces'),
+ *   connector: (node) => Effect.succeed([...]),
+ * });
+ * ```
+ */
+export declare const whenId: (id: string) => (node: Node.Node) => Option.Option<Node.Node>;
+/**
+ * Matches a node by its type string (the `node.type` property).
+ *
+ * @param type - The node type string to match against.
+ * @returns A matcher that returns Option.some(node) if types match, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * GraphBuilder.createExtension({
+ *   id: 'space-settings-extension',
+ *   match: NodeMatcher.whenNodeType('org.dxos.plugin.space.settings'),
+ *   connector: (node) => Effect.succeed([...]),
+ * });
+ * ```
+ */
+export declare const whenNodeType: (type: string) => (node: Node.Node) => Option.Option<Node.Node>;
+/**
+ * Matches a node whose data is an instance of the given ECHO schema type.
+ * Returns the **typed entity data** (not the node) for direct use in callbacks.
+ *
+ * Use this when you need to work directly with the typed ECHO entity in your
+ * connector or actions callback.
+ *
+ * @template T - The ECHO schema type to match against.
+ * @param type - The ECHO schema (e.g., `Collection.Collection`, `Document.Document`).
+ * @returns A matcher that returns Option.some(entity) if the data matches, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * GraphBuilder.createExtension({
+ *   id: 'collection-extension',
+ *   match: NodeMatcher.whenEchoType(Collection.Collection),
+ *   connector: (collection) => {
+ *     // `collection` is typed as Collection.Collection
+ *     return Effect.succeed(collection.objects.map(...));
+ *   },
+ * });
+ * ```
+ *
+ * Can be composed directly with {@link whenAll}/{@link whenAny}/{@link whenNot} while
+ * preserving the typed entity data in the result.
+ *
+ * @see {@link whenEchoTypeMatches} - Returns the node instead of data for legacy composition.
+ */
+export declare const whenEchoType: <T extends Type.AnyEntity>(type: T) => NodeMatcher<Entity.Entity<Schema.Schema.Type<T>>>;
+/**
+ * Matches a node whose data is any ECHO object.
+ * Returns the **object data** (not the node) for direct use in callbacks.
+ *
+ * Use this when you need to work with any ECHO object regardless of its specific type.
+ *
+ * @returns Option.some(object) if the node's data is an ECHO object, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * GraphBuilder.createExtension({
+ *   id: 'object-properties',
+ *   match: NodeMatcher.whenEchoObject,
+ *   connector: (object) => {
+ *     // `object` is typed as Obj.Unknown
+ *     const id = Obj.getDXN(object).toString();
+ *     return Effect.succeed([{ id: `${id}.settings`, ... }]);
+ *   },
+ * });
+ * ```
+ *
+ * Can be composed directly with {@link whenAll}/{@link whenAny}/{@link whenNot} while
+ * preserving the `Obj.Unknown` data type in the result.
+ *
+ * @see {@link whenEchoObjectMatches} - Returns the node instead of data for legacy composition.
+ */
+export declare const whenEchoObject: (node: Node.Node) => Option.Option<Obj.Unknown>;
+/**
+ * Composes multiple matchers with AND logic - all matchers must match for success.
+ * The result data type is the intersection of all matchers' data types.
+ * Filter matchers like {@link whenNot} return `unknown`, making them transparent
+ * in the intersection (since `T & unknown = T`).
+ *
+ * @param matchers - The matchers to combine. All must return Option.some for success.
+ * @returns A matcher whose data type is the intersection of all input matchers' data types.
+ *   Returns the first matcher's value when all match, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * // Match ECHO objects that are NOT Channels — result is NodeMatcher<Obj.Unknown>.
+ * const whenCommentable = NodeMatcher.whenAll(
+ *   NodeMatcher.whenEchoObject,
+ *   NodeMatcher.whenNot(NodeMatcher.whenEchoTypeMatches(Channel.Channel)),
+ * );
+ * ```
+ */
+export declare const whenAll: {
+    <A>(a: NodeMatcher<A>, b: NodeMatcher<unknown>): NodeMatcher<A>;
+    <A>(a: NodeMatcher<unknown>, b: NodeMatcher<A>): NodeMatcher<A>;
+    <A, B>(a: NodeMatcher<A>, b: NodeMatcher<B>): NodeMatcher<A & B>;
+    <A, B, C>(a: NodeMatcher<A>, b: NodeMatcher<B>, c: NodeMatcher<C>): NodeMatcher<A & B & C>;
+    <A, B, C, D>(a: NodeMatcher<A>, b: NodeMatcher<B>, c: NodeMatcher<C>, d: NodeMatcher<D>): NodeMatcher<A & B & C & D>;
+    (...matchers: NodeMatcher<any>[]): NodeMatcher<any>;
+};
+/**
+ * Composes multiple matchers with OR logic - at least one matcher must match.
+ * The result data type is the union of all matchers' data types.
+ *
+ * @param matchers - The matchers to combine. At least one must return Option.some.
+ * @returns A matcher whose data type is the union of all input matchers' data types.
+ *   Returns the first matching matcher's value, or Option.none() if none match.
+ *
+ * @example
+ * ```ts
+ * // Match nodes that are either Sequences or Routines
+ * const whenInvocable = NodeMatcher.whenAny(
+ *   NodeMatcher.whenEchoTypeMatches(Sequence),
+ *   NodeMatcher.whenEchoTypeMatches(Routine.Routine),
+ * );
+ * ```
+ */
+export declare const whenAny: {
+    <A, B>(a: NodeMatcher<A>, b: NodeMatcher<B>): NodeMatcher<A | B>;
+    <A, B, C>(a: NodeMatcher<A>, b: NodeMatcher<B>, c: NodeMatcher<C>): NodeMatcher<A | B | C>;
+    <A, B, C, D>(a: NodeMatcher<A>, b: NodeMatcher<B>, c: NodeMatcher<C>, d: NodeMatcher<D>): NodeMatcher<A | B | C | D>;
+    (...matchers: NodeMatcher<any>[]): NodeMatcher<any>;
+};
+/**
+ * Matches a node whose data is an instance of the given ECHO schema type.
+ * Returns the **node** (not the data) to enable composition with whenAll/whenAny/whenNot.
+ *
+ * Use this instead of {@link whenEchoType} when you need to combine matchers.
+ * The difference is what's returned:
+ * - `whenEchoType` returns the typed entity (for direct use)
+ * - `whenEchoTypeMatches` returns the node (for composition)
+ *
+ * @template T - The ECHO schema type to match against.
+ * @param type - The ECHO schema (e.g., `Channel.Channel`, `Document.Document`).
+ * @returns A matcher that returns Option.some(node) if the data matches, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * // Use with whenAny for OR logic
+ * const whenPresentable = NodeMatcher.whenAny(
+ *   NodeMatcher.whenEchoTypeMatches(Collection.Collection),
+ *   NodeMatcher.whenEchoTypeMatches(Markdown.Document),
+ * );
+ *
+ * // Use with whenNot for exclusion
+ * const whenNotChannel = NodeMatcher.whenNot(
+ *   NodeMatcher.whenEchoTypeMatches(Channel.Channel),
+ * );
+ * ```
+ *
+ * @see {@link whenEchoType} - Use instead when you need the typed entity directly.
+ */
+export declare const whenEchoTypeMatches: <T extends Type.AnyEntity>(type: T) => NodeMatcher;
+/**
+ * Matches a node whose data is any ECHO object.
+ * Returns the **node** (not the data) to enable composition with whenAll/whenAny/whenNot.
+ *
+ * Use this instead of {@link whenEchoObject} when you need to combine matchers.
+ * The difference is what's returned:
+ * - `whenEchoObject` returns the object data (for direct use)
+ * - `whenEchoObjectMatches` returns the node (for composition)
+ *
+ * @returns Option.some(node) if the node's data is an ECHO object, Option.none() otherwise.
+ *
+ * @example
+ * ```ts
+ * // Match ECHO objects that are not system types
+ * const whenUserObject = NodeMatcher.whenAll(
+ *   NodeMatcher.whenEchoObjectMatches,
+ *   NodeMatcher.whenNot(NodeMatcher.whenEchoTypeMatches(SystemType)),
+ * );
+ * ```
+ *
+ * @see {@link whenEchoObject} - Use instead when you need the object data directly.
+ */
+export declare const whenEchoObjectMatches: (node: Node.Node) => Option.Option<Node.Node>;
+/**
+ * Negates a matcher - matches when the given matcher does NOT match.
+ * Useful for exclusion patterns like "any object EXCEPT type X".
+ *
+ * Returns `NodeMatcher<unknown>` because negation is a filter — it doesn't provide
+ * typed data. This makes it transparent in {@link whenAll} intersections
+ * (since `T & unknown = T`).
+ *
+ * @param matcher - The matcher to negate.
+ * @returns A matcher that returns Option.some(node) if the input matcher returns none,
+ *   and Option.none() if the input matcher returns some.
+ *
+ * @example
+ * ```ts
+ * // Match any ECHO object that is NOT a Channel — result is NodeMatcher<Obj.Unknown>.
+ * const whenCommentable = NodeMatcher.whenAll(
+ *   NodeMatcher.whenEchoObject,
+ *   NodeMatcher.whenNot(NodeMatcher.whenEchoTypeMatches(Channel.Channel)),
+ * );
+ *
+ * // Match any node that is NOT the root
+ * const whenNotRoot = NodeMatcher.whenNot(NodeMatcher.whenRoot);
+ * ```
+ */
+export declare const whenNot: (matcher: NodeMatcher<any>) => NodeMatcher<unknown>;
+//# sourceMappingURL=node-matcher.d.ts.map

package/dist/types/src/node-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-matcher.d.ts","sourceRoot":"","sources":["../../../src/node-matcher.ts"],"names":[],"mappings":"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"}

package/dist/types/src/node-matcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-matcher.test.d.ts.map

package/dist/types/src/node-matcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-matcher.test.d.ts","sourceRoot":"","sources":["../../../src/node-matcher.test.ts"],"names":[],"mappings":""}

package/dist/types/src/node.d.ts

@@ -1,4 +1,22 @@
-import { type MaybePromise, type MakeOptional } from '@dxos/util';
+import type * as Context from 'effect/Context';
+import type * as Effect from 'effect/Effect';
+import { type MakeOptional } from '@dxos/util';
+/**
+ * Root node ID.
+ */
+export declare const RootId = "root";
+/**
+ * Root node type.
+ */
+export declare const RootType = "org.dxos.type.graphRoot";
+/**
+ * Action node type.
+ */
+export declare const ActionType = "org.dxos.type.graphAction";
+/**
+ * Action group node type.
+ */
+export declare const ActionGroupType = "org.dxos.type.graphActionGroup";
 /**
  * Represents a node in the graph.
  */
@@ -27,22 +45,43 @@ export type Node<TData = any, TProperties extends Record<string, any> = Record<s
     data: TData;
 }>;
 export type NodeFilter<TData = any, TProperties extends Record<string, any> = Record<string, any>> = (node: Node<unknown, Record<string, any>>, connectedNode: Node) => node is Node<TData, TProperties>;
-export type Relation = 'outbound' | 'inbound';
+export type RelationDirection = 'outbound' | 'inbound';
+export type Relation = Readonly<{
+    kind: string;
+    direction: RelationDirection;
+}>;
+export type RelationInput = Relation | string;
+export declare const relation: (kind: string, direction?: RelationDirection) => Relation;
+export declare const childRelation: (direction?: RelationDirection) => Relation;
+export declare const actionRelation: (direction?: RelationDirection) => Relation;
 export declare const isGraphNode: (data: unknown) => data is Node;
 export type NodeArg<TData, TProperties extends Record<string, any> = Record<string, any>> = MakeOptional<Node<TData, TProperties>, 'data' | 'properties' | 'cacheable'> & {
     /** Will automatically add nodes with an edge from this node to each. */
     nodes?: NodeArg<unknown>[];
     /** Will automatically add specified edges. */
-    edges?: [string, Relation][];
+    edges?: [string, RelationInput][];
 };
-export type InvokeParams = {
+export type InvokeProps = {
     /** Node the invoked action is connected to. */
     parent?: Node;
+    /** Path from root to the node in the current tree context. */
+    path?: string[];
     caller?: string;
 };
-export type ActionData = (params?: InvokeParams) => MaybePromise<void>;
+/**
+ * Action data is an Effect-returning function.
+ * The Effect is provided with captured context at execution time.
+ */
+export type ActionData<R = never> = (params?: InvokeProps) => Effect.Effect<any, Error, R>;
+/**
+ * Context captured at extension creation time.
+ * Automatically provided to action Effects at execution.
+ */
+export type ActionContext = Context.Context<any>;
 export type Action<TProperties extends Record<string, any> = Record<string, any>> = Readonly<Omit<Node<ActionData, TProperties>, 'properties'> & {
     properties: Readonly<TProperties>;
+    /** Captured context from extension creation. Provided automatically at action execution. */
+    _actionContext?: ActionContext;
 }>;
 export declare const isAction: (data: unknown) => data is Action;
 export declare const actionGroupSymbol: unique symbol;
@@ -52,4 +91,10 @@ export type ActionGroup<TProperties extends Record<string, any> = Record<string,
 export declare const isActionGroup: (data: unknown) => data is ActionGroup;
 export type ActionLike = Action | ActionGroup;
 export declare const isActionLike: (data: unknown) => data is Action | ActionGroup;
+/** Typed factory for constructing a NodeArg. Provides auto-complete and type validation. */
+export declare const make: <TData = any, TProperties extends Record<string, any> = Record<string, any>>(arg: NodeArg<TData, TProperties>) => NodeArg<TData, TProperties>;
+/** Create an action node. Automatically sets `type: ActionType`. */
+export declare const makeAction: <R = never>(arg: Omit<NodeArg<ActionData<R>>, 'type' | 'nodes' | 'edges'>) => NodeArg<ActionData<R>>;
+/** Create an action group node. Automatically sets `type` and `data`. */
+export declare const makeActionGroup: (arg: Omit<NodeArg<typeof actionGroupSymbol>, 'type' | 'data' | 'nodes' | 'edges'>) => NodeArg<typeof actionGroupSymbol>;
 //# sourceMappingURL=node.d.ts.map

package/dist/types/src/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/node.ts"],"names":[],"mappings":"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"}

package/dist/types/src/scheduler.browser.d.ts

@@ -0,0 +1,2 @@
+export { scheduleTask, yieldOrContinue } from 'main-thread-scheduling';
+//# sourceMappingURL=scheduler.browser.d.ts.map

package/dist/types/src/scheduler.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.browser.d.ts","sourceRoot":"","sources":["../../../src/scheduler.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/src/scheduler.d.ts

@@ -0,0 +1,8 @@
+type ScheduleOptions = {
+    strategy?: 'smooth' | 'interactive' | 'idle';
+    signal?: AbortSignal;
+};
+export declare const scheduleTask: <T>(callback: () => T | Promise<T>, _options?: ScheduleOptions) => Promise<T>;
+export declare const yieldOrContinue: (_priority: 'smooth' | 'interactive' | 'idle') => Promise<void>;
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/types/src/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/scheduler.ts"],"names":[],"mappings":"AAOA,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE9F,eAAO,MAAM,YAAY,GAAU,CAAC,YAAY,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,eAAe,KAAG,OAAO,CAAC,CAAC,CAG3G,CAAC;AAEF,eAAO,MAAM,eAAe,cAAqB,QAAQ,GAAG,aAAa,GAAG,MAAM,KAAG,OAAO,CAAC,IAAI,CAEhG,CAAC"}

package/dist/types/src/stories/EchoGraph.stories.d.ts

@@ -1,17 +1,10 @@
-import '@dxos-theme';
-import React from 'react';
-declare const _default: {
+import { type StoryObj } from '@storybook/react-vite';
+declare const meta: {
     title: string;
     decorators: import("@storybook/react").Decorator[];
 };
-export default _default;
-export declare const JsonView: {
-    render: () => React.JSX.Element;
-};
-export declare const TreeView: {
-    render: () => React.JSX.Element;
-};
-export declare const TabTreeView: {
-    render: () => React.JSX.Element;
-};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const JsonView: Story;
+export declare const TreeView: Story;
 //# sourceMappingURL=EchoGraph.stories.d.ts.map

package/dist/types/src/stories/EchoGraph.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EchoGraph.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/EchoGraph.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAKrB,OAAO,KAAwF,MAAM,OAAO,CAAC;;;;;AA8O7G,wBAYE;AAEF,eAAO,MAAM,QAAQ;;CAcpB,CAAC;AAEF,eAAO,MAAM,QAAQ;;CAgGpB,CAAC;AAGF,eAAO,MAAM,WAAW;;CAoHvB,CAAC"}
+{"version":3,"file":"EchoGraph.stories.d.ts","sourceRoot":"","sources":["../../../../src/stories/EchoGraph.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAoPjE,QAAA,MAAM,IAAI;;;CAaM,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,QAAQ,EAAE,KActB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAmItB,CAAC"}

package/dist/types/src/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './setup-graph-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC"}

package/dist/types/src/testing/setup-graph-builder.d.ts

@@ -0,0 +1,31 @@
+import { Registry } from '@effect-atom/atom-react';
+import * as Graph from '../graph';
+import * as GraphBuilder from '../graph-builder';
+import * as Node from '../node';
+export type SetupGraphBuilderOptions = {
+    registry?: Registry.Registry;
+    extensions?: GraphBuilder.BuilderExtensions;
+};
+export declare const setupGraphBuilder: ({ registry, extensions }?: SetupGraphBuilderOptions) => {
+    registry: Registry.Registry;
+    builder: GraphBuilder.GraphBuilder;
+    graph: Graph.ExpandableGraph;
+    addExtensions: (nextExtensions: GraphBuilder.BuilderExtensions) => void;
+    expand: (id: string, relation?: Node.RelationInput) => Promise<void>;
+    flush: () => Promise<void>;
+    getConnections: (id: string, relation?: Node.RelationInput) => Readonly<{
+        id: string;
+        type: string;
+        cacheable?: string[];
+        properties: Readonly<Record<string, any>>;
+        data: any;
+    }>[];
+    getNode: (id: string) => Readonly<{
+        id: string;
+        type: string;
+        cacheable?: string[];
+        properties: Readonly<Record<string, any>>;
+        data: any;
+    }> | null;
+};
+//# sourceMappingURL=setup-graph-builder.d.ts.map

package/dist/types/src/testing/setup-graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/testing/setup-graph-builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,OAAO,KAAK,KAAK,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,UAAU,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,iBAAiB,8BAAgD,wBAAwB;;;;oCAYlE,YAAY,CAAC,iBAAiB;iBAG3C,MAAM,aAAY,IAAI,CAAC,aAAa;;yBAKlC,MAAM,aAAY,IAAI,CAAC,aAAa;;;;;;;kBAE3C,MAAM;;;;;;;CAEvB,CAAC"}

package/dist/types/src/util.d.ts

@@ -0,0 +1,40 @@
+import * as Node from './node';
+/** Join parts with the primary separator. */
+export declare const primaryKey: (...parts: string[]) => string;
+/** Split a key on the primary separator. */
+export declare const primaryParts: (key: string) => string[];
+/** Join parts with the secondary separator. */
+export declare const secondaryKey: (...parts: string[]) => string;
+/** Split a key on the secondary separator. */
+export declare const secondaryParts: (key: string) => string[];
+/**
+ * Normalize a relation input to a full Relation object.
+ */
+export declare const normalizeRelation: (relation?: Node.RelationInput) => Node.Relation;
+/**
+ * Shallow-compare two values: same reference, or same own-keys with === values.
+ */
+export declare const shallowEqual: (a: unknown, b: unknown) => boolean;
+/**
+ * Returns true if two NodeArg arrays are semantically identical (same id, type, data, properties per index).
+ * Inline child nodes (the `nodes` field) are compared recursively.
+ */
+export declare const nodeArgsUnchanged: (prev: Node.NodeArg<any>[], next: Node.NodeArg<any>[]) => boolean;
+/**
+ * Build a qualified node ID by joining path segments.
+ */
+export declare const qualifyId: (parentId: string, ...segmentIds: string[]) => string;
+/**
+ * Validate that a segment ID does not contain the path separator.
+ */
+export declare const validateSegmentId: (id: string) => void;
+/**
+ * Extract the parent qualified ID (everything before the last path separator).
+ * Returns undefined for IDs with no parent (single segment).
+ */
+export declare const getParentId: (qualifiedId: string) => string | undefined;
+/**
+ * Extract the last segment of a qualified ID.
+ */
+export declare const getSegmentId: (qualifiedId: string) => string;
+//# sourceMappingURL=util.d.ts.map

package/dist/types/src/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/util.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAW/B,6CAA6C;AAC7C,eAAO,MAAM,UAAU,aAAc,MAAM,EAAE,KAAG,MAA6B,CAAC;AAE9E,4CAA4C;AAC5C,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAAM,EAAwB,CAAC;AAE1E,+CAA+C;AAC/C,eAAO,MAAM,YAAY,aAAc,MAAM,EAAE,KAAG,MAA+B,CAAC;AAElF,8CAA8C;AAC9C,eAAO,MAAM,cAAc,QAAS,MAAM,KAAG,MAAM,EAA0B,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,iBAAiB,cAAe,IAAI,CAAC,aAAa,KAAG,IAAI,CAAC,QACsC,CAAC;AAE9G;;GAEG;AACH,eAAO,MAAM,YAAY,MAAO,OAAO,KAAK,OAAO,KAAG,OAarD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SAAU,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAG,OAexF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,aAAc,MAAM,iBAAiB,MAAM,EAAE,KAAG,MAA8C,CAAC;AAErH;;GAEG;AACH,eAAO,MAAM,iBAAiB,OAAQ,MAAM,KAAG,IAE9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAiB,MAAM,KAAG,MAAM,GAAG,SAG1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAiB,MAAM,KAAG,MAElD,CAAC"}