@alloy-js/core 0.23.0-dev.8 → 0.23.0

package/dist/dev/src/tracer.js

@@ -0,0 +1,180 @@
+import { effect } from "@vue/reactivity";
+import { debug, isConsoleTraceEnabled } from "./debug/index.js";
+import { colorText, parseBreakOnIds } from "./debug/trace.js";
+import { untrack } from "./reactivity.js";
+import { inspectRefkey } from "./refkey.js";
+import { scheduler } from "./scheduler.js";
+const dids = parseBreakOnIds();
+let triggerCount = 0;
+export function traceEffect(phase, cb) {
+  if (!isConsoleTraceEnabled(phase.area) && !isConsoleTraceEnabled(phase.area + "." + phase.subarea)) return;
+  let first = true;
+  const triggerIds = new Set();
+  effect(() => {
+    if (first) {
+      // just track what we need, don't log.
+      cb();
+      first = false;
+      return;
+    }
+    debug.trace(phase, cb, triggerIds);
+    triggerIds.clear();
+  }, {
+    scheduler: scheduler(true),
+    onTrigger(event) {
+      const id = triggerCount++;
+      if (dids.has(id)) {
+        // eslint-disable-next-line no-debugger
+        debugger;
+      }
+      triggerIds.add(id);
+    }
+  });
+}
+
+/**
+ * Format a symbol name with its ID in a blue-green color
+ * @param symbol The symbol to format
+ * @returns A formatted string representation of the symbol name with ID
+ */
+export function formatSymbolName(symbol) {
+  return colorText(`Symbol ${symbol.name}[${symbol.id}]`, {
+    fg: {
+      r: 0,
+      b: 150,
+      g: 100
+    }
+  });
+}
+export function formatSymbol(symbol) {
+  // Base display with name and ID
+  let result = formatSymbolName(symbol);
+
+  // Add details on subsequent lines
+  const details = [];
+  if (!symbol.binder) {
+    details.push(colorText("  !UNBOUND", {
+      fg: {
+        r: 255,
+        g: 0,
+        b: 0
+      }
+    }));
+  }
+
+  // Show scope info with formatted name
+  if (symbol.scope) {
+    details.push(untrack(() => `  scope: ${formatScopeName(symbol.scope)}`));
+  }
+  for (const space of symbol.memberSpaces) {
+    details.push(untrack(() => formatSpaceSymbols(space)));
+  }
+  if (symbol.ownerSymbol) {
+    details.push(untrack(() => `  ownerSymbol: ${formatSymbolName(symbol.ownerSymbol)}`));
+  }
+
+  // Show all refkeys with proper formatting
+  if (symbol.refkeys && symbol.refkeys.length > 0) {
+    details.push(`  refkeys: ${formatRefkeys(symbol.refkeys)}`);
+  }
+  if (details.length > 0) {
+    result += "\n" + details.join("\n");
+  }
+  return result;
+}
+export function formatSpaceSymbols(space) {
+  return `  ${space.key} symbols (${space.size}): ${[...space].map(s => s.name).join(", ")}`;
+}
+export function formatScopeName(scope) {
+  if (!scope) {
+    return "no scope";
+  }
+  return colorText(`${scope.name}[${scope.id}]`, {
+    fg: {
+      r: 0,
+      g: 150,
+      b: 50
+    }
+  });
+}
+export function formatSymbolTableName(table) {
+  // avoid instance of checks here in order to not create circular module imports.
+  const name = "symbol" in table ? formatSymbolName(table.symbol) : formatScopeName(table.scope);
+  return colorText(`${name}:${table.key}`, {
+    fg: {
+      r: 0,
+      g: 125,
+      b: 25
+    }
+  });
+}
+
+/**
+ * Format an OutputScope for display, showing information in a concise format
+ * @param scope The scope to format
+ * @returns A formatted string representation of the scope
+ */
+export function formatScope(scope) {
+  if (!scope) {
+    return "!Undefined scope!";
+  }
+  // Base display with name
+  let result = colorText(`Scope ${formatScopeName(scope)}`, {
+    fg: {
+      r: 0,
+      b: 200,
+      g: 100
+    }
+  });
+
+  // Add details on subsequent lines
+  const details = [];
+  if (!scope.binder) {
+    details.push(colorText("  !UNBOUND", {
+      fg: {
+        r: 255,
+        g: 0,
+        b: 0
+      }
+    }));
+  }
+
+  // Show parent scope if present
+  if (scope.parent) {
+    details.push(`  parent: ${formatScopeName(scope.parent)}`);
+  }
+
+  // Show child scopes if present
+  if (scope.children && scope.children.size > 0) {
+    details.push(`  children: ${scope.children.size}`);
+  }
+
+  // Show declaration spaces
+  for (const space of scope.spaces) {
+    details.push(`  ${untrack(() => formatSpaceSymbols(space))}`);
+  }
+  if (details.length > 0) {
+    result += "\n" + details.join("\n");
+  }
+  return result;
+}
+export function formatRefkeys(refkeys) {
+  if (!refkeys) {
+    return "";
+  }
+  if (Array.isArray(refkeys)) {
+    return refkeys.map(formatRefkey).join(", ");
+  }
+  return formatRefkey(refkeys);
+}
+function formatRefkey(refkey) {
+  const text = inspectRefkey(refkey);
+  return colorText(text, {
+    fg: {
+      r: 150,
+      g: 0,
+      b: 0
+    }
+  });
+}
+//# sourceMappingURL=tracer.js.map

package/dist/dev/src/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["effect","debug","isConsoleTraceEnabled","colorText","parseBreakOnIds","untrack","inspectRefkey","scheduler","dids","triggerCount","traceEffect","phase","cb","area","subarea","first","triggerIds","Set","trace","clear","onTrigger","event","id","has","add","formatSymbolName","symbol","name","fg","r","b","g","formatSymbol","result","details","binder","push","scope","formatScopeName","space","memberSpaces","formatSpaceSymbols","ownerSymbol","refkeys","length","formatRefkeys","join","key","size","map","s","formatSymbolTableName","table","formatScope","parent","children","spaces","Array","isArray","formatRefkey","refkey","text"],"sources":["../../../src/tracer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/utils.js

@@ -0,0 +1,487 @@
+import { memo as _$memo, createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { toRaw } from "@vue/reactivity";
+import { createCustomContext, effect, ensureIsEmpty, getContext, memo, onCleanup, ref, root, untrack } from "./reactivity.js";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+import { isComponentCreator } from "./runtime/component.js";
+const defaultJoinOptions = {
+  joiner: "\n",
+  ender: false
+};
+
+/**
+ * Map a Map to an array using a mapper and place a joiner between each element.
+ * Defaults to joining with a newline.
+ *
+ * @see {@link join} for joining without mapping.
+ * @param src - Source map.
+ * @param cb - Mapper function.
+ * @param options - Join options.
+ * @returns The mapped and joined array.
+ *
+ */
+
+/**
+ * Map a Map to an array using a mapper and place a joiner between each element.
+ * Defaults to joining with a newline.
+ *
+ * @see {@link join} for joining without mapping.
+ * @param src - Source map.
+ * @param cb - Mapper function.
+ * @param options - Join options.
+ * @returns The mapped and joined array.
+ *
+ */
+
+/**
+ * Map a array or iterator to another array using a mapper and place a joiner
+ * between each element. Defaults to joining with a newline.
+ *
+ * @see {@link join} for joining without mapping.
+ * @param src - Source array.
+ * @param cb - Mapper function.
+ * @param options - Join options.
+ * @returns The mapped and joined array.
+ */
+
+export function mapJoin(src, cb, rawOptions = {}) {
+  /**
+   * Strategy overview:
+   * - Initial render: collect a stable array of mapper outputs, cache
+   *   per-index slot metadata, and create joiner `Ref`s for the gaps between
+   *   items so the rendered list can be mutated without recreating siblings.
+   * - List mutations: diff the incoming iterable against slot metadata, reuse
+   *   entries with matching keys, recycle disposers past the change point, and
+   *   prune caches while recalculating first/last non-empty indices so we only
+   *   edit joiners that are affected by the change.
+   * - Content transitions: each child renders inside a custom context that
+   *   exposes an `isEmpty` flag; when a child gains or loses content we update
+   *   neighbor joiner refs so separators appear and disappear reactively
+   *   without re-running the mapper.
+   */
+  const options = {
+    ...defaultJoinOptions,
+    ...rawOptions
+  };
+  const ender = options.ender === true ? options.joiner : options.ender || undefined;
+  const itemSlots = [];
+  function getOrCreateSlot(index) {
+    let slot = itemSlots[index];
+    if (!slot) {
+      slot = {
+        isEmpty: ref(true)
+      };
+      itemSlots[index] = slot;
+    }
+    return slot;
+  }
+  const firstNonEmptyIndex = ref(-1, {
+    isInfrastructure: true
+  });
+  const lastNonEmptyIndex = ref(-1, {
+    isInfrastructure: true
+  });
+  const mapped = [];
+  let enderMemo;
+
+  // Creates a ref placeholder that stores the joiner node for a boundary.
+  function createJoinerRef() {
+    return ref(undefined, {
+      isInfrastructure: true
+    });
+  }
+
+  // Makes sure we have a joiner ref at the requested boundary index.
+  function ensureJoinerSlot(index) {
+    if (index === 0 || options.joiner === undefined) {
+      return;
+    }
+    const slot = getOrCreateSlot(index);
+    slot.joiner ??= createJoinerRef();
+    mapped[index * 2 - 1] = slot.joiner;
+  }
+
+  // Sets the joiner ref based on whether neighboring children have content.
+  function updateJoinerForIndex(index) {
+    if (index === 0 || options.joiner === undefined) {
+      return;
+    }
+    const slot = itemSlots[index];
+    const joinerRef = slot?.joiner;
+    if (!joinerRef) {
+      return;
+    }
+    if (index >= itemSlots.length) {
+      if (joinerRef.value !== undefined) {
+        joinerRef.value = undefined;
+      }
+      return;
+    }
+    const previousNonEmpty = findPrevNonEmpty(index - 1);
+    const rightSlot = itemSlots[index];
+    const shouldShow = previousNonEmpty !== -1 && rightSlot !== undefined && rightSlot.isEmpty.value === false;
+    const newValue = shouldShow ? options.joiner : undefined;
+    if (joinerRef.value !== newValue) {
+      joinerRef.value = newValue;
+    }
+  }
+
+  // Finds the next child that is not empty starting at or after `from`.
+  function findNextNonEmpty(from) {
+    for (let i = Math.max(from, 0); i < itemSlots.length; i++) {
+      const slot = itemSlots[i];
+      if (slot && slot.isEmpty.value === false) {
+        return i;
+      }
+    }
+    return -1;
+  }
+
+  // Finds the previous child that is not empty before or at `from`.
+  function findPrevNonEmpty(from) {
+    for (let i = Math.min(from, itemSlots.length - 1); i >= 0; i--) {
+      const slot = itemSlots[i];
+      if (slot && slot.isEmpty.value === false) {
+        return i;
+      }
+    }
+    return -1;
+  }
+
+  // Recomputes the cached first and last non-empty indices after changes.
+  function recalculateNonEmptyBounds() {
+    const first = findNextNonEmpty(0);
+    firstNonEmptyIndex.value = first;
+    lastNonEmptyIndex.value = first === -1 ? -1 : findPrevNonEmpty(itemSlots.length - 1);
+    refreshJoiners();
+  }
+
+  // Syncs all joiner refs after the structural shape of the list updates.
+  function refreshJoiners() {
+    if (options.joiner === undefined) {
+      return;
+    }
+    for (let i = 1; i < itemSlots.length; i++) {
+      const slot = itemSlots[i];
+      if (slot?.joiner) {
+        updateJoinerForIndex(i);
+      }
+    }
+  }
+
+  // Applies empty-state bookkeeping for an item and updates neighbor joiners.
+  function applyEmptyStateChange(index, isEmpty, wasEmpty) {
+    if (wasEmpty === isEmpty) {
+      return;
+    }
+    if (isEmpty) {
+      if (firstNonEmptyIndex.value === index) {
+        firstNonEmptyIndex.value = findNextNonEmpty(index + 1);
+      }
+      if (lastNonEmptyIndex.value === index) {
+        lastNonEmptyIndex.value = findPrevNonEmpty(index - 1);
+      }
+    } else {
+      if (firstNonEmptyIndex.value === -1 || index < firstNonEmptyIndex.value) {
+        firstNonEmptyIndex.value = index;
+      }
+      if (index > lastNonEmptyIndex.value) {
+        lastNonEmptyIndex.value = index;
+      }
+    }
+    updateJoinerForIndex(index);
+    updateJoinerForIndex(index + 1);
+  }
+  let previousItemsLen = 0;
+  onCleanup(() => {
+    for (const slot of itemSlots) {
+      slot.disposer?.();
+    }
+  });
+  return () => {
+    const itemsSource = src();
+    // need to unpack reactives for branding checks
+    const itemsSourceRaw = toRaw(itemsSource);
+    let items = Array.isArray(itemsSourceRaw) ? itemsSource : [...itemsSource];
+    if (options.skipFalsy) {
+      items = items.filter(item => item !== null && item !== undefined && typeof item !== "boolean");
+    }
+    const context = getContext();
+    // this is important to access here in reactive context so we are
+    // notified of new items from reactives.
+    const itemsLen = items.length;
+    const compare = getCompareFunction(itemsSourceRaw);
+    const mapper = getMapperFunction(itemsSourceRaw);
+    return untrack(() => {
+      let startIndex = 0;
+      for (; startIndex < itemsLen && startIndex < itemSlots.length; startIndex++) {
+        const slot = itemSlots[startIndex];
+        if (!slot || !compare(items[startIndex], slot.item)) {
+          break;
+        }
+      }
+      if (startIndex > 0 && startIndex < itemsLen) {
+        // need to update the previous joiner (might be ender or absent)
+        ensureJoinerSlot(startIndex);
+      }
+      for (; startIndex < itemsLen; startIndex++) {
+        const slot = getOrCreateSlot(startIndex);
+        slot.item = items[startIndex];
+        const emptyFlag = slot.isEmpty;
+        if (slot.disposer) {
+          if (emptyFlag.value === false) {
+            if (context) {
+              context.childrenWithContent--;
+            }
+            emptyFlag.value = true;
+            applyEmptyStateChange(startIndex, true, false);
+          }
+          slot.disposer();
+        }
+        const cleanupIndex = startIndex;
+        mapped[startIndex * 2] = createCustomContext(cb => {
+          return root(disposer => {
+            const nestedContext = getContext();
+            const isEmptyFlag = ensureIsEmpty(nestedContext);
+            slot.disposer = disposer;
+            disposer();
+            effect(prev => {
+              const isEmpty = isEmptyFlag.value;
+              return untrack(() => {
+                if (slot.isEmpty.value !== isEmpty) {
+                  slot.isEmpty.value = isEmpty;
+                }
+                const wasEmpty = prev ?? true;
+                applyEmptyStateChange(cleanupIndex, isEmpty, wasEmpty);
+                return isEmpty;
+              });
+            }, undefined, {
+              debug: {
+                name: `list:slotEmpty:${cleanupIndex}`,
+                type: "list"
+              }
+            });
+            cb(mapper(items[cleanupIndex], cleanupIndex));
+          });
+        });
+        ensureJoinerSlot(startIndex);
+      }
+      mapped.length = startIndex * 2;
+      if (mapped.length > 0) {
+        if (ender !== undefined) {
+          enderMemo ??= memo(() => lastNonEmptyIndex.value === -1 ? undefined : ender);
+          mapped[mapped.length - 1] = enderMemo;
+        } else {
+          mapped[mapped.length - 1] = undefined;
+        }
+      }
+      for (; startIndex < previousItemsLen; startIndex++) {
+        const slot = itemSlots[startIndex];
+        if (!slot) {
+          continue;
+        }
+        slot.disposer?.();
+        if (slot.isEmpty.value === false) {
+          if (context) {
+            context.childrenWithContent--;
+          }
+          slot.isEmpty.value = true;
+          applyEmptyStateChange(startIndex, true, false);
+        }
+      }
+      if (previousItemsLen !== itemsLen) {
+        itemSlots.length = itemsLen;
+        recalculateNonEmptyBounds();
+      }
+      previousItemsLen = itemsLen;
+      return mapped;
+    });
+  };
+
+  // Chooses the equality function based on the collection type in use.
+  function getCompareFunction(itemsSource) {
+    return Array.isArray(itemsSource) || isIterable(itemsSource) ? compareArray : compareMap;
+  }
+
+  // Selects the mapper signature to match the collection type in use.
+  function getMapperFunction(itemsSource) {
+    return Array.isArray(itemsSource) || itemsSource instanceof Set || isIterable(itemsSource) ? mapArray : mapMap;
+  }
+  // Strict equality check for array-like collections.
+  function compareArray(elem1, elem2) {
+    return elem1 === elem2;
+  }
+
+  // Equality check for map entries that includes key and value.
+  function compareMap(record1, record2) {
+    return record1[0] === record2[0] && record1[1] === record2[1];
+  }
+
+  // Invokes the user mapper for array-like collections.
+  function mapArray(item, index) {
+    return cb(item, index);
+  }
+
+  // Invokes the user mapper for map collections.
+  function mapMap(item, index) {
+    return cb(item[0], item[1], index);
+  }
+
+  // Runtime type guard for iterables returned from custom sources.
+  function isIterable(x) {
+    return typeof x.next === "function";
+  }
+}
+
+/**
+ * Place a joiner between each element of an array or iterator. Defaults to
+ * joining with a newline.
+ *
+ * @see mapJoin for mapping before joining.
+ * @returns The joined array
+ */
+export function join(src, options = {}) {
+  const mergedOptions = {
+    ...defaultJoinOptions,
+    ...options
+  };
+  const joined = [];
+  const ender = mergedOptions.ender === true ? mergedOptions.joiner : mergedOptions.ender;
+  src = Array.from(src);
+  for (const [index, item] of src.entries()) {
+    joined.push(item);
+    if (index !== src.length - 1) {
+      joined.push(mergedOptions.joiner);
+    }
+  }
+  if (src.length > 0 && ender) {
+    joined.push(ender);
+  }
+  return joined;
+}
+/**
+ * Returns a memo which is a list of all the provided children.
+ * If you want this as an array, see {@link childrenArray}.
+ */
+export function children(fn, options = {}) {
+  return memo(() => {
+    const children = fn();
+    if (options.preserveFragments && Array.isArray(children)) {
+      return children.map(collectChildren);
+    } else {
+      return collectChildren(children);
+    }
+  });
+  function collectChildren(children) {
+    if (Array.isArray(children)) {
+      return children.map(collectChildren).flat();
+    } else if (typeof children === "function" && !isComponentCreator(children)) {
+      return collectChildren(children());
+    } else {
+      return children;
+    }
+  }
+}
+export function childrenArray(fn, options) {
+  const c = children(fn, options)();
+  if (Array.isArray(c)) {
+    return c;
+  } else if (c === undefined) {
+    return [];
+  } else {
+    return [c];
+  }
+}
+export function findKeyedChild(children, tag) {
+  for (const child of children) {
+    if (isKeyedChild(child) && child.tag === tag) {
+      return child;
+    }
+  }
+  return null;
+}
+export function findKeyedChildren(children, tag) {
+  const keyedChildren = [];
+  for (const child of children) {
+    if (isKeyedChild(child) && child.tag === tag) {
+      keyedChildren.push(child);
+    }
+  }
+  return keyedChildren;
+}
+export function findUnkeyedChildren(children) {
+  return children.filter(child => !isKeyedChild(child));
+}
+export function isKeyedChild(child) {
+  return isComponentCreator(child) && !!child.tag;
+}
+
+/**
+ * A visitor to collect the output from {@link render}. Used by
+ * {@link traverseOutput}.
+ */
+
+/**
+ * Traverse the output from {@link render} and call the visitor for each
+ * file and directory within it.
+ *
+ * @param sourceDirectory - The root directory to traverse.
+ * @param visitor - The visitor to call for each file and directory.
+ */
+export async function traverseOutput(sourceDirectory, visitor) {
+  await visitor.visitDirectory(sourceDirectory);
+  for (const item of sourceDirectory.contents) {
+    if (item.kind === "directory") {
+      await traverseOutput(item, visitor);
+    } else {
+      await visitor.visitFile(item);
+    }
+  }
+}
+
+/**
+ * Convert a list of props to a joiner and ender for use in {@link (mapJoin:1)}.
+ */
+export function baseListPropsToMapJoinArgs(props) {
+  let joiner, punctuation;
+  if ("joiner" in props) {
+    joiner = props.joiner;
+  } else {
+    punctuation = props.comma ? "," : props.semicolon ? ";" : "";
+    joiner = [punctuation, _$memo(() => _$memo(() => !!props.softline)() ? _$createIntrinsic("sbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 600,
+      columnNumber: 11
+    }) : _$memo(() => !!props.hardline)() ? _$createIntrinsic("hbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 602,
+      columnNumber: 11
+    }) : _$memo(() => !!props.literalline)() ? _$createIntrinsic("lbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 604,
+      columnNumber: 11
+    }) : _$memo(() => !!props.line)() ? _$createIntrinsic("br", {}, {
+      fileName: import.meta.url,
+      lineNumber: 606,
+      columnNumber: 11
+    }) : _$memo(() => !!props.space)() ? [" "] : _$memo(() => !!props.doubleHardline)() ? [_$createIntrinsic("hbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 611,
+      columnNumber: 13
+    }), _$createIntrinsic("hbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 612,
+      columnNumber: 13
+    })] : _$createIntrinsic("hbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 614,
+      columnNumber: 11
+    }), false, "_$memo(\u2026)(\u2026) ? \u2026")];
+  }
+  const ender = "ender" in props ? props.ender : props.enderPunctuation ? punctuation : undefined;
+  return {
+    joiner,
+    ender
+  };
+}
+//# sourceMappingURL=utils.js.map