@callis/ucum 0.0.1 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @callis/ucum
+
+## 0.1.0
+
+### Minor Changes
+
+- 344d7e8: Add `@callis/ucum`, full UCUM unit conversion as a `UnitSystem`: prefixes, every unit of the UCUM essence file, unit expressions with annotations and `10*n`, exact conversion, `Cel` and `[degF]`, and unit algebra for `*` and `/`. The package embeds the unchanged `ucum-essence.xml` (UCUM License, Version 1.1; see `SOURCE.md`) and reads it when first imported. It has no runtime dependencies.
+
+### Patch Changes
+
+- 0bf76ff: Include the full MIT implementation license in the core and FHIR provider tarballs, preserving FHIR source notices and UCUM licensing. Include generated changelogs in all four package archives. Clarify the first 0.1 public subset and current UCUM integration in package documentation.
+- Updated dependencies [049b205]
+- Updated dependencies [344d7e8]
+- Updated dependencies [95cf7fd]
+- Updated dependencies [e2c7274]
+- Updated dependencies [44b1ac6]
+- Updated dependencies [da7c6f7]
+- Updated dependencies [0bf76ff]
+- Updated dependencies [4730457]
+- Updated dependencies [cc25fd7]
+  - @callis/core@0.1.0

package/LICENSE.md

@@ -0,0 +1,39 @@
+# License
+
+`@callis/ucum` contains two kinds of material under two licenses.
+
+## Code: MIT
+
+The code of this package (everything except the UCUM file described below) is licensed under the MIT License:
+
+    MIT License
+
+    Copyright (c) 2026 Losol AS
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE.
+
+## UCUM data: UCUM License, Version 1.1
+
+The package also contains the unchanged essence file of the Unified Code for Units of Measure (UCUM), `data/ucum-essence.xml`, and the same text as a string in `dist/essence/ucum-essence-xml.js`. That file is not MIT licensed.
+
+Copyright 1999-2024 Regenstrief Institute, Inc. All rights reserved. Licensed under the UCUM License, Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <https://unitsofmeasure.org/license>. The full text is in [UCUM-LICENSE.md](UCUM-LICENSE.md).
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+[SOURCE.md](SOURCE.md) records where the file comes from and how the package uses it.

package/README.md

@@ -1,7 +1,56 @@
 # @callis/ucum
 
-Name-reservation placeholder. This version contains no runtime code and no functional implementation. Use @callis/ucum >=0.1.0 when the real release is available.
+Full [UCUM](https://ucum.org/ucum) unit conversion for [Callis](https://github.com/losol/callis), the FHIRPath engine for TypeScript.
 
-This package only reserves the npm name so that real releases from 0.1.0 onward can be published through the approved Callis GitHub Actions release workflow with provenance. It contains no UCUM data, FHIR model data or third-party source. Callis: <https://github.com/losol/callis>.
+`@callis/core` ships a minimal unit system: identical units, calendar durations and the UCUM time units. This package is the opt-in for everything else, such as `1 'kg' = 1000 'g'` or `1 'mg/dL'` in `'g/L'` ([ADR-0007](../../docs/adr/0007-ucum-split.md)). It has no runtime dependencies besides its `@callis/core` peer, and it works in any JavaScript runtime: it reads no files and makes no network requests.
 
-The placeholder text is licensed under MIT; see LICENSE. This placeholder does not describe the licensing of the future implementation or its data.
+## Usage
+
+`ucum` is a `UnitSystem`. Pass it to public `evaluate(input, expression, { units: ucum })` or `compile(expression, { units: ucum })`. For example, `evaluate(null, "1 'kg' = 1000 'g'", { units: ucum })` returns `[true]`. It can also be called directly:
+
+```ts
+import { Decimal } from '@callis/core';
+import { ucum } from '@callis/ucum';
+
+ucum.convert(Decimal.ONE, 'mg/dL', 'g/L')?.toString(); // '0.01'
+ucum.compare?.(Decimal.of(23n), 'Cel', Decimal.of(734n, 1), '[degF]'); // 0: 23 °C = 73.4 °F
+ucum.divide('cm2', 'cm'); // { unit: 'cm', factor: 1 }
+ucum.parse('xyz'); // undefined
+```
+
+## Behaviour
+
+- **Units.** Every prefix and unit of the UCUM essence file, in case-sensitive expressions with `.`, `/`, exponents, parentheses, annotations (`mg{total}`, `{RBC}`), `10*n` and `10^n`. Annotations do not change a unit's meaning.
+- **Conversion** is exact. A conversion whose ratio terminates keeps every digit (`1.0 'm'` is `100.0 'cm'`); a recurring one, such as feet to yards, is rounded once to 28 significant digits. Comparisons use exact ratios, so they are never fooled by that rounding.
+- **Special units.** `Cel` and `[degF]` convert on their offset scales (`23 'Cel' = 73.4 '[degF]'`). Other special units, such as `[pH]` or `B[SPL]`, and prefixed or compound uses of `Cel`, are not converted, and special units take no part in `*` and `/`.
+- **Arbitrary units** such as `[iU]` only match the identical unit: UCUM makes them commensurable with nothing else, including each other.
+- **Calendar durations** (`year`, `month`, `week`, …) keep exactly the rules of the minimal unit system: `week` to `millisecond` equal `'wk'` to `'ms'`, while `year` and `month` are only equivalent to `'a'` and `'mo'`. Calendar units only multiply and divide with `'1'`.
+- **`*` and `/`** keep the units as written where possible: identical units add exponents (`'cm2' / 'cm'` is `'cm'`), a unit commensurable with an earlier one that has not cancelled out is converted into it (`'m/s' * 'min'` is `'m'` with factor 60), and fully cancelled units give `'1'` with their ratio (`'cm' / 'm'` is `0.01 '1'`).
+- **Errors.** Unknown or invalid units, incommensurable units and results beyond the Decimal size bound give `undefined`. Nothing throws.
+- **Bounded work.** Unit strings may come from untrusted data, so a unit whose exact magnitude needs more than 4,096 bits (about 1,200 digits) is rejected, as is a product or quotient whose unit would. The largest unit in the essence file needs 260 bits.
+
+[docs/spec-notes.md](../../docs/spec-notes.md#ucum-unit-algebra) records how these rules follow the FHIRPath and UCUM specifications.
+
+## Data and license
+
+The package contains the essence file of UCUM, `ucum-essence.xml` from [ucum-org/ucum](https://github.com/ucum-org/ucum), byte for byte as published, under the UCUM License, Version 1.1 of the Regenstrief Institute. It is not changed, subset or converted: the MIT-licensed code reads the embedded file once, when the package is first imported, and keeps the resulting tables in memory only.
+
+- [SOURCE.md](SOURCE.md): the pinned upstream commit, the checksums, the copyright notice and how the file is used.
+- [LICENSE.md](LICENSE.md): MIT for the code, and the UCUM notice for the data.
+- [UCUM-LICENSE.md](UCUM-LICENSE.md): the full UCUM license.
+
+Copyright 1999-2024 Regenstrief Institute, Inc. All rights reserved. The UCUM file is licensed under the UCUM License, Version 1.1; you may obtain a copy at <https://unitsofmeasure.org/license>. It is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+
+## Size and startup
+
+Measured with `pnpm --filter @callis/ucum measure` (after `pnpm build`) on Node.js 24.18.0, macOS on an Apple M2, 30 runs. Other machines will differ; these are measurements, not guarantees.
+
+| | Built | Minified |
+| --- | ---: | ---: |
+| Code (`dist/index.js`), gzip | 10.69 kB | 4.93 kB |
+| UCUM file as a string (`dist/essence/ucum-essence-xml.js`), gzip | 12.02 kB | 11.77 kB |
+| Total, gzip | 22.71 kB | 16.70 kB |
+
+The repository's size check (`scripts/report-size.ts`) allows 24 kB gzip for the built JavaScript, against 22.71 kB now; about 12 kB of that is the UCUM text, which cannot shrink without changing the file. The packed tarball is 76.02 kB (396 kB unpacked, with source maps and the XML file).
+
+Importing the package reads the UCUM file and resolves all 336 units and prefixes. In a fresh process this takes a median of 9.7 ms (p10 9.5 ms, p90 10.1 ms) after `@callis/core` is loaded: about 3.9 ms to read the XML and 4.2 ms to resolve the tables, plus loading the module. Earlier runs on the same machine gave medians between 9.3 and 10.0 ms, so expect variation of that order. Once V8 has optimized the code the same work takes about 1.9 ms, but it only happens once per process. A first conversion then takes about 0.3 ms, and later ones a few microseconds.

package/SOURCE.md

@@ -0,0 +1,32 @@
+# UCUM source data
+
+`data/ucum-essence.xml` is the essence file of the Unified Code for Units of Measure (UCUM), published by the Regenstrief Institute, **unchanged**: no unit, field, description or comment is added, removed or edited.
+
+| | |
+| --- | --- |
+| Repository | <https://github.com/ucum-org/ucum> |
+| Commit | `e6660c5745d460c2f5e98675594f7ae9c8efc2a3` |
+| File | `ucum-essence.xml`: UCUM version 2.2, revision date 2024-06-17 |
+| Size | 82,776 bytes |
+| SHA-256 | `dfccea1b5dc284245ebae97edd1dc03c45864da4e87df55bc9851797b4fd0b61` |
+| License | UCUM Copyright Notice and License, Version 1.1 (June 2024): [UCUM-LICENSE.md](UCUM-LICENSE.md), copied unchanged from `LICENSE.md` of the same commit (SHA-256 `b7989c84c68b7a80d42aad28cfdd824d756c2f70f26eaf1347d2e49f7838bbdf`), and at <https://unitsofmeasure.org/license> |
+
+`data/source.json` records the same checksums. The tests and `pnpm --filter @callis/ucum check:package` verify them, also in the packed package.
+
+## Notice
+
+Copyright 1999-2024 Regenstrief Institute, Inc. All rights reserved. Licensed under the UCUM License, Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <https://unitsofmeasure.org/license>.
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+The UCUM license grants no trademark rights (its section 6); the name UCUM is used here only to describe where the file comes from. Callis is not endorsed by the Regenstrief Institute.
+
+## How the package uses the file
+
+- The package contains the file twice, both times byte for byte: as `data/ucum-essence.xml`, and as one string in `dist/essence/ucum-essence-xml.js`, which `scripts/embed-essence.ts` generates from `data/ucum-essence.xml` with the notice above. The string lets the package read the file in any JavaScript runtime, without file system or network access.
+- When the package is first imported, its MIT-licensed code reads that string and builds lookup tables in memory. Nothing derived from the file is stored or distributed, and the package has no runtime dependencies.
+- The code implements behaviour that the essence file does not contain, from the [UCUM specification](https://ucum.org/ucum) text: the expression grammar, and the conversion functions of the special units `Cel` and `[degF]`. Other special units are not converted.
+
+The owner chose this approach for [T0007](../../docs/tasks/T0007-ucum.md) after checking the UCUM license: the file is redistributed whole and unmodified, with the notices its section 3(b) asks for, instead of tables generated from it.
+
+To update the file, replace `data/ucum-essence.xml` and `UCUM-LICENSE.md` with the files of a newer upstream commit, update `data/source.json` and this file, and run `pnpm --filter @callis/ucum embed`.

package/UCUM-LICENSE.md

@@ -0,0 +1,283 @@
+# UCUM Copyright Notice and License
+
+Version 1.1, June 2024
+
+The Unified Code for Units of Measure (UCUM), also known as the “UCUM
+Specification,” is copyright ©1999-2024, Regenstrief Institute, Inc. All
+rights reserved.
+
+## UNIFIED CODE FOR UNITS OF MEASURE (UCUM) A.K.A. UCUM SPECIFICATION
+
+By exercising the Licensed Rights (defined below), You accept and agree
+to be bound by the terms and conditions of this Unified Code for Units
+of Measure (UCUM) Version 1.0 License. To the extent this License may be
+interpreted as a contract, You are granted the Licensed Rights in
+consideration of Your acceptance of these terms and conditions, and the
+Licensor grants You such rights in consideration of benefits the
+Licensor receives from making the Licensed Material available under
+these terms and conditions.
+
+### Section 1. Definitions.
+
+1.1 “**Contribution**” shall mean any
+work of authorship, including the original version of the Work and any
+modifications or additions to that Work or Derivative Works thereof,
+that is intentionally submitted to Licensor for inclusion in the Work by
+the copyright owner or by an individual or Legal Entity authorized to
+submit on behalf of the copyright owner. For the purposes of this
+definition, “submitted” means any form of electronic, verbal, or written
+communication sent to the Licensor or its representatives, including but
+not limited to communication on electronic mailing lists, source code
+control systems, and issue tracking systems that are managed by, or on
+behalf of, the Licensor for the purpose of discussing and improving the
+Work, but excluding communication that is conspicuously marked or
+otherwise designated in writing by the copyright owner as “Not a
+Contribution.”
+
+1.2 “**Contributor**” shall mean
+Licensor and any individual or Legal Entity on behalf of whom a
+Contribution has been received by Licensor and subsequently incorporated
+within the Work.
+
+1.3 “**Derivative Works**” shall
+mean any work, in any form, that is based on (or derived from) the Work
+and for which the editorial revisions, annotations, elaborations, or
+other modifications represent, as a whole, an original work of
+authorship. For avoidance of doubt, a Software Application that merely
+communicates with and/or interoperates with an unmodified instance of
+the Work is not a Derivative Work.
+
+1.4 “**Legal Entity**” shall mean the
+union of the acting entity and all other entities that control, are
+controlled by, or are under common control with that entity. For the
+purposes of this definition, “control” means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether
+by contract or otherwise, or (ii) ownership of fifty percent (50%) or
+more of the outstanding shares, or (iii) beneficial ownership of such
+entity.
+
+1.5 “**Licensed Rights**” shall
+mean the rights granted to You subject to the terms and conditions of
+this License, which are limited to all copyrights that apply to Your use
+of the Work and that the Licensor has authority to license.
+
+1.6 “**License**” shall mean the terms and
+conditions for use, reproduction, and distribution as defined by
+Sections 1 through 9 of this document.
+
+1.7 “**Licensor**” shall mean the
+copyright owner or entity authorized by the copyright owner that is
+granting the License. Regenstrief Institute, Inc. is the copyright owner
+and Licensor.
+
+1.8 “**Software Application**” means any software applications developed by You to
+interact with the Work.
+
+1.9 “**Work**” shall mean the Unified Code
+For Units Of Measure (“UCUM”), including the UCUM Specification, in any
+form, made available under the License, as indicated by a copyright
+notice that is included in or attached to the work (an example is
+provided in the Appendix below).
+
+1.10 “**You**” (or “**Your**”) shall mean an individual or
+Legal Entity exercising permissions granted by this License.
+
+### Section 2. License Grant.
+
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a worldwide, non-exclusive, no-charge,
+royalty-free, revocable license to reproduce, publicly display, publicly
+perform, and distribute the Work, and to use the Work for the purposes
+of developing and commercializing Software Applications that will
+communicate with and interoperate with the Work.
+
+### Section 3. License Conditions.
+
+Your exercise of the License Grant is expressly made subject to the
+following conditions.
+
+a. You may not: 
+i. use the Work for the purpose of developing or
+promulgating a different standard for identifying units of measure; 
+ii. use the Work in any way which may dilute the Work’s purpose of providing
+a definitive standard for identifying precisely defined, unambiguous
+units of measure in electronic documents and messages; 
+iii. use the Work in any way that expressly or implicitly change its meaning; 
+iv. add, delete, or modify the Work’s content including field names, field
+contents, descriptions, and comments; or 
+v. use the Work to create Derivative Works. 
+b. Attribution. 
+  i. If you reproduce or distribute
+copies of the Work in its entirety, including but not limited to
+reproduction or distribution in connection with a Software Application, You must:
+
+1.  provide the following with the Work: a. a copyright notice; b. a
+    notice that refers to this License; c. a notice that refers to the
+    disclaimer of warranties; and d. the text of or the URL or hyperlink
+    to, this Copyright Notice and License. ii. You may satisfy the
+    conditions in Section 3(b) in any reasonable manner based on the
+    medium, means, and context in which You exercise the Licensed
+    Rights. For example, it may be reasonable to satisfy the conditions
+    by providing a URL or hyperlink that includes the required
+    information when distributing the Work by electronic download.
+
+### Section 4. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+royalty-free, irrevocable (except as stated in this section) patent
+license to make, have made, use, offer to sell, sell, import, and
+otherwise transfer the Work, where such license applies only to those
+patent claims licensable by such Contributor that are necessarily
+infringed by their Contribution(s) alone or by combination of their
+Contribution(s) with the Work to which such Contribution(s) was
+submitted. If Your institute patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Work or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses granted to
+You under this License for that Work shall terminate as of the date such
+litigation is filed.
+
+### Section 5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally
+submitted for inclusion in the Work by You to the Licensor shall be
+under the terms and conditions of this License, without any additional
+terms or conditions. Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may
+have executed with Licensor regarding such Contributions.
+
+### Section 6. Trademarks.
+
+This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as
+required for reasonable and customary use in describing the origin of
+the Work and reproducing or redistributing the Work as required by
+Section 3.
+
+### Section 7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor
+provides the Work (and each Contributor provides its Contributions) on
+an
+\*<span id="“AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND"></span>**“AS
+IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND**\*, either
+express or implied, including, without limitation, any warranties or
+conditions of
+\*<span id="TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE"></span>**TITLE,
+NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+PURPOSE**\*. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+### Section 8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including
+negligence), contract, or otherwise, unless required by applicable law
+(such as deliberate and grossly negligent acts) or agreed to in writing,
+shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any
+character arising as a result of this License or out of the use or
+inability to use the Work (including but not limited to damages for loss
+of goodwill, work stoppage, computer failure or malfunction, or any and
+all other commercial damages or losses), even if such Contributor has
+been advised of the possibility of such damages. You are responsible for
+and liable for all of Your access to and use of the Work, directly or
+indirectly, whether such access or use is permitted by or in violation
+of this Agreement. Without limiting the generality of the foregoing, You
+are responsible for the Software Applications and their use of the Work,
+if any. You agree to indemnify, defend, and hold harmless all
+Contributors and their officers, directors, employees, agents,
+affiliates, successors, and assigns from and against any and all losses,
+damages, liabilities, deficiencies, claims, actions, judgments,
+settlements, interest, awards, penalties, fines, costs, or expenses of
+whatever kind, including attorneys’ fees, arising from or relating to
+(a) Your use or misuse of the Work, (b) Your breach of this Agreement,
+and/or (c) the Software Applications. You may not enter into any
+third-party agreement that would, in any manner whatsoever, constitute
+an admission of fault by Contributors or bind Contributors in any way,
+without prior written consent of all affected Contributors.
+
+### Section 9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work, You may choose to offer acceptance of
+support, warranty, indemnity, or other liability obligations and/or
+rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You
+agree to indemnify, defend, and hold each Contributor harmless for any
+liability incurred by, or claims asserted against, such Contributor by
+reason of your accepting any such warranty or additional liability.
+
+### Section 10. Term and Termination.
+
+10.1 This License applies for the term of the copyrights licensed here.
+However, if You fail to comply with this License, then Your rights under
+this License terminate automatically.
+
+10.2 Where Your right to use the Work has terminated under Section 10,
+it reinstates: a. automatically as of the date the violation is cured,
+provided it is cured within 30 days of Your discovery of the violation;
+or b. upon express reinstatement by the Licensor. For the avoidance of
+doubt, this Section 10 does not affect any right the Licensor may have
+to seek remedies for Your violations of this License.
+
+10.3 For the avoidance of doubt, the Licensor may also offer the Work
+under separate terms or conditions or stop distributing the Work at any
+time; however, doing so will not terminate this License.
+
+10.4 Sections 1, 7, 10, and 12 survive termination of this License.
+
+### Section 11. Other Terms and Conditions.
+
+11.1 The Licensor shall not be bound by any additional or different
+terms or conditions communicated by You unless expressly agreed.
+
+11.2 Any arrangements, understandings, or agreements regarding the Work
+not stated herein are separate from and independent of the terms and
+conditions of this License.
+
+### Section 12. Interpretation.
+
+12.1 For the avoidance of doubt, this License does not, and shall not be
+interpreted to, reduce, limit, restrict, or impose conditions on any use
+of the Work that could lawfully be made without permission under this
+License.
+
+12.2 To the extent possible, if any provision of this License is deemed
+unenforceable, it shall be automatically reformed to the minimum extent
+necessary to make it enforceable. If the provision cannot be reformed,
+it shall be severed from this License without affecting the
+enforceability of the remaining terms and conditions.
+
+12.3 No term or condition of this License will be waived and no failure
+to comply consented to unless expressly agreed to by the Licensor.
+
+12.4 Nothing in this License constitutes or may be interpreted as a
+limitation upon, or waiver of, any privileges and immunities that apply
+to the Licensor or You, including from the legal processes of any
+jurisdiction or authority.
+
+## END OF TERMS AND CONDITIONS
+
+### APPENDIX: How to apply the UCUM License to your work.
+
+To apply the UCUM License to your work, attach the following boilerplate
+notice. The text should be enclosed in the appropriate comment syntax
+for the file format. We also recommend that a file or class name and
+description of purpose be included on the same “printed page” as the
+copyright notice for easier identification within third-party archives.
+
+> Copyright 1999-2024 Regenstrief Institute, Inc. All rights reserved.
+> Licensed under the UCUM License, Version 1.1 (the “License”); you may
+> not use this file except in compliance with the License. You may
+> obtain a copy of the License at
+
+> <https://unitsofmeasure.org/license>
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an
+\*<span id="“AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND"></span>**“AS
+IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND**\*, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.

package/data/source.json

@@ -0,0 +1,20 @@
+{
+  "repository": "https://github.com/ucum-org/ucum",
+  "commit": "e6660c5745d460c2f5e98675594f7ae9c8efc2a3",
+  "files": {
+    "ucum-essence.xml": {
+      "upstreamPath": "ucum-essence.xml",
+      "packagePath": "data/ucum-essence.xml",
+      "bytes": 82776,
+      "sha256": "dfccea1b5dc284245ebae97edd1dc03c45864da4e87df55bc9851797b4fd0b61",
+      "gitBlob": "ec61d23ce68da34bf10726daef7b33d70bbc1b4f"
+    },
+    "LICENSE.md": {
+      "upstreamPath": "LICENSE.md",
+      "packagePath": "UCUM-LICENSE.md",
+      "bytes": 14158,
+      "sha256": "b7989c84c68b7a80d42aad28cfdd824d756c2f70f26eaf1347d2e49f7838bbdf",
+      "gitBlob": "c31769a87daecbae90c0b3556651105383423931"
+    }
+  }
+}