@itwin/ecschema-metadata 5.11.0-dev.2 → 5.11.0-dev.4

package/lib/esm/IncrementalLoading/SchemaStubQueries.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaStubQueries.js","sourceRoot":"","sources":["../../../src/IncrementalLoading/SchemaStubQueries.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;IACxC,OAAO;;cAEK,KAAK;cACL,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;IACxC,OAAO;;cAEK,KAAK;cACL,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,EAAE;IACjD,OAAO;;cAEK,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;;;;CAcrB,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;CAU5B,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;oBAMT,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;;0BAUX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;CAc9C,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;oBAMA,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;0BASX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;CAa9C,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;oBAMN,QAAQ,CAAC,OAAO,CAAC;;;oBAGjB,QAAQ,CAAC,OAAO,CAAC;6BACR,iBAAiB,CAAC,OAAO,CAAC;;;;;;;0BAO7B,QAAQ,CAAC,WAAW,CAAC;;;0BAGrB,QAAQ,CAAC,WAAW,CAAC;mCACZ,iBAAiB,CAAC,WAAW,CAAC;;;;;;;;;;;CAWhE,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;oBAMA,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;0BASX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;0BAkBrB,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;gCAcf,QAAQ,CAAC,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BzD,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;oBAMC,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;;;;;;0BAcX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;CAmB9C,CAAC;AAEF,MAAM,eAAe,GAAG;;IAEpB,oBAAoB;;IAEpB,WAAW;;IAEX,iBAAiB;;IAEjB,WAAW;;IAEX,UAAU;;IAEV,iBAAiB,CAAC,WAAW,EAAE;;IAE/B,iBAAiB,CAAC,cAAc,EAAE;;IAElC,iBAAiB,CAAC,gBAAgB,EAAE;;IAEpC,iBAAiB,CAAC,IAAI,EAAE;;IAExB,iBAAiB,CAAC,YAAY,EAAE;;IAEhC,iBAAiB,CAAC,QAAQ,EAAE;;IAE5B,iBAAiB,CAAC,UAAU,EAAE;;IAE9B,iBAAiB,CAAC,UAAU,EAAE;;IAE9B,iBAAiB,CAAC,MAAM,EAAE;;CAE7B,CAAC;AAEF,MAAM,eAAe,GAAG;;MAElB,aAAa;MACb,eAAe;;;;;;;;CAQpB,CAAC;AAEF,MAAM,eAAe,GAAG;;MAElB,oBAAoB;;;;;;;;;;;;;;;;;CAiBzB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,eAAe;IACf,eAAe;CAChB,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n * See LICENSE.md in the project root for license terms and full copyright notice.\r\n *--------------------------------------------------------------------------------------------*/\r\nimport { SchemaItemQueries } from \"./SchemaItemQueries\";\r\n\r\nexport const modifier = (alias: string) => {\r\n  return `\r\n    CASE\r\n      WHEN [${alias}].[modifier] = 0 THEN 'None'\r\n      WHEN [${alias}].[modifier] = 1 THEN 'Abstract'\r\n      WHEN [${alias}].[modifier] = 2 THEN 'Sealed'\r\n      ELSE NULL\r\n    END\r\n  `;\r\n};\r\n\r\nexport const strength = (alias: string) => {\r\n  return `\r\n    CASE\r\n      WHEN [${alias}].[RelationshipStrength] = 0 THEN 'Referencing'\r\n      WHEN [${alias}].[RelationshipStrength] = 1 THEN 'Holding'\r\n      WHEN [${alias}].[RelationshipStrength] = 2 THEN 'Embedding'\r\n      ELSE NULL\r\n    END\r\n  `;\r\n};\r\n\r\nexport const strengthDirection = (alias: string) => {\r\n  return `\r\n    CASE\r\n      WHEN [${alias}].[RelationshipStrengthDirection] = 1 THEN 'Forward'\r\n      WHEN [${alias}].[RelationshipStrengthDirection] = 2 THEN 'Backward'\r\n      ELSE NULL\r\n    END\r\n  `;\r\n};\r\n\r\nconst withAppliesTo = `\r\n  AppliesToCTE AS (\r\n    SELECT\r\n      [mixinAppliesTo].[ECInstanceId] AS [AppliesToId],\r\n      [appliesToSchema].[name] as [AppliesToSchema],\r\n      json_extract(XmlCAToJson([ca].[Class].[Id], [ca].[Instance]), '$.IsMixin.AppliesToEntityClass') AS [AppliesTo]\r\n    FROM [meta].[CustomAttribute] [ca]\r\n    JOIN [meta].[ECClassDef] [mixinAppliesTo]\r\n      ON [mixinAppliesTo].[ECInstanceId] = [ca].[ContainerId]\r\n    JOIN [meta].[ECSchemaDef] [appliesToSchema]\r\n      ON [appliesToSchema].[ECInstanceId] = [mixinAppliesTo].[Schema].[Id]\r\n    WHERE [ca].[ContainerType] = 30\r\n      AND json_extract(XmlCAToJson([ca].[Class].[Id], [ca].[Instance]), '$.ecClass') = 'IsMixin'\r\n  )\r\n`;\r\n\r\nconst withSchemaReferences = `\r\n  SchemaReferences AS (\r\n    SELECT\r\n      [ref].[SourceECInstanceId] AS [SchemaId],\r\n      CONCAT([Name],'.',[VersionMajor],'.',[VersionWrite],'.',[VersionMinor]) AS [fullName]\r\n    FROM\r\n      [meta].[ECSchemaDef] AS [refSchema]\r\n    INNER JOIN [meta].[SchemaHasSchemaReferences] [ref]\r\n      ON [ref].[TargetECInstanceId] = [refSchema].[ECInstanceId]\r\n  )\r\n`;\r\n\r\nconst customAttributeQuery = `\r\n  SELECT\r\n    [Schema].[Id] AS [SchemaId],\r\n    json_object(\r\n      'name', [class].[Name],\r\n      'schemaItemType', 'CustomAttributeClass',\r\n      'modifier', ${modifier(\"class\")},\r\n      'label', [class].[DisplayLabel],\r\n      'description', [class].[Description],\r\n      'appliesTo', [class].[CustomAttributeContainerType],\r\n      'baseClasses', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'CustomAttributeClass',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description],\r\n            'appliesTo', [baseClass].[CustomAttributeContainerType]\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n      )\r\n    ) AS [item]\r\n  FROM [meta].[ECClassDef] [class]\r\n  WHERE [class].[Type] = 3\r\n`;\r\n\r\nconst structQuery = `\r\n  SELECT\r\n    [Schema].[Id] AS [SchemaId],\r\n    json_object(\r\n      'name', [class].[Name],\r\n      'schemaItemType', 'StructClass',\r\n      'modifier', ${modifier(\"class\")},\r\n      'label', [class].[DisplayLabel],\r\n      'description', [class].[Description],\r\n      'baseClasses', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'StructClass',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description]\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n      )\r\n    ) AS [item]\r\n  FROM [meta].[ECClassDef] [class]\r\n  WHERE [class].[Type] = 2\r\n`;\r\n\r\nconst relationshipQuery = `\r\n  SELECT\r\n    [Schema].[Id] AS [SchemaId],\r\n    json_object(\r\n      'name', [class].[Name],\r\n      'schemaItemType', 'RelationshipClass',\r\n      'modifier', ${modifier(\"class\")},\r\n      'label', [class].[DisplayLabel],\r\n      'description', [class].[Description],\r\n      'strength', ${strength(\"class\")},\r\n      'strengthDirection', ${strengthDirection(\"class\")},\r\n      'baseClasses', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'RelationshipClass',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description],\r\n            'strength', ${strength(\"baseClass\")},\r\n            'strengthDirection', ${strengthDirection(\"baseClass\")}\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n      )\r\n    ) AS [item]\r\n  FROM [meta].[ECClassDef] [class]\r\n  WHERE [class].[Type] = 1\r\n`;\r\n\r\nconst entityQuery = `\r\n  SELECT\r\n    [Schema].[Id] AS [SchemaId],\r\n    json_object(\r\n      'name', [class].[Name],\r\n      'schemaItemType', 'EntityClass',\r\n      'modifier', ${modifier(\"class\")},\r\n      'label', [class].[DisplayLabel],\r\n      'description', [class].[Description],\r\n      'baseClasses', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'EntityClass',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description]\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n          AND NOT EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [baseClass].[ECInstanceId] = [ca].[Class].[Id]\r\n            AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\r\n        ),\r\n      'mixins', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'Mixin',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description],\r\n            'appliesTo', (\r\n              SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\r\n              FROM [AppliesToCTE] [atCTE]\r\n              WHERE [atCTE].[AppliesToId] = [baseClass].[ECInstanceId]\r\n            ),\r\n            'baseClasses', (\r\n              SELECT\r\n                json_group_array(json(json_object(\r\n                  'schema', ec_classname([mixinBaseClass].[ECInstanceId], 's'),\r\n                  'name', [mixinBaseClass].[Name],\r\n                  'schemaItemType', 'Mixin',\r\n                  'modifier', ${modifier(\"mixinBaseClass\")},\r\n                  'label', [mixinBaseClass].[DisplayLabel],\r\n                  'description', [mixinBaseClass].[Description],\r\n                  'appliesTo', (\r\n                    SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\r\n                    FROM [AppliesToCTE] [atCTE]\r\n                    WHERE [atCTE].[AppliesToId] = [mixinBaseClass].[ECInstanceId]\r\n                  )\r\n                )))\r\n              FROM\r\n                [meta].[ECClassDef] [mixinBaseClass]\r\n              INNER JOIN [meta].[ClassHasAllBaseClasses] [mixinBaseClassMap]\r\n                ON [mixinBaseClassMap].[TargetECInstanceId] = [mixinBaseClass].[ECInstanceId]\r\n              WHERE [mixinBaseClassMap].[SourceECInstanceId] = [baseClass].[ECInstanceId]\r\n            )\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n          AND EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [baseClass].[ECInstanceId] = [ca].[Class].[Id]\r\n            AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\r\n          )\r\n    ) AS [item]\r\n  FROM [meta].[ECClassDef] [class]\r\n  WHERE [class].[Type] = 0\r\n    AND NOT EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [class].[ECInstanceId] = [ca].[Class].[Id]\r\n      AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\r\n`;\r\n\r\nconst mixinQuery = `\r\n  SELECT\r\n    [Schema].[Id] AS [SchemaId],\r\n    json_object(\r\n      'name', [class].[Name],\r\n      'schemaItemType', 'Mixin',\r\n      'modifier', ${modifier(\"class\")},\r\n      'label', [class].[DisplayLabel],\r\n      'description', [class].[Description],\r\n      'appliesTo', (\r\n        SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\r\n        FROM [AppliesToCTE] [atCTE]\r\n        WHERE [atCTE].[AppliesToId] = [class].[ECInstanceId]\r\n      ),\r\n      'baseClasses', (\r\n        SELECT\r\n          json_group_array(json(json_object(\r\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\r\n            'name', [baseClass].[Name],\r\n            'schemaItemType', 'Mixin',\r\n            'modifier', ${modifier(\"baseClass\")},\r\n            'label', [baseClass].[DisplayLabel],\r\n            'description', [baseClass].[Description],\r\n            'appliesTo', (\r\n              SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\r\n              FROM [AppliesToCTE] [atCTE]\r\n              WHERE [atCTE].[AppliesToId] = [baseClass].[ECInstanceId]\r\n            )\r\n          )))\r\n        FROM\r\n          [meta].[ECClassDef] [baseClass]\r\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\r\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\r\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\r\n      )\r\n    ) AS [item]\r\n    FROM [meta].[ECClassDef] [class]\r\n    WHERE [class].[Type] = 0 AND EXISTS (SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [class].[ECInstanceId] = [ca].[Class].[Id]\r\n      AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\r\n`;\r\n\r\nconst withSchemaItems = `\r\nSchemaItems AS (\r\n  ${customAttributeQuery}\r\n  UNION ALL\r\n  ${structQuery}\r\n  UNION ALL\r\n  ${relationshipQuery}\r\n  UNION ALL\r\n  ${entityQuery}\r\n  UNION ALL\r\n  ${mixinQuery}\r\n  UNION ALL\r\n  ${SchemaItemQueries.enumeration()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.kindOfQuantity()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.propertyCategory()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.unit()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.invertedUnit()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.constant()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.phenomenon()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.unitSystem()}\r\n  UNION ALL\r\n  ${SchemaItemQueries.format()}\r\n  )\r\n`;\r\n\r\nconst schemaStubQuery = `\r\n  WITH\r\n    ${withAppliesTo},\r\n    ${withSchemaItems}\r\n  SELECT\r\n    [items].[item]\r\n  FROM\r\n    [SchemaItems] [items]\r\n  JOIN [meta].[ECSchemaDef] [schemaDef]\r\n    ON [schemaDef].[ECInstanceId] = [items].[SchemaId]\r\n  WHERE [schemaDef].[Name] = :schemaName\r\n`;\r\n\r\nconst schemaInfoQuery = `\r\n  WITH\r\n    ${withSchemaReferences}\r\n  SELECT\r\n    [Name] as [name],\r\n    CONCAT('',[VersionMajor],'.',[VersionWrite],'.',[VersionMinor]) AS [version],\r\n    [Alias] as [alias],\r\n    [DisplayLabel] as [label],\r\n    [Description] as [description],\r\n    (\r\n      SELECT\r\n        json_group_array([schemaReferences].[fullName])\r\n      FROM\r\n        [SchemaReferences] [schemaReferences]\r\n      WHERE\r\n        [schemaReferences].[SchemaId] = [schemaDef].[ECInstanceId]\r\n    ) AS [references]\r\n  FROM\r\n    [meta].[ECSchemaDef] [schemaDef]\r\n`;\r\n\r\n/**\r\n * Partial Schema queries.\r\n * @internal\r\n */\r\nexport const ecsqlQueries = {\r\n  schemaStubQuery,\r\n  schemaInfoQuery,\r\n};\r\n"]}
+{"version":3,"file":"SchemaStubQueries.js","sourceRoot":"","sources":["../../../src/IncrementalLoading/SchemaStubQueries.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;IACxC,OAAO;;cAEK,KAAK;cACL,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE;IACxC,OAAO;;cAEK,KAAK;cACL,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,EAAE;IACjD,OAAO;;cAEK,KAAK;cACL,KAAK;;;GAGhB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;;;;CAcrB,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;CAU5B,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;oBAMT,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;;0BAUX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;CAc9C,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;oBAMA,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;0BASX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;CAa9C,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;oBAMN,QAAQ,CAAC,OAAO,CAAC;;;oBAGjB,QAAQ,CAAC,OAAO,CAAC;6BACR,iBAAiB,CAAC,OAAO,CAAC;;;;;;;0BAO7B,QAAQ,CAAC,WAAW,CAAC;;;0BAGrB,QAAQ,CAAC,WAAW,CAAC;mCACZ,iBAAiB,CAAC,WAAW,CAAC;;;;;;;;;;;CAWhE,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;oBAMA,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;0BASX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;0BAkBrB,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;gCAcf,QAAQ,CAAC,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BzD,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;oBAMC,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;;;;;;0BAcX,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;CAmB9C,CAAC;AAEF,MAAM,eAAe,GAAG;;IAEpB,oBAAoB;;IAEpB,WAAW;;IAEX,iBAAiB;;IAEjB,WAAW;;IAEX,UAAU;;IAEV,iBAAiB,CAAC,WAAW,EAAE;;IAE/B,iBAAiB,CAAC,cAAc,EAAE;;IAElC,iBAAiB,CAAC,gBAAgB,EAAE;;IAEpC,iBAAiB,CAAC,IAAI,EAAE;;IAExB,iBAAiB,CAAC,YAAY,EAAE;;IAEhC,iBAAiB,CAAC,QAAQ,EAAE;;IAE5B,iBAAiB,CAAC,UAAU,EAAE;;IAE9B,iBAAiB,CAAC,UAAU,EAAE;;IAE9B,iBAAiB,CAAC,MAAM,EAAE;;CAE7B,CAAC;AAEF,MAAM,eAAe,GAAG;;MAElB,aAAa;MACb,eAAe;;;;;;;;CAQpB,CAAC;AAEF,MAAM,eAAe,GAAG;;MAElB,oBAAoB;;;;;;;;;;;;;;;;;CAiBzB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,eAAe;IACf,eAAe;CAChB,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\nimport { SchemaItemQueries } from \"./SchemaItemQueries\";\n\nexport const modifier = (alias: string) => {\n  return `\n    CASE\n      WHEN [${alias}].[modifier] = 0 THEN 'None'\n      WHEN [${alias}].[modifier] = 1 THEN 'Abstract'\n      WHEN [${alias}].[modifier] = 2 THEN 'Sealed'\n      ELSE NULL\n    END\n  `;\n};\n\nexport const strength = (alias: string) => {\n  return `\n    CASE\n      WHEN [${alias}].[RelationshipStrength] = 0 THEN 'Referencing'\n      WHEN [${alias}].[RelationshipStrength] = 1 THEN 'Holding'\n      WHEN [${alias}].[RelationshipStrength] = 2 THEN 'Embedding'\n      ELSE NULL\n    END\n  `;\n};\n\nexport const strengthDirection = (alias: string) => {\n  return `\n    CASE\n      WHEN [${alias}].[RelationshipStrengthDirection] = 1 THEN 'Forward'\n      WHEN [${alias}].[RelationshipStrengthDirection] = 2 THEN 'Backward'\n      ELSE NULL\n    END\n  `;\n};\n\nconst withAppliesTo = `\n  AppliesToCTE AS (\n    SELECT\n      [mixinAppliesTo].[ECInstanceId] AS [AppliesToId],\n      [appliesToSchema].[name] as [AppliesToSchema],\n      json_extract(XmlCAToJson([ca].[Class].[Id], [ca].[Instance]), '$.IsMixin.AppliesToEntityClass') AS [AppliesTo]\n    FROM [meta].[CustomAttribute] [ca]\n    JOIN [meta].[ECClassDef] [mixinAppliesTo]\n      ON [mixinAppliesTo].[ECInstanceId] = [ca].[ContainerId]\n    JOIN [meta].[ECSchemaDef] [appliesToSchema]\n      ON [appliesToSchema].[ECInstanceId] = [mixinAppliesTo].[Schema].[Id]\n    WHERE [ca].[ContainerType] = 30\n      AND json_extract(XmlCAToJson([ca].[Class].[Id], [ca].[Instance]), '$.ecClass') = 'IsMixin'\n  )\n`;\n\nconst withSchemaReferences = `\n  SchemaReferences AS (\n    SELECT\n      [ref].[SourceECInstanceId] AS [SchemaId],\n      CONCAT([Name],'.',[VersionMajor],'.',[VersionWrite],'.',[VersionMinor]) AS [fullName]\n    FROM\n      [meta].[ECSchemaDef] AS [refSchema]\n    INNER JOIN [meta].[SchemaHasSchemaReferences] [ref]\n      ON [ref].[TargetECInstanceId] = [refSchema].[ECInstanceId]\n  )\n`;\n\nconst customAttributeQuery = `\n  SELECT\n    [Schema].[Id] AS [SchemaId],\n    json_object(\n      'name', [class].[Name],\n      'schemaItemType', 'CustomAttributeClass',\n      'modifier', ${modifier(\"class\")},\n      'label', [class].[DisplayLabel],\n      'description', [class].[Description],\n      'appliesTo', [class].[CustomAttributeContainerType],\n      'baseClasses', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'CustomAttributeClass',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description],\n            'appliesTo', [baseClass].[CustomAttributeContainerType]\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n      )\n    ) AS [item]\n  FROM [meta].[ECClassDef] [class]\n  WHERE [class].[Type] = 3\n`;\n\nconst structQuery = `\n  SELECT\n    [Schema].[Id] AS [SchemaId],\n    json_object(\n      'name', [class].[Name],\n      'schemaItemType', 'StructClass',\n      'modifier', ${modifier(\"class\")},\n      'label', [class].[DisplayLabel],\n      'description', [class].[Description],\n      'baseClasses', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'StructClass',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description]\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n      )\n    ) AS [item]\n  FROM [meta].[ECClassDef] [class]\n  WHERE [class].[Type] = 2\n`;\n\nconst relationshipQuery = `\n  SELECT\n    [Schema].[Id] AS [SchemaId],\n    json_object(\n      'name', [class].[Name],\n      'schemaItemType', 'RelationshipClass',\n      'modifier', ${modifier(\"class\")},\n      'label', [class].[DisplayLabel],\n      'description', [class].[Description],\n      'strength', ${strength(\"class\")},\n      'strengthDirection', ${strengthDirection(\"class\")},\n      'baseClasses', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'RelationshipClass',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description],\n            'strength', ${strength(\"baseClass\")},\n            'strengthDirection', ${strengthDirection(\"baseClass\")}\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n      )\n    ) AS [item]\n  FROM [meta].[ECClassDef] [class]\n  WHERE [class].[Type] = 1\n`;\n\nconst entityQuery = `\n  SELECT\n    [Schema].[Id] AS [SchemaId],\n    json_object(\n      'name', [class].[Name],\n      'schemaItemType', 'EntityClass',\n      'modifier', ${modifier(\"class\")},\n      'label', [class].[DisplayLabel],\n      'description', [class].[Description],\n      'baseClasses', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'EntityClass',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description]\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n          AND NOT EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [baseClass].[ECInstanceId] = [ca].[Class].[Id]\n            AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\n        ),\n      'mixins', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'Mixin',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description],\n            'appliesTo', (\n              SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\n              FROM [AppliesToCTE] [atCTE]\n              WHERE [atCTE].[AppliesToId] = [baseClass].[ECInstanceId]\n            ),\n            'baseClasses', (\n              SELECT\n                json_group_array(json(json_object(\n                  'schema', ec_classname([mixinBaseClass].[ECInstanceId], 's'),\n                  'name', [mixinBaseClass].[Name],\n                  'schemaItemType', 'Mixin',\n                  'modifier', ${modifier(\"mixinBaseClass\")},\n                  'label', [mixinBaseClass].[DisplayLabel],\n                  'description', [mixinBaseClass].[Description],\n                  'appliesTo', (\n                    SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\n                    FROM [AppliesToCTE] [atCTE]\n                    WHERE [atCTE].[AppliesToId] = [mixinBaseClass].[ECInstanceId]\n                  )\n                )))\n              FROM\n                [meta].[ECClassDef] [mixinBaseClass]\n              INNER JOIN [meta].[ClassHasAllBaseClasses] [mixinBaseClassMap]\n                ON [mixinBaseClassMap].[TargetECInstanceId] = [mixinBaseClass].[ECInstanceId]\n              WHERE [mixinBaseClassMap].[SourceECInstanceId] = [baseClass].[ECInstanceId]\n            )\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n          AND EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [baseClass].[ECInstanceId] = [ca].[Class].[Id]\n            AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\n          )\n    ) AS [item]\n  FROM [meta].[ECClassDef] [class]\n  WHERE [class].[Type] = 0\n    AND NOT EXISTS(SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [class].[ECInstanceId] = [ca].[Class].[Id]\n      AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\n`;\n\nconst mixinQuery = `\n  SELECT\n    [Schema].[Id] AS [SchemaId],\n    json_object(\n      'name', [class].[Name],\n      'schemaItemType', 'Mixin',\n      'modifier', ${modifier(\"class\")},\n      'label', [class].[DisplayLabel],\n      'description', [class].[Description],\n      'appliesTo', (\n        SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\n        FROM [AppliesToCTE] [atCTE]\n        WHERE [atCTE].[AppliesToId] = [class].[ECInstanceId]\n      ),\n      'baseClasses', (\n        SELECT\n          json_group_array(json(json_object(\n            'schema', ec_classname([baseClass].[ECInstanceId], 's'),\n            'name', [baseClass].[Name],\n            'schemaItemType', 'Mixin',\n            'modifier', ${modifier(\"baseClass\")},\n            'label', [baseClass].[DisplayLabel],\n            'description', [baseClass].[Description],\n            'appliesTo', (\n              SELECT IIF(instr([atCTE].[AppliesTo], ':') > 1, ec_classname(ec_classId([atCTE].[AppliesTo]), 's.c'), CONCAT([atCTE].[AppliesToSchema], '.', [atCTE].[AppliesTo]))\n              FROM [AppliesToCTE] [atCTE]\n              WHERE [atCTE].[AppliesToId] = [baseClass].[ECInstanceId]\n            )\n          )))\n        FROM\n          [meta].[ECClassDef] [baseClass]\n        INNER JOIN [meta].[ClassHasAllBaseClasses] [baseClassMap]\n          ON [baseClassMap].[TargetECInstanceId] = [baseclass].[ECInstanceId]\n        WHERE [baseClassMap].[SourceECInstanceId] = [class].[ECInstanceId]\n      )\n    ) AS [item]\n    FROM [meta].[ECClassDef] [class]\n    WHERE [class].[Type] = 0 AND EXISTS (SELECT 1 FROM [meta].[ClassCustomAttribute] [ca] WHERE [class].[ECInstanceId] = [ca].[Class].[Id]\n      AND [ca].[CustomAttributeClass].[Id] Is ([CoreCA].[IsMixin]))\n`;\n\nconst withSchemaItems = `\nSchemaItems AS (\n  ${customAttributeQuery}\n  UNION ALL\n  ${structQuery}\n  UNION ALL\n  ${relationshipQuery}\n  UNION ALL\n  ${entityQuery}\n  UNION ALL\n  ${mixinQuery}\n  UNION ALL\n  ${SchemaItemQueries.enumeration()}\n  UNION ALL\n  ${SchemaItemQueries.kindOfQuantity()}\n  UNION ALL\n  ${SchemaItemQueries.propertyCategory()}\n  UNION ALL\n  ${SchemaItemQueries.unit()}\n  UNION ALL\n  ${SchemaItemQueries.invertedUnit()}\n  UNION ALL\n  ${SchemaItemQueries.constant()}\n  UNION ALL\n  ${SchemaItemQueries.phenomenon()}\n  UNION ALL\n  ${SchemaItemQueries.unitSystem()}\n  UNION ALL\n  ${SchemaItemQueries.format()}\n  )\n`;\n\nconst schemaStubQuery = `\n  WITH\n    ${withAppliesTo},\n    ${withSchemaItems}\n  SELECT\n    [items].[item]\n  FROM\n    [SchemaItems] [items]\n  JOIN [meta].[ECSchemaDef] [schemaDef]\n    ON [schemaDef].[ECInstanceId] = [items].[SchemaId]\n  WHERE [schemaDef].[Name] = :schemaName\n`;\n\nconst schemaInfoQuery = `\n  WITH\n    ${withSchemaReferences}\n  SELECT\n    [Name] as [name],\n    CONCAT('',[VersionMajor],'.',[VersionWrite],'.',[VersionMinor]) AS [version],\n    [Alias] as [alias],\n    [DisplayLabel] as [label],\n    [Description] as [description],\n    (\n      SELECT\n        json_group_array([schemaReferences].[fullName])\n      FROM\n        [SchemaReferences] [schemaReferences]\n      WHERE\n        [schemaReferences].[SchemaId] = [schemaDef].[ECInstanceId]\n    ) AS [references]\n  FROM\n    [meta].[ECSchemaDef] [schemaDef]\n`;\n\n/**\n * Partial Schema queries.\n * @internal\n */\nexport const ecsqlQueries = {\n  schemaStubQuery,\n  schemaInfoQuery,\n};\n"]}

package/lib/esm/Interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../src/Interfaces.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Metadata\r\n */\r\n\r\nimport { ECClass, StructClass } from \"./Metadata/Class\";\r\nimport { Constant } from \"./Metadata/Constant\";\r\nimport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\r\nimport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\r\nimport { EntityClass } from \"./Metadata/EntityClass\";\r\nimport { AnyEnumerator, Enumeration } from \"./Metadata/Enumeration\";\r\nimport { Format } from \"./Metadata/Format\";\r\nimport { InvertedUnit } from \"./Metadata/InvertedUnit\";\r\nimport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\r\nimport { Mixin } from \"./Metadata/Mixin\";\r\nimport { OverrideFormat } from \"./Metadata/OverrideFormat\";\r\nimport { Phenomenon } from \"./Metadata/Phenomenon\";\r\nimport { AnyProperty } from \"./Metadata/Property\";\r\nimport { PropertyCategory } from \"./Metadata/PropertyCategory\";\r\nimport { RelationshipClass, RelationshipConstraint } from \"./Metadata/RelationshipClass\";\r\nimport { Schema } from \"./Metadata/Schema\";\r\nimport { SchemaItem } from \"./Metadata/SchemaItem\";\r\nimport { Unit } from \"./Metadata/Unit\";\r\nimport { UnitSystem } from \"./Metadata/UnitSystem\";\r\nimport { SchemaItemKey, SchemaKey } from \"./SchemaKey\";\r\n\r\n/** @public @preview */\r\nexport type LazyLoadedSchema = SchemaKey & Promise<Schema>;\r\n\r\n/** @public @preview */\r\nexport type LazyLoadedSchemaItem<T extends SchemaItem> = SchemaItemKey & Promise<T>;\r\n/** @public @preview */\r\nexport type LazyLoadedECClass = LazyLoadedSchemaItem<ECClass>;\r\n/** @public @preview */\r\nexport type LazyLoadedEntityClass = LazyLoadedSchemaItem<EntityClass>;\r\n/** @public @preview */\r\nexport type LazyLoadedMixin = LazyLoadedSchemaItem<Mixin>;\r\n/** @public @preview */\r\nexport type LazyLoadedStructClass = LazyLoadedSchemaItem<StructClass>;\r\n/** @public @preview */\r\nexport type LazyLoadedRelationshipClass = LazyLoadedSchemaItem<RelationshipClass>;\r\n/** @public @preview */\r\nexport type LazyLoadedEnumeration = LazyLoadedSchemaItem<Enumeration>;\r\n/** @public @preview */\r\nexport type LazyLoadedFormat = LazyLoadedSchemaItem<Format>;\r\n/** @public @preview */\r\nexport type LazyLoadedKindOfQuantity = LazyLoadedSchemaItem<KindOfQuantity>;\r\n/** @public @preview */\r\nexport type LazyLoadedPropertyCategory = LazyLoadedSchemaItem<PropertyCategory>;\r\n/** @public @preview */\r\nexport type LazyLoadedRelationshipConstraintClass = LazyLoadedSchemaItem<EntityClass | Mixin | RelationshipClass>;\r\n/** @public @preview */\r\nexport type LazyLoadedUnit = LazyLoadedSchemaItem<Unit>;\r\n/** @public @preview */\r\nexport type LazyLoadedInvertedUnit = LazyLoadedSchemaItem<InvertedUnit>;\r\n/** @public @preview */\r\nexport type LazyLoadedPhenomenon = LazyLoadedSchemaItem<Phenomenon>;\r\n/** @public @preview */\r\nexport type LazyLoadedUnitSystem = LazyLoadedSchemaItem<UnitSystem>;\r\n\r\n/** @public @preview */\r\nexport type AnyClass =\r\n  EntityClass |\r\n  Mixin |\r\n  StructClass |\r\n  CustomAttributeClass |\r\n  RelationshipClass;\r\n\r\n/** @public @preview */\r\nexport type AnySchemaItem =\r\n  AnyClass |\r\n  Enumeration |\r\n  KindOfQuantity |\r\n  PropertyCategory |\r\n  Unit |\r\n  InvertedUnit |\r\n  Constant |\r\n  Phenomenon |\r\n  UnitSystem |\r\n  Format;\r\n\r\n/** @public @preview */\r\nexport type AnyECType =\r\n  Schema |\r\n  SchemaItem |\r\n  AnyProperty |\r\n  RelationshipConstraint |\r\n  CustomAttributeContainerProps |\r\n  CustomAttribute |\r\n  OverrideFormat |\r\n  AnyEnumerator;\r\n\r\n/**\r\n *  Holds the SchemaKeys for a schema and it's references.  Designed so that Schema fulfills this interface.\r\n * @public @preview\r\n */\r\nexport interface SchemaInfo {\r\n  readonly alias: string;\r\n  readonly schemaKey: SchemaKey;\r\n  readonly references: ReadonlyArray<WithSchemaKey>;\r\n}\r\n\r\n/** @public @preview */\r\nexport interface WithSchemaKey {\r\n  readonly schemaKey: SchemaKey;\r\n}\r\n\r\n/** This is needed to break a circular dependency between Class and EntityClass.\r\n * @public @preview\r\n */\r\nexport interface HasMixins {\r\n  readonly mixins: ReadonlyArray<LazyLoadedMixin>;\r\n  getMixinsSync(): Iterable<Mixin>;\r\n}\r\n"]}
+{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../src/Interfaces.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Metadata\n */\n\nimport { ECClass, StructClass } from \"./Metadata/Class\";\nimport { Constant } from \"./Metadata/Constant\";\nimport { CustomAttribute, CustomAttributeContainerProps } from \"./Metadata/CustomAttribute\";\nimport { CustomAttributeClass } from \"./Metadata/CustomAttributeClass\";\nimport { EntityClass } from \"./Metadata/EntityClass\";\nimport { AnyEnumerator, Enumeration } from \"./Metadata/Enumeration\";\nimport { Format } from \"./Metadata/Format\";\nimport { InvertedUnit } from \"./Metadata/InvertedUnit\";\nimport { KindOfQuantity } from \"./Metadata/KindOfQuantity\";\nimport { Mixin } from \"./Metadata/Mixin\";\nimport { OverrideFormat } from \"./Metadata/OverrideFormat\";\nimport { Phenomenon } from \"./Metadata/Phenomenon\";\nimport { AnyProperty } from \"./Metadata/Property\";\nimport { PropertyCategory } from \"./Metadata/PropertyCategory\";\nimport { RelationshipClass, RelationshipConstraint } from \"./Metadata/RelationshipClass\";\nimport { Schema } from \"./Metadata/Schema\";\nimport { SchemaItem } from \"./Metadata/SchemaItem\";\nimport { Unit } from \"./Metadata/Unit\";\nimport { UnitSystem } from \"./Metadata/UnitSystem\";\nimport { SchemaItemKey, SchemaKey } from \"./SchemaKey\";\n\n/** @public @preview */\nexport type LazyLoadedSchema = SchemaKey & Promise<Schema>;\n\n/** @public @preview */\nexport type LazyLoadedSchemaItem<T extends SchemaItem> = SchemaItemKey & Promise<T>;\n/** @public @preview */\nexport type LazyLoadedECClass = LazyLoadedSchemaItem<ECClass>;\n/** @public @preview */\nexport type LazyLoadedEntityClass = LazyLoadedSchemaItem<EntityClass>;\n/** @public @preview */\nexport type LazyLoadedMixin = LazyLoadedSchemaItem<Mixin>;\n/** @public @preview */\nexport type LazyLoadedStructClass = LazyLoadedSchemaItem<StructClass>;\n/** @public @preview */\nexport type LazyLoadedRelationshipClass = LazyLoadedSchemaItem<RelationshipClass>;\n/** @public @preview */\nexport type LazyLoadedEnumeration = LazyLoadedSchemaItem<Enumeration>;\n/** @public @preview */\nexport type LazyLoadedFormat = LazyLoadedSchemaItem<Format>;\n/** @public @preview */\nexport type LazyLoadedKindOfQuantity = LazyLoadedSchemaItem<KindOfQuantity>;\n/** @public @preview */\nexport type LazyLoadedPropertyCategory = LazyLoadedSchemaItem<PropertyCategory>;\n/** @public @preview */\nexport type LazyLoadedRelationshipConstraintClass = LazyLoadedSchemaItem<EntityClass | Mixin | RelationshipClass>;\n/** @public @preview */\nexport type LazyLoadedUnit = LazyLoadedSchemaItem<Unit>;\n/** @public @preview */\nexport type LazyLoadedInvertedUnit = LazyLoadedSchemaItem<InvertedUnit>;\n/** @public @preview */\nexport type LazyLoadedPhenomenon = LazyLoadedSchemaItem<Phenomenon>;\n/** @public @preview */\nexport type LazyLoadedUnitSystem = LazyLoadedSchemaItem<UnitSystem>;\n\n/** @public @preview */\nexport type AnyClass =\n  EntityClass |\n  Mixin |\n  StructClass |\n  CustomAttributeClass |\n  RelationshipClass;\n\n/** @public @preview */\nexport type AnySchemaItem =\n  AnyClass |\n  Enumeration |\n  KindOfQuantity |\n  PropertyCategory |\n  Unit |\n  InvertedUnit |\n  Constant |\n  Phenomenon |\n  UnitSystem |\n  Format;\n\n/** @public @preview */\nexport type AnyECType =\n  Schema |\n  SchemaItem |\n  AnyProperty |\n  RelationshipConstraint |\n  CustomAttributeContainerProps |\n  CustomAttribute |\n  OverrideFormat |\n  AnyEnumerator;\n\n/**\n *  Holds the SchemaKeys for a schema and it's references.  Designed so that Schema fulfills this interface.\n * @public @preview\n */\nexport interface SchemaInfo {\n  readonly alias: string;\n  readonly schemaKey: SchemaKey;\n  readonly references: ReadonlyArray<WithSchemaKey>;\n}\n\n/** @public @preview */\nexport interface WithSchemaKey {\n  readonly schemaKey: SchemaKey;\n}\n\n/** This is needed to break a circular dependency between Class and EntityClass.\n * @public @preview\n */\nexport interface HasMixins {\n  readonly mixins: ReadonlyArray<LazyLoadedMixin>;\n  getMixinsSync(): Iterable<Mixin>;\n}\n"]}

package/lib/esm/Localization/LocalizationProvider.d.ts

@@ -0,0 +1,31 @@
+import { SchemaLocalizationJson } from "./LocalizationTypes";
+/**
+ * Interface for providing localization JSON files for schemas.
+ * @beta
+ */
+export interface ILocalizationProvider {
+    /**
+     * Load localization JSON for a given schema and locale.
+     * @param schemaName The name of the schema
+     * @param locale The locale identifier (e.g., "de", "fr", "es-CO")
+     * @returns Promise resolving to the localization JSON, or undefined if not found
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+export declare class LocalizationProvider implements ILocalizationProvider {
+    private _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>);
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;
+}
+//# sourceMappingURL=LocalizationProvider.d.ts.map

package/lib/esm/Localization/LocalizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;CAClG;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAMpD,OAAO,CAAC,OAAO;IAJ3B;;;OAGG;gBACiB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAGhH;;OAEG;IACU,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;CAmB9G"}

package/lib/esm/Localization/LocalizationProvider.js

@@ -0,0 +1,33 @@
+/**
+ * The provider to load the localization JSON files.
+ * @beta
+ */
+export class LocalizationProvider {
+    _loader;
+    /**
+     * Constructs a LocalizationProvider.
+     * @param _loader Function that loads JSON content given a schema name and locale
+     */
+    constructor(_loader) {
+        this._loader = _loader;
+    }
+    /**
+     * Load localization JSON for a given schema and locale.
+     */
+    async getLocalization(schemaName, locale) {
+        const localizationData = await this._loader(schemaName, locale);
+        if (localizationData) {
+            if (!localizationData.name || !localizationData.locale) {
+                throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);
+            }
+            if (localizationData.name !== schemaName) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name "${schemaName}" but got "${localizationData.name}"`);
+            }
+            if (localizationData.locale !== locale) {
+                throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale "${locale}" but got "${localizationData.locale}"`);
+            }
+        }
+        return localizationData;
+    }
+}
+//# sourceMappingURL=LocalizationProvider.js.map

package/lib/esm/Localization/LocalizationProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationProvider.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationProvider.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAMX;IAJpB;;;OAGG;IACH,YAAoB,OAA4F;QAA5F,YAAO,GAAP,OAAO,CAAqF;IAChH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAAC,UAAkB,EAAE,MAAc;QAC7D,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAEhE,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,IAAI,MAAM,kCAAkC,CAAC,CAAC;YAC3G,CAAC;YAED,IAAI,gBAAgB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,4BAA4B,UAAU,cAAc,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;YACtJ,CAAC;YAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,UAAU,IAAI,MAAM,uBAAuB,MAAM,cAAc,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC/I,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\nimport { SchemaLocalizationJson } from \"./LocalizationTypes\";\n\n/**\n * Interface for providing localization JSON files for schemas.\n * @beta\n */\nexport interface ILocalizationProvider {\n  /**\n   * Load localization JSON for a given schema and locale.\n   * @param schemaName The name of the schema\n   * @param locale The locale identifier (e.g., \"de\", \"fr\", \"es-CO\")\n   * @returns Promise resolving to the localization JSON, or undefined if not found\n   */\n  getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined>;\n}\n\n/**\n * The provider to load the localization JSON files.\n * @beta\n */\nexport class LocalizationProvider implements ILocalizationProvider {\n\n  /**\n   * Constructs a LocalizationProvider.\n   * @param _loader Function that loads JSON content given a schema name and locale\n   */\n  constructor(private _loader: (schemaName: string, locale: string) => Promise<SchemaLocalizationJson | undefined>) {\n  }\n\n  /**\n   * Load localization JSON for a given schema and locale.\n   */\n  public async getLocalization(schemaName: string, locale: string): Promise<SchemaLocalizationJson | undefined> {\n    const localizationData = await this._loader(schemaName, locale);\n\n    if (localizationData) {\n      if (!localizationData.name || !localizationData.locale) {\n        throw new Error(`Invalid localization JSON for ${schemaName}:${locale} - missing schema name or locale`);\n      }\n\n      if (localizationData.name !== schemaName) {\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected schema name \"${schemaName}\" but got \"${localizationData.name}\"`);\n      }\n\n      if (localizationData.locale !== locale) {\n        throw new Error(`Localization JSON mismatch for ${schemaName}:${locale} - expected locale \"${locale}\" but got \"${localizationData.locale}\"`);\n      }\n    }\n\n    return localizationData;\n  }\n}\n"]}

package/lib/esm/Localization/LocalizationTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Represents localized label and description for a schema element.
+ * @beta
+ */
+export interface LocalizedText {
+    label?: string;
+    description?: string;
+}
+/**
+ * Localized text for a schema item
+ * @beta
+ */
+export interface LocalizedItemText extends LocalizedText {
+    /** Localized members keyed by member name */
+    members?: {
+        [memberName: string]: LocalizedText;
+    };
+}
+/**
+ * JSON structure for schema localization file.
+ * @beta
+ */
+export interface SchemaLocalizationJson {
+    /** Schema version identifier */
+    $schema: string;
+    /** Name of the schema this localization applies to */
+    name: string;
+    /** Version of the schema */
+    version: string;
+    /** Locale identifier (e.g., "de", "fr", "es-CO") */
+    locale: string;
+    /** Localized schema label */
+    label?: string;
+    /** Localized schema description */
+    description?: string;
+    /** Localized schema items, keyed by item name */
+    items?: {
+        [itemName: string]: LocalizedItemText;
+    };
+}
+//# sourceMappingURL=LocalizationTypes.d.ts.map

package/lib/esm/Localization/LocalizationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.d.ts","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,6CAA6C;IAC7C,OAAO,CAAC,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAA;KAAE,CAAC;CACnD"}

package/lib/esm/Localization/LocalizationTypes.js

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+export {};
+//# sourceMappingURL=LocalizationTypes.js.map

package/lib/esm/Localization/LocalizationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationTypes.js","sourceRoot":"","sources":["../../../src/Localization/LocalizationTypes.ts"],"names":[],"mappings":"AAAA;;;+FAG+F","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/**\n * Represents localized label and description for a schema element.\n * @beta\n */\nexport interface LocalizedText {\n  label?: string;\n  description?: string;\n}\n\n/**\n * Localized text for a schema item\n * @beta\n */\nexport interface LocalizedItemText extends LocalizedText {\n  /** Localized members keyed by member name */\n  members?: { [memberName: string]: LocalizedText };\n}\n\n/**\n * JSON structure for schema localization file.\n * @beta\n */\nexport interface SchemaLocalizationJson {\n  /** Schema version identifier */\n  $schema: string;\n  /** Name of the schema this localization applies to */\n  name: string;\n  /** Version of the schema */\n  version: string;\n  /** Locale identifier (e.g., \"de\", \"fr\", \"es-CO\") */\n  locale: string;\n  /** Localized schema label */\n  label?: string;\n  /** Localized schema description */\n  description?: string;\n  /** Localized schema items, keyed by item name */\n  items?: { [itemName: string]: LocalizedItemText };\n}\n"]}

package/lib/esm/Localization/SchemaLocalization.d.ts

@@ -0,0 +1,94 @@
+import { SchemaKey } from "../SchemaKey";
+import { SchemaView } from "../SchemaView";
+import { Schema } from "../Metadata/Schema";
+import { ECClass } from "../Metadata/Class";
+import { Property } from "../Metadata/Property";
+import { SchemaItem } from "../Metadata/SchemaItem";
+import { ILocalizationProvider } from "./LocalizationProvider";
+import { AnyEnumerator, Enumeration } from "../Metadata/Enumeration";
+import { LocalizedText } from "./LocalizationTypes";
+type SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+export declare class SchemaLocalization {
+    private _provider;
+    private _locale;
+    private _cache;
+    private constructor();
+    private get _baseLocale();
+    private cacheKey;
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization>;
+    get locale(): string;
+    setLocale(locale: string): void;
+    /**
+     * Get localization provider.
+     */
+    get provider(): ILocalizationProvider;
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void>;
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined;
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText;
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText;
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText;
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText;
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    private loadLocalizationInfo;
+    /**
+     * Get major version from version string
+     */
+    private getMajorVersion;
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    private getCachedLocalization;
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    private resolveLabel;
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    private resolveDescription;
+}
+export {};
+//# sourceMappingURL=SchemaLocalization.d.ts.map

package/lib/esm/Localization/SchemaLocalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.d.ts","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAI5E,KAAK,cAAc,GAAG,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,WAAW,GAAG,UAAU,CAAC,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;AAE1H;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA8D;IAE5E,OAAO;IAKP,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;WACiB,MAAM,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMzI,IAAW,MAAM,IAAI,MAAM,CAE1B;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,IAAW,QAAQ,IAAI,qBAAqB,CAE3C;IAED;;;OAGG;IACU,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAc/F;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAcrG;;;;OAIG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,aAAa;IAM5E;;;;OAIG;IACI,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa;IAM/E;;;;OAIG;IACI,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC,QAAQ,GAAG,aAAa;IAMzH;;;;OAIG;IACI,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,GAAG,UAAU,CAAC,UAAU,GAAG,aAAa;IAMlJ;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/lib/esm/Localization/SchemaLocalization.js

@@ -0,0 +1,193 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Logger } from "@itwin/core-bentley";
+const loggerCategory = "SchemaLocalization";
+/**
+ * Manages schema localization to provide localized labels and descriptions.
+ * @beta
+ */
+export class SchemaLocalization {
+    _provider;
+    _locale;
+    _cache = new Map();
+    constructor(provider, locale) {
+        this._provider = provider;
+        this._locale = locale;
+    }
+    get _baseLocale() {
+        return this._locale.includes("-") ? this._locale.split("-")[0] : undefined;
+    }
+    cacheKey(schemaName, locale) {
+        return `${schemaName}:${locale}`;
+    }
+    /**
+     * Create a SchemaLocalization instance and pre-load localization files for the given schemas.
+     * @param provider The localization provider to use for loading localization files
+     * @param locale The target locale (e.g., "de", "fr", "es-CO")
+     * @param schemas The schemas whose localization should be pre-loaded
+     */
+    static async create(provider, locale, schemaKeys) {
+        const localization = new SchemaLocalization(provider, locale);
+        await localization.loadLocalizations(schemaKeys);
+        return localization;
+    }
+    get locale() {
+        return this._locale;
+    }
+    setLocale(locale) {
+        this._locale = locale;
+        this._cache.clear();
+    }
+    /**
+     * Get localization provider.
+     */
+    get provider() {
+        return this._provider;
+    }
+    /**
+     * Load localizations for the given schema keys.
+     * @param schemaKeys The schema keys to load localization for
+     */
+    async loadLocalizations(schemaKeys) {
+        const promises = [];
+        for (const key of schemaKeys) {
+            promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));
+            if (this._baseLocale !== undefined)
+                promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Get a localized label for a schema, schema item, or member.
+     */
+    getLabel(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const label = this.resolveLabel(localization, itemName, memberName);
+        if (label)
+            return label;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveLabel(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get a localized description for a schema, schema item, or member.
+     */
+    getDescription(schemaName, itemName, memberName) {
+        const localization = this.getCachedLocalization(schemaName, this._locale);
+        const description = this.resolveDescription(localization, itemName, memberName);
+        if (description)
+            return description;
+        if (this._baseLocale) {
+            const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);
+            return this.resolveDescription(baseLocalization, itemName, memberName);
+        }
+        return undefined;
+    }
+    /**
+     * Get localized label and description of a schema.
+     * Label fallback: localized label → base locale label → original label → schema name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchema(schema) {
+        const label = this.getLabel(schema.name) ?? (schema.label || schema.name);
+        const description = this.getDescription(schema.name) ?? schema.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a schema item (class, enumeration, unit, etc.).
+     * Label fallback: localized label → base locale label → original label → item name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedSchemaItem(item) {
+        const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);
+        const description = this.getDescription(item.schema.name, item.name) ?? item.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of a property.
+     * Label fallback: localized label → base locale label → original label → property name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedProperty(ecClass, property) {
+        const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);
+        const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;
+        return { label, description };
+    }
+    /**
+     * Get localized label and description of an enumerator.
+     * Label fallback: localized label → base locale label → original label → enumerator name
+     * Description fallback: localized description → base locale description → original description
+     */
+    getLocalizedEnumerator(enumeration, enumerator) {
+        const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);
+        const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;
+        return { label, description };
+    }
+    /**
+     * Load localization information for a specific schema and locale.
+     */
+    async loadLocalizationInfo(schemaName, readVersion, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        if (this._cache.has(cacheKey))
+            return;
+        const localization = await this._provider.getLocalization(schemaName, locale);
+        if (localization?.version) {
+            const localizationMajor = this.getMajorVersion(localization.version);
+            if (localizationMajor === undefined || readVersion !== localizationMajor) {
+                Logger.logWarning(loggerCategory, `Localization version mismatch for schema "${schemaName}". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? "undefined"}.`);
+                this._cache.set(cacheKey, undefined);
+                return;
+            }
+        }
+        this._cache.set(cacheKey, localization);
+    }
+    /**
+     * Get major version from version string
+     */
+    getMajorVersion(version) {
+        const rawVersion = version.split(".");
+        if (rawVersion.length > 0) {
+            const majorVersion = parseInt(rawVersion[0], 10);
+            return isNaN(majorVersion) ? undefined : majorVersion;
+        }
+        return undefined;
+    }
+    /**
+     * Retrieve the cached localization for a locale
+     */
+    getCachedLocalization(schemaName, locale) {
+        const cacheKey = this.cacheKey(schemaName, locale);
+        return this._cache.get(cacheKey);
+    }
+    /**
+     * Resolve a label from a localization object by item and optional member path.
+     */
+    resolveLabel(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.label;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.label;
+        return item?.members?.[memberName]?.label;
+    }
+    /**
+     * Resolve a description from a localization object by item and optional member path.
+     */
+    resolveDescription(localization, itemName, memberName) {
+        if (!localization)
+            return undefined;
+        if (!itemName)
+            return localization.description;
+        const item = localization.items?.[itemName];
+        if (!memberName)
+            return item?.description;
+        return item?.members?.[memberName]?.description;
+    }
+}
+//# sourceMappingURL=SchemaLocalization.js.map

package/lib/esm/Localization/SchemaLocalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaLocalization.js","sourceRoot":"","sources":["../../../src/Localization/SchemaLocalization.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nimport { SchemaKey } from \"../SchemaKey\";\nimport { SchemaView } from \"../SchemaView\";\nimport { Schema } from \"../Metadata/Schema\";\nimport { ECClass } from \"../Metadata/Class\";\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Property } from \"../Metadata/Property\";\nimport { SchemaItem } from \"../Metadata/SchemaItem\";\nimport { ILocalizationProvider } from \"./LocalizationProvider\";\nimport { AnyEnumerator, Enumeration } from \"../Metadata/Enumeration\";\nimport { LocalizedText, SchemaLocalizationJson } from \"./LocalizationTypes\";\n\nconst loggerCategory = \"SchemaLocalization\";\n\ntype SchemaViewItem = SchemaView.Class | SchemaView.Enumeration | SchemaView.KindOfQuantity | SchemaView.PropertyCategory;\n\n/**\n * Manages schema localization to provide localized labels and descriptions.\n * @beta\n */\nexport class SchemaLocalization {\n  private _provider: ILocalizationProvider;\n  private _locale: string;\n  private _cache: Map<string, SchemaLocalizationJson | undefined> = new Map();\n\n  private constructor(provider: ILocalizationProvider, locale: string) {\n    this._provider = provider;\n    this._locale = locale;\n  }\n\n  private get _baseLocale(): string | undefined {\n    return this._locale.includes(\"-\") ? this._locale.split(\"-\")[0] : undefined;\n  }\n\n  private cacheKey(schemaName: string, locale: string): string {\n    return `${schemaName}:${locale}`;\n  }\n\n  /**\n   * Create a SchemaLocalization instance and pre-load localization files for the given schemas.\n   * @param provider The localization provider to use for loading localization files\n   * @param locale The target locale (e.g., \"de\", \"fr\", \"es-CO\")\n   * @param schemas The schemas whose localization should be pre-loaded\n   */\n  public static async create(provider: ILocalizationProvider, locale: string, schemaKeys: Iterable<SchemaKey>): Promise<SchemaLocalization> {\n    const localization = new SchemaLocalization(provider, locale);\n    await localization.loadLocalizations(schemaKeys);\n    return localization;\n  }\n\n  public get locale(): string {\n    return this._locale;\n  }\n\n  public setLocale(locale: string): void {\n    this._locale = locale;\n    this._cache.clear();\n  }\n\n  /**\n   * Get localization provider.\n   */\n  public get provider(): ILocalizationProvider {\n    return this._provider;\n  }\n\n  /**\n   * Load localizations for the given schema keys.\n   * @param schemaKeys The schema keys to load localization for\n   */\n  public async loadLocalizations(schemaKeys: Iterable<SchemaKey>): Promise<void> {\n    const promises: Promise<void>[] = [];\n    for (const key of schemaKeys) {\n      promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._locale));\n      if (this._baseLocale !== undefined)\n        promises.push(this.loadLocalizationInfo(key.name, key.readVersion, this._baseLocale));\n    }\n    await Promise.all(promises);\n  }\n\n  /**\n   * Get a localized label for a schema, schema item, or member.\n   */\n  public getLabel(schemaName: string, itemName?: string, memberName?: string): string | undefined {\n    const localization = this.getCachedLocalization(schemaName, this._locale);\n    const label = this.resolveLabel(localization, itemName, memberName);\n    if (label)\n      return label;\n\n    if (this._baseLocale) {\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\n      return this.resolveLabel(baseLocalization, itemName, memberName);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get a localized description for a schema, schema item, or member.\n   */\n  public getDescription(schemaName: string, itemName?: string, memberName?: string): string | undefined {\n    const localization = this.getCachedLocalization(schemaName, this._locale);\n    const description = this.resolveDescription(localization, itemName, memberName);\n    if (description)\n      return description;\n\n    if (this._baseLocale) {\n      const baseLocalization = this.getCachedLocalization(schemaName, this._baseLocale);\n      return this.resolveDescription(baseLocalization, itemName, memberName);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get localized label and description of a schema.\n   * Label fallback: localized label → base locale label → original label → schema name\n   * Description fallback: localized description → base locale description → original description\n   */\n  public getLocalizedSchema(schema: Schema | SchemaView.Schema): LocalizedText {\n    const label = this.getLabel(schema.name) ?? (schema.label || schema.name);\n    const description = this.getDescription(schema.name) ?? schema.description;\n    return { label, description };\n  }\n\n  /**\n   * Get localized label and description of a schema item (class, enumeration, unit, etc.).\n   * Label fallback: localized label → base locale label → original label → item name\n   * Description fallback: localized description → base locale description → original description\n   */\n  public getLocalizedSchemaItem(item: SchemaItem | SchemaViewItem): LocalizedText {\n    const label = this.getLabel(item.schema.name, item.name) ?? (item.label || item.name);\n    const description = this.getDescription(item.schema.name, item.name) ?? item.description;\n    return { label, description };\n  }\n\n  /**\n   * Get localized label and description of a property.\n   * Label fallback: localized label → base locale label → original label → property name\n   * Description fallback: localized description → base locale description → original description\n   */\n  public getLocalizedProperty(ecClass: ECClass | SchemaView.Class, property: Property | SchemaView.Property): LocalizedText {\n    const label = this.getLabel(ecClass.schema.name, ecClass.name, property.name) ?? (property.label || property.name);\n    const description = this.getDescription(ecClass.schema.name, ecClass.name, property.name) ?? property.description;\n    return { label, description };\n  }\n\n  /**\n   * Get localized label and description of an enumerator.\n   * Label fallback: localized label → base locale label → original label → enumerator name\n   * Description fallback: localized description → base locale description → original description\n   */\n  public getLocalizedEnumerator(enumeration: Enumeration | SchemaView.Enumeration, enumerator: AnyEnumerator | SchemaView.Enumerator): LocalizedText {\n    const label = this.getLabel(enumeration.schema.name, enumeration.name, enumerator.name) ?? (enumerator.label || enumerator.name);\n    const description = this.getDescription(enumeration.schema.name, enumeration.name, enumerator.name) ?? enumerator.description;\n    return { label, description };\n  }\n\n  /**\n   * Load localization information for a specific schema and locale.\n   */\n  private async loadLocalizationInfo(schemaName: string, readVersion: number, locale: string): Promise<void> {\n    const cacheKey = this.cacheKey(schemaName, locale);\n    if (this._cache.has(cacheKey))\n      return;\n\n    const localization = await this._provider.getLocalization(schemaName, locale);\n    if (localization?.version) {\n      const localizationMajor = this.getMajorVersion(localization.version);\n      if (localizationMajor === undefined || readVersion !== localizationMajor) {\n        Logger.logWarning(loggerCategory, `Localization version mismatch for schema \"${schemaName}\". Schema major version is ${readVersion.toString()}, but localization is for major version ${localizationMajor?.toString() ?? \"undefined\"}.`);\n        this._cache.set(cacheKey, undefined);\n        return;\n      }\n    }\n\n    this._cache.set(cacheKey, localization);\n  }\n\n  /**\n   * Get major version from version string\n   */\n  private getMajorVersion(version: string): number | undefined {\n    const rawVersion = version.split(\".\");\n    if (rawVersion.length > 0) {\n      const majorVersion = parseInt(rawVersion[0], 10);\n      return isNaN(majorVersion) ? undefined : majorVersion;\n    }\n    return undefined;\n  }\n\n  /**\n   * Retrieve the cached localization for a locale\n   */\n  private getCachedLocalization(schemaName: string, locale: string): SchemaLocalizationJson | undefined {\n    const cacheKey = this.cacheKey(schemaName, locale);\n    return this._cache.get(cacheKey);\n  }\n\n  /**\n   * Resolve a label from a localization object by item and optional member path.\n   */\n  private resolveLabel(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\n    if (!localization)\n      return undefined;\n    if (!itemName)\n      return localization.label;\n    const item = localization.items?.[itemName];\n    if (!memberName)\n      return item?.label;\n    return item?.members?.[memberName]?.label;\n  }\n\n  /**\n   * Resolve a description from a localization object by item and optional member path.\n   */\n  private resolveDescription(localization: SchemaLocalizationJson | undefined, itemName?: string, memberName?: string): string | undefined {\n    if (!localization)\n      return undefined;\n    if (!itemName)\n      return localization.description;\n    const item = localization.items?.[itemName];\n    if (!memberName)\n      return item?.description;\n    return item?.members?.[memberName]?.description;\n  }\n}\n"]}