@arcgis/node-toolkit 6.0.0-next.6 → 6.0.0-next.8

package/dist/env.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads the .env file and loads the environment variables.
+ *
+ * @param searchRoot Set this to `import.meta.dirname`. If no `.env` file is found, will search at `process.cwd()`.
+ */
+export declare function readEnvFile(searchRoot: string): void;

package/dist/env.js

@@ -0,0 +1,10 @@
+import { findPath } from "./file.js";
+function readEnvFile(searchRoot) {
+  const envFile = findPath(".env", searchRoot) ?? findPath(".env");
+  if (envFile !== void 0) {
+    process.loadEnvFile(envFile);
+  }
+}
+export {
+  readEnvFile
+};

package/dist/markdown.d.ts

@@ -0,0 +1,9 @@
+export declare const markdownTextLimit = 65000;
+/**
+ * Split markdown to fit into GitHub comment length limit. Splits at best available
+ * places: headings, code blocks and details sections, blank lines.
+ *
+ * Use cases: automated reports in issues, pull request check status comments,
+ * reporting public API diff inside a pr comment.
+ */
+export declare function splitMarkdown(content: string, limit?: number): string[];

package/dist/markdown.js

@@ -0,0 +1,102 @@
+const markdownTextLimit = 65e3;
+const boundaryKinds = ["heading", "block", "blank", "line", "text"];
+function splitMarkdown(content, limit = markdownTextLimit) {
+  if (!Number.isSafeInteger(limit) || limit < 2) {
+    throw new Error("Markdown limit must be an integer of at least 2.");
+  }
+  const chunks = [];
+  let start = 0;
+  let blocks = [];
+  let prefix = "";
+  while (prefix.length + content.length - start > limit) {
+    const remaining = content.slice(start);
+    const split = getBoundary(remaining, limit - prefix.length, blocks, start === 0 || content[start - 1] === "\n");
+    chunks.push(
+      prefix + remaining.slice(0, split.index) + closeBlocks(split.blocks, remaining[split.index - 1] === "\n")
+    );
+    start += split.index;
+    blocks = split.blocks;
+    prefix = openBlocks(blocks);
+  }
+  chunks.push(prefix + content.slice(start));
+  return chunks;
+}
+function getBoundary(content, limit, initialBlocks, atLineStart) {
+  const blocks = [...initialBlocks];
+  let best;
+  let skipEnd = 0;
+  for (const match of content.matchAll(/[^\n]*(?:\n|$)/gu)) {
+    const index = match.index;
+    if (index > limit) {
+      break;
+    }
+    const line = match[0];
+    const end = index + line.length;
+    let textStart = Math.max(index, skipEnd);
+    if (end <= textStart) {
+      continue;
+    }
+    const aligned = textStart === index && (index > 0 || atLineStart);
+    const fence = aligned ? /^ {0,3}(`{3,}|~{3,})([^\r\n]*)/u.exec(line) : null;
+    const activeFence = blocks.at(-1)?.fence;
+    const opening = aligned && activeFence === void 0 ? /^[ \t]*<details\b[^>]*>(?:\s*<summary\b[^>]*>[\s\S]*?<\/summary\s*>)?/iu.exec(content.slice(index)) : null;
+    const kind = !aligned ? "text" : activeFence !== void 0 ? "line" : opening !== null || fence !== null ? "block" : /^ {0,3}#{1,6}\s/u.test(line) ? "heading" : /^\s*$/u.test(line) ? "blank" : "line";
+    consider(textStart, kind);
+    if (activeFence !== void 0) {
+      if (fence !== null && fence[1].startsWith(activeFence[0]) && fence[1].length >= activeFence.length && fence[2].trim() === "") {
+        blocks.pop();
+        textStart = end;
+      }
+    } else if (fence !== null) {
+      blocks.push({ opening: line.trimEnd(), closing: fence[1], fence: fence[1] });
+      textStart = end;
+    } else if (aligned && /^\s*<!--/u.test(line)) {
+      const closing = content.indexOf("-->", index);
+      textStart = closing === -1 ? content.length : closing + 3;
+    } else if (opening !== null) {
+      if (/<\/details\s*>/iu.test(line)) {
+        textStart = end;
+      } else {
+        blocks.push({ opening: opening[0], closing: "</details>" });
+        textStart = index + opening[0].length;
+      }
+    } else if (aligned && /^\s*<\/details\s*>/iu.test(line)) {
+      blocks.pop();
+      textStart = end;
+    }
+    skipEnd = textStart;
+    if (textStart <= end) {
+      consider(end, line.endsWith("\n") ? "line" : "text");
+      let exact = Math.min(end, limit - closeBlocks(blocks).length);
+      if (/[\uD800-\uDBFF]/u.test(content[exact - 1]) && /[\uDC00-\uDFFF]/u.test(content[exact])) {
+        exact--;
+      }
+      if (exact >= textStart) {
+        consider(exact, "text");
+      }
+    }
+  }
+  if (best === void 0) {
+    throw new Error("Markdown limit is too small to split the enclosing blocks.");
+  }
+  return best;
+  function consider(index, kind) {
+    if (index <= 0 || index + closeBlocks(blocks, content[index - 1] === "\n").length > limit) {
+      return;
+    }
+    if (best === void 0 || boundaryKinds.indexOf(kind) < boundaryKinds.indexOf(best.kind) || kind === best.kind && index > best.index) {
+      best = { index, kind, blocks: [...blocks] };
+    }
+  }
+}
+function closeBlocks(blocks, endsWithNewline = false) {
+  return blocks.length === 0 ? "" : `${endsWithNewline ? "" : "\n"}${blocks.toReversed().map(({ closing }) => closing).join("\n")}
+`;
+}
+function openBlocks(blocks) {
+  return blocks.map(({ opening, fence }) => opening + (fence === void 0 ? "\n\n" : "\n")).join("");
+}
+export {
+  markdownTextLimit,
+  splitMarkdown
+};

package/dist/packageJson.d.ts

@@ -51,7 +51,7 @@ export type PackageJson = {
     /** @public */
     "css.customData"?: string[];
     /** @public */
-    "customElements"?: string;
+    "customElements"?: string[] | string;
     /** @public */
     "html.customData"?: string[];
     /** @public */

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@arcgis/node-toolkit",
-  "version": "6.0.0-next.6",
+  "version": "6.0.0-next.8",
   "description": "Collection of common internal build-time patterns and utilities for ArcGIS Maps SDK for JavaScript components.",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "type": "module",
   "exports": {
     "./codeowners": "./dist/codeowners.js",
+    "./env": "./dist/env.js",
     "./file": "./dist/file.js",
+    "./markdown": "./dist/markdown.js",
     "./shell": "./dist/shell.js",
     "./glob": "./dist/glob.js",
     "./path": "./dist/path.js",