@robosystems/client 0.3.38 → 0.3.40

package/artifacts/graphql/generated/graphql.ts

@@ -670,8 +670,8 @@ export type InformationBlockValidation = {
  * Pass/fail/skip counts for one ``rule_category`` within a block's
  * verification results.
  *
- * Drives the per-category accordions in the Verification Results panel
- * (financial-viewer §7.12). ``category`` is the rule's ``rule_category``
+ * Drives the per-category accordions in the Verification Results panel.
+ * ``category`` is the rule's ``rule_category``
  * (one of the cm:VerificationRule subclasses), resolved by joining each
  * result to its Rule.
  */
@@ -709,7 +709,7 @@ export type InformationBlockVerificationResult = {
  * Server-computed aggregate of a block's ``verification_results``.
  *
  * Overall counts plus a per-``rule_category`` breakdown, so the viewer
- * renders the grouped Verification Results panel (financial-viewer §7.12)
+ * renders the grouped Verification Results panel
  * without a client-side results→rules join. Status closure is
  * ``pass | fail | error | skipped`` (the ``public.verification_results``
  * CHECK); ``total`` is their sum.
@@ -932,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']>
 }
 
@@ -1530,6 +1536,7 @@ export type Query = {
   publishList: Maybe<PublishListDetail>
   publishLists: Maybe<PublishListList>
   report: Maybe<Report>
+  reportDownloadUrl: Maybe<ReportBundleDownload>
   reportPackage: Maybe<ReportPackage>
   reportingTaxonomy: Maybe<Taxonomy>
   reports: Maybe<ReportList>
@@ -1751,6 +1758,12 @@ export type QueryReportArgs = {
   reportId: Scalars['String']['input']
 }
 
+export type QueryReportDownloadUrlArgs = {
+  expiresIn?: Scalars['Int']['input']
+  format?: ReportDownloadFormat
+  reportId: Scalars['String']['input']
+}
+
 export type QueryReportPackageArgs = {
   reportId: Scalars['String']['input']
 }
@@ -1879,6 +1892,31 @@ export type Report = {
   taxonomyId: Scalars['String']['output']
 }
 
+/**
+ * Presigned-URL response for a published Report's serialization bundle.
+ *
+ * Every flavor resolves to a short-lived presigned URL pointing at the
+ * bundle in S3 — JSON-LD is stamped at publish time, XBRL is
+ * materialized on first download and cached by ``generation_count``.
+ * The client follows ``download_url`` to fetch the artifact directly
+ * from S3 (the API never streams the bytes). Mirrors the
+ * backup-download shape the frontend already consumes.
+ */
+export type ReportBundleDownload = {
+  /** MIME type of the artifact behind the URL. */
+  contentType: Scalars['String']['output']
+  /** Presigned URL that streams the bundle directly from S3. */
+  downloadUrl: Scalars['String']['output']
+  /** UTC timestamp at which the presigned URL stops working. */
+  expiresAt: Scalars['DateTime']['output']
+  /** Serialization flavor delivered by this URL — one of the ``RdfFlavor`` / ``XbrlFlavor`` values (e.g. ``jsonld``, ``xbrl-2.1``). */
+  format: Scalars['String']['output']
+  /** Bundle generation number stamped on the Report. */
+  generationCount: Scalars['Int']['output']
+}
+
+export type ReportDownloadFormat = 'JSONLD' | 'XBRL_2_1'
+
 /** List of report header summaries (used by report list reads). */
 export type ReportList = {
   /** Report definitions, newest first. */
@@ -2162,6 +2200,7 @@ export type UnmappedElement = {
   code: Maybe<Scalars['String']['output']>
   externalSource: Maybe<Scalars['String']['output']>
   id: Scalars['String']['output']
+  liquidity: Maybe<Scalars['String']['output']>
   name: Scalars['String']['output']
   suggestedTargets: Array<SuggestedTarget>
   trait: Maybe<Scalars['String']['output']>
@@ -3269,6 +3308,22 @@ export type GetLedgerReportQuery = {
   } | null
 }
 
+export type GetLedgerReportDownloadUrlQueryVariables = Exact<{
+  reportId: Scalars['String']['input']
+  format?: InputMaybe<ReportDownloadFormat>
+  expiresIn?: InputMaybe<Scalars['Int']['input']>
+}>
+
+export type GetLedgerReportDownloadUrlQuery = {
+  reportDownloadUrl: {
+    downloadUrl: string
+    expiresAt: any
+    contentType: string
+    format: string
+    generationCount: number
+  } | null
+}
+
 export type GetLedgerReportPackageQueryVariables = Exact<{
   reportId: Scalars['String']['input']
 }>
@@ -3673,6 +3728,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']
 }>
@@ -3686,9 +3742,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
@@ -3829,6 +3889,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']
@@ -6811,6 +6902,77 @@ export const GetLedgerReportDocument = {
     },
   ],
 } as unknown as DocumentNode<GetLedgerReportQuery, GetLedgerReportQueryVariables>
+export const GetLedgerReportDownloadUrlDocument = {
+  kind: 'Document',
+  definitions: [
+    {
+      kind: 'OperationDefinition',
+      operation: 'query',
+      name: { kind: 'Name', value: 'GetLedgerReportDownloadUrl' },
+      variableDefinitions: [
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'reportId' } },
+          type: {
+            kind: 'NonNullType',
+            type: { kind: 'NamedType', name: { kind: 'Name', value: 'String' } },
+          },
+        },
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'format' } },
+          type: { kind: 'NamedType', name: { kind: 'Name', value: 'ReportDownloadFormat' } },
+          defaultValue: { kind: 'EnumValue', value: 'JSONLD' },
+        },
+        {
+          kind: 'VariableDefinition',
+          variable: { kind: 'Variable', name: { kind: 'Name', value: 'expiresIn' } },
+          type: { kind: 'NamedType', name: { kind: 'Name', value: 'Int' } },
+          defaultValue: { kind: 'IntValue', value: '300' },
+        },
+      ],
+      selectionSet: {
+        kind: 'SelectionSet',
+        selections: [
+          {
+            kind: 'Field',
+            name: { kind: 'Name', value: 'reportDownloadUrl' },
+            arguments: [
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'reportId' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'reportId' } },
+              },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'format' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'format' } },
+              },
+              {
+                kind: 'Argument',
+                name: { kind: 'Name', value: 'expiresIn' },
+                value: { kind: 'Variable', name: { kind: 'Name', value: 'expiresIn' } },
+              },
+            ],
+            selectionSet: {
+              kind: 'SelectionSet',
+              selections: [
+                { kind: 'Field', name: { kind: 'Name', value: 'downloadUrl' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'expiresAt' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'contentType' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'format' } },
+                { kind: 'Field', name: { kind: 'Name', value: 'generationCount' } },
+              ],
+            },
+          },
+        ],
+      },
+    },
+  ],
+} as unknown as DocumentNode<
+  GetLedgerReportDownloadUrlQuery,
+  GetLedgerReportDownloadUrlQueryVariables
+>
 export const GetLedgerReportPackageDocument = {
   kind: 'Document',
   definitions: [
@@ -7941,6 +8103,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' } },
@@ -7972,6 +8139,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' } },
+              },
             ],
           },
           {
@@ -7988,6 +8165,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' },
@@ -8008,9 +8190,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' } },
@@ -8607,6 +8793,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/reportDownloadUrl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Presigned-URL download for a published Report's serialization bundle.
+ *
+ * Replaces the retired `GET .../reports/{id}/download` REST resource — a
+ * download is a read of stored state, so it lives on the read surface.
+ * Every flavor resolves to a short-lived presigned S3 URL the client
+ * follows directly (JSON-LD is stamped at publish time; XBRL is
+ * materialized + cached on first request). `format` accepts the
+ * `ReportDownloadFormat` enum (`JSONLD`, `XBRL_2_1`).
+ */
+export declare const GET_REPORT_DOWNLOAD_URL: string;

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_REPORT_DOWNLOAD_URL = void 0;
+const graphql_request_1 = require("graphql-request");
+/**
+ * Presigned-URL download for a published Report's serialization bundle.
+ *
+ * Replaces the retired `GET .../reports/{id}/download` REST resource — a
+ * download is a read of stored state, so it lives on the read surface.
+ * Every flavor resolves to a short-lived presigned S3 URL the client
+ * follows directly (JSON-LD is stamped at publish time; XBRL is
+ * materialized + cached on first request). `format` accepts the
+ * `ReportDownloadFormat` enum (`JSONLD`, `XBRL_2_1`).
+ */
+exports.GET_REPORT_DOWNLOAD_URL = (0, graphql_request_1.gql) `
+  query GetLedgerReportDownloadUrl(
+    $reportId: String!
+    $format: ReportDownloadFormat = JSONLD
+    $expiresIn: Int = 300
+  ) {
+    reportDownloadUrl(reportId: $reportId, format: $format, expiresIn: $expiresIn) {
+      downloadUrl
+      expiresAt
+      contentType
+      format
+      generationCount
+    }
+  }
+`;

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

@@ -0,0 +1,27 @@
+import { gql } from 'graphql-request'
+
+/**
+ * Presigned-URL download for a published Report's serialization bundle.
+ *
+ * Replaces the retired `GET .../reports/{id}/download` REST resource — a
+ * download is a read of stored state, so it lives on the read surface.
+ * Every flavor resolves to a short-lived presigned S3 URL the client
+ * follows directly (JSON-LD is stamped at publish time; XBRL is
+ * materialized + cached on first request). `format` accepts the
+ * `ReportDownloadFormat` enum (`JSONLD`, `XBRL_2_1`).
+ */
+export const GET_REPORT_DOWNLOAD_URL = gql`
+  query GetLedgerReportDownloadUrl(
+    $reportId: String!
+    $format: ReportDownloadFormat = JSONLD
+    $expiresIn: Int = 300
+  ) {
+    reportDownloadUrl(reportId: $reportId, format: $format, expiresIn: $expiresIn) {
+      downloadUrl
+      expiresAt
+      contentType
+      format
+      generationCount
+    }
+  }
+`

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
+    }
+  }
+`