@chartcoach/catalog 0.1.4 → 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chartcoach Contributors
+
+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.

package/README.md

@@ -3,7 +3,7 @@
 JavaScript models and parsers for chartcoach catalog artifacts.
 
 Read the package docs at [docs.chartcoach.dev/javascript](https://docs.chartcoach.dev/javascript).
-Read the catalog contract at [docs.chartcoach.dev/catalog](https://docs.chartcoach.dev/catalog).
+Read about the cataloging scheme at [docs.chartcoach.dev/catalog](https://docs.chartcoach.dev/catalog).
 
 Install the package from an application root:
 
@@ -14,12 +14,8 @@ npm install @chartcoach/catalog
 ```ts
 import { DEFAULT_CATALOG, loadCatalog } from "@chartcoach/catalog"
 
-const entries = await fetch(DEFAULT_CATALOG.entriesUrl).then((response) =>
-  response.arrayBuffer(),
-)
-const manifestText = await fetch(DEFAULT_CATALOG.manifestUrl).then((response) =>
-  response.text(),
-)
+const entries = await (await fetch(DEFAULT_CATALOG.entriesUrl)).arrayBuffer()
+const manifestText = await (await fetch(DEFAULT_CATALOG.manifestUrl)).text()
 
 const catalog = await loadCatalog({ entries, manifestText })
 const guideline = catalog.require("compare-percentages-with-bars-not-pies")
@@ -54,7 +50,7 @@ const entriesUrl = catalogArtifactUrl(
   catalogArtifact(metadata, "entries"),
 )
 
-const entries = await fetch(entriesUrl).then((response) => response.arrayBuffer())
+const entries = await (await fetch(entriesUrl)).arrayBuffer()
 ```
 
 Run package checks from the repository root:

package/dist/catalog/artifacts.d.ts

@@ -1,5 +1,6 @@
+export { CHARTCOACH_DEFAULTS, type ChartCoachDefaults } from "./chartcoach-defaults.js";
 export declare const DEFAULT_CATALOG: {
-    readonly version: "0.1.4";
+    readonly version: "0.1.5";
     readonly digest: "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19";
     readonly releaseRootUrl: string;
     readonly metadataUrl: string;

package/dist/catalog/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/catalog/artifacts.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAgBlF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GAAG,GAAG,EACrB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,YAAY,GACjB,kBAAkB,CAMpB"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/catalog/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOrF,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAgBlF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAEhG;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,YAAY,GACjB,kBAAkB,CAMpB"}

package/dist/catalog/artifacts.js

@@ -1,11 +1,10 @@
+import { CHARTCOACH_DEFAULTS } from "./chartcoach-defaults.js";
 import { CatalogError } from "./errors.js";
-const defaultCatalogArtifactBaseUrl = "https://artifacts.chartcoach.dev";
-const defaultCatalogDigest = "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19";
-const defaultCatalogVersion = "0.1.4";
-const defaultCatalogReleaseRootUrl = new URL(`catalog/releases/${defaultCatalogVersion}/${defaultCatalogDigest}/`, `${defaultCatalogArtifactBaseUrl}/`).toString();
+export { CHARTCOACH_DEFAULTS } from "./chartcoach-defaults.js";
+const defaultCatalogReleaseRootUrl = new URL(`catalog/releases/${CHARTCOACH_DEFAULTS.catalogVersion}/${CHARTCOACH_DEFAULTS.catalogDigest}/`, `${CHARTCOACH_DEFAULTS.catalogArtifactBaseUrl}/`).toString();
 export const DEFAULT_CATALOG = {
-    version: defaultCatalogVersion,
-    digest: defaultCatalogDigest,
+    version: CHARTCOACH_DEFAULTS.catalogVersion,
+    digest: CHARTCOACH_DEFAULTS.catalogDigest,
     releaseRootUrl: defaultCatalogReleaseRootUrl,
     metadataUrl: new URL("metadata.json", defaultCatalogReleaseRootUrl).toString(),
     entriesUrl: new URL("entries.parquet", defaultCatalogReleaseRootUrl).toString(),

package/dist/catalog/chartcoach-defaults.d.ts

@@ -0,0 +1,17 @@
+export type ChartCoachDefaults = {
+    catalogArtifactBaseUrl: string;
+    catalogDigest: string;
+    catalogVersion: string;
+    guidelineUrlTemplate: string;
+    indexTopK: number;
+    lanceDocumentTable: string;
+};
+export declare const CHARTCOACH_DEFAULTS: {
+    readonly catalogArtifactBaseUrl: "https://artifacts.chartcoach.dev";
+    readonly catalogDigest: "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19";
+    readonly catalogVersion: "0.1.5";
+    readonly guidelineUrlTemplate: "https://chartcoach.dev/guidelines/{id}";
+    readonly indexTopK: 10;
+    readonly lanceDocumentTable: "catalog_documents";
+};
+//# sourceMappingURL=chartcoach-defaults.d.ts.map

package/dist/catalog/chartcoach-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartcoach-defaults.d.ts","sourceRoot":"","sources":["../../src/catalog/chartcoach-defaults.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;CAOO,CAAC"}

package/dist/catalog/chartcoach-defaults.js

@@ -0,0 +1,8 @@
+export const CHARTCOACH_DEFAULTS = {
+    catalogArtifactBaseUrl: "https://artifacts.chartcoach.dev",
+    catalogDigest: "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19",
+    catalogVersion: "0.1.5",
+    guidelineUrlTemplate: "https://chartcoach.dev/guidelines/{id}",
+    indexTopK: 10,
+    lanceDocumentTable: "catalog_documents",
+};

package/dist/catalog/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/catalog/labels.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAU,GAAG,YAAY,CAkB1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAU,GAAG,MAAM,CAExE"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/catalog/labels.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAU,GAAG,YAAY,CAoB1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAU,GAAG,MAAM,CAExE"}

package/dist/catalog/load-parquet-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-parquet-core.d.ts","sourceRoot":"","sources":["../../src/catalog/load-parquet-core.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAWF,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,OAAO,CAAC,CAiBlB"}
+{"version":3,"file":"load-parquet-core.d.ts","sourceRoot":"","sources":["../../src/catalog/load-parquet-core.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AACtD,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ;IACE,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAWN,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB3E"}

package/dist/catalog/load-parquet-core.js

@@ -32,9 +32,7 @@ function resolveLoadCatalogInput(input) {
     }
     return {
         entries: input.entries,
-        manifest: input.manifestText === undefined
-            ? input.manifest
-            : parseCatalogManifest(input.manifestText),
+        manifest: input.manifestText === undefined ? input.manifest : parseCatalogManifest(input.manifestText),
     };
 }
 function isCatalogBytes(value) {

package/dist/catalog/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/catalog/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,eAAO,MAAM,0BAA0B,8CAA+C,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD,CAAC;AAKF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAkGtE;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,eAAe,QAkCnG"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/catalog/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,eAAO,MAAM,0BAA0B,8CAA+C,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACnD,CAAC;AAKF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CA6FtE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,QAAQ,EAAE,eAAe,QAmC1B"}

package/dist/catalog/manifest.js

@@ -13,8 +13,7 @@ export function parseCatalogManifest(markdown) {
     let currentName;
     let currentLines = [];
     function flushDefinition() {
-        if (currentHeading !== "Section Roles" &&
-            currentHeading !== "Label Families") {
+        if (currentHeading !== "Section Roles" && currentHeading !== "Label Families") {
             currentLines = [];
             return;
         }

package/dist/catalog/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/catalog/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,UAAU,CACxB,SAAS,EAAE,IAAI,CACb,SAAS,EACT,IAAI,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CACpE,GACA,MAAM,CAYR"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/catalog/markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,UAAU,CACxB,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,GAC9F,MAAM,CAYR"}

package/dist/catalog/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/catalog/model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,qBAAa,OAAQ,YAAW,QAAQ,CAAC,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;gBAElC,UAAU,GAAE,QAAQ,CAAC,SAAS,CAAM,EAAE,OAAO,GAAE,cAAmB;IAkB9E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAQ9B,MAAM,IAAI,MAAM,EAAE;IAIlB,YAAY,IAAI,MAAM,EAAE;IAQxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC;CAGzC"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/catalog/model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,qBAAa,OAAQ,YAAW,QAAQ,CAAC,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;gBAElC,UAAU,GAAE,QAAQ,CAAC,SAAS,CAAM,EAAE,OAAO,GAAE,cAAmB;IAkB9E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAQ9B,MAAM,IAAI,MAAM,EAAE;IAIlB,YAAY,IAAI,MAAM,EAAE;IAMxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC;CAGzC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { Catalog, type CatalogOptions, type Guideline, type GuidelineSection } from "./catalog/model.js";
+export { Catalog, type CatalogOptions, type Guideline, type GuidelineSection, } from "./catalog/model.js";
 export { CatalogError } from "./catalog/errors.js";
-export { DEFAULT_CATALOG, catalogArtifact, catalogArtifactUrl, parseCatalogReleaseMetadata, type ArtifactDescriptor, type ArtifactKind, type CatalogReleaseMetadata, } from "./catalog/artifacts.js";
+export { CHARTCOACH_DEFAULTS, DEFAULT_CATALOG, catalogArtifact, catalogArtifactUrl, parseCatalogReleaseMetadata, type ArtifactDescriptor, type ArtifactKind, type CatalogReleaseMetadata, type ChartCoachDefaults, } from "./catalog/artifacts.js";
 export { loadCatalog, type AsyncBuffer, type CatalogBytes, type LoadCatalogInput, type ParquetBytes, } from "./catalog/load-parquet-core.js";
 export { type CatalogManifest, type ManifestDefinition, parseCatalogManifest, } from "./catalog/manifest.js";
 export { parseLabel, type CatalogLabel } from "./catalog/labels.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-export { Catalog } from "./catalog/model.js";
+export { Catalog, } from "./catalog/model.js";
 export { CatalogError } from "./catalog/errors.js";
-export { DEFAULT_CATALOG, catalogArtifact, catalogArtifactUrl, parseCatalogReleaseMetadata, } from "./catalog/artifacts.js";
+export { CHARTCOACH_DEFAULTS, DEFAULT_CATALOG, catalogArtifact, catalogArtifactUrl, parseCatalogReleaseMetadata, } from "./catalog/artifacts.js";
 export { loadCatalog, } from "./catalog/load-parquet-core.js";
 export { parseCatalogManifest, } from "./catalog/manifest.js";
 export { parseLabel } from "./catalog/labels.js";

package/package.json

@@ -1,23 +1,20 @@
 {
   "name": "@chartcoach/catalog",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "JavaScript models and artifact parsers for the chartcoach visualization guideline catalog.",
+  "bugs": {
+    "url": "https://github.com/chartcoach/chartcoach/issues"
+  },
   "license": "MIT",
   "author": "Péter Ferenc Gyarmati <dev.petergy@gmail.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chartcoach/chartcoach.git"
   },
-  "bugs": {
-    "url": "https://github.com/chartcoach/chartcoach/issues"
-  },
   "files": [
     "dist",
     "src"
   ],
-  "publishConfig": {
-    "access": "public"
-  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,12 +25,8 @@
       "default": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -b tsconfig.build.json --force && tsc-alias -p tsconfig.build.json --resolve-full-paths --resolve-full-extension .js",
-    "lint": "oxlint . && pnpm run lint:imports",
-    "lint:imports": "node scripts/check-extensionless-imports.mjs",
-    "test": "vitest run",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
     "hyparquet": "^1.26.1",
@@ -45,5 +38,15 @@
     "tsc-alias": "^1.8.17",
     "typescript": "^5.9.3",
     "vitest": "^3.2.6"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "format": "oxfmt src test scripts package.json tsconfig.json tsconfig.build.json vitest.config.ts",
+    "format:check": "oxfmt src test scripts package.json tsconfig.json tsconfig.build.json vitest.config.ts --check",
+    "lint": "oxlint .",
+    "sync:defaults": "node scripts/sync-chartcoach-defaults.mjs",
+    "sync:defaults:check": "node scripts/sync-chartcoach-defaults.mjs --check",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}

package/src/catalog/artifacts.ts

@@ -1,17 +1,15 @@
+import { CHARTCOACH_DEFAULTS } from "./chartcoach-defaults";
 import { CatalogError } from "./errors";
+export { CHARTCOACH_DEFAULTS, type ChartCoachDefaults } from "./chartcoach-defaults";
 
-const defaultCatalogArtifactBaseUrl = "https://artifacts.chartcoach.dev";
-const defaultCatalogDigest =
-  "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19";
-const defaultCatalogVersion = "0.1.4";
 const defaultCatalogReleaseRootUrl = new URL(
-  `catalog/releases/${defaultCatalogVersion}/${defaultCatalogDigest}/`,
-  `${defaultCatalogArtifactBaseUrl}/`,
+  `catalog/releases/${CHARTCOACH_DEFAULTS.catalogVersion}/${CHARTCOACH_DEFAULTS.catalogDigest}/`,
+  `${CHARTCOACH_DEFAULTS.catalogArtifactBaseUrl}/`,
 ).toString();
 
 export const DEFAULT_CATALOG = {
-  version: defaultCatalogVersion,
-  digest: defaultCatalogDigest,
+  version: CHARTCOACH_DEFAULTS.catalogVersion,
+  digest: CHARTCOACH_DEFAULTS.catalogDigest,
   releaseRootUrl: defaultCatalogReleaseRootUrl,
   metadataUrl: new URL("metadata.json", defaultCatalogReleaseRootUrl).toString(),
   entriesUrl: new URL("entries.parquet", defaultCatalogReleaseRootUrl).toString(),
@@ -54,10 +52,7 @@ export function parseCatalogReleaseMetadata(value: unknown): CatalogReleaseMetad
   return metadata;
 }
 
-export function catalogArtifactUrl(
-  baseUrl: string | URL,
-  descriptor: ArtifactDescriptor,
-): string {
+export function catalogArtifactUrl(baseUrl: string | URL, descriptor: ArtifactDescriptor): string {
   return new URL(descriptor.path, baseUrl).toString();
 }
 

package/src/catalog/chartcoach-defaults.ts

@@ -0,0 +1,17 @@
+export type ChartCoachDefaults = {
+  catalogArtifactBaseUrl: string;
+  catalogDigest: string;
+  catalogVersion: string;
+  guidelineUrlTemplate: string;
+  indexTopK: number;
+  lanceDocumentTable: string;
+};
+
+export const CHARTCOACH_DEFAULTS = {
+  catalogArtifactBaseUrl: "https://artifacts.chartcoach.dev",
+  catalogDigest: "7cfd43ee820be252b8ae9058c4c36109a9c8415c6b3a5ff8a9127117b4a10c19",
+  catalogVersion: "0.1.5",
+  guidelineUrlTemplate: "https://chartcoach.dev/guidelines/{id}",
+  indexTopK: 10,
+  lanceDocumentTable: "catalog_documents",
+} as const satisfies ChartCoachDefaults;

package/src/catalog/labels.ts

@@ -16,7 +16,9 @@ export function parseLabel(value: unknown, context = "label"): CatalogLabel {
     .split(":")
     .map((part) => part.trim());
   if ((parts.length !== 2 && parts.length !== 3) || parts.some((part) => part.length === 0)) {
-    throw new CatalogError(`${context} must use <family>:<category> or <family>:<category>:<modifier>.`);
+    throw new CatalogError(
+      `${context} must use <family>:<category> or <family>:<category>:<modifier>.`,
+    );
   }
   const [family, category, modifier] = parts as [string, string, string | undefined];
   return {

package/src/catalog/load-parquet-core.ts

@@ -13,11 +13,13 @@ export type AsyncBuffer = {
 
 export type ParquetBytes = ArrayBuffer | ArrayBufferView;
 export type CatalogBytes = ParquetBytes | AsyncBuffer;
-export type LoadCatalogInput = CatalogBytes | {
-  entries: CatalogBytes;
-  manifest?: CatalogManifest;
-  manifestText?: string;
-};
+export type LoadCatalogInput =
+  | CatalogBytes
+  | {
+      entries: CatalogBytes;
+      manifest?: CatalogManifest;
+      manifestText?: string;
+    };
 
 function normalizeParquetBytes(bytes: ParquetBytes): ArrayBuffer {
   if (bytes instanceof ArrayBuffer) return bytes;
@@ -28,9 +30,7 @@ function normalizeParquetBytes(bytes: ParquetBytes): ArrayBuffer {
   return u8.slice().buffer;
 }
 
-export async function loadCatalog(
-  input: LoadCatalogInput,
-): Promise<Catalog> {
+export async function loadCatalog(input: LoadCatalogInput): Promise<Catalog> {
   const { entries, manifest } = resolveLoadCatalogInput(input);
   const normalizedFile =
     entries instanceof ArrayBuffer || ArrayBuffer.isView(entries)
@@ -61,9 +61,8 @@ function resolveLoadCatalogInput(input: LoadCatalogInput): {
 
   return {
     entries: input.entries,
-    manifest: input.manifestText === undefined
-      ? input.manifest
-      : parseCatalogManifest(input.manifestText),
+    manifest:
+      input.manifestText === undefined ? input.manifest : parseCatalogManifest(input.manifestText),
   };
 }
 
@@ -71,11 +70,9 @@ function isCatalogBytes(value: LoadCatalogInput): value is CatalogBytes {
   return (
     value instanceof ArrayBuffer ||
     ArrayBuffer.isView(value) ||
-    (
-      typeof value === "object" &&
+    (typeof value === "object" &&
       value !== null &&
       typeof (value as AsyncBuffer).byteLength === "number" &&
-      typeof (value as AsyncBuffer).slice === "function"
-    )
+      typeof (value as AsyncBuffer).slice === "function")
   );
 }

package/src/catalog/manifest.ts

@@ -33,10 +33,7 @@ export function parseCatalogManifest(markdown: string): CatalogManifest {
   let currentLines: string[] = [];
 
   function flushDefinition() {
-    if (
-      currentHeading !== "Section Roles" &&
-      currentHeading !== "Label Families"
-    ) {
+    if (currentHeading !== "Section Roles" && currentHeading !== "Label Families") {
       currentLines = [];
       return;
     }
@@ -87,9 +84,7 @@ export function parseCatalogManifest(markdown: string): CatalogManifest {
     ) {
       flushDefinition();
       if (!title) {
-        throw new CatalogError(
-          `Manifest heading ${currentHeading} contains an empty subheading.`,
-        );
+        throw new CatalogError(`Manifest heading ${currentHeading} contains an empty subheading.`);
       }
       currentName = title;
       currentLines = [];
@@ -119,7 +114,10 @@ export function parseCatalogManifest(markdown: string): CatalogManifest {
   };
 }
 
-export function validateManifestCoverage(guidelines: readonly Guideline[], manifest: CatalogManifest) {
+export function validateManifestCoverage(
+  guidelines: readonly Guideline[],
+  manifest: CatalogManifest,
+) {
   const usedRoles = new Set<string>();
   const usedFamilies = new Set<string>();
 

package/src/catalog/markdown.ts

@@ -3,10 +3,7 @@ import { stringify as stringifyYaml } from "yaml";
 import type { Guideline } from "./model";
 
 export function toMarkdown(
-  guideline: Pick<
-    Guideline,
-    "id" | "title" | "bibliography" | "description" | "labels" | "body"
-  >,
+  guideline: Pick<Guideline, "id" | "title" | "bibliography" | "description" | "labels" | "body">,
 ): string {
   const frontmatter = {
     id: guideline.id,

package/src/catalog/model.ts

@@ -72,9 +72,7 @@ export class Catalog implements Iterable<Guideline> {
 
   sectionRoles(): string[] {
     return sortedUnique(
-      this.guidelines.flatMap((guideline) =>
-        guideline.sections.map((section) => section.role),
-      ),
+      this.guidelines.flatMap((guideline) => guideline.sections.map((section) => section.role)),
     );
   }
 

package/src/index.ts

@@ -1,6 +1,12 @@
-export { Catalog, type CatalogOptions, type Guideline, type GuidelineSection } from "./catalog/model";
+export {
+  Catalog,
+  type CatalogOptions,
+  type Guideline,
+  type GuidelineSection,
+} from "./catalog/model";
 export { CatalogError } from "./catalog/errors";
 export {
+  CHARTCOACH_DEFAULTS,
   DEFAULT_CATALOG,
   catalogArtifact,
   catalogArtifactUrl,
@@ -8,6 +14,7 @@ export {
   type ArtifactDescriptor,
   type ArtifactKind,
   type CatalogReleaseMetadata,
+  type ChartCoachDefaults,
 } from "./catalog/artifacts";
 export {
   loadCatalog,