@volter/editor-react 0.5.210 → 0.5.212

package/src/source/r3f-diagnostic-index.ts

@@ -1,165 +0,0 @@
-/**
- * "warnings live on the row".
- *
- * The join that carries an R3F authorability diagnostic from where it is
- * PRODUCED (a whole-file analysis, `r3fAuthoringDiagnostics`) to where it is
- * READ (one hierarchy row). Pure, browser-safe, and unit-testable without a
- * dev server: the two halves below are the entire mapping, and both the
- * server-side annotator (`currentOidIndex`, `vite-plugin-ui-oid.ts`) and the
- * client-side reader (`R3fSourceAuthoringAdapter.diagnosticsFor`) call one of
- * them rather than re-deriving it.
- *
- * ## Why the join is by IDENTITY the index already holds, never by name
- *
- * Before H5 these diagnostics reached exactly one place: the dev server's
- * terminal (and the `/__editor/state` warnings map), formatted to a string by
- * `server/project-validation.ts`'s `validateSource`. A string in a log has no
- * row identity at all, so the first question was what identity to give it.
- *
- * A diagnostic carries `{file, line, col, component}`. An `OidEntry` carries
- * `{file, line, col, component, tag}` — where `component` is the component
- * whose BODY lexically contains the element. Those two `component` fields mean
- * the same thing on the definition side, and both positions come from
- * `node.getStart()`, so the entry-side selection below needs no name
- * resolution, no import walking, and no second derivation that could disagree
- * with the first:
- *
- * - **at this element** — the diagnostic's `(file,line,col)` IS this entry's.
- *   That is R3F004 ("`<Enemy>` has no name"), whose subject is the callsite
- *   element itself. (R3F002/3/5 point at a function/variable NAME identifier
- *   or a `ref={…}` identifier, never at a `<`, so they can never collide with
- *   an element position and be misread as this kind.)
- * - **inside this component** — the diagnostic names the component whose body
- *   contains this element (`d.component === entry.component`, same file). That
- *   is R3F002/R3F003/R3F005, which are ABOUT a definition.
- *
- * The second rule is what gets a definition-side warning onto an INSTANCE row
- * in another file, and it needs no cross-file resolution: the oid transform
- * stamps a component boundary with BOTH its callsite oid
- * (`userData.authoringInstance`) and its definition-root oid (`userData.oid`),
- * so the client already holds both index entries for one row — the same two
- * entries H3's `sourceLocation`/`definitionLocation` return. {@link
- * mergeRowDiagnostics} unions them.
- *
- * ## Why this cannot drift from index freshness
- *
- * It is not a separate channel. The diagnostics are attached to the entries of
- * the very payload `refreshSourceState()` already fetches, computed in the same
- * pass from the same file bytes. There is no second fetch to fall behind, no
- * cache to invalidate, and no clock of its own: whatever makes the index stale
- * makes them stale together, and whatever refreshes it refreshes them.
- *
- * ## A diagnostic that lands on no row does not vanish
- *
- * Some will not reach a row, and that is expected rather than a hole to be
- * plugged: a component defined but never instantiated has no live object, a
- * component whose definition file is not stamped as R3F is never analyzed here
- * at all, and a hosted (no-dev-server) session has no analyzer (see
- * `browser-oid-index.ts`). Nothing is LOST in any of those cases — this join is
- * PURELY ADDITIVE. The channel these diagnostics have always had is untouched:
- * `server/project-validation.ts`'s `validateSource` still formats every one of
- * them into the dev server's terminal warning block and into the project
- * warnings map that `/__editor/state` (and so `volter-game-editor status`) reports. Rows are
- * a second, better-placed audience, not a replacement.
- */
-
-import type { OidEntry, R3fAuthoringDiagnostic } from './oid-transform';
-
-/** The per-entry selector {@link fileDiagnosticJoin} builds. */
-export type EntryDiagnosticSelector = (
-  entry: Pick<OidEntry, 'line' | 'col' | 'component' | 'parentOid'>,
-) => R3fAuthoringDiagnostic[] | undefined;
-
-const position = (at: { line: number; col: number }): string => `${at.line}:${at.col}`;
-
-/**
- * Build the selector for ONE file: which of that file's diagnostics pertain to
- * each of that file's oid entries. Both arguments must belong to the same
- * file — the caller already has them grouped that way, so nothing here
- * re-filters by file.
- *
- * The two rules of the module doc are applied as a PARTITION, not as an `||`,
- * and that distinction is load-bearing. A diagnostic whose position is one of
- * this file's stamped elements is ABOUT that element (R3F004); everything else
- * is about a component definition (R3F002/3/5). Without the partition, an
- * R3F004 on `<Enemy>` in a file that ALSO defines `Enemy` would match the
- * component rule too and badge every element inside `Enemy`'s body — a warning
- * about one callsite smeared across the definition's internals.
- *
- * Deriving the split from the data (does this position name a stamped
- * element?) rather than from a hand-kept list of which codes are
- * callsite-scoped is deliberate: a new R3F00x code classifies itself.
- *
- * The component rule additionally lands on that component's ROOT element only
- * — the outermost stamped element of its body, recognized through `parentOid`
- * (no parent, or a parent belonging to a different component). Two reasons,
- * one practical and one exact: a definition's internals are not what an author
- * is being warned about, and the root element is PRECISELY the entry an
- * instance row reaches, because that oid is what the transform stamps on the
- * boundary object as `userData.oid`. Anything looser would badge every
- * `<mesh>` inside the component as well.
- *
- * The returned selector yields a fresh array, or `undefined` when nothing
- * pertains — so the caller omits the field entirely instead of shipping an
- * empty array on every entry.
- */
-export function fileDiagnosticJoin(
-  fileEntries: ReadonlyMap<string, OidEntry>,
-  fileDiagnostics: readonly R3fAuthoringDiagnostic[],
-): EntryDiagnosticSelector {
-  if (fileDiagnostics.length === 0) return () => undefined;
-  const elementPositions = new Set<string>();
-  for (const [, entry] of fileEntries) elementPositions.add(position(entry));
-
-  const atElement: R3fAuthoringDiagnostic[] = [];
-  const aboutComponent: R3fAuthoringDiagnostic[] = [];
-  for (const diagnostic of fileDiagnostics) {
-    (elementPositions.has(position(diagnostic)) ? atElement : aboutComponent).push(diagnostic);
-  }
-
-  const isComponentRoot = (entry: Pick<OidEntry, 'component' | 'parentOid'>): boolean => {
-    if (entry.parentOid === undefined) return true;
-    return fileEntries.get(entry.parentOid)?.component !== entry.component;
-  };
-
-  return (entry) => {
-    const pertinent = [
-      ...atElement.filter((d) => d.line === entry.line && d.col === entry.col),
-      ...(entry.component === null || !isComponentRoot(entry)
-        ? []
-        : aboutComponent.filter((d) => d.component === entry.component)),
-    ];
-    return pertinent.length > 0 ? pertinent : undefined;
-  };
-}
-
-/** Stable identity of one diagnostic, for the union below. Code + position is
- *  exact: two diagnostics of the same code at the same place ARE the same
- *  finding reached through two entries, which is the normal case when a
- *  component is defined and instantiated in one file. */
-function diagnosticKey(diagnostic: R3fAuthoringDiagnostic): string {
-  return `${diagnostic.code}|${diagnostic.file}|${diagnostic.line}|${diagnostic.col}`;
-}
-
-/**
- * Union of the diagnostics reachable from one ROW's index entries — its
- * callsite entry and its definition-root entry — in that order, deduped.
- * `undefined`/absent entries are skipped, so a row with only one of the two
- * (a plain host element; an instance whose index entry has not landed) is the
- * ordinary case, not a special one.
- */
-export function mergeRowDiagnostics(
-  ...entries: ReadonlyArray<Pick<OidEntry, 'diagnostics'> | undefined>
-): R3fAuthoringDiagnostic[] {
-  const seen = new Set<string>();
-  const merged: R3fAuthoringDiagnostic[] = [];
-  for (const entry of entries) {
-    for (const diagnostic of entry?.diagnostics ?? []) {
-      const key = diagnosticKey(diagnostic);
-      if (seen.has(key)) continue;
-      seen.add(key);
-      merged.push(diagnostic);
-    }
-  }
-  return merged;
-}

package/src/source/r3f-environment-binding.ts

@@ -1,106 +0,0 @@
-/** Exact source tokens for native R3F scene attachments.
- *
- * These are not a Volter environment format. `<color attach="background">`,
- * `<fog attach="fog">`, and `<fogExp2 attach="fog">` are ordinary Fiber
- * projections of THREE.Scene properties. The live Scene remains runtime truth;
- * this metadata only identifies literal constructor arguments that can be
- * changed without interpreting arbitrary project code.
- */
-
-import ts from 'typescript';
-import { jsxAttribute, numericLiteral } from './ts-ast';
-
-import type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/sdk/source-authoring';
-export type { R3fEnvironmentBinding, R3fEnvironmentNumberBinding, R3fEnvironmentStringBinding } from '@volter/sdk/source-authoring';
-
-function attributeString(attribute: ts.JsxAttribute | undefined): string | undefined {
-  const initializer = attribute?.initializer;
-  if (!initializer) return undefined;
-  if (ts.isStringLiteral(initializer)) return initializer.text;
-  const expression = ts.isJsxExpression(initializer) ? initializer.expression : undefined;
-  return expression &&
-    (ts.isStringLiteral(expression) || ts.isNoSubstitutionTemplateLiteral(expression))
-    ? expression.text
-    : undefined;
-}
-
-function args(element: ts.JsxOpeningLikeElement): readonly ts.Expression[] | undefined {
-  const initializer = jsxAttribute(element, 'args')?.initializer;
-  const expression =
-    initializer && ts.isJsxExpression(initializer) ? initializer.expression : undefined;
-  return expression && ts.isArrayLiteralExpression(expression)
-    ? expression.elements.filter(ts.isExpression)
-    : undefined;
-}
-
-function numberBinding(
-  expression: ts.Expression | undefined,
-  sf: ts.SourceFile,
-): R3fEnvironmentNumberBinding | undefined {
-  if (!expression) return undefined;
-  const value = numericLiteral(expression);
-  return value === undefined
-    ? undefined
-    : { value, start: expression.getStart(sf), end: expression.getEnd() };
-}
-
-function stringBinding(
-  expression: ts.Expression | undefined,
-  sf: ts.SourceFile,
-): R3fEnvironmentStringBinding | undefined {
-  if (
-    !expression ||
-    (!ts.isStringLiteral(expression) && !ts.isNoSubstitutionTemplateLiteral(expression))
-  ) {
-    return undefined;
-  }
-  const start = expression.getStart(sf);
-  const quote = sf.text[start];
-  if (quote !== "'" && quote !== '"' && quote !== '`') return undefined;
-  return { value: expression.text, start, end: expression.getEnd(), quote };
-}
-
-/** Bind recognized native scene attachments, including dynamic ones. Dynamic
- * arguments deliberately produce a binding with missing tokens: the World
- * Inspector can still identify the native mode but must keep that field
- * read-only. */
-export function environmentBindingsByElement(
-  sf: ts.SourceFile,
-): Map<ts.JsxOpeningLikeElement, R3fEnvironmentBinding> {
-  const result = new Map<ts.JsxOpeningLikeElement, R3fEnvironmentBinding>();
-  const visit = (node: ts.Node): void => {
-    if (ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) {
-      const tag = node.tagName.getText(sf);
-      const attachedTo = attributeString(jsxAttribute(node, 'attach'));
-      const values = args(node);
-      if (tag === 'color' && attachedTo === 'background') {
-        const color = stringBinding(values?.[0], sf);
-        result.set(node, {
-          kind: 'background-color',
-          ...(color ? { color } : {}),
-        });
-      } else if (tag === 'fog' && attachedTo === 'fog') {
-        const color = stringBinding(values?.[0], sf);
-        const near = numberBinding(values?.[1], sf);
-        const far = numberBinding(values?.[2], sf);
-        result.set(node, {
-          kind: 'fog',
-          ...(color ? { color } : {}),
-          ...(near ? { near } : {}),
-          ...(far ? { far } : {}),
-        });
-      } else if (tag === 'fogExp2' && attachedTo === 'fog') {
-        const color = stringBinding(values?.[0], sf);
-        const density = numberBinding(values?.[1], sf);
-        result.set(node, {
-          kind: 'fog-exp2',
-          ...(color ? { color } : {}),
-          ...(density ? { density } : {}),
-        });
-      }
-    }
-    ts.forEachChild(node, visit);
-  };
-  visit(sf);
-  return result;
-}

package/src/source/r3f-joint-binding.ts

@@ -1,228 +0,0 @@
-/**
- * Source addresses for native `@react-three/rapier` impulse joints.
- *
- * A joint hook has no JSX node of its own, so it cannot carry an OID. The two
- * `<RigidBody ref={…}>` elements are its existing source anchors. This analysis
- * joins a package-recognized hook to those elements inside the same lexical
- * component and records only JSON-shaped data on their OID entries. Literal
- * hook parameters can be written back in place; computed parameters remain
- * identifiable but deliberately read-only.
- */
-
-import ts from 'typescript';
-import { enclosingScope, numericLiteral, refIdentifier } from './ts-ast';
-
-import type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/sdk/source-authoring';
-export type { R3fJointBinding, R3fJointHook, R3fJointLiteral, R3fJointLiteralRange } from '@volter/sdk/source-authoring';
-
-const JOINT_HOOKS = new Set<R3fJointHook>([
-  'useFixedJoint',
-  'useSphericalJoint',
-  'useRevoluteJoint',
-  'usePrismaticJoint',
-  'useRopeJoint',
-  'useSpringJoint',
-]);
-
-function rapierNamedImports(statement: ts.Statement): readonly ts.ImportSpecifier[] {
-  if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
-    return [];
-  }
-  if (statement.moduleSpecifier.text !== '@react-three/rapier') return [];
-  const bindings = statement.importClause?.namedBindings;
-  return bindings && ts.isNamedImports(bindings) ? bindings.elements : [];
-}
-
-function imports(sf: ts.SourceFile): {
-  hooks: Map<string, R3fJointHook>;
-  rigidBodies: Set<string>;
-} {
-  const hooks = new Map<string, R3fJointHook>();
-  const rigidBodies = new Set<string>();
-  for (const statement of sf.statements) {
-    for (const element of rapierNamedImports(statement)) {
-      const imported = element.propertyName?.text ?? element.name.text;
-      if (imported === 'RigidBody') rigidBodies.add(element.name.text);
-      if (JOINT_HOOKS.has(imported as R3fJointHook)) {
-        hooks.set(element.name.text, imported as R3fJointHook);
-      }
-    }
-  }
-  return { hooks, rigidBodies };
-}
-
-type BodyIndex = Map<ts.FunctionLikeDeclaration | null, Map<string, ts.JsxOpeningLikeElement[]>>;
-
-interface JointBindingPair {
-  readonly first: ts.JsxOpeningLikeElement;
-  readonly second: ts.JsxOpeningLikeElement;
-  readonly binding: Omit<R3fJointBinding, 'endpoint'>;
-}
-
-function bindingPairForCall(
-  call: ts.CallExpression,
-  sf: ts.SourceFile,
-  hooks: ReadonlyMap<string, R3fJointHook>,
-  bodies: BodyIndex,
-): JointBindingPair | null {
-  if (!ts.isIdentifier(call.expression)) return null;
-  const hook = hooks.get(call.expression.text);
-  const body1 = call.arguments[0];
-  const body2 = call.arguments[1];
-  const paramsExpression = call.arguments[2];
-  if (!hook || !body1 || !body2 || !paramsExpression) return null;
-  if (!ts.isIdentifier(body1) || !ts.isIdentifier(body2)) return null;
-  const scopeBodies = bodies.get(enclosingScope(call));
-  const first = scopeBodies?.get(body1.text);
-  const second = scopeBodies?.get(body2.text);
-  // More than one element using one ref is not a writable address.
-  if (first?.length !== 1 || second?.length !== 1) return null;
-  const literal = literalValue(paramsExpression);
-  const params = Array.isArray(literal) && validParams(hook, literal) ? literal : undefined;
-  const ranges = params ? literalRanges(paramsExpression) : undefined;
-  const { line, character } = sf.getLineAndCharacterOfPosition(call.getStart(sf));
-  return {
-    first: first[0]!,
-    second: second[0]!,
-    binding: {
-      hook,
-      line: line + 1,
-      col: character,
-      body1Ref: body1.text,
-      body2Ref: body2.text,
-      ...(params
-        ? {
-            params,
-            ...(Array.isArray(ranges) ? { paramRanges: ranges } : {}),
-          }
-        : {}),
-    },
-  };
-}
-
-function literalValue(expression: ts.Expression): R3fJointLiteral | undefined {
-  const numeric = numericLiteral(expression);
-  if (numeric !== undefined) return numeric;
-  if (expression.kind === ts.SyntaxKind.TrueKeyword) return true;
-  if (expression.kind === ts.SyntaxKind.FalseKeyword) return false;
-  if (!ts.isArrayLiteralExpression(expression)) return undefined;
-  const result: R3fJointLiteral[] = [];
-  for (const element of expression.elements) {
-    if (ts.isSpreadElement(element) || ts.isOmittedExpression(element)) return undefined;
-    const value = literalValue(element);
-    if (value === undefined) return undefined;
-    result.push(value);
-  }
-  return result;
-}
-
-function literalRanges(expression: ts.Expression): R3fJointLiteralRange | undefined {
-  if (numericLiteral(expression) !== undefined) {
-    return { start: expression.getStart(), end: expression.getEnd() };
-  }
-  if (
-    expression.kind === ts.SyntaxKind.TrueKeyword ||
-    expression.kind === ts.SyntaxKind.FalseKeyword
-  ) {
-    return { start: expression.getStart(), end: expression.getEnd() };
-  }
-  if (!ts.isArrayLiteralExpression(expression)) return undefined;
-  const result: R3fJointLiteralRange[] = [];
-  for (const element of expression.elements) {
-    if (ts.isSpreadElement(element) || ts.isOmittedExpression(element)) return undefined;
-    const range = literalRanges(element);
-    if (!range) return undefined;
-    result.push(range);
-  }
-  return result;
-}
-
-function validParams(hook: R3fJointHook, params: readonly R3fJointLiteral[]): boolean {
-  const vec = (value: R3fJointLiteral | undefined, length: number): boolean =>
-    Array.isArray(value) &&
-    value.length === length &&
-    value.every((part) => typeof part === 'number');
-  switch (hook) {
-    case 'useFixedJoint':
-      return (
-        params.length === 4 &&
-        vec(params[0], 3) &&
-        vec(params[1], 4) &&
-        vec(params[2], 3) &&
-        vec(params[3], 4)
-      );
-    case 'useSphericalJoint':
-      return params.length === 2 && vec(params[0], 3) && vec(params[1], 3);
-    case 'useRevoluteJoint':
-    case 'usePrismaticJoint':
-      return (
-        (params.length === 3 || params.length === 4) &&
-        vec(params[0], 3) &&
-        vec(params[1], 3) &&
-        vec(params[2], 3) &&
-        (params.length === 3 || vec(params[3], 2))
-      );
-    case 'useRopeJoint':
-      return (
-        params.length === 3 &&
-        vec(params[0], 3) &&
-        vec(params[1], 3) &&
-        typeof params[2] === 'number'
-      );
-    case 'useSpringJoint':
-      return (
-        params.length === 5 &&
-        vec(params[0], 3) &&
-        vec(params[1], 3) &&
-        params.slice(2).every((part) => typeof part === 'number')
-      );
-  }
-}
-
-/** Joint bindings keyed by the existing `<RigidBody>` opening element. */
-export function jointBindingsByElement(
-  sf: ts.SourceFile,
-): Map<ts.JsxOpeningLikeElement, readonly R3fJointBinding[]> {
-  const imported = imports(sf);
-  const result = new Map<ts.JsxOpeningLikeElement, R3fJointBinding[]>();
-  if (imported.hooks.size === 0 || imported.rigidBodies.size === 0) return result;
-
-  const bodies: BodyIndex = new Map();
-  const collectBodies = (node: ts.Node): void => {
-    if (
-      (ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) &&
-      imported.rigidBodies.has(node.tagName.getText(sf))
-    ) {
-      const ref = refIdentifier(node);
-      if (ref) {
-        const scope = enclosingScope(node);
-        const scoped = bodies.get(scope) ?? new Map();
-        const matches = scoped.get(ref) ?? [];
-        matches.push(node);
-        scoped.set(ref, matches);
-        bodies.set(scope, scoped);
-      }
-    }
-    ts.forEachChild(node, collectBodies);
-  };
-  collectBodies(sf);
-
-  const attach = (element: ts.JsxOpeningLikeElement, binding: R3fJointBinding): void => {
-    const bindings = result.get(element) ?? [];
-    bindings.push(binding);
-    result.set(element, bindings);
-  };
-
-  const collectHooks = (node: ts.Node): void => {
-    if (ts.isCallExpression(node)) {
-      const pair = bindingPairForCall(node, sf, imported.hooks, bodies);
-      if (pair) {
-        attach(pair.first, { ...pair.binding, endpoint: 0 });
-        attach(pair.second, { ...pair.binding, endpoint: 1 });
-      }
-    }
-    ts.forEachChild(node, collectHooks);
-  };
-  collectHooks(sf);
-  return result;
-}

package/src/source/r3f-lod-binding.ts

@@ -1,81 +0,0 @@
-/** Source addresses for Drei's native THREE.LOD projection (`<Detailed>`). */
-
-import ts from 'typescript';
-import { jsxAttribute, numericLiteral } from './ts-ast';
-
-import type { R3fLodBinding, R3fLodNumberBinding } from '@volter/sdk/source-authoring';
-export type { R3fLodBinding, R3fLodNumberBinding } from '@volter/sdk/source-authoring';
-
-function detailedNames(sf: ts.SourceFile): Set<string> {
-  const names = new Set<string>();
-  for (const statement of sf.statements) {
-    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
-      continue;
-    }
-    if (!statement.moduleSpecifier.text.startsWith('@react-three/drei')) continue;
-    const bindings = statement.importClause?.namedBindings;
-    if (bindings && ts.isNamedImports(bindings)) {
-      for (const element of bindings.elements) {
-        if ((element.propertyName?.text ?? element.name.text) === 'Detailed') {
-          names.add(element.name.text);
-        }
-      }
-    } else if (bindings && ts.isNamespaceImport(bindings)) {
-      names.add(`${bindings.name.text}.Detailed`);
-    }
-  }
-  return names;
-}
-
-function expressionOf(attribute: ts.JsxAttribute | undefined): ts.Expression | undefined {
-  return attribute?.initializer && ts.isJsxExpression(attribute.initializer)
-    ? attribute.initializer.expression
-    : undefined;
-}
-
-function numberBinding(
-  expression: ts.Expression,
-  sf: ts.SourceFile,
-): R3fLodNumberBinding | undefined {
-  const value = numericLiteral(expression);
-  return value === undefined
-    ? undefined
-    : { value, start: expression.getStart(sf), end: expression.getEnd() };
-}
-
-/** Bind every recognized `<Detailed>` even when its values are computed: the
- * live THREE.LOD remains inspectable, while only literal tokens are writable. */
-export function lodBindingsByElement(
-  sf: ts.SourceFile,
-): Map<ts.JsxOpeningLikeElement, R3fLodBinding> {
-  const names = detailedNames(sf);
-  const result = new Map<ts.JsxOpeningLikeElement, R3fLodBinding>();
-  const visit = (node: ts.Node): void => {
-    if (
-      (ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) &&
-      names.has(node.tagName.getText(sf))
-    ) {
-      const distancesExpression = expressionOf(jsxAttribute(node, 'distances'));
-      const distanceBindings =
-        distancesExpression && ts.isArrayLiteralExpression(distancesExpression)
-          ? distancesExpression.elements.map((element) => numberBinding(element, sf))
-          : [];
-      const distances =
-        distanceBindings.length > 0 && distanceBindings.every((value) => value !== undefined)
-          ? (distanceBindings as R3fLodNumberBinding[])
-          : undefined;
-      const hysteresisExpression = expressionOf(jsxAttribute(node, 'hysteresis'));
-      const hysteresis = hysteresisExpression ? numberBinding(hysteresisExpression, sf) : undefined;
-      const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
-      result.set(node, {
-        line: line + 1,
-        col: character,
-        ...(distances ? { distances } : {}),
-        ...(hysteresis ? { hysteresis } : {}),
-      });
-    }
-    ts.forEachChild(node, visit);
-  };
-  visit(sf);
-  return result;
-}