Method toArray

packages/foam-core/src/query/index.ts:594–656

* Executes the query and returns projected ResourceViews. `.where(...)` * predicates may reference source-derived fields, so they force the slow * path: fetch the full view, filter, then sort/limit. Without `.where`, * sort/offset/limit are pushed into `executeQuery` so source is read only

()

   * for the surviving slice.
   */
  toArray(): ResourceView[] {
    const userSelect = (this._descriptor.select ?? DEFAULT_SELECT).map(
      normalizeSelectEntry
    );
    const userFields = userSelect.map(e => e.field);

    if (this._jsPredicates.length === 0) {
      return executeQuery(
        {
          filter: this._descriptor.filter,
          select: userSelect,
          sort: this._descriptor.sort,
          offset: this._descriptor.offset,
          limit: this._descriptor.limit,
        },
        this.workspace,
        this.graph,
        { trusted: this.trusted, readSource: this.readSource }
      ).results;
    }

    const sourceDerived = userFields.filter(requiresSource);
    const fullSelect: SelectEntry[] = [
      ...ALL_QUERY_FIELDS.map(f => ({ field: f, label: f })),
      ...sourceDerived.map(f => ({ field: f, label: f })),
    ];
    let results = executeQuery(
      {
        filter: this._descriptor.filter,
        select: fullSelect,
      },
      this.workspace,
      this.graph,
      { trusted: this.trusted, readSource: this.readSource }
    ).results;

    for (const pred of this._jsPredicates) {
      try {
        results = results.filter(pred);
      } catch (e) {
        Logger.warn(`[foam-query] JS predicate error: ${e}`);
      }
    }

    if (this._descriptor.sort) {
      const { field, direction } = parseSortDescriptor(this._descriptor.sort);
      results = [...results].sort((a, b) => {
        const cmp = compareValues(a[field], b[field]);
        return direction === 'desc' ? -cmp : cmp;
      });
    }

    const offsetN = this._descriptor.offset ?? 0;
    if (offsetN > 0) results = results.slice(offsetN);
    if (this._descriptor.limit !== undefined)
      results = results.slice(0, this._descriptor.limit);

    return results.map(r => {