@graphty/graph-io 0.3.48 → 0.3.50

package/dist/chunks/{convert-BcQ8_jMo.js → convert-Ct2zelbQ.js}

@@ -1,7 +1,11 @@
 function flipY(y) {
   return y === 0 ? 0 : -y;
 }
+function yStretch(extra) {
+  return extra.pxPerUnit === void 0 || extra.pxPerUnitY === void 0 ? 1 : extra.pxPerUnitY / extra.pxPerUnit;
+}
 function toNeutral(p, extra, size, realZ) {
+  p[1] *= yStretch(extra);
   if (extra.anchor === "top-left" && size !== null) {
     p[0] += size[0] / 2;
     p[1] += extra.yAxis === "down" ? size[1] / 2 : -size[1] / 2;
@@ -15,8 +19,9 @@ function toNeutral(p, extra, size, realZ) {
 function toFilePositions(coords, extra, sizes) {
   const out = new Float64Array(coords.length);
   const down = extra.yAxis === "down";
+  const stretch = yStretch(extra);
   for (let i = 0; i < coords.length; i += 3) {
-    let y = coords[i + 1];
+    let y = coords[i + 1] / stretch;
     let z = coords[i + 2];
     if (down) {
       y = flipY(y);
@@ -56,4 +61,4 @@ export {
   toNeutral as t,
   writtenPositions as w
 };
-//# sourceMappingURL=convert-BcQ8_jMo.js.map
+//# sourceMappingURL=convert-Ct2zelbQ.js.map

package/dist/chunks/convert-Ct2zelbQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-Ct2zelbQ.js","sources":["../../src/positions/convert.ts"],"sourcesContent":["/**\n * The coordinate conversions between a file's spelling and the neutral convention (center, y up):\n * the y flip, the top-left anchor shift, and `toFilePositions()`, the inverse a writer uses. Format\n * modules import from here, so they never pull in the reader.\n */\n\nimport type { PositionColumnExtra } from \"./types.js\";\n\n/**\n * A y that grows downward as one that grows upward, and back: a negation that never yields -0.\n * @param y - the coordinate\n * @returns the flipped coordinate\n * @category Positions\n */\nexport function flipY(y: number): number {\n    return y === 0 ? 0 : -y;\n}\n\n/**\n * How much longer a unit of y is than a unit of x, for a program that stretches its axes apart.\n * @param extra - how the file spells its coordinates\n * @returns `pxPerUnitY / pxPerUnit`, 1 when either is absent\n */\nfunction yStretch(extra: PositionColumnExtra): number {\n    return extra.pxPerUnit === undefined || extra.pxPerUnitY === undefined ? 1 : extra.pxPerUnitY / extra.pxPerUnit;\n}\n\n/**\n * One coordinate from a file's spelling into the neutral convention, in place.\n * @param p - x, y, z as the file wrote them; becomes the node's center, y up\n * @param extra - how the file spells it\n * @param size - the node's width and height, for a top-left anchor; null when unknown\n * @param realZ - whether the file has a z that differs between nodes\n */\nexport function toNeutral(\n    p: [number, number, number],\n    extra: PositionColumnExtra,\n    size: readonly [number, number] | null,\n    realZ: boolean,\n): void {\n    p[1] *= yStretch(extra);\n    if (extra.anchor === \"top-left\" && size !== null) {\n        p[0] += size[0] / 2;\n        p[1] += extra.yAxis === \"down\" ? size[1] / 2 : -size[1] / 2;\n    }\n    p[2] = realZ ? p[2] - (extra.zOrigin ?? 0) : 0;\n    if (extra.yAxis === \"down\") {\n        // with a real z this turns the drawing 180 degrees about x, so a 3D shape is never mirrored\n        p[1] = flipY(p[1]);\n        p[2] = flipY(p[2]);\n    }\n}\n\n/**\n * Neutral coordinates (center, y up, as `extractPositions()` returns them) back into a column\n * spelled as `extra` declares, for a writer: the y flip, Pajek's z origin and yEd's top-left corner\n * are undone. Rows that are NaN stay NaN.\n * @param coords - x, y, z per node\n * @param extra - the spelling of the column to write\n * @param sizes - each node's width and height, needed for a top-left anchor\n * @param sizes.width - widths by node index\n * @param sizes.height - heights by node index\n * @returns a new array, x, y, z per node in the file's spelling\n * @category Positions\n */\nexport function toFilePositions(\n    coords: Float64Array,\n    extra: PositionColumnExtra,\n    sizes?: { width: Float64Array; height: Float64Array },\n): Float64Array {\n    const out = new Float64Array(coords.length);\n    const down = extra.yAxis === \"down\";\n    const stretch = yStretch(extra);\n    for (let i = 0; i < coords.length; i += 3) {\n        let y = coords[i + 1] / stretch;\n        let z = coords[i + 2];\n        if (down) {\n            y = flipY(y);\n            z = flipY(z);\n        }\n        out[i] = coords[i];\n        out[i + 1] = y;\n        out[i + 2] = z === 0 && extra.sourceDims !== 3 ? 0 : z + (extra.zOrigin ?? 0);\n        const row = i / 3;\n        if (extra.anchor === \"top-left\" && sizes !== undefined) {\n            out[i] -= sizes.width[row] / 2;\n            out[i + 1] -= down ? sizes.height[row] / 2 : -sizes.height[row] / 2;\n        }\n    }\n    return out;\n}\n\n/**\n * The median of some numbers.\n * @param values - the numbers, reordered in place\n * @returns the median, or null for none\n * @category Positions\n */\nexport function median(values: number[]): number | null {\n    if (values.length === 0) {\n        return null;\n    }\n    values.sort((a, b) => a - b);\n    const mid = values.length >> 1;\n    return values.length % 2 === 1 ? values[mid] : (values[mid - 1] + values[mid]) / 2;\n}\n\n/**\n * How each built-in writer that writes the position column as it stands spells a coordinate:\n * GML (y down, as yEd draws it) and Pajek (y down, z centered on 0.5). Every other built-in writer\n * either converts the neutral form itself (JSON, XGMML, CX, CX2, Cytoscape sessions, yEd graphics\n * in a styled GraphML) or writes a y-up format (GEXF, DOT).\n */\nconst WRITTEN_SPELLING: Readonly<Record<string, PositionColumnExtra>> = {\n    gml: { yAxis: \"down\" },\n    pajek: { yAxis: \"down\", zOrigin: 0.5 },\n};\n\n/**\n * Neutral coordinates (center, y up) as a built-in format's writer expects its position column, so\n * a graph whose positions are in the neutral form is written the way up its program draws it.\n * @example\n * ```ts\n * const column = writtenPositions(\"gml\", coords); // y flipped for GML\n * ```\n * @param format - the format being written\n * @param coords - x, y, z per node; NaN for a node with no position\n * @returns the coordinates to write (the same array when the format needs no conversion)\n * @category Positions\n */\nexport function writtenPositions(format: string, coords: Float64Array): Float64Array {\n    const spelling = WRITTEN_SPELLING[format];\n    return spelling === undefined ? coords : toFilePositions(coords, spelling);\n}\n"],"names":[],"mappings":"AAcO,SAAS,MAAM,GAAmB;AACrC,SAAO,MAAM,IAAI,IAAI,CAAC;AAC1B;AAOA,SAAS,SAAS,OAAoC;AAClD,SAAO,MAAM,cAAc,UAAa,MAAM,eAAe,SAAY,IAAI,MAAM,aAAa,MAAM;AAC1G;AASO,SAAS,UACZ,GACA,OACA,MACA,OACI;AACJ,IAAE,CAAC,KAAK,SAAS,KAAK;AACtB,MAAI,MAAM,WAAW,cAAc,SAAS,MAAM;AAC9C,MAAE,CAAC,KAAK,KAAK,CAAC,IAAI;AAClB,MAAE,CAAC,KAAK,MAAM,UAAU,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI;AAAA,EAC9D;AACA,IAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,KAAK,MAAM,WAAW,KAAK;AAC7C,MAAI,MAAM,UAAU,QAAQ;AAExB,MAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AACjB,MAAE,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;AAAA,EACrB;AACJ;AAcO,SAAS,gBACZ,QACA,OACA,OACY;AACZ,QAAM,MAAM,IAAI,aAAa,OAAO,MAAM;AAC1C,QAAM,OAAO,MAAM,UAAU;AAC7B,QAAM,UAAU,SAAS,KAAK;AAC9B,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,GAAG;AACvC,QAAI,IAAI,OAAO,IAAI,CAAC,IAAI;AACxB,QAAI,IAAI,OAAO,IAAI,CAAC;AACpB,QAAI,MAAM;AACN,UAAI,MAAM,CAAC;AACX,UAAI,MAAM,CAAC;AAAA,IACf;AACA,QAAI,CAAC,IAAI,OAAO,CAAC;AACjB,QAAI,IAAI,CAAC,IAAI;AACb,QAAI,IAAI,CAAC,IAAI,MAAM,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,MAAM,WAAW;AAC3E,UAAM,MAAM,IAAI;AAChB,QAAI,MAAM,WAAW,cAAc,UAAU,QAAW;AACpD,UAAI,CAAC,KAAK,MAAM,MAAM,GAAG,IAAI;AAC7B,UAAI,IAAI,CAAC,KAAK,OAAO,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,OAAO,GAAG,IAAI;AAAA,IACtE;AAAA,EACJ;AACA,SAAO;AACX;AAQO,SAAS,OAAO,QAAiC;AACpD,MAAI,OAAO,WAAW,GAAG;AACrB,WAAO;AAAA,EACX;AACA,SAAO,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAC3B,QAAM,MAAM,OAAO,UAAU;AAC7B,SAAO,OAAO,SAAS,MAAM,IAAI,OAAO,GAAG,KAAK,OAAO,MAAM,CAAC,IAAI,OAAO,GAAG,KAAK;AACrF;AAQA,MAAM,mBAAkE;AAAA,EACpE,KAAK,EAAE,OAAO,OAAA;AAAA,EACd,OAAO,EAAE,OAAO,QAAQ,SAAS,IAAA;AACrC;AAcO,SAAS,iBAAiB,QAAgB,QAAoC;AACjF,QAAM,WAAW,iBAAiB,MAAM;AACxC,SAAO,aAAa,SAAY,SAAS,gBAAgB,QAAQ,QAAQ;AAC7E;"}

package/dist/chunks/{credentials-BiQsnMTb.js → credentials-CmvJXYeH.js}

@@ -1,10 +1,11 @@
-import { K as ImportReportBuilder } from "./report-CgdsL9Hb.js";
+import { K as ImportReportBuilder } from "./report-CwMfYa9J.js";
 const NDEX_SOURCE_ID = "ndex";
 const CYPHER_SOURCE_ID = "cypher";
 const NEO4J_SOURCE_ID = "neo4j";
 const NEPTUNE_SOURCE_ID = "neptune";
 const REST_SOURCE_ID = "rest";
 const OPENALEX_SOURCE_ID = "openalex";
+const SPARQL_SOURCE_ID = "sparql";
 const SOURCE_ATTR_PREFIX = "_source.";
 const SOURCE_STUB_ATTR = "_source.stub";
 const SOURCE_ENTITY_ATTR = "_source.entity";
@@ -185,6 +186,34 @@ function base64(text) {
   }
   return btoa(binary);
 }
+function forSlot(slot, value, bind) {
+  if (typeof value !== "string") {
+    if (slot.kind === "basic") {
+      return new SourceCredential({ kind: "basic", username: value.username, password: value.password }, bind);
+    }
+  } else if (slot.kind === "bearer") {
+    return new SourceCredential({ kind: "bearer", token: value }, bind);
+  } else if (slot.kind === "api-key") {
+    const send = slot.send ?? { query: slot.name };
+    const header = "header" in send ? send.header : null;
+    const query = "query" in send ? send.query : null;
+    return new SourceCredential({ kind: "api-key", header, query, value }, bind);
+  }
+  return failAlone("E_SOURCE_PARAM", `a ${slot.kind} slot cannot take this value`, {
+    name: "credential",
+    reason: "type"
+  });
+}
+function credentialSlots(descriptor) {
+  if (descriptor?.credentials !== void 0) {
+    return descriptor.credentials;
+  }
+  const kind = descriptor?.auth?.[0];
+  if (kind === void 0 || descriptor?.authRequired === "none") {
+    return [];
+  }
+  return [{ name: "default", kind, required: descriptor?.authRequired === "required" }];
+}
 const credentials = Object.freeze({
   /**
    * An `Authorization: Bearer` token, or a function returning a fresh one per request.
@@ -236,11 +265,30 @@ const credentials = Object.freeze({
    */
   custom(apply, kind, bind) {
     return new SourceCredential({ kind: "custom", name: kind, apply }, bind);
-  }
+  },
+  /**
+   * The credential a source's slot describes (`credentialSlots(descriptor)`), from its plain
+   * value: an API key sent as the slot says, a bearer token, or a basic slot's user name and
+   * password.
+   * @example
+   * ```ts
+   * const [slot] = credentialSlots(openalex.descriptor); // api_key, sent as ?api_key=
+   * const credential = credentials.forSlot(slot, key);
+   * ```
+   * @param slot - the slot
+   * @param value - the key or token, or `{ username, password }` for a basic slot
+   * @param bind - the origins it may be sent to
+   * @returns the credential
+   */
+  forSlot
 });
 function secretOf(credential) {
   return SECRETS.get(credential);
 }
+function credentialQuery(credential) {
+  const secret = secretOf(credential);
+  return secret?.kind === "api-key" && secret.header === null ? secret.query ?? "api_key" : null;
+}
 async function applyCredential(credential, request) {
   const secret = secretOf(credential);
   if (secret === void 0) {
@@ -273,7 +321,7 @@ async function applyCredential(credential, request) {
       return new Request(url, request);
     }
     case "aws-sigv4": {
-      const { signRequest } = await import("./sigv4-LkAzsLAu.js");
+      const { signRequest } = await import("./sigv4-BXwVbza3.js");
       return signRequest(request, secret.options);
     }
     case "custom":
@@ -323,25 +371,28 @@ export {
   NDEX_SOURCE_ID as N,
   OPENALEX_SOURCE_ID as O,
   REST_SOURCE_ID as R,
-  SOURCE_ENTITY_ATTR as S,
+  SPARQL_SOURCE_ID as S,
   applyCredential as a,
   failAlone as b,
   credentials as c,
   defineSource as d,
-  SOURCE_STUB_ATTR as e,
+  SOURCE_ENTITY_ATTR as e,
   failOn as f,
-  NEO4J_SOURCE_ID as g,
-  NEPTUNE_SOURCE_ID as h,
-  SOURCE_FORMAT_PREFIX as i,
-  checkParams as j,
-  checkLazySource as k,
-  checkSource as l,
-  SOURCE_ATTR_PREFIX as m,
-  SOURCE_DEGREE_ATTR as n,
+  SOURCE_STUB_ATTR as g,
+  NEO4J_SOURCE_ID as h,
+  NEPTUNE_SOURCE_ID as i,
+  SOURCE_FORMAT_PREFIX as j,
+  checkParams as k,
+  credentialQuery as l,
+  checkLazySource as m,
+  checkSource as n,
   originOf as o,
-  fromStorableCredential as p,
-  storableCredential as s,
+  SOURCE_ATTR_PREFIX as p,
+  SOURCE_DEGREE_ATTR as q,
+  credentialSlots as r,
+  fromStorableCredential as s,
+  storableCredential as t,
   unwrapCredential as u,
   warnOn as w
 };
-//# sourceMappingURL=credentials-BiQsnMTb.js.map
+//# sourceMappingURL=credentials-CmvJXYeH.js.map

package/dist/chunks/credentials-CmvJXYeH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-CmvJXYeH.js","sources":["../../src/sources/ids.ts","../../src/sources/fail.ts","../../src/sources/define.ts","../../src/sources/credentials.ts"],"sourcesContent":["/**\n * The public names of network sources: one constant per built-in source id, and the reserved\n * `_source.` attribute names. Nothing else in graph-io spells them, so a rename is one edit here.\n *\n * Experimental: the ids and the `_source.` namespace await the owner's final word (design\n * section 22, items 4 and 5).\n */\n\n/**\n * The NDEx source (www.ndexbio.org). Experimental.\n * @category Network sources\n */\nexport const NDEX_SOURCE_ID = \"ndex\";\n\n/**\n * The generic Cypher source, for any openCypher server. Experimental.\n * @category Network sources\n */\nexport const CYPHER_SOURCE_ID = \"cypher\";\n\n/**\n * The Neo4j preset of the Cypher source. Experimental.\n * @category Network sources\n */\nexport const NEO4J_SOURCE_ID = \"neo4j\";\n\n/**\n * The Amazon Neptune preset of the Cypher source. Experimental.\n * @category Network sources\n */\nexport const NEPTUNE_SOURCE_ID = \"neptune\";\n\n/**\n * The generic REST mapping source. Experimental.\n * @category Network sources\n */\nexport const REST_SOURCE_ID = \"rest\";\n\n/**\n * The OpenAlex preset of the REST mapping source. Experimental.\n * @category Network sources\n */\nexport const OPENALEX_SOURCE_ID = \"openalex\";\n\n/**\n * The SPARQL source, for any SPARQL 1.1 endpoint. Experimental.\n * @category Network sources\n */\nexport const SPARQL_SOURCE_ID = \"sparql\";\n\n/**\n * The prefix of the reserved attribute namespace sources and graphty-element write facts under.\n * @category Network sources\n */\nexport const SOURCE_ATTR_PREFIX = \"_source.\";\n\n/**\n * Node attribute: true on a stub, a node known only by its id until it is hydrated or expanded.\n * @category Network sources\n */\nexport const SOURCE_STUB_ATTR = \"_source.stub\";\n\n/**\n * Node attribute: the entity a stub node is (a REST mapping's entity name).\n * @category Network sources\n */\nexport const SOURCE_ENTITY_ATTR = \"_source.entity\";\n\n/**\n * Node attribute: the node's degree at the source, when the source returns it at no extra cost\n * (the Cypher source's degree hint).\n * @category Network sources\n */\nexport const SOURCE_DEGREE_ATTR = \"_source.degree\";\n\n/**\n * The prefix of `ImportGraphResult.format` for a load from a source: `\"source:<id>\"`.\n * @category Network sources\n */\nexport const SOURCE_FORMAT_PREFIX = \"source:\";\n","/**\n * Raising a network source issue: one place that turns a code and its params into an ImportError\n * whose `issue.params` and `details` both carry the params, so callers branch on\n * `err.issue.code` and read `err.issue.params` as with every other graph-io failure.\n */\n\nimport { ImportReportBuilder } from \"../common/report.js\";\nimport { type IssueCategory } from \"../types.js\";\nimport { type SourceIssueCode } from \"./codes.js\";\n\n/** The category each code is filed under. */\nconst CATEGORY: Readonly<Partial<Record<SourceIssueCode, IssueCategory>>> = {\n    E_SOURCE_PARAM: \"validation-error\",\n    E_SOURCE_INVALID: \"validation-error\",\n    E_SOURCE_RESPONSE: \"parse-error\",\n    E_SOURCE_NOT_A_GRAPH: \"parse-error\",\n    E_SOURCE_NOT_FOUND: \"missing-value\",\n    E_SOURCE_UNKNOWN: \"missing-value\",\n};\n\n/**\n * Abort a load with a source error, carrying the load's report so far plus the error.\n * @param report - the load's report\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n * @returns never; it throws the ImportError\n */\nexport function failOn(\n    report: ImportReportBuilder,\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n): never {\n    // a fork, so a failure the runner turns into a warning (a later page's 401, a cap) leaves no\n    // error in the load's own report; the ImportError carries everything recorded so far\n    return report.fork().failWith(CATEGORY[code] ?? \"unsupported\", code, message, undefined, params, params);\n}\n\n/**\n * Raise a source error outside a load (registration, a credential factory).\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n * @param format - the report's format name\n */\nexport function failAlone(\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n    format = \"source\",\n): never {\n    failOn(new ImportReportBuilder(format, 0), code, message, params);\n}\n\n/**\n * Record a source warning on a report.\n * @param report - the report\n * @param code - the code\n * @param message - a plain-ASCII message, for logs\n * @param params - the issue's values\n */\nexport function warnOn(\n    report: ImportReportBuilder,\n    code: SourceIssueCode,\n    message: string,\n    params: Readonly<Record<string, unknown>>,\n): void {\n    report.warning(\"unsupported\", code, message, undefined, params);\n}\n","/**\n * `defineSource` and the registration checks (design section 2): the id form, exactly one read\n * method, and the declared features against the methods present. Also the parameter checks every\n * load runs against the descriptor before any request.\n */\n\nimport { type ImportReportBuilder } from \"../common/report.js\";\nimport { failAlone, failOn } from \"./fail.js\";\nimport {\n    type GraphSource,\n    type LazySource,\n    type SourceDescriptor,\n    type SourceFeature,\n    type SourceParamDescriptor,\n} from \"./types.js\";\n\n/** Lowercase letters, digits and single dashes between them. */\nconst ID_FORM = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\n/** The optional methods and the feature each one is. */\nconst FEATURE_METHODS: readonly (readonly [SourceFeature, \"expand\" | \"probe\" | \"list\" | \"validate\"])[] = [\n    [\"expand\", \"expand\"],\n    [\"probe\", \"probe\"],\n    [\"list\", \"list\"],\n    [\"validate\", \"validate\"],\n];\n\n/**\n * Refuse a malformed source.\n * @param id - the source id\n * @param reason - why\n * @param message - for logs\n */\nfunction invalid(id: string, reason: string, message: string): never {\n    failAlone(\"E_SOURCE_INVALID\", message, { id, reason });\n}\n\n/**\n * Check a source id.\n * @param id - the id\n */\nfunction checkSourceId(id: unknown): asserts id is string {\n    if (typeof id !== \"string\" || !ID_FORM.test(id)) {\n        invalid(String(id), \"id\", `source id ${JSON.stringify(id)} must be lowercase letters, digits and dashes`);\n    }\n}\n\n/**\n * The features a loaded source has, from its methods.\n * @param source - the source\n * @returns the features\n */\nfunction featuresOf(source: GraphSource<never>): readonly SourceFeature[] {\n    return FEATURE_METHODS.filter(([, method]) => typeof source[method] === \"function\").map(([f]) => f);\n}\n\n/**\n * Check a loaded source: its id, exactly one read method, and its declared features.\n * @param source - the source\n * @param declared - features a lazy registration declared, if any\n */\nexport function checkSource(source: GraphSource<never>, declared?: SourceDescriptor): void {\n    checkSourceId((source as { id?: unknown }).id);\n    const reads = ([\"records\", \"file\", \"import\"] as const).filter((m) => typeof source[m] === \"function\");\n    if (reads.length !== 1) {\n        invalid(source.id, \"read-methods\", `source ${source.id} must have exactly one of records, file and import`);\n    }\n    const features = (declared ?? source.descriptor)?.features;\n    if (features !== undefined) {\n        const has = new Set(featuresOf(source));\n        for (const f of features) {\n            if (f !== \"page\" && !has.has(f)) {\n                invalid(source.id, \"features\", `source ${source.id} declares ${f} but has no ${f} method`);\n            }\n        }\n    }\n}\n\n/**\n * Check a lazy registration before its code is loaded.\n * @param source - the lazy source\n */\nexport function checkLazySource(source: LazySource): void {\n    checkSourceId(source.id);\n    if (typeof source.load !== \"function\" || typeof source.descriptor !== \"object\") {\n        invalid(source.id, \"lazy\", `lazy source ${source.id} needs a descriptor and a load function`);\n    }\n}\n\n/**\n * Define a network source: returns it unchanged, with its parameter type inferred, after the\n * registration checks (an id of lowercase letters, digits and dashes; exactly one of `records`,\n * `file` and `import`; declared features backed by methods). A malformed source throws an\n * ImportError whose `issue.code` is E_SOURCE_INVALID. Experimental.\n * @param source - the source\n * @returns the same source\n * @example\n * ```ts\n * const people = defineSource({\n *     id: \"people\",\n *     async records(params: { team: string }, ctx) {\n *         const rows = await ctx.fetchJson<{ id: string; name: string }[]>(`/api/people?team=${params.team}`);\n *         return { nodes: rows };\n *     },\n * });\n * ```\n * @category Network sources\n */\nexport function defineSource<P>(source: GraphSource<P>): GraphSource<P> {\n    checkSource(source);\n    return source;\n}\n\n/**\n * Why a number or integer param is wrong, if it is.\n * @param p - the param's descriptor\n * @param value - the value given\n * @returns the reason, or null when it is fine\n */\nfunction numberProblem(p: SourceParamDescriptor, value: unknown): string | null {\n    if (typeof value !== \"number\" || Number.isNaN(value) || (p.type === \"integer\" && !Number.isInteger(value))) {\n        return \"type\";\n    }\n    if ((p.min !== undefined && value < p.min) || (p.max !== undefined && value > p.max)) {\n        return \"range\";\n    }\n    return null;\n}\n\n/**\n * Why a URL param is wrong, if it is.\n * @param value - the value given\n * @returns the reason, or null when it is fine\n */\nfunction urlProblem(value: unknown): string | null {\n    let url: URL;\n    try {\n        url = new URL(typeof value === \"string\" ? value : \"\");\n    } catch {\n        return \"type\";\n    }\n    return url.username !== \"\" || url.password !== \"\" ? \"credentials-in-url\" : null;\n}\n\n/**\n * Why a present param value is wrong for its descriptor, if it is.\n * @param p - the param's descriptor\n * @param value - the value given (not undefined or null)\n * @returns the reason, or null when it is fine\n */\nfunction paramProblem(p: SourceParamDescriptor, value: unknown): string | null {\n    switch (p.type) {\n        case \"integer\":\n        case \"number\":\n            return numberProblem(p, value);\n        case \"boolean\":\n            return typeof value === \"boolean\" ? null : \"type\";\n        case \"enum\":\n            return p.values !== undefined && !p.values.some((v) => v.value === value) ? \"enum\" : null;\n        case \"url\":\n            return urlProblem(value);\n        default:\n            return null;\n    }\n}\n\n/**\n * Check params against a descriptor before any request: required ones present, numbers and\n * integers in range, booleans, enums, URLs (never with a user name or password in them).\n * @param params - the caller's params\n * @param descriptor - the source's descriptor\n * @param report - the load's report\n */\nexport function checkParams(\n    params: Readonly<Record<string, unknown>>,\n    descriptor: SourceDescriptor | undefined,\n    report: ImportReportBuilder,\n): void {\n    if (typeof params !== \"object\" || (params as unknown) === null) {\n        failOn(report, \"E_SOURCE_PARAM\", \"params must be an object\", { name: \"params\", reason: \"type\" });\n    }\n    for (const p of descriptor?.params ?? []) {\n        const value = params[p.name];\n        const missing = value === undefined || value === null;\n        let reason: string | null = null;\n        if (!missing) {\n            reason = paramProblem(p, value);\n        } else if (p.required === true && p.default === undefined) {\n            reason = \"required\";\n        }\n        if (reason !== null) {\n            failOn(report, \"E_SOURCE_PARAM\", `parameter ${p.name}: ${reason}`, { name: p.name, reason });\n        }\n    }\n}\n","/**\n * Credentials (design section 6): objects made by factories, holding their secret where no code\n * can read it back. graph-io applies a credential inside `ctx.fetch`, only to the origins it is\n * bound to, and keeps nothing after a load settles.\n *\n * Experimental, with the source contract.\n */\n\nimport { failAlone } from \"./fail.js\";\nimport {\n    type AwsCredentials,\n    type Credential,\n    type CredentialKind,\n    type SourceCredentialSlot,\n    type SourceDescriptor,\n} from \"./types.js\";\n\n/**\n * Where a credential may go: the load's endpoint origin by default. Experimental.\n * @category Network sources\n */\nexport interface CredentialBind {\n    /** The origins (scheme, host and port) it may be sent to. */\n    readonly origins?: readonly string[] | undefined;\n}\n\n/**\n * The options of `credentials.awsSigV4`. Experimental.\n * @category Network sources\n */\nexport interface AwsSigV4Options {\n    /** The AWS region (\"us-east-1\"). */\n    readonly region: string;\n    /** The signing service: \"neptune-db\" (default) or \"neptune-graph\" for Neptune Analytics. */\n    readonly service?: string | undefined;\n    /** The credentials, or a function returning fresh ones per request. */\n    readonly credentials: AwsCredentials | (() => Promise<AwsCredentials>);\n}\n\n/** What only graph-io's own code can read about a credential. */\ntype Secret =\n    | { readonly kind: \"bearer\"; readonly token: string | (() => Promise<string>) }\n    | { readonly kind: \"basic\"; readonly username: string; readonly password: string }\n    | {\n          readonly kind: \"api-key\";\n          readonly header: string | null;\n          readonly query: string | null;\n          readonly value: string;\n      }\n    | { readonly kind: \"aws-sigv4\"; readonly options: AwsSigV4Options }\n    | {\n          readonly kind: \"custom\";\n          readonly name: string;\n          readonly apply: (request: Request) => Promise<Request> | Request;\n      };\n\n/** The secrets, by credential; a WeakMap so nothing reachable from the object holds them. */\nconst SECRETS = new WeakMap<Credential, Secret>();\n\n/** The key Node's util.inspect looks up. */\nconst INSPECT = Symbol.for(\"nodejs.util.inspect.custom\");\n\n/**\n * The scheme, host and port of a URL. `URL.origin` is \"null\" for schemes such as bolt+s:, so this\n * is used everywhere instead.\n * @param url - the URL\n * @returns the origin string\n */\nexport function originOf(url: URL): string {\n    return `${url.protocol}//${url.host}`;\n}\n\n/**\n * Normalize the origins a credential is bound to.\n * @param bind - the bind option\n * @returns the normalized origins\n */\nfunction bindOrigins(bind: CredentialBind | undefined): readonly string[] {\n    return Object.freeze(\n        (bind?.origins ?? []).map((o) => {\n            let url: URL;\n            try {\n                url = new URL(o);\n            } catch {\n                return failAlone(\"E_SOURCE_PARAM\", `credential origin ${JSON.stringify(o)} is not a URL`, {\n                    name: \"origins\",\n                    reason: \"origin\",\n                });\n            }\n            return originOf(url);\n        }),\n    );\n}\n\n/** The object every factory returns: kind and origins visible, the secret in SECRETS. */\nclass SourceCredential implements Credential {\n    readonly kind: CredentialKind;\n    readonly origins: readonly string[];\n    readonly username: string | undefined;\n\n    /**\n     * Create one; only the factories do.\n     * @param secret - the secret\n     * @param bind - the origins it is bound to\n     */\n    constructor(secret: Secret, bind: CredentialBind | undefined) {\n        this.kind = secret.kind === \"custom\" ? secret.name : secret.kind;\n        this.origins = bindOrigins(bind);\n        this.username = secret.kind === \"basic\" ? secret.username : undefined;\n        SECRETS.set(this, secret);\n        Object.freeze(this);\n    }\n\n    /**\n     * What JSON.stringify writes: never the secret.\n     * @returns kind, origins and a basic credential's user name\n     */\n    toJSON(): Record<string, unknown> {\n        return this.username === undefined\n            ? { kind: this.kind, origins: this.origins }\n            : { kind: this.kind, origins: this.origins, username: this.username };\n    }\n\n    /**\n     * What util.inspect and console.log show in Node: never the secret.\n     * @returns the same as toJSON\n     */\n    [INSPECT](): Record<string, unknown> {\n        return this.toJSON();\n    }\n\n    /**\n     * What string conversion shows: never the secret.\n     * @returns a description\n     */\n    toString(): string {\n        return `[Credential ${this.kind}]`;\n    }\n}\n\n/**\n * Base64 of a string's UTF-8 bytes.\n * @param text - the text\n * @returns base64\n */\nfunction base64(text: string): string {\n    let binary = \"\";\n    for (const b of new TextEncoder().encode(text)) {\n        binary += String.fromCodePoint(b);\n    }\n    return btoa(binary);\n}\n\n/**\n * The plain value a slot's credential is made from: a key or a token, or a user name and password.\n * @category Network sources\n */\nexport type SlotValue =\n    | string\n    | {\n          /** A basic slot's user name. */\n          readonly username: string;\n          /** A basic slot's password. */\n          readonly password: string;\n      };\n\n/**\n * The credential a slot describes, from its plain value.\n * @param slot - the slot\n * @param value - the key or token, or a basic slot's user name and password\n * @param bind - the origins it may be sent to\n * @returns the credential\n */\nfunction forSlot(slot: SourceCredentialSlot, value: SlotValue, bind?: CredentialBind): Credential {\n    if (typeof value !== \"string\") {\n        if (slot.kind === \"basic\") {\n            return new SourceCredential({ kind: \"basic\", username: value.username, password: value.password }, bind);\n        }\n    } else if (slot.kind === \"bearer\") {\n        return new SourceCredential({ kind: \"bearer\", token: value }, bind);\n    } else if (slot.kind === \"api-key\") {\n        const send = slot.send ?? { query: slot.name };\n        const header = \"header\" in send ? send.header : null;\n        const query = \"query\" in send ? send.query : null;\n        return new SourceCredential({ kind: \"api-key\", header, query, value }, bind);\n    }\n    return failAlone(\"E_SOURCE_PARAM\", `a ${slot.kind} slot cannot take this value`, {\n        name: \"credential\",\n        reason: \"type\",\n    });\n}\n\n/**\n * The credential slots a source takes: the ones its descriptor declares, else one slot `default`\n * of its first credential kind when it takes a credential (`auth`), else none. Experimental.\n * @param descriptor - the source's descriptor\n * @returns the slots\n * @category Network sources\n */\nexport function credentialSlots(descriptor: SourceDescriptor | undefined): readonly SourceCredentialSlot[] {\n    if (descriptor?.credentials !== undefined) {\n        return descriptor.credentials;\n    }\n    const kind = descriptor?.auth?.[0];\n    if (kind === undefined || descriptor?.authRequired === \"none\") {\n        return [];\n    }\n    return [{ name: \"default\", kind, required: descriptor?.authRequired === \"required\" }];\n}\n\n/**\n * The factories that make credentials. Pass the result as the `credential` option of a load; it is\n * sent only to the load's endpoint origin, or to `bind.origins` when you give them. Experimental.\n * @example\n * ```ts\n * await loadFromSource(\"people\", { team: \"core\" }, {\n *     endpoint: \"https://example.com\",\n *     credential: credentials.bearer(token),\n * });\n * ```\n * @category Network sources\n */\nexport const credentials = Object.freeze({\n    /**\n     * An `Authorization: Bearer` token, or a function returning a fresh one per request.\n     * @param token - the token or a function returning it\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    bearer(token: string | (() => Promise<string>), bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"bearer\", token }, bind);\n    },\n    /**\n     * HTTP basic authentication (a database user and password).\n     * @param username - the user name\n     * @param password - the password\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    basic(username: string, password: string, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"basic\", username, password }, bind);\n    },\n    /**\n     * An API key sent in a request header or a query parameter.\n     * @param where - `{ header: \"X-Api-Key\" }` or `{ query: \"api_key\" }`\n     * @param value - the key\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    apiKey(\n        where: { readonly header: string } | { readonly query: string },\n        value: string,\n        bind?: CredentialBind,\n    ): Credential {\n        const header = \"header\" in where ? where.header : null;\n        const query = \"query\" in where ? where.query : null;\n        return new SourceCredential({ kind: \"api-key\", header, query, value }, bind);\n    },\n    /**\n     * AWS Signature Version 4 (Amazon Neptune). The signer loads on first use.\n     * @param options - region, service and the credentials or a provider of them\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    awsSigV4(options: AwsSigV4Options, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"aws-sigv4\", options }, bind);\n    },\n    /**\n     * Anything else: a function that returns the request with its authentication added. The\n     * request's origin must not change.\n     * @param apply - adds the authentication\n     * @param kind - what to call it in `credential.kind`\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    custom(apply: (request: Request) => Promise<Request> | Request, kind: string, bind?: CredentialBind): Credential {\n        return new SourceCredential({ kind: \"custom\", name: kind, apply }, bind);\n    },\n    /**\n     * The credential a source's slot describes (`credentialSlots(descriptor)`), from its plain\n     * value: an API key sent as the slot says, a bearer token, or a basic slot's user name and\n     * password.\n     * @example\n     * ```ts\n     * const [slot] = credentialSlots(openalex.descriptor); // api_key, sent as ?api_key=\n     * const credential = credentials.forSlot(slot, key);\n     * ```\n     * @param slot - the slot\n     * @param value - the key or token, or `{ username, password }` for a basic slot\n     * @param bind - the origins it may be sent to\n     * @returns the credential\n     */\n    forSlot,\n});\n\n/**\n * The secret of a credential made by the factories, or undefined for any other object.\n * @param credential - the credential\n * @returns the secret\n */\nfunction secretOf(credential: Credential): Secret | undefined {\n    return SECRETS.get(credential);\n}\n\n/**\n * Whether an object is a credential made by the `credentials` factories.\n * @param value - the value\n * @returns true for a factory-made credential\n */\nexport function isCredential(value: unknown): value is Credential {\n    return typeof value === \"object\" && value !== null && secretOf(value as Credential) !== undefined;\n}\n\n/**\n * The request header a credential sets, for the browser checks; null for a query key or a custom one.\n * @param credential - the credential\n * @returns the header name, lowercase\n */\nexport function credentialHeader(credential: Credential): string | null {\n    const secret = secretOf(credential);\n    if (secret?.kind === \"api-key\") {\n        return secret.header?.toLowerCase() ?? null;\n    }\n    return secret?.kind === \"bearer\" || secret?.kind === \"basic\" || secret?.kind === \"aws-sigv4\"\n        ? \"authorization\"\n        : null;\n}\n\n/**\n * The query parameter a credential is sent in, so a cursor can leave it out; null for one sent in\n * a header or not at all.\n * @param credential - the credential\n * @returns the parameter's name\n */\nexport function credentialQuery(credential: Credential): string | null {\n    const secret = secretOf(credential);\n    return secret?.kind === \"api-key\" && secret.header === null ? (secret.query ?? \"api_key\") : null;\n}\n\n/**\n * Add a credential to a request. Internal to graph-io: only `ctx.fetch` calls it.\n * @param credential - the credential\n * @param request - the request\n * @returns the request with its authentication\n */\nexport async function applyCredential(credential: Credential, request: Request): Promise<Request> {\n    const secret = secretOf(credential);\n    if (secret === undefined) {\n        return failAlone(\"E_SOURCE_PARAM\", \"the credential was not made by the credentials factories\", {\n            name: \"credential\",\n            reason: \"type\",\n        });\n    }\n    switch (secret.kind) {\n        case \"bearer\": {\n            const token = typeof secret.token === \"string\" ? secret.token : await secret.token();\n            const headers = new Headers(request.headers);\n            headers.set(\"Authorization\", `Bearer ${token}`);\n            return new Request(request, { headers });\n        }\n        case \"basic\": {\n            const headers = new Headers(request.headers);\n            const pair = `${secret.username}:${secret.password}`;\n            headers.set(\"Authorization\", `Basic ${base64(pair)}`);\n            return new Request(request, { headers });\n        }\n        case \"api-key\": {\n            if (secret.header !== null) {\n                const headers = new Headers(request.headers);\n                headers.set(secret.header, secret.value);\n                return new Request(request, { headers });\n            }\n            const url = new URL(request.url);\n            url.searchParams.set(secret.query ?? \"api_key\", secret.value);\n            return new Request(url, request);\n        }\n        case \"aws-sigv4\": {\n            const { signRequest } = await import(\"./sigv4.js\");\n            return signRequest(request, secret.options);\n        }\n        case \"custom\":\n            return secret.apply(request);\n        default:\n            return request;\n    }\n}\n\n/**\n * The raw secret, for a transport that must hand it to a driver (Bolt). Internal to graph-io; the\n * caller applies the origin and TLS rules itself.\n * @param credential - the credential\n * @returns the kind and the values the driver needs\n */\nexport function unwrapCredential(\n    credential: Credential,\n):\n    | { readonly kind: \"basic\"; readonly username: string; readonly password: string }\n    | { readonly kind: \"bearer\"; readonly token: string | (() => Promise<string>) }\n    | { readonly kind: CredentialKind }\n    | undefined {\n    const secret = secretOf(credential);\n    if (secret?.kind === \"basic\") {\n        return { kind: \"basic\", username: secret.username, password: secret.password };\n    }\n    if (secret?.kind === \"bearer\") {\n        return { kind: \"bearer\", token: secret.token };\n    }\n    return secret === undefined ? undefined : { kind: credential.kind };\n}\n\n/**\n * Whether a credential can be remembered: its secret is a plain value, not a function. A token\n * refresher, a custom credential and an AWS provider cannot.\n * @param credential - the credential\n * @returns true for basic, a bearer string token and an API key\n */\nexport function isStorableCredential(credential: Credential): boolean {\n    const secret = secretOf(credential);\n    return (\n        secret?.kind === \"basic\" ||\n        secret?.kind === \"api-key\" ||\n        (secret?.kind === \"bearer\" && typeof secret.token === \"string\")\n    );\n}\n\n/**\n * The plain parts of a credential that can be remembered. Experimental.\n * @category Network sources\n */\nexport type StorableCredential =\n    | {\n          /** A user name and password, sent as HTTP Basic authentication. */\n          readonly kind: \"basic\";\n          /** The user name. */\n          readonly username: string;\n          /** The password. */\n          readonly password: string;\n      }\n    | {\n          /** A bearer token, sent in the Authorization header. */\n          readonly kind: \"bearer\";\n          /** The token. */\n          readonly token: string;\n      }\n    | {\n          /** An API key, sent in a header or a query parameter. */\n          readonly kind: \"api-key\";\n          /** The header that carries the key, or null when a query parameter does. */\n          readonly header: string | null;\n          /** The query parameter that carries the key, or null when a header does. */\n          readonly query: string | null;\n          /** The key. */\n          readonly value: string;\n      };\n\n/**\n * The parts of a credential a credential store saves (graphty-element's `CredentialStore` is the\n * one caller), or null when it cannot be saved: a token function, an AWS provider or a custom\n * credential. The result HOLDS THE SECRET: never log it, and keep it only where you would keep the\n * password itself. `fromStorableCredential` makes the credential again. Experimental.\n * @param credential - a credential made by the `credentials` factories\n * @returns the parts, or null\n * @category Network sources\n */\nexport function storableCredential(credential: Credential): StorableCredential | null {\n    const secret = secretOf(credential);\n    switch (secret?.kind) {\n        case \"basic\":\n            return { kind: \"basic\", username: secret.username, password: secret.password };\n        case \"api-key\":\n            return { kind: \"api-key\", header: secret.header, query: secret.query, value: secret.value };\n        case \"bearer\":\n            return typeof secret.token === \"string\" ? { kind: \"bearer\", token: secret.token } : null;\n        default:\n            return null;\n    }\n}\n\n/**\n * The credential `storableCredential` took apart, bound to the origins given. Experimental.\n * @param parts - what `storableCredential` returned\n * @param bind - the origins it may be sent to\n * @returns the credential\n * @category Network sources\n */\nexport function fromStorableCredential(parts: StorableCredential, bind?: CredentialBind): Credential {\n    switch (parts.kind) {\n        case \"basic\":\n            return credentials.basic(parts.username, parts.password, bind);\n        case \"bearer\":\n            return credentials.bearer(parts.token, bind);\n        default:\n            return new SourceCredential(\n                { kind: \"api-key\", header: parts.header, query: parts.query, value: parts.value },\n                bind,\n            );\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/{cx-export-BEeF6ymo.js → cx-export-Bt6NoqTQ.js}

@@ -1,6 +1,6 @@
 import { GraphFormatError } from "@graphty/graph-format";
-import { L as LOSS } from "./export-CZ7VRm4I.js";
-import { p as plural, a as agree } from "./report-CgdsL9Hb.js";
+import { L as LOSS } from "./export-Cha4dRFz.js";
+import { p as plural, a as agree } from "./report-CwMfYa9J.js";
 const RAW = `${String.fromCodePoint(0)}cx:`;
 const RAW_JSON = /"\\u0000cx:(-?\d+)"/g;
 const BIG_INTEGER_TEXT = /^-?[1-9]\d{15,}$/;
@@ -256,4 +256,4 @@ export {
   planNodeIds as p,
   stringify as s
 };
-//# sourceMappingURL=cx-export-BEeF6ymo.js.map
+//# sourceMappingURL=cx-export-Bt6NoqTQ.js.map

package/dist/chunks/{cx-export-BEeF6ymo.js.map → cx-export-Bt6NoqTQ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"cx-export-BEeF6ymo.js","sources":["../../src/common/cx-export.ts"],"sourcesContent":["/**\n * The exporter machinery CX version 1 and CX2 share (design/graph-io/cytoscape-and-obo/design.md\n * sections 1.2 and 1.3): integer node ids (safe integers, or the digits of an integer beyond 2^53\n * written raw), sanitizeIds \"mangle\" renumbering, edge ids from the id role column, the declared\n * type of a column, the direction notes (every CX edge is directed) and the JSON writer that keeps\n * -0 and raw big integers.\n */\n\nimport { type Column, GraphFormatError, type GraphSnapshot, type NodeId } from \"@graphty/graph-format\";\n\nimport { type LossNote } from \"../types.js\";\nimport { type PairFolding } from \"./direction.js\";\nimport { LOSS } from \"./export.js\";\nimport { type ResolvedExportOptions } from \"./options.js\";\nimport { agree, plural } from \"./plural.js\";\n\n/**\n * Records a loss note.\n * @category Plugin helpers\n */\nexport type CxNoteFn = (code: string, message: string, column?: string | null, count?: number | null) => void;\n\n/**\n * The prefix of a string that stands for a raw number literal in the output: -0 (which\n * JSON.stringify writes as 0) and an integer id beyond 2^53 (kept as its digits).\n */\nconst RAW = `${String.fromCodePoint(0)}cx:`;\n\n/** A raw literal as JSON.stringify writes it, to be unquoted. */\nconst RAW_JSON = /\"\\\\u0000cx:(-?\\d+)\"/g;\n\n/** An integer literal beyond 2^53 as text: a CX id graph-io keeps as its digits. */\nconst BIG_INTEGER_TEXT = /^-?[1-9]\\d{15,}$/;\n\n/**\n * The node ids as written: the original, a renumbered one, or a raw big integer.\n * @category Plugin helpers\n */\nexport interface WrittenIds {\n    /** How many ids were renumbered (sanitizeIds \"mangle\"). */\n    readonly changed: number;\n    /**\n     * The written id of a node.\n     * @param i - the node index\n     * @returns a number, or a raw string for a big integer\n     */\n    idAt(i: number): NodeId;\n    /**\n     * Whether a node was renumbered.\n     * @param i - the node index\n     * @returns true when its original goes into graphty:originalId\n     */\n    isChanged(i: number): boolean;\n    /**\n     * The original id of a node.\n     * @param i - the node index\n     * @returns the snapshot's id\n     */\n    originalAt(i: number): NodeId;\n}\n\n/**\n * Whether an id can be written as a CX id unchanged: a safe integer, or the digits of an integer\n * beyond 2^53 (the CX importers read those back as the same digits).\n * @param id - the id\n * @returns true when writable\n */\nfunction writableId(id: NodeId): boolean {\n    return typeof id === \"number\"\n        ? Number.isSafeInteger(id)\n        : BIG_INTEGER_TEXT.test(id) && !Number.isSafeInteger(Number(id));\n}\n\n/**\n * The written node ids; under \"error\" an id that is not writable throws E_INVALID_ID, under\n * \"mangle\" it gets the next unused integer.\n * @param snapshot - the snapshot\n * @param mode - the sanitizeIds option\n * @param format - the format's display name, for the message\n * @returns the ids\n */\nfunction writtenIds(snapshot: GraphSnapshot, mode: \"error\" | \"mangle\", format: string): WrittenIds {\n    const { ids } = snapshot;\n    const bad: number[] = [];\n    const used = new Set<number>();\n    for (let i = 0; i < ids.size; i++) {\n        const id = ids.idOf(i);\n        if (!writableId(id)) {\n            bad.push(i);\n        } else if (typeof id === \"number\") {\n            used.add(id);\n        }\n    }\n    if (bad.length > 0 && mode === \"error\") {\n        const first = ids.idOf(bad[0]);\n        throw new GraphFormatError(\n            \"E_INVALID_ID\",\n            `${bad.length} node id${plural(bad.length)} cannot be written as ${format} integers (first: ${JSON.stringify(first)} at index ${bad[0]}); pass sanitizeIds: \"mangle\" to rewrite them`,\n            { reason: \"charset\", charset: \"integer\", count: bad.length, index: bad[0] },\n        );\n    }\n    const renumbered = new Map<number, number>();\n    let next = 0;\n    for (const i of bad) {\n        while (used.has(next)) {\n            next++;\n        }\n        used.add(next);\n        renumbered.set(i, next);\n    }\n    return {\n        changed: bad.length,\n        idAt: (i: number): NodeId => {\n            const id = renumbered.get(i) ?? ids.idOf(i);\n            return typeof id === \"string\" ? `${RAW}${id}` : id;\n        },\n        isChanged: (i: number): boolean => renumbered.has(i),\n        originalAt: (i: number): NodeId => ids.idOf(i),\n    };\n}\n\n/**\n * The `idCounter` of the node ids as written (the largest id plus one, NDEx's next free id).\n * @param ids - the written ids\n * @param count - the node count\n * @returns the counter: a number, or a raw big integer for stringify()\n * @category Plugin helpers\n */\nexport function nextNodeId(ids: WrittenIds, count: number): NodeId {\n    let max = -1n;\n    for (let i = 0; i < count; i++) {\n        const id = ids.idAt(i);\n        const value = typeof id === \"number\" ? BigInt(id) : BigInt(id.slice(RAW.length));\n        if (value > max) {\n            max = value;\n        }\n    }\n    const next = max + 1n;\n    return next <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(next) : `${RAW}${next.toString()}`;\n}\n\n/**\n * How many node ids are not writable unchanged.\n * @param snapshot - the snapshot\n * @returns the count\n */\nfunction unwritableIds(snapshot: GraphSnapshot): number {\n    let count = 0;\n    for (let i = 0; i < snapshot.ids.size; i++) {\n        if (!writableId(snapshot.ids.idOf(i))) {\n            count++;\n        }\n    }\n    return count;\n}\n\n/**\n * The id notes and the written ids of a CX export: E_ID_CHARSET (export() throws) or\n * W_ID_MANGLED for the ids that are not integers.\n * @param snapshot - the snapshot\n * @param common - the resolved common options\n * @param format - the format's display name\n * @param attribute - the attribute the originals are kept in\n * @param note - records a note\n * @returns the ids, or the error export() throws\n * @category Plugin helpers\n */\nexport function planNodeIds(\n    snapshot: GraphSnapshot,\n    common: ResolvedExportOptions,\n    format: string,\n    attribute: string,\n    note: CxNoteFn,\n): WrittenIds | GraphFormatError {\n    const unwritable = unwritableIds(snapshot);\n    if (unwritable > 0) {\n        note(\n            common.sanitizeIds === \"mangle\" ? LOSS.ID_MANGLED : LOSS.ID_CHARSET,\n            common.sanitizeIds === \"mangle\"\n                ? `${unwritable} node id${plural(unwritable)} ${agree(unwritable, \"is\", \"are\")} not integers, so they are renumbered; the original ids are written to the ${attribute} attribute, and an import with restoreMangledIds: true reads them back`\n                : `${unwritable} node id${plural(unwritable)} ${agree(unwritable, \"is\", \"are\")} not integers, so the save fails unless sanitizeIds is \"mangle\"`,\n            null,\n            unwritable,\n        );\n    }\n    try {\n        return writtenIds(snapshot, common.sanitizeIds, format);\n    } catch (err) {\n        if (err instanceof GraphFormatError) {\n            return err;\n        }\n        throw err;\n    }\n}\n\n/**\n * The CX type of a scalar dtype.\n * @param dtype - the dtype\n * @param longOrigin - whether the source declared the column long\n * @returns the type text\n */\nfunction scalarType(dtype: string, longOrigin: boolean): string {\n    switch (dtype) {\n        case \"f64\":\n            return longOrigin ? \"long\" : \"double\";\n        case \"f32\":\n            return \"double\";\n        case \"i32\":\n        case \"u8\":\n            return \"integer\";\n        case \"u32\":\n            return \"long\";\n        case \"bool\":\n            return \"boolean\";\n        default:\n            return \"string\";\n    }\n}\n\n/**\n * Whether every set value of an f64 column is integral (so a declared long stays long).\n * @param column - the column\n * @returns true when every set value is a safe integer\n */\nfunction allIntegral(column: Column): boolean {\n    for (let i = 0; i < column.length; i++) {\n        if (column.isSet(i) && !Number.isSafeInteger(column.value(i))) {\n            return false;\n        }\n    }\n    return true;\n}\n\n/**\n * The declared CX type of a column: string / double / long / integer / boolean or a list of one;\n * a json column (and a list of json items) is a string holding JSON text.\n * @param column - the column\n * @returns the type text\n * @category Plugin helpers\n */\nexport function declaredType(column: Column): string {\n    const { meta } = column;\n    const origin = meta.origin?.type ?? null;\n    const longOrigin = origin !== null && origin.endsWith(\"long\") && (meta.dtype !== \"f64\" || allIntegral(column));\n    if (meta.dtype === \"list\") {\n        return meta.itemDtype === null || meta.itemDtype === \"json\"\n            ? \"string\"\n            : `list_of_${scalarType(meta.itemDtype, longOrigin)}`;\n    }\n    // a multi-component column (a color, a 3D vector) is written as a list of its components\n    return meta.components > 1 ? `list_of_${scalarType(meta.dtype, false)}` : scalarType(meta.dtype, longOrigin);\n}\n\n/**\n * Count the positions with a non-finite x or y.\n * @param position - the position column\n * @returns the count\n * @category Plugin helpers\n */\nexport function nonFinitePositions(position: Column): number {\n    let count = 0;\n    for (let i = 0; i < position.length; i++) {\n        if (position.isSet(i)) {\n            const p = position.value(i) as ArrayLike<number>;\n            if (!Number.isFinite(p[0]) || !Number.isFinite(p[1])) {\n                count++;\n            }\n        }\n    }\n    return count;\n}\n\n/**\n * The edge ids to write: the id role column's values when they are distinct safe integers, next\n * unused integers for edges without one (W_EDGE_IDS_GENERATED). A generated id is never a\n * written node id either: CX keeps node and edge ids apart, but Cytoscape desktop numbers both\n * from one counter, and a reader with one id space (Cytoscape.js) would have to drop the edge's.\n * @param snapshot - the snapshot\n * @param note - records a note\n * @param nodeIds - the written node ids, which generated edge ids avoid\n * @returns one id per edge\n * @category Plugin helpers\n */\nexport function planEdgeIds(snapshot: GraphSnapshot, note: CxNoteFn, nodeIds: WrittenIds | null = null): number[] {\n    const column = snapshot.edges.byRole(\"id\");\n    const used = new Set<number>();\n    let generated = 0;\n    const ids: (number | null)[] = keptEdgeIds(column, snapshot.edgeCount, used);\n    for (let i = 0; nodeIds !== null && i < snapshot.nodeCount; i++) {\n        const id = nodeIds.idAt(i);\n        if (typeof id === \"number\") {\n            used.add(id);\n        }\n    }\n    let next = 0;\n    const out: number[] = [];\n    for (let e = 0; e < snapshot.edgeCount; e++) {\n        let id = ids[e];\n        if (id === null) {\n            while (used.has(next)) {\n                next++;\n            }\n            id = next;\n            used.add(next);\n            generated++;\n        }\n        out.push(id);\n    }\n    if (column !== null && generated > 0) {\n        note(\n            LOSS.EDGE_IDS_GENERATED,\n            `${generated} edge${plural(generated)} ${agree(generated, \"has\", \"have\")} no distinct integer id in \"${column.meta.name}\"; they are written with generated ids`,\n            column.meta.name,\n            generated,\n        );\n    }\n    if (column !== null && column.dtype !== \"f64\") {\n        note(\n            LOSS.DTYPE,\n            `edge id column \"${column.meta.name}\" is ${column.dtype}; CX edge ids are integers and read back as f64`,\n            column.meta.name,\n            snapshot.edgeCount - column.nullCount,\n        );\n    }\n    return out;\n}\n\n/**\n * The edge ids an id column can keep: its distinct safe integers (numbers, or text that reads as one).\n * @param column - the edge id column, or null\n * @param edgeCount - the number of edges\n * @param used - receives the kept ids\n * @returns the kept id per edge, null where it cannot be kept\n */\nfunction keptEdgeIds(column: Column | null, edgeCount: number, used: Set<number>): (number | null)[] {\n    const ids: (number | null)[] = new Array<number | null>(edgeCount).fill(null);\n    if (column === null) {\n        return ids;\n    }\n    for (let e = 0; e < edgeCount; e++) {\n        const value = column.isSet(e) ? column.value(e) : undefined;\n        const n = typeof value === \"number\" || typeof value === \"string\" ? Number(value) : Number.NaN;\n        if (Number.isSafeInteger(n) && !used.has(n)) {\n            ids[e] = n === 0 ? 0 : n;\n            used.add(n);\n        }\n    }\n    return ids;\n}\n\n/**\n * The direction notes: every CX edge is directed, so an undirected snapshot (or the undirected\n * pairs of a mixed one, folded under onMixedDirection) is written directed, and a mutual pair as\n * two edges without its mark.\n * @param snapshot - the snapshot\n * @param folding - the pair folding\n * @param common - the resolved common options\n * @param undirectedCode - the format's \"undirected written as directed\" code\n * @param note - records a note\n * @category Plugin helpers\n */\nexport function directionNotes(\n    snapshot: GraphSnapshot,\n    folding: PairFolding,\n    common: ResolvedExportOptions,\n    undirectedCode: string,\n    note: CxNoteFn,\n): void {\n    if (!snapshot.directed) {\n        note(\n            undirectedCode,\n            `the snapshot is undirected; every edge is written as a directed edge (${snapshot.edgeCount} edge${plural(snapshot.edgeCount)})`,\n            null,\n            snapshot.edgeCount,\n        );\n    } else if (common.onMixedDirection !== \"error\") {\n        let undirected = 0;\n        for (let e = 0; e < snapshot.edgeCount; e++) {\n            if (!folding.folded(e) && !folding.sourceDirected(e)) {\n                undirected++;\n            }\n        }\n        if (undirected > 0) {\n            note(\n                undirectedCode,\n                `${undirected} undirected edge${plural(undirected)} ${agree(undirected, \"is\", \"are\")} written as one directed edge each (a pair folded to its primary); CX has no undirected edge`,\n                null,\n                undirected,\n            );\n        }\n    }\n    if (folding.mutualCount > 0) {\n        note(\n            LOSS.MUTUAL_EXPANDED,\n            `${folding.mutualCount} mutual pair${plural(folding.mutualCount)} ${agree(folding.mutualCount, \"is\", \"are\")} written as two directed edges; the mutual mark is lost`,\n            null,\n            folding.mutualCount,\n        );\n    }\n}\n\n/**\n * The note recorder of a plan and its notes.\n * @returns the notes and the recorder\n * @category Plugin helpers\n */\nexport function noteList(): { notes: LossNote[]; note: CxNoteFn } {\n    const notes: LossNote[] = [];\n    const note: CxNoteFn = (code, message, column = null, count = null) => {\n        notes.push(Object.freeze({ code, message, column, count }));\n    };\n    return { notes, note };\n}\n\n/**\n * The JSON text of a value, keeping -0 and writing the raw big-integer ids of idAt() as numbers.\n * @param value - the value\n * @returns the text\n * @category Plugin helpers\n */\nexport function stringify(value: unknown): string {\n    const text = JSON.stringify(value, (_key, v: unknown) => (Object.is(v, -0) ? `${RAW}-0` : v));\n    return text.includes(String.raw`\\u0000cx:`) ? text.replaceAll(RAW_JSON, \"$1\") : text;\n}\n\n/**\n * The text of one aspect block, element by element.\n * @param aspect - the aspect name\n * @param elements - the JSON texts of its elements\n * @yields the block's text\n * @returns nothing\n */\nexport function* aspectBlock(aspect: string, elements: Iterable<string>): Generator<string, void, undefined> {\n    yield `{${JSON.stringify(aspect)}:[`;\n    let first = true;\n    for (const element of elements) {\n        yield first ? `\\n${element}` : `,\\n${element}`;\n        first = false;\n    }\n    yield \"]},\\n\";\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"cx-export-Bt6NoqTQ.js","sources":["../../src/common/cx-export.ts"],"sourcesContent":["/**\n * The exporter machinery CX version 1 and CX2 share (design/graph-io/cytoscape-and-obo/design.md\n * sections 1.2 and 1.3): integer node ids (safe integers, or the digits of an integer beyond 2^53\n * written raw), sanitizeIds \"mangle\" renumbering, edge ids from the id role column, the declared\n * type of a column, the direction notes (every CX edge is directed) and the JSON writer that keeps\n * -0 and raw big integers.\n */\n\nimport { type Column, GraphFormatError, type GraphSnapshot, type NodeId } from \"@graphty/graph-format\";\n\nimport { type LossNote } from \"../types.js\";\nimport { type PairFolding } from \"./direction.js\";\nimport { LOSS } from \"./export.js\";\nimport { type ResolvedExportOptions } from \"./options.js\";\nimport { agree, plural } from \"./plural.js\";\n\n/**\n * Records a loss note.\n * @category Plugin helpers\n */\nexport type CxNoteFn = (code: string, message: string, column?: string | null, count?: number | null) => void;\n\n/**\n * The prefix of a string that stands for a raw number literal in the output: -0 (which\n * JSON.stringify writes as 0) and an integer id beyond 2^53 (kept as its digits).\n */\nconst RAW = `${String.fromCodePoint(0)}cx:`;\n\n/** A raw literal as JSON.stringify writes it, to be unquoted. */\nconst RAW_JSON = /\"\\\\u0000cx:(-?\\d+)\"/g;\n\n/** An integer literal beyond 2^53 as text: a CX id graph-io keeps as its digits. */\nconst BIG_INTEGER_TEXT = /^-?[1-9]\\d{15,}$/;\n\n/**\n * The node ids as written: the original, a renumbered one, or a raw big integer.\n * @category Plugin helpers\n */\nexport interface WrittenIds {\n    /** How many ids were renumbered (sanitizeIds \"mangle\"). */\n    readonly changed: number;\n    /**\n     * The written id of a node.\n     * @param i - the node index\n     * @returns a number, or a raw string for a big integer\n     */\n    idAt(i: number): NodeId;\n    /**\n     * Whether a node was renumbered.\n     * @param i - the node index\n     * @returns true when its original goes into graphty:originalId\n     */\n    isChanged(i: number): boolean;\n    /**\n     * The original id of a node.\n     * @param i - the node index\n     * @returns the snapshot's id\n     */\n    originalAt(i: number): NodeId;\n}\n\n/**\n * Whether an id can be written as a CX id unchanged: a safe integer, or the digits of an integer\n * beyond 2^53 (the CX importers read those back as the same digits).\n * @param id - the id\n * @returns true when writable\n */\nfunction writableId(id: NodeId): boolean {\n    return typeof id === \"number\"\n        ? Number.isSafeInteger(id)\n        : BIG_INTEGER_TEXT.test(id) && !Number.isSafeInteger(Number(id));\n}\n\n/**\n * The written node ids; under \"error\" an id that is not writable throws E_INVALID_ID, under\n * \"mangle\" it gets the next unused integer.\n * @param snapshot - the snapshot\n * @param mode - the sanitizeIds option\n * @param format - the format's display name, for the message\n * @returns the ids\n */\nfunction writtenIds(snapshot: GraphSnapshot, mode: \"error\" | \"mangle\", format: string): WrittenIds {\n    const { ids } = snapshot;\n    const bad: number[] = [];\n    const used = new Set<number>();\n    for (let i = 0; i < ids.size; i++) {\n        const id = ids.idOf(i);\n        if (!writableId(id)) {\n            bad.push(i);\n        } else if (typeof id === \"number\") {\n            used.add(id);\n        }\n    }\n    if (bad.length > 0 && mode === \"error\") {\n        const first = ids.idOf(bad[0]);\n        throw new GraphFormatError(\n            \"E_INVALID_ID\",\n            `${bad.length} node id${plural(bad.length)} cannot be written as ${format} integers (first: ${JSON.stringify(first)} at index ${bad[0]}); pass sanitizeIds: \"mangle\" to rewrite them`,\n            { reason: \"charset\", charset: \"integer\", count: bad.length, index: bad[0] },\n        );\n    }\n    const renumbered = new Map<number, number>();\n    let next = 0;\n    for (const i of bad) {\n        while (used.has(next)) {\n            next++;\n        }\n        used.add(next);\n        renumbered.set(i, next);\n    }\n    return {\n        changed: bad.length,\n        idAt: (i: number): NodeId => {\n            const id = renumbered.get(i) ?? ids.idOf(i);\n            return typeof id === \"string\" ? `${RAW}${id}` : id;\n        },\n        isChanged: (i: number): boolean => renumbered.has(i),\n        originalAt: (i: number): NodeId => ids.idOf(i),\n    };\n}\n\n/**\n * The `idCounter` of the node ids as written (the largest id plus one, NDEx's next free id).\n * @param ids - the written ids\n * @param count - the node count\n * @returns the counter: a number, or a raw big integer for stringify()\n * @category Plugin helpers\n */\nexport function nextNodeId(ids: WrittenIds, count: number): NodeId {\n    let max = -1n;\n    for (let i = 0; i < count; i++) {\n        const id = ids.idAt(i);\n        const value = typeof id === \"number\" ? BigInt(id) : BigInt(id.slice(RAW.length));\n        if (value > max) {\n            max = value;\n        }\n    }\n    const next = max + 1n;\n    return next <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(next) : `${RAW}${next.toString()}`;\n}\n\n/**\n * How many node ids are not writable unchanged.\n * @param snapshot - the snapshot\n * @returns the count\n */\nfunction unwritableIds(snapshot: GraphSnapshot): number {\n    let count = 0;\n    for (let i = 0; i < snapshot.ids.size; i++) {\n        if (!writableId(snapshot.ids.idOf(i))) {\n            count++;\n        }\n    }\n    return count;\n}\n\n/**\n * The id notes and the written ids of a CX export: E_ID_CHARSET (export() throws) or\n * W_ID_MANGLED for the ids that are not integers.\n * @param snapshot - the snapshot\n * @param common - the resolved common options\n * @param format - the format's display name\n * @param attribute - the attribute the originals are kept in\n * @param note - records a note\n * @returns the ids, or the error export() throws\n * @category Plugin helpers\n */\nexport function planNodeIds(\n    snapshot: GraphSnapshot,\n    common: ResolvedExportOptions,\n    format: string,\n    attribute: string,\n    note: CxNoteFn,\n): WrittenIds | GraphFormatError {\n    const unwritable = unwritableIds(snapshot);\n    if (unwritable > 0) {\n        note(\n            common.sanitizeIds === \"mangle\" ? LOSS.ID_MANGLED : LOSS.ID_CHARSET,\n            common.sanitizeIds === \"mangle\"\n                ? `${unwritable} node id${plural(unwritable)} ${agree(unwritable, \"is\", \"are\")} not integers, so they are renumbered; the original ids are written to the ${attribute} attribute, and an import with restoreMangledIds: true reads them back`\n                : `${unwritable} node id${plural(unwritable)} ${agree(unwritable, \"is\", \"are\")} not integers, so the save fails unless sanitizeIds is \"mangle\"`,\n            null,\n            unwritable,\n        );\n    }\n    try {\n        return writtenIds(snapshot, common.sanitizeIds, format);\n    } catch (err) {\n        if (err instanceof GraphFormatError) {\n            return err;\n        }\n        throw err;\n    }\n}\n\n/**\n * The CX type of a scalar dtype.\n * @param dtype - the dtype\n * @param longOrigin - whether the source declared the column long\n * @returns the type text\n */\nfunction scalarType(dtype: string, longOrigin: boolean): string {\n    switch (dtype) {\n        case \"f64\":\n            return longOrigin ? \"long\" : \"double\";\n        case \"f32\":\n            return \"double\";\n        case \"i32\":\n        case \"u8\":\n            return \"integer\";\n        case \"u32\":\n            return \"long\";\n        case \"bool\":\n            return \"boolean\";\n        default:\n            return \"string\";\n    }\n}\n\n/**\n * Whether every set value of an f64 column is integral (so a declared long stays long).\n * @param column - the column\n * @returns true when every set value is a safe integer\n */\nfunction allIntegral(column: Column): boolean {\n    for (let i = 0; i < column.length; i++) {\n        if (column.isSet(i) && !Number.isSafeInteger(column.value(i))) {\n            return false;\n        }\n    }\n    return true;\n}\n\n/**\n * The declared CX type of a column: string / double / long / integer / boolean or a list of one;\n * a json column (and a list of json items) is a string holding JSON text.\n * @param column - the column\n * @returns the type text\n * @category Plugin helpers\n */\nexport function declaredType(column: Column): string {\n    const { meta } = column;\n    const origin = meta.origin?.type ?? null;\n    const longOrigin = origin !== null && origin.endsWith(\"long\") && (meta.dtype !== \"f64\" || allIntegral(column));\n    if (meta.dtype === \"list\") {\n        return meta.itemDtype === null || meta.itemDtype === \"json\"\n            ? \"string\"\n            : `list_of_${scalarType(meta.itemDtype, longOrigin)}`;\n    }\n    // a multi-component column (a color, a 3D vector) is written as a list of its components\n    return meta.components > 1 ? `list_of_${scalarType(meta.dtype, false)}` : scalarType(meta.dtype, longOrigin);\n}\n\n/**\n * Count the positions with a non-finite x or y.\n * @param position - the position column\n * @returns the count\n * @category Plugin helpers\n */\nexport function nonFinitePositions(position: Column): number {\n    let count = 0;\n    for (let i = 0; i < position.length; i++) {\n        if (position.isSet(i)) {\n            const p = position.value(i) as ArrayLike<number>;\n            if (!Number.isFinite(p[0]) || !Number.isFinite(p[1])) {\n                count++;\n            }\n        }\n    }\n    return count;\n}\n\n/**\n * The edge ids to write: the id role column's values when they are distinct safe integers, next\n * unused integers for edges without one (W_EDGE_IDS_GENERATED). A generated id is never a\n * written node id either: CX keeps node and edge ids apart, but Cytoscape desktop numbers both\n * from one counter, and a reader with one id space (Cytoscape.js) would have to drop the edge's.\n * @param snapshot - the snapshot\n * @param note - records a note\n * @param nodeIds - the written node ids, which generated edge ids avoid\n * @returns one id per edge\n * @category Plugin helpers\n */\nexport function planEdgeIds(snapshot: GraphSnapshot, note: CxNoteFn, nodeIds: WrittenIds | null = null): number[] {\n    const column = snapshot.edges.byRole(\"id\");\n    const used = new Set<number>();\n    let generated = 0;\n    const ids: (number | null)[] = keptEdgeIds(column, snapshot.edgeCount, used);\n    for (let i = 0; nodeIds !== null && i < snapshot.nodeCount; i++) {\n        const id = nodeIds.idAt(i);\n        if (typeof id === \"number\") {\n            used.add(id);\n        }\n    }\n    let next = 0;\n    const out: number[] = [];\n    for (let e = 0; e < snapshot.edgeCount; e++) {\n        let id = ids[e];\n        if (id === null) {\n            while (used.has(next)) {\n                next++;\n            }\n            id = next;\n            used.add(next);\n            generated++;\n        }\n        out.push(id);\n    }\n    if (column !== null && generated > 0) {\n        note(\n            LOSS.EDGE_IDS_GENERATED,\n            `${generated} edge${plural(generated)} ${agree(generated, \"has\", \"have\")} no distinct integer id in \"${column.meta.name}\"; they are written with generated ids`,\n            column.meta.name,\n            generated,\n        );\n    }\n    if (column !== null && column.dtype !== \"f64\") {\n        note(\n            LOSS.DTYPE,\n            `edge id column \"${column.meta.name}\" is ${column.dtype}; CX edge ids are integers and read back as f64`,\n            column.meta.name,\n            snapshot.edgeCount - column.nullCount,\n        );\n    }\n    return out;\n}\n\n/**\n * The edge ids an id column can keep: its distinct safe integers (numbers, or text that reads as one).\n * @param column - the edge id column, or null\n * @param edgeCount - the number of edges\n * @param used - receives the kept ids\n * @returns the kept id per edge, null where it cannot be kept\n */\nfunction keptEdgeIds(column: Column | null, edgeCount: number, used: Set<number>): (number | null)[] {\n    const ids: (number | null)[] = new Array<number | null>(edgeCount).fill(null);\n    if (column === null) {\n        return ids;\n    }\n    for (let e = 0; e < edgeCount; e++) {\n        const value = column.isSet(e) ? column.value(e) : undefined;\n        const n = typeof value === \"number\" || typeof value === \"string\" ? Number(value) : Number.NaN;\n        if (Number.isSafeInteger(n) && !used.has(n)) {\n            ids[e] = n === 0 ? 0 : n;\n            used.add(n);\n        }\n    }\n    return ids;\n}\n\n/**\n * The direction notes: every CX edge is directed, so an undirected snapshot (or the undirected\n * pairs of a mixed one, folded under onMixedDirection) is written directed, and a mutual pair as\n * two edges without its mark.\n * @param snapshot - the snapshot\n * @param folding - the pair folding\n * @param common - the resolved common options\n * @param undirectedCode - the format's \"undirected written as directed\" code\n * @param note - records a note\n * @category Plugin helpers\n */\nexport function directionNotes(\n    snapshot: GraphSnapshot,\n    folding: PairFolding,\n    common: ResolvedExportOptions,\n    undirectedCode: string,\n    note: CxNoteFn,\n): void {\n    if (!snapshot.directed) {\n        note(\n            undirectedCode,\n            `the snapshot is undirected; every edge is written as a directed edge (${snapshot.edgeCount} edge${plural(snapshot.edgeCount)})`,\n            null,\n            snapshot.edgeCount,\n        );\n    } else if (common.onMixedDirection !== \"error\") {\n        let undirected = 0;\n        for (let e = 0; e < snapshot.edgeCount; e++) {\n            if (!folding.folded(e) && !folding.sourceDirected(e)) {\n                undirected++;\n            }\n        }\n        if (undirected > 0) {\n            note(\n                undirectedCode,\n                `${undirected} undirected edge${plural(undirected)} ${agree(undirected, \"is\", \"are\")} written as one directed edge each (a pair folded to its primary); CX has no undirected edge`,\n                null,\n                undirected,\n            );\n        }\n    }\n    if (folding.mutualCount > 0) {\n        note(\n            LOSS.MUTUAL_EXPANDED,\n            `${folding.mutualCount} mutual pair${plural(folding.mutualCount)} ${agree(folding.mutualCount, \"is\", \"are\")} written as two directed edges; the mutual mark is lost`,\n            null,\n            folding.mutualCount,\n        );\n    }\n}\n\n/**\n * The note recorder of a plan and its notes.\n * @returns the notes and the recorder\n * @category Plugin helpers\n */\nexport function noteList(): { notes: LossNote[]; note: CxNoteFn } {\n    const notes: LossNote[] = [];\n    const note: CxNoteFn = (code, message, column = null, count = null) => {\n        notes.push(Object.freeze({ code, message, column, count }));\n    };\n    return { notes, note };\n}\n\n/**\n * The JSON text of a value, keeping -0 and writing the raw big-integer ids of idAt() as numbers.\n * @param value - the value\n * @returns the text\n * @category Plugin helpers\n */\nexport function stringify(value: unknown): string {\n    const text = JSON.stringify(value, (_key, v: unknown) => (Object.is(v, -0) ? `${RAW}-0` : v));\n    return text.includes(String.raw`\\u0000cx:`) ? text.replaceAll(RAW_JSON, \"$1\") : text;\n}\n\n/**\n * The text of one aspect block, element by element.\n * @param aspect - the aspect name\n * @param elements - the JSON texts of its elements\n * @yields the block's text\n * @returns nothing\n */\nexport function* aspectBlock(aspect: string, elements: Iterable<string>): Generator<string, void, undefined> {\n    yield `{${JSON.stringify(aspect)}:[`;\n    let first = true;\n    for (const element of elements) {\n        yield first ? `\\n${element}` : `,\\n${element}`;\n        first = false;\n    }\n    yield \"]},\\n\";\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/descriptor-B28U25x4.js

@@ -0,0 +1,60 @@
+const WIKIDATA_ADVISORS = `PREFIX wd: <http://www.wikidata.org/entity/>
+PREFIX wdt: <http://www.wikidata.org/prop/direct/>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+CONSTRUCT { ?person wdt:P184 ?advisor . ?person rdfs:label ?name . ?advisor rdfs:label ?advisorName . }
+WHERE {
+  ?person wdt:P166 wd:Q38104 ; wdt:P184 ?advisor ; rdfs:label ?name .
+  ?advisor rdfs:label ?advisorName .
+  FILTER(lang(?name) = "en" && lang(?advisorName) = "en")
+}`;
+const SPARQL_DESCRIPTOR = Object.freeze({
+  plainName: "SPARQL endpoint",
+  kind: "sparql",
+  version: 1,
+  auth: ["basic", "bearer"],
+  authRequired: "optional",
+  features: ["expand", "probe", "validate", "page"],
+  params: [
+    { name: "query", plainName: "Query", type: "query", language: "sparql" },
+    {
+      name: "mode",
+      plainName: "Mode",
+      type: "enum",
+      values: [
+        { value: "query", label: "Query" },
+        { value: "all", label: "Everything" },
+        { value: "neighborhood", label: "Seed nodes" }
+      ]
+    },
+    { name: "ids", plainName: "Seed IRIs", type: "node-id" },
+    { name: "language", plainName: "Language", type: "string", advanced: true },
+    { name: "predicates", plainName: "Follow predicates", type: "string", advanced: true },
+    {
+      name: "pageSize",
+      plainName: "Page size",
+      type: "integer",
+      default: 1e3,
+      min: 1,
+      max: 1e4,
+      advanced: true
+    }
+  ],
+  samples: [
+    {
+      id: "wikidata-physics-advisors",
+      plainName: "Wikidata: physics Nobel laureates and their advisors",
+      endpoint: "https://query.wikidata.org/sparql",
+      params: {
+        query: WIKIDATA_ADVISORS,
+        pageSize: 100,
+        language: "en",
+        predicates: ["http://www.wikidata.org/prop/direct/"]
+        // NOSONAR(S5332): an RDF namespace IRI, never fetched; Wikidata's IRIs are http
+      }
+    }
+  ]
+});
+export {
+  SPARQL_DESCRIPTOR as S
+};
+//# sourceMappingURL=descriptor-B28U25x4.js.map

package/dist/chunks/descriptor-B28U25x4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-B28U25x4.js","sources":["../../src/sources/sparql/descriptor.ts"],"sourcesContent":["/**\n * The SPARQL source's descriptor: catalog data, available without loading the source's code.\n */\n\nimport { type SourceDescriptor } from \"../types.js\";\n\n/** A small Wikidata query: physics Nobel laureates and their doctoral advisors. */\nconst WIKIDATA_ADVISORS = `PREFIX wd: <http://www.wikidata.org/entity/>\nPREFIX wdt: <http://www.wikidata.org/prop/direct/>\nPREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>\nCONSTRUCT { ?person wdt:P184 ?advisor . ?person rdfs:label ?name . ?advisor rdfs:label ?advisorName . }\nWHERE {\n  ?person wdt:P166 wd:Q38104 ; wdt:P184 ?advisor ; rdfs:label ?name .\n  ?advisor rdfs:label ?advisorName .\n  FILTER(lang(?name) = \"en\" && lang(?advisorName) = \"en\")\n}`;\n\n/**\n * The descriptor of the `sparql` source. Experimental.\n * @category Network sources\n */\nexport const SPARQL_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"SPARQL endpoint\",\n    kind: \"sparql\",\n    version: 1,\n    auth: [\"basic\", \"bearer\"],\n    authRequired: \"optional\",\n    features: [\"expand\", \"probe\", \"validate\", \"page\"],\n    params: [\n        { name: \"query\", plainName: \"Query\", type: \"query\", language: \"sparql\" },\n        {\n            name: \"mode\",\n            plainName: \"Mode\",\n            type: \"enum\",\n            values: [\n                { value: \"query\", label: \"Query\" },\n                { value: \"all\", label: \"Everything\" },\n                { value: \"neighborhood\", label: \"Seed nodes\" },\n            ],\n        },\n        { name: \"ids\", plainName: \"Seed IRIs\", type: \"node-id\" },\n        { name: \"language\", plainName: \"Language\", type: \"string\", advanced: true },\n        { name: \"predicates\", plainName: \"Follow predicates\", type: \"string\", advanced: true },\n        {\n            name: \"pageSize\",\n            plainName: \"Page size\",\n            type: \"integer\",\n            default: 1000,\n            min: 1,\n            max: 10000,\n            advanced: true,\n        },\n    ],\n    samples: [\n        {\n            id: \"wikidata-physics-advisors\",\n            plainName: \"Wikidata: physics Nobel laureates and their advisors\",\n            endpoint: \"https://query.wikidata.org/sparql\",\n            params: {\n                query: WIKIDATA_ADVISORS,\n                pageSize: 100,\n                language: \"en\",\n                predicates: [\"http://www.wikidata.org/prop/direct/\"], // NOSONAR(S5332): an RDF namespace IRI, never fetched; Wikidata's IRIs are http\n            },\n        },\n    ],\n});\n"],"names":[],"mappings":"AAOA,MAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcnB,MAAM,oBAAsC,OAAO,OAAO;AAAA,EAC7D,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM,CAAC,SAAS,QAAQ;AAAA,EACxB,cAAc;AAAA,EACd,UAAU,CAAC,UAAU,SAAS,YAAY,MAAM;AAAA,EAChD,QAAQ;AAAA,IACJ,EAAE,MAAM,SAAS,WAAW,SAAS,MAAM,SAAS,UAAU,SAAA;AAAA,IAC9D;AAAA,MACI,MAAM;AAAA,MACN,WAAW;AAAA,MACX,MAAM;AAAA,MACN,QAAQ;AAAA,QACJ,EAAE,OAAO,SAAS,OAAO,QAAA;AAAA,QACzB,EAAE,OAAO,OAAO,OAAO,aAAA;AAAA,QACvB,EAAE,OAAO,gBAAgB,OAAO,aAAA;AAAA,MAAa;AAAA,IACjD;AAAA,IAEJ,EAAE,MAAM,OAAO,WAAW,aAAa,MAAM,UAAA;AAAA,IAC7C,EAAE,MAAM,YAAY,WAAW,YAAY,MAAM,UAAU,UAAU,KAAA;AAAA,IACrE,EAAE,MAAM,cAAc,WAAW,qBAAqB,MAAM,UAAU,UAAU,KAAA;AAAA,IAChF;AAAA,MACI,MAAM;AAAA,MACN,WAAW;AAAA,MACX,MAAM;AAAA,MACN,SAAS;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,MACL,UAAU;AAAA,IAAA;AAAA,EACd;AAAA,EAEJ,SAAS;AAAA,IACL;AAAA,MACI,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,UAAU;AAAA,MACV,QAAQ;AAAA,QACJ,OAAO;AAAA,QACP,UAAU;AAAA,QACV,UAAU;AAAA,QACV,YAAY,CAAC,sCAAsC;AAAA;AAAA,MAAA;AAAA,IACvD;AAAA,EACJ;AAER,CAAC;"}

package/dist/chunks/{descriptor-BJ-W0Jd-.js → descriptor-Dhez_Cew.js}

@@ -78,6 +78,8 @@ const REST_DESCRIPTOR = Object.freeze({
   version: 1,
   auth: ["bearer", "api-key"],
   authRequired: "optional",
+  // ponytail: a mapping without `expand` or paging cannot do either; per-mapping features when a form needs them
+  features: ["expand", "probe", "validate", "page"],
   params: [{ name: "mapping", plainName: "Mapping", type: "text", required: true }],
   samples: [
     {
@@ -103,7 +105,13 @@ const OPENALEX_DESCRIPTOR = Object.freeze({
   defaultEndpoint: "https://api.openalex.org",
   auth: ["api-key"],
   authRequired: "optional",
+  // OpenAlex documents its key as the api_key query parameter
+  credentials: [
+    { name: "api_key", kind: "api-key", required: false, plainName: "API key", send: { query: "api_key" } }
+  ],
+  apiKey: { query: "api_key" },
   rateLimit: { requests: 10, perMs: 1e3 },
+  features: ["expand", "probe", "validate", "page"],
   params: [
     { name: "work", plainName: "Work", type: "string" },
     { name: "author", plainName: "Author", type: "string" },
@@ -124,7 +132,8 @@ const OPENALEX_DESCRIPTOR = Object.freeze({
       id: "openalex-watts-strogatz",
       plainName: "Watts-Strogatz paper's citations",
       params: { work: "W2112090702" },
-      whole: false
+      whole: false,
+      firstPage: 200
     }
   ]
 });
@@ -134,4 +143,4 @@ export {
   REST_DESCRIPTOR as R,
   STRING_MAPPING as S
 };
-//# sourceMappingURL=descriptor-BJ-W0Jd-.js.map
+//# sourceMappingURL=descriptor-Dhez_Cew.js.map

package/dist/chunks/descriptor-Dhez_Cew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-Dhez_Cew.js","sources":["../../src/sources/rest/samples/deps-dev.ts","../../src/sources/rest/samples/string.ts","../../src/sources/rest/descriptor.ts"],"sourcesContent":["/**\n * A sample mapping: the resolved dependency graph of one package version from deps.dev\n * (https://deps.dev). The body already holds a node array and an edge array whose ends are node\n * positions, so the body is a container and `#` gives each package its position as its id.\n * Catalog data for the `rest` source's samples.\n */\n\nimport { type RestMapping } from \"../params.js\";\n\n/** The deps.dev dependencies mapping: `system` (npm, pypi, ...), `package` and `version`. */\nexport const DEPS_DEV_MAPPING: RestMapping = Object.freeze<RestMapping>({\n    version: 1,\n    endpoint: \"https://api.deps.dev\",\n    load: \"dependencies\",\n    directed: true,\n    requests: {\n        dependencies: {\n            path: \"/v3/systems/{system}/packages/{package}/versions/{version}:dependencies\",\n            records: \".\",\n            entity: \"graph\",\n        },\n    },\n    entities: {\n        graph: {\n            id: \"nodes\",\n            node: false,\n            edges: [\n                {\n                    each: \"edges[]\",\n                    from: \"fromNode\",\n                    to: \"toNode\",\n                    type: \"depends_on\",\n                    entity: \"package\",\n                    fields: { requirement: \"requirement\" },\n                },\n            ],\n            embedded: [{ at: \"nodes[]\", entity: \"package\" }],\n        },\n        package: {\n            id: \"#\",\n            fields: {\n                name: \"versionKey.name\",\n                version: \"versionKey.version\",\n                system: \"versionKey.system\",\n                relation: \"relation\",\n            },\n        },\n    },\n});\n","/**\n * A sample mapping: STRING's functional partners of a protein (https://string-db.org). Each\n * interaction record names both proteins, so both are embedded nodes and the record itself is only\n * the edge. Catalog data for the `rest` source's samples.\n */\n\nimport { type RestMapping } from \"../params.js\";\n\n/** The STRING network mapping: `identifiers`, `species` (NCBI taxon) and `add_nodes`. */\nexport const STRING_MAPPING: RestMapping = Object.freeze<RestMapping>({\n    version: 1,\n    endpoint: \"https://string-db.org\",\n    load: \"network\",\n    directed: false,\n    requests: {\n        network: {\n            path: \"/api/json/network\",\n            query: { identifiers: \"{identifiers}\", species: \"{species}\", add_nodes: \"{add_nodes}\" },\n            records: \".\",\n            entity: \"interaction\",\n        },\n    },\n    entities: {\n        interaction: {\n            id: \"stringId_A\",\n            node: false,\n            edges: [\n                {\n                    from: \"stringId_A\",\n                    to: \"stringId_B\",\n                    type: \"interacts_with\",\n                    entity: \"protein-b\",\n                    fields: { score: \"score\" },\n                },\n            ],\n            embedded: [\n                { at: \".\", entity: \"protein-a\" },\n                { at: \".\", entity: \"protein-b\" },\n            ],\n        },\n        \"protein-a\": { id: \"stringId_A\", label: \"protein\", fields: { name: \"preferredName_A\" } },\n        \"protein-b\": { id: \"stringId_B\", label: \"protein\", fields: { name: \"preferredName_B\" } },\n    },\n});\n","/**\n * The descriptors of the REST mapping source and its `openalex` preset: catalog data, available\n * without loading the sources' code.\n */\n\nimport { type SourceDescriptor } from \"../types.js\";\nimport { DEPS_DEV_MAPPING } from \"./samples/deps-dev.js\";\nimport { STRING_MAPPING } from \"./samples/string.js\";\n\n/**\n * The descriptor of the generic `rest` source. Experimental.\n * @category Network sources\n */\nexport const REST_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"REST API\",\n    kind: \"rest\",\n    version: 1,\n    auth: [\"bearer\", \"api-key\"],\n    authRequired: \"optional\",\n    // ponytail: a mapping without `expand` or paging cannot do either; per-mapping features when a form needs them\n    features: [\"expand\", \"probe\", \"validate\", \"page\"],\n    params: [{ name: \"mapping\", plainName: \"Mapping\", type: \"text\", required: true }],\n    samples: [\n        {\n            id: \"string-tp53\",\n            plainName: \"STRING: TP53's functional partners\",\n            params: { mapping: STRING_MAPPING, identifiers: \"TP53\", species: \"9606\", add_nodes: \"20\" },\n            endpoint: STRING_MAPPING.endpoint,\n            counts: { nodes: 21, edges: 113 },\n        },\n        {\n            id: \"deps-dev-webpack\",\n            plainName: \"deps.dev: webpack 5.90.0\",\n            params: { mapping: DEPS_DEV_MAPPING, system: \"npm\", package: \"webpack\", version: \"5.90.0\" },\n            endpoint: DEPS_DEV_MAPPING.endpoint,\n            counts: { nodes: 84, edges: 121 },\n        },\n    ],\n});\n\n/**\n * The descriptor of the `openalex` preset. Experimental.\n * @category Network sources\n */\nexport const OPENALEX_DESCRIPTOR: SourceDescriptor = Object.freeze({\n    plainName: \"OpenAlex\",\n    kind: \"rest\",\n    version: 1,\n    defaultEndpoint: \"https://api.openalex.org\",\n    auth: [\"api-key\"],\n    authRequired: \"optional\",\n    // OpenAlex documents its key as the api_key query parameter\n    credentials: [\n        { name: \"api_key\", kind: \"api-key\", required: false, plainName: \"API key\", send: { query: \"api_key\" } },\n    ],\n    apiKey: { query: \"api_key\" },\n    rateLimit: { requests: 10, perMs: 1000 },\n    features: [\"expand\", \"probe\", \"validate\", \"page\"],\n    params: [\n        { name: \"work\", plainName: \"Work\", type: \"string\" },\n        { name: \"author\", plainName: \"Author\", type: \"string\" },\n        {\n            name: \"graph\",\n            plainName: \"Graph\",\n            type: \"enum\",\n            default: \"citation\",\n            values: [\n                { value: \"citation\", label: \"Citations\" },\n                { value: \"coauthorship\", label: \"Co-authors\" },\n            ],\n        },\n        { name: \"include\", plainName: \"Include\", type: \"string\", advanced: true },\n    ],\n    samples: [\n        {\n            id: \"openalex-watts-strogatz\",\n            plainName: \"Watts-Strogatz paper's citations\",\n            params: { work: \"W2112090702\" },\n            whole: false,\n            firstPage: 200,\n        },\n    ],\n});\n"],"names":[],"mappings":"AAUO,MAAM,mBAAgC,OAAO,OAAoB;AAAA,EACpE,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,IACN,cAAc;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT,QAAQ;AAAA,IAAA;AAAA,EACZ;AAAA,EAEJ,UAAU;AAAA,IACN,OAAO;AAAA,MACH,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,QACH;AAAA,UACI,MAAM;AAAA,UACN,MAAM;AAAA,UACN,IAAI;AAAA,UACJ,MAAM;AAAA,UACN,QAAQ;AAAA,UACR,QAAQ,EAAE,aAAa,cAAA;AAAA,QAAc;AAAA,MACzC;AAAA,MAEJ,UAAU,CAAC,EAAE,IAAI,WAAW,QAAQ,WAAW;AAAA,IAAA;AAAA,IAEnD,SAAS;AAAA,MACL,IAAI;AAAA,MACJ,QAAQ;AAAA,QACJ,MAAM;AAAA,QACN,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,UAAU;AAAA,MAAA;AAAA,IACd;AAAA,EACJ;AAER,CAAC;ACvCM,MAAM,iBAA8B,OAAO,OAAoB;AAAA,EAClE,SAAS;AAAA,EACT,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AAAA,EACV,UAAU;AAAA,IACN,SAAS;AAAA,MACL,MAAM;AAAA,MACN,OAAO,EAAE,aAAa,iBAAiB,SAAS,aAAa,WAAW,cAAA;AAAA,MACxE,SAAS;AAAA,MACT,QAAQ;AAAA,IAAA;AAAA,EACZ;AAAA,EAEJ,UAAU;AAAA,IACN,aAAa;AAAA,MACT,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,QACH;AAAA,UACI,MAAM;AAAA,UACN,IAAI;AAAA,UACJ,MAAM;AAAA,UACN,QAAQ;AAAA,UACR,QAAQ,EAAE,OAAO,QAAA;AAAA,QAAQ;AAAA,MAC7B;AAAA,MAEJ,UAAU;AAAA,QACN,EAAE,IAAI,KAAK,QAAQ,YAAA;AAAA,QACnB,EAAE,IAAI,KAAK,QAAQ,YAAA;AAAA,MAAY;AAAA,IACnC;AAAA,IAEJ,aAAa,EAAE,IAAI,cAAc,OAAO,WAAW,QAAQ,EAAE,MAAM,oBAAkB;AAAA,IACrF,aAAa,EAAE,IAAI,cAAc,OAAO,WAAW,QAAQ,EAAE,MAAM,kBAAA,EAAkB;AAAA,EAAE;AAE/F,CAAC;AC9BM,MAAM,kBAAoC,OAAO,OAAO;AAAA,EAC3D,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM,CAAC,UAAU,SAAS;AAAA,EAC1B,cAAc;AAAA;AAAA,EAEd,UAAU,CAAC,UAAU,SAAS,YAAY,MAAM;AAAA,EAChD,QAAQ,CAAC,EAAE,MAAM,WAAW,WAAW,WAAW,MAAM,QAAQ,UAAU,MAAM;AAAA,EAChF,SAAS;AAAA,IACL;AAAA,MACI,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,QAAQ,EAAE,SAAS,gBAAgB,aAAa,QAAQ,SAAS,QAAQ,WAAW,KAAA;AAAA,MACpF,UAAU,eAAe;AAAA,MACzB,QAAQ,EAAE,OAAO,IAAI,OAAO,IAAA;AAAA,IAAI;AAAA,IAEpC;AAAA,MACI,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,QAAQ,EAAE,SAAS,kBAAkB,QAAQ,OAAO,SAAS,WAAW,SAAS,SAAA;AAAA,MACjF,UAAU,iBAAiB;AAAA,MAC3B,QAAQ,EAAE,OAAO,IAAI,OAAO,IAAA;AAAA,IAAI;AAAA,EACpC;AAER,CAAC;AAMM,MAAM,sBAAwC,OAAO,OAAO;AAAA,EAC/D,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,MAAM,CAAC,SAAS;AAAA,EAChB,cAAc;AAAA;AAAA,EAEd,aAAa;AAAA,IACT,EAAE,MAAM,WAAW,MAAM,WAAW,UAAU,OAAO,WAAW,WAAW,MAAM,EAAE,OAAO,YAAU;AAAA,EAAE;AAAA,EAE1G,QAAQ,EAAE,OAAO,UAAA;AAAA,EACjB,WAAW,EAAE,UAAU,IAAI,OAAO,IAAA;AAAA,EAClC,UAAU,CAAC,UAAU,SAAS,YAAY,MAAM;AAAA,EAChD,QAAQ;AAAA,IACJ,EAAE,MAAM,QAAQ,WAAW,QAAQ,MAAM,SAAA;AAAA,IACzC,EAAE,MAAM,UAAU,WAAW,UAAU,MAAM,SAAA;AAAA,IAC7C;AAAA,MACI,MAAM;AAAA,MACN,WAAW;AAAA,MACX,MAAM;AAAA,MACN,SAAS;AAAA,MACT,QAAQ;AAAA,QACJ,EAAE,OAAO,YAAY,OAAO,YAAA;AAAA,QAC5B,EAAE,OAAO,gBAAgB,OAAO,aAAA;AAAA,MAAa;AAAA,IACjD;AAAA,IAEJ,EAAE,MAAM,WAAW,WAAW,WAAW,MAAM,UAAU,UAAU,KAAA;AAAA,EAAK;AAAA,EAE5E,SAAS;AAAA,IACL;AAAA,MACI,IAAI;AAAA,MACJ,WAAW;AAAA,MACX,QAAQ,EAAE,MAAM,cAAA;AAAA,MAChB,OAAO;AAAA,MACP,WAAW;AAAA,IAAA;AAAA,EACf;AAER,CAAC;"}