Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

3.0 KB
Raw Blame
/*
 *  Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

import { useTranslation } from 'react-i18next';

import { Badge } from './ui/badge';
import {
  type ParsedDelimiter,
  parseDelimitersForDisplay,
} from '@/utils/delimiter-preview';

interface Props {
  /** The current value of the delimiter field. */
  value: string | undefined;
}

/**
 * Renders a best-effort, informational preview of the delimiters
 * derived from `value`. Pure display — does not affect the stored value
 * or the chunking behavior. The preview may differ from what the
 * backend actually parses (see #17383).
 *
 * Each delimiter is shown as a small monospace badge; whitespace
 * characters (which would otherwise be invisible in the single-line
 * input) are rendered with visible Unicode glyphs (`↵` for newline,
 * `⇥` for tab, `␣` for space, etc.).
 */
export function DelimiterPreview({ value }: Props) {
  return <DelimiterBadges parsed={parseDelimitersForDisplay(value)} />;
}

/**
 * Preview of the chunker operator's delimiter LIST (one delimiter per row).
 * The caller parses the rows for the running backend, so the badges show what
 * that backend will actually split at.
 */
export function DelimiterListPreview({
  parsed,
}: {
  parsed: ParsedDelimiter[];
}) {
  return <DelimiterBadges parsed={parsed} />;
}

function DelimiterBadges({ parsed }: { parsed: ParsedDelimiter[] }) {
  const { t } = useTranslation();

  if (parsed.length === 0) {
    return (
      <p
        className="pt-1 text-xs italic text-text-secondary"
        data-testid="delimiter-preview-empty"
      >
        {t('knowledgeDetails.delimiterPreviewEmpty', {
          defaultValue: 'No delimiters — text will be chunked by size only.',
        })}
      </p>
    );
  }

  return (
    <div
      className="flex flex-wrap items-center gap-1 pt-1"
      data-testid="delimiter-preview"
    >
      <span className="text-xs text-text-secondary">
        {t('knowledgeDetails.delimiterPreviewLabel', {
          defaultValue: 'Splits at:',
        })}
      </span>
      {parsed.map((d, i) => (
        <Badge
          key={`${d.display}-${i}`}
          variant="secondary"
          className="font-mono text-xs"
        >
          {d.display}
        </Badge>
      ))}
      <span className="text-xs text-text-secondary">
        {t('knowledgeDetails.delimiterPreviewCount', {
          count: parsed.length,
          defaultValue: '({{count}})',
        }).replace('{{count}}', String(parsed.length))}
      </span>
    </div>
  );
}