Function declareSequence

src/compute-engine/engine-sequences.ts:30–66

(
  ce: IComputeEngine,
  name: string,
  def: SequenceDefinition
)

} from './oeis.js';

export function declareSequence(
  ce: IComputeEngine,
  name: string,
  def: SequenceDefinition
): IComputeEngine {
  // Validate basic requirements (without parsing)
  if (!def.base || Object.keys(def.base).length === 0) {
    throw new Error(`Sequence "${name}" requires at least one base case`);
  }
  if (!def.recurrence) {
    throw new Error(`Sequence "${name}" requires a recurrence relation`);
  }

  // Declare the symbol first with a placeholder handler
  // This ensures the symbol exists when we parse the recurrence
  ce.declare(name, {
    subscriptEvaluate: () => undefined,
  });

  // Now validate and create the actual handler
  const validation = validateSequenceDefinition(ce, name, def);
  if (!validation.valid) {
    throw new Error(validation.error);
  }

  // Create the full subscriptEvaluate handler
  const handler = createSequenceHandler(ce, name, def);

  // Update the symbol's subscriptEvaluate handler
  // We need to access the internal definition to update it
  const boxedDef = ce.lookupDefinition(name);
  if (boxedDef && isValueDef(boxedDef)) {
    boxedDef.value.subscriptEvaluate = handler;
  }

  return ce;
}

export function getSequenceStatus(
  ce: IComputeEngine,