@robosystems/client 0.3.37 → 0.3.39

package/artifacts/graphql/generated/graphql.ts

@@ -226,6 +226,8 @@ export type DraftEntry = {
   totalDebit: Scalars['Int']['output']
   /** Entry type (e.g., 'closing', 'adjusting') */
   type: Scalars['String']['output']
+  /** True if closing the period will publish this draft to QuickBooks — i.e. the graph has a qb_authoritative/hybrid QB connection AND this is an RL-originated draft (schedule/manual) not already in QB. False means it posts locally only. */
+  willPublishToQb: Scalars['Boolean']['output']
 }
 
 /** A single line item within a draft entry. */
@@ -641,10 +643,12 @@ export type InformationBlockRuleTarget = {
 
 /** `$Variable` → concept qname binding for a rule expression. */
 export type InformationBlockRuleVariable = {
+  /** Element id the variable binds to directly. Set for schedule SumEquals rules over CoA-debit elements that have no qname; null otherwise. */
+  variableElementId: Maybe<Scalars['String']['output']>
   /** Local name in the rule expression, e.g. 'Assets'. */
   variableName: Scalars['String']['output']
-  /** Concept qname the variable resolves to, e.g. 'fac:Assets'. */
-  variableQname: Scalars['String']['output']
+  /** Concept qname the variable resolves to, e.g. 'fac:Assets'. Null for tenant CoA elements (which key on `code`/`element_id`, not qname) — in that case the binding is carried by `variable_element_id`. */
+  variableQname: Maybe<Scalars['String']['output']>
 }
 
 /**
@@ -928,15 +932,21 @@ export type LibraryAssociation = {
   /** presentation | calculation | mapping | equivalence | general-special | essence-alias */
   associationType: Scalars['String']['output']
   fromElementId: Scalars['String']['output']
+  fromElementIsAbstract: Maybe<Scalars['Boolean']['output']>
   fromElementName: Maybe<Scalars['String']['output']>
   fromElementQname: Maybe<Scalars['String']['output']>
+  /** Primary elementsOfFinancialStatements trait (for node coloring) */
+  fromElementTrait: Maybe<Scalars['String']['output']>
   id: Scalars['String']['output']
   orderValue: Maybe<Scalars['Float']['output']>
   structureId: Scalars['String']['output']
   structureName: Maybe<Scalars['String']['output']>
   toElementId: Scalars['String']['output']
+  toElementIsAbstract: Maybe<Scalars['Boolean']['output']>
   toElementName: Maybe<Scalars['String']['output']>
   toElementQname: Maybe<Scalars['String']['output']>
+  /** Primary elementsOfFinancialStatements trait (for node coloring) */
+  toElementTrait: Maybe<Scalars['String']['output']>
   weight: Maybe<Scalars['Float']['output']>
 }
 
@@ -1220,10 +1230,18 @@ export type PeriodDrafts = {
   allBalanced: Scalars['Boolean']['output']
   draftCount: Scalars['Int']['output']
   drafts: Array<DraftEntry>
+  /** Number of drafts that post locally only (no QB write-back). */
+  localOnlyCount: Scalars['Int']['output']
   /** YYYY-MM period name */
   period: Scalars['String']['output']
   periodEnd: Scalars['Date']['output']
   periodStart: Scalars['Date']['output']
+  /** Number of drafts that will publish to QuickBooks on close. */
+  qbPublishCount: Scalars['Int']['output']
+  /** write_policy of the publishing QB connection ('qb_authoritative' / 'hybrid'), or null when there is no write-back connection. */
+  qbWritePolicy: Maybe<Scalars['String']['output']>
+  /** Id of the QuickBooks connection these drafts publish to on close, or null when the graph has no qb_authoritative/hybrid QB connection (the drafts post locally only). */
+  qbWritebackConnectionId: Maybe<Scalars['String']['output']>
   /** Sum across all drafts, in cents */
   totalCredit: Scalars['Int']['output']
   /** Sum across all drafts, in cents */
@@ -2838,7 +2856,7 @@ export type GetInformationBlockQuery = {
       ruleSeverity: string
       ruleOrigin: string
       ruleTarget: { targetKind: string; targetRefId: string } | null
-      ruleVariables: Array<{ variableName: string; variableQname: string }>
+      ruleVariables: Array<{ variableName: string; variableQname: string | null }>
     }>
     factSet: {
       id: string
@@ -2965,7 +2983,7 @@ export type ListInformationBlocksQuery = {
       ruleSeverity: string
       ruleOrigin: string
       ruleTarget: { targetKind: string; targetRefId: string } | null
-      ruleVariables: Array<{ variableName: string; variableQname: string }>
+      ruleVariables: Array<{ variableName: string; variableQname: string | null }>
     }>
     factSet: {
       id: string
@@ -3157,6 +3175,10 @@ export type GetLedgerPeriodDraftsQuery = {
     totalDebit: number
     totalCredit: number
     allBalanced: boolean
+    qbWritebackConnectionId: string | null
+    qbWritePolicy: string | null
+    qbPublishCount: number
+    localOnlyCount: number
     drafts: Array<{
       entryId: string
       postingDate: any
@@ -3168,6 +3190,7 @@ export type GetLedgerPeriodDraftsQuery = {
       totalDebit: number
       totalCredit: number
       balanced: boolean
+      willPublishToQb: boolean
       lineItems: Array<{
         lineItemId: string
         elementId: string
@@ -3339,7 +3362,7 @@ export type GetLedgerReportPackageQuery = {
           ruleSeverity: string
           ruleOrigin: string
           ruleTarget: { targetKind: string; targetRefId: string } | null
-          ruleVariables: Array<{ variableName: string; variableQname: string }>
+          ruleVariables: Array<{ variableName: string; variableQname: string | null }>
         }>
         factSet: {
           id: string
@@ -3656,6 +3679,7 @@ export type ListLedgerUnmappedElementsQuery = {
 export type ListLibraryTaxonomyArcsQueryVariables = Exact<{
   taxonomyId: Scalars['ID']['input']
   associationType: InputMaybe<Scalars['String']['input']>
+  structureId: InputMaybe<Scalars['ID']['input']>
   limit?: Scalars['Int']['input']
   offset?: Scalars['Int']['input']
 }>
@@ -3669,9 +3693,13 @@ export type ListLibraryTaxonomyArcsQuery = {
     fromElementId: string
     fromElementQname: string | null
     fromElementName: string | null
+    fromElementTrait: string | null
+    fromElementIsAbstract: boolean | null
     toElementId: string
     toElementQname: string | null
     toElementName: string | null
+    toElementTrait: string | null
+    toElementIsAbstract: boolean | null
     associationType: string
     arcrole: string | null
     orderValue: number | null
@@ -3812,6 +3840,37 @@ export type GetLibraryElementQuery = {
   } | null
 }
 
+export type ListLibraryStructuresQueryVariables = Exact<{
+  taxonomyId: InputMaybe<Scalars['ID']['input']>
+  blockType: InputMaybe<Scalars['String']['input']>
+}>
+
+export type ListLibraryStructuresQuery = {
+  libraryStructures: Array<{
+    id: string
+    name: string
+    blockType: string
+    taxonomyId: string
+    roleUri: string | null
+    isActive: boolean
+  }>
+}
+
+export type GetLibraryStructureQueryVariables = Exact<{
+  id: Scalars['ID']['input']
+}>
+
+export type GetLibraryStructureQuery = {
+  libraryStructure: {
+    id: string
+    name: string
+    blockType: string
+    taxonomyId: string
+    roleUri: string | null
+    isActive: boolean
+  } | null
+}
+
 export type ListLibraryTaxonomiesQueryVariables = Exact<{
   standard: InputMaybe<Scalars['String']['input']>
   includeElementCount?: Scalars['Boolean']['input']
@@ -6517,6 +6576,10 @@ export const GetLedgerPeriodDraftsDocument = {
                 { kind: 'Field', name: { kind: 'Name', value: 'totalDebit' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'totalCredit' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'allBalanced' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'qbWritebackConnectionId' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'qbWritePolicy' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'qbPublishCount' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'localOnlyCount' } },
                 {
                   kind: 'Field',
                   name: { kind: 'Name', value: 'drafts' },
@@ -6533,6 +6596,7 @@ export const GetLedgerPeriodDraftsDocument = {
                       { kind: 'Field', name: { kind: 'Name', value: 'totalDebit' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'totalCredit' } },
                       { kind: 'Field', name: { kind: 'Name', value: 'balanced' } },
+                      { kind: 'Field', name: { kind: 'Name', value: 'willPublishToQb' } },
                       {
                         kind: 'Field',
                         name: { kind: 'Name', value: 'lineItems' },
@@ -7919,6 +7983,11 @@ export const ListLibraryTaxonomyArcsDocument = {
           variable: { kind: 'Variable', name: { kind: 'Name', value: 'associationType' } },
           type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
         },
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'structureId' } },
+          type: { kind: 'NamedType', name: { kind: 'Name', value: 'ID' } },
+        },
         {
           kind: 'VariableDefinition',
           variable: { kind: 'Variable', name: { kind: 'Name', value: 'limit' } },
@@ -7950,6 +8019,16 @@ export const ListLibraryTaxonomyArcsDocument = {
                 name: { kind: 'Name', value: 'taxonomyId' },
                 value: { kind: 'Variable', name: { kind: 'Name', value: 'taxonomyId' } },
               },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'associationType' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'associationType' } },
+              },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'structureId' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'structureId' } },
+              },
             ],
           },
           {
@@ -7966,6 +8045,11 @@ export const ListLibraryTaxonomyArcsDocument = {
                 name: { kind: 'Name', value: 'associationType' },
                 value: { kind: 'Variable', name: { kind: 'Name', value: 'associationType' } },
               },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'structureId' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'structureId' } },
+              },
               {
                 kind: 'Argument',
                 name: { kind: 'Name', value: 'limit' },
@@ -7986,9 +8070,13 @@ export const ListLibraryTaxonomyArcsDocument = {
                 { kind: 'Field', name: { kind: 'Name', value: 'fromElementId' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'fromElementQname' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'fromElementName' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'fromElementTrait' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'fromElementIsAbstract' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'toElementId' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'toElementQname' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'toElementName' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'toElementTrait' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'toElementIsAbstract' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'associationType' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'arcrole' } },
                 { kind: 'Field', name: { kind: 'Name', value: 'orderValue' } },
@@ -8585,6 +8673,107 @@ export const GetLibraryElementDocument = {
     },
   ],
 } as unknown as DocumentNode<GetLibraryElementQuery, GetLibraryElementQueryVariables>
+export const ListLibraryStructuresDocument = {
+  kind: 'Document',
+  definitions: [
+    {
+      kind: 'OperationDefinition',
+      operation: 'query',
+      name: { kind: 'Name', value: 'ListLibraryStructures' },
+      variableDefinitions: [
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'taxonomyId' } },
+          type: { kind: 'NamedType', name: { kind: 'Name', value: 'ID' } },
+        },
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'blockType' } },
+          type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
+        },
+      ],
+      selectionSet: {
+        kind: 'SelectionSet',
+        selections: [
+          {
+            kind: 'Field',
+            name: { kind: 'Name', value: 'libraryStructures' },
+            arguments: [
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'taxonomyId' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'taxonomyId' } },
+              },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'blockType' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'blockType' } },
+              },
+            ],
+            selectionSet: {
+              kind: 'SelectionSet',
+              selections: [
+                { kind: 'Field', name: { kind: 'Name', value: 'id' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'name' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'blockType' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'taxonomyId' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'roleUri' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'isActive' } },
+              ],
+            },
+          },
+        ],
+      },
+    },
+  ],
+} as unknown as DocumentNode<ListLibraryStructuresQuery, ListLibraryStructuresQueryVariables>
+export const GetLibraryStructureDocument = {
+  kind: 'Document',
+  definitions: [
+    {
+      kind: 'OperationDefinition',
+      operation: 'query',
+      name: { kind: 'Name', value: 'GetLibraryStructure' },
+      variableDefinitions: [
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'id' } },
+          type: {
+            kind: 'NonNullType',
+            type: { kind: 'NamedType', name: { kind: 'Name', value: 'ID' } },
+          },
+        },
+      ],
+      selectionSet: {
+        kind: 'SelectionSet',
+        selections: [
+          {
+            kind: 'Field',
+            name: { kind: 'Name', value: 'libraryStructure' },
+            arguments: [
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'id' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'id' } },
+              },
+            ],
+            selectionSet: {
+              kind: 'SelectionSet',
+              selections: [
+                { kind: 'Field', name: { kind: 'Name', value: 'id' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'name' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'blockType' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'taxonomyId' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'roleUri' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'isActive' } },
+              ],
+            },
+          },
+        ],
+      },
+    },
+  ],
+} as unknown as DocumentNode<GetLibraryStructureQuery, GetLibraryStructureQueryVariables>
 export const ListLibraryTaxonomiesDocument = {
   kind: 'Document',
   definitions: [

package/artifacts/graphql/queries/ledger/periodDrafts.d.ts

@@ -4,5 +4,11 @@
  *
  * `period` is YYYY-MM format. Balance check is server-side — `balanced`
  * per entry, `allBalanced` for the period total.
+ *
+ * This is also the close-review *outbox*: each draft carries its QB
+ * write-back disposition (`willPublishToQb`) and the response carries a
+ * publish summary (`qbWritebackConnectionId` / `qbWritePolicy` /
+ * `qbPublishCount` / `localOnlyCount`) — which drafts `close-period` will
+ * push to QuickBooks vs. post locally only.
  */
 export declare const GET_PERIOD_DRAFTS: string;

package/artifacts/graphql/queries/ledger/periodDrafts.js

@@ -8,6 +8,12 @@ const graphql_request_1 = require("graphql-request");
  *
  * `period` is YYYY-MM format. Balance check is server-side — `balanced`
  * per entry, `allBalanced` for the period total.
+ *
+ * This is also the close-review *outbox*: each draft carries its QB
+ * write-back disposition (`willPublishToQb`) and the response carries a
+ * publish summary (`qbWritebackConnectionId` / `qbWritePolicy` /
+ * `qbPublishCount` / `localOnlyCount`) — which drafts `close-period` will
+ * push to QuickBooks vs. post locally only.
  */
 exports.GET_PERIOD_DRAFTS = (0, graphql_request_1.gql) `
   query GetLedgerPeriodDrafts($period: String!) {
@@ -19,6 +25,10 @@ exports.GET_PERIOD_DRAFTS = (0, graphql_request_1.gql) `
       totalDebit
       totalCredit
       allBalanced
+      qbWritebackConnectionId
+      qbWritePolicy
+      qbPublishCount
+      localOnlyCount
       drafts {
         entryId
         postingDate
@@ -30,6 +40,7 @@ exports.GET_PERIOD_DRAFTS = (0, graphql_request_1.gql) `
         totalDebit
         totalCredit
         balanced
+        willPublishToQb
         lineItems {
           lineItemId
           elementId

package/artifacts/graphql/queries/ledger/periodDrafts.ts

@@ -6,6 +6,12 @@ import { gql } from 'graphql-request'
  *
  * `period` is YYYY-MM format. Balance check is server-side — `balanced`
  * per entry, `allBalanced` for the period total.
+ *
+ * This is also the close-review *outbox*: each draft carries its QB
+ * write-back disposition (`willPublishToQb`) and the response carries a
+ * publish summary (`qbWritebackConnectionId` / `qbWritePolicy` /
+ * `qbPublishCount` / `localOnlyCount`) — which drafts `close-period` will
+ * push to QuickBooks vs. post locally only.
  */
 export const GET_PERIOD_DRAFTS = gql`
   query GetLedgerPeriodDrafts($period: String!) {
@@ -17,6 +23,10 @@ export const GET_PERIOD_DRAFTS = gql`
       totalDebit
       totalCredit
       allBalanced
+      qbWritebackConnectionId
+      qbWritePolicy
+      qbPublishCount
+      localOnlyCount
       drafts {
         entryId
         postingDate
@@ -28,6 +38,7 @@ export const GET_PERIOD_DRAFTS = gql`
         totalDebit
         totalCredit
         balanced
+        willPublishToQb
         lineItems {
           lineItemId
           elementId

package/artifacts/graphql/queries/library/arcs.js

@@ -12,13 +12,19 @@ exports.LIST_LIBRARY_TAXONOMY_ARCS = (0, graphql_request_1.gql) `
   query ListLibraryTaxonomyArcs(
     $taxonomyId: ID!
     $associationType: String
+    $structureId: ID
     $limit: Int! = 200
     $offset: Int! = 0
   ) {
-    libraryTaxonomyArcCount(taxonomyId: $taxonomyId)
+    libraryTaxonomyArcCount(
+      taxonomyId: $taxonomyId
+      associationType: $associationType
+      structureId: $structureId
+    )
     libraryTaxonomyArcs(
       taxonomyId: $taxonomyId
       associationType: $associationType
+      structureId: $structureId
       limit: $limit
       offset: $offset
     ) {
@@ -28,9 +34,13 @@ exports.LIST_LIBRARY_TAXONOMY_ARCS = (0, graphql_request_1.gql) `
       fromElementId
       fromElementQname
       fromElementName
+      fromElementTrait
+      fromElementIsAbstract
       toElementId
       toElementQname
       toElementName
+      toElementTrait
+      toElementIsAbstract
       associationType
       arcrole
       orderValue

package/artifacts/graphql/queries/library/arcs.ts

@@ -10,13 +10,19 @@ export const LIST_LIBRARY_TAXONOMY_ARCS = gql`
   query ListLibraryTaxonomyArcs(
     $taxonomyId: ID!
     $associationType: String
+    $structureId: ID
     $limit: Int! = 200
     $offset: Int! = 0
   ) {
-    libraryTaxonomyArcCount(taxonomyId: $taxonomyId)
+    libraryTaxonomyArcCount(
+      taxonomyId: $taxonomyId
+      associationType: $associationType
+      structureId: $structureId
+    )
     libraryTaxonomyArcs(
       taxonomyId: $taxonomyId
       associationType: $associationType
+      structureId: $structureId
       limit: $limit
       offset: $offset
     ) {
@@ -26,9 +32,13 @@ export const LIST_LIBRARY_TAXONOMY_ARCS = gql`
       fromElementId
       fromElementQname
       fromElementName
+      fromElementTrait
+      fromElementIsAbstract
       toElementId
       toElementQname
       toElementName
+      toElementTrait
+      toElementIsAbstract
       associationType
       arcrole
       orderValue

package/artifacts/graphql/queries/library/structures.d.ts

@@ -0,0 +1,19 @@
+/**
+ * List the structures (extended link roles) contributed by a taxonomy —
+ * the named presentation/calculation hierarchies (BS-classified,
+ * IS-multistep, CashFlow, the calc DAG roots, etc). Pair a structure's
+ * ``id`` with ``listLibraryTaxonomyArcs`` + a ``structureId`` filter to
+ * load just that hierarchy's arcs — this is how the hierarchy view scopes
+ * a tree to one role at a time.
+ *
+ * Pass ``taxonomyId`` to scope to a single taxonomy; pass ``blockType``
+ * to filter to one statement kind (balance_sheet, income_statement,
+ * cash_flow_statement, …).
+ */
+export declare const LIST_LIBRARY_STRUCTURES: string;
+/**
+ * Fetch one structure by id. Returns null when the id doesn't resolve.
+ * Metadata only — pair with ``listLibraryTaxonomyArcs`` + a ``structureId``
+ * filter to load the structure's arcs.
+ */
+export declare const GET_LIBRARY_STRUCTURE: string;

package/artifacts/graphql/queries/library/structures.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_LIBRARY_STRUCTURE = exports.LIST_LIBRARY_STRUCTURES = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * List the structures (extended link roles) contributed by a taxonomy —
+ * the named presentation/calculation hierarchies (BS-classified,
+ * IS-multistep, CashFlow, the calc DAG roots, etc). Pair a structure's
+ * ``id`` with ``listLibraryTaxonomyArcs`` + a ``structureId`` filter to
+ * load just that hierarchy's arcs — this is how the hierarchy view scopes
+ * a tree to one role at a time.
+ *
+ * Pass ``taxonomyId`` to scope to a single taxonomy; pass ``blockType``
+ * to filter to one statement kind (balance_sheet, income_statement,
+ * cash_flow_statement, …).
+ */
+exports.LIST_LIBRARY_STRUCTURES = (0, graphql_request_1.gql) `
+  query ListLibraryStructures($taxonomyId: ID, $blockType: String) {
+    libraryStructures(taxonomyId: $taxonomyId, blockType: $blockType) {
+      id
+      name
+      blockType
+      taxonomyId
+      roleUri
+      isActive
+    }
+  }
+`;
+/**
+ * Fetch one structure by id. Returns null when the id doesn't resolve.
+ * Metadata only — pair with ``listLibraryTaxonomyArcs`` + a ``structureId``
+ * filter to load the structure's arcs.
+ */
+exports.GET_LIBRARY_STRUCTURE = (0, graphql_request_1.gql) `
+  query GetLibraryStructure($id: ID!) {
+    libraryStructure(id: $id) {
+      id
+      name
+      blockType
+      taxonomyId
+      roleUri
+      isActive
+    }
+  }
+`;

package/artifacts/graphql/queries/library/structures.ts

@@ -0,0 +1,44 @@
+import { gql } from 'graphql-request'
+
+/**
+ * List the structures (extended link roles) contributed by a taxonomy —
+ * the named presentation/calculation hierarchies (BS-classified,
+ * IS-multistep, CashFlow, the calc DAG roots, etc). Pair a structure's
+ * ``id`` with ``listLibraryTaxonomyArcs`` + a ``structureId`` filter to
+ * load just that hierarchy's arcs — this is how the hierarchy view scopes
+ * a tree to one role at a time.
+ *
+ * Pass ``taxonomyId`` to scope to a single taxonomy; pass ``blockType``
+ * to filter to one statement kind (balance_sheet, income_statement,
+ * cash_flow_statement, …).
+ */
+export const LIST_LIBRARY_STRUCTURES = gql`
+  query ListLibraryStructures($taxonomyId: ID, $blockType: String) {
+    libraryStructures(taxonomyId: $taxonomyId, blockType: $blockType) {
+      id
+      name
+      blockType
+      taxonomyId
+      roleUri
+      isActive
+    }
+  }
+`
+
+/**
+ * Fetch one structure by id. Returns null when the id doesn't resolve.
+ * Metadata only — pair with ``listLibraryTaxonomyArcs`` + a ``structureId``
+ * filter to load the structure's arcs.
+ */
+export const GET_LIBRARY_STRUCTURE = gql`
+  query GetLibraryStructure($id: ID!) {
+    libraryStructure(id: $id) {
+      id
+      name
+      blockType
+      taxonomyId
+      roleUri
+      isActive
+    }
+  }
+`