@devilsdev/rag-pipeline-utils 2.1.5 → 2.1.8

package/docs-site/package.json

@@ -1,47 +0,0 @@
-{
-  "name": "rag-docs-test",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "docusaurus": "docusaurus",
-    "start": "docusaurus start",
-    "build": "docusaurus build",
-    "swizzle": "docusaurus swizzle",
-    "deploy": "docusaurus deploy",
-    "clear": "docusaurus clear",
-    "serve": "docusaurus serve",
-    "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids",
-    "lint": "echo 'Lint skipped for docs-site'",
-    "test": "echo 'No tests in docs-site. Run from root.'",
-    "docs:build": "npm run --workspace ../ docs:build"
-  },
-  "dependencies": {
-    "@docusaurus/core": "3.7.0",
-    "@docusaurus/preset-classic": "3.7.0",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.0.0",
-    "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.7.0",
-    "@docusaurus/types": "3.7.0"
-  },
-  "browserslist": {
-    "production": [
-      ">0.5%",
-      "not dead",
-      "not op_mini all"
-    ],
-    "development": [
-      "last 3 chrome version",
-      "last 3 firefox version",
-      "last 5 safari version"
-    ]
-  },
-  "engines": {
-    "node": ">=18.0"
-  }
-}

package/docs-site/sidebars.js

@@ -1,39 +0,0 @@
-// @ts-check
-
-/**
- * Sidebar configuration for RAG Pipeline Utils documentation site
- * Version: 2.0.0
- * Author: Ali Kahwaji
- * Updated: Structured for modular clarity and DX
- * @type {import('@docusaurus/plugin-content-docs').SidebarsConfig}
- */
-
-const sidebars = {
-  tutorialSidebar: [
-    {
-      type: 'category',
-      label: 'Overview',
-      collapsed: false,
-      items: ['Introduction', 'Architecture', 'Tutorials', 'Use-Cases'],
-    },
-    {
-      type: 'category',
-      label: 'Developer Guide',
-      collapsed: false,
-      items: ['Usage', 'CLI', 'Plugins'],
-    },
-    {
-      type: 'category',
-      label: 'Advanced',
-      collapsed: true,
-      items: ['Evaluation', 'FAQ'],
-    },
-    {
-      type: 'link',
-      label: '📰 Blog',
-      href: '/blog',
-    },    
-  ],
-};
-
-export default sidebars;

package/docs-site/src/components/HomepageFeatures/index.js

@@ -1,56 +0,0 @@
-/**
- * Version: 1.4.1
- * Description: Feature grid with Framer Motion and deduplicated layout
- * Author: Ali Kahwaji
- */
-
-import React from 'react';
-import clsx from 'clsx';
-import { motion } from 'framer-motion';
-import styles from './index.module.css';
-
-import FeatureImage from '@site/static/img/logo.svg';
-
-const features = [
-  {
-    title: 'Composable Pipelines',
-    description: 'Build flexible RAG workflows with interchangeable loaders, embedders, retrievers, and LLM runners using a clean plugin-based design.',
-  },
-  {
-    title: 'Evaluation & Dashboard',
-    description: 'Use built-in CLI tooling and React dashboards to assess LLM accuracy, BLEU/ROUGE scores, and prompt results at scale.',
-  },
-  {
-    title: 'Fully Extendable',
-    description: 'Register custom components with the PluginRegistry and extend the system without modifying the core logic.',
-  },
-];
-
-export default function HomepageFeatures() {
-  return (
-    <section className={styles.features}>
-      <div className="container">
-        <div className="row">
-          {features.map((feature, idx) => (
-            <motion.div
-              key={idx}
-              className={clsx('col col--4', styles.feature)}
-              initial={{ opacity: 0, y: 30 }}
-              whileInView={{ opacity: 1, y: 0 }}
-              viewport={{ once: true, amount: 0.3 }}
-              transition={{ duration: 0.6, delay: idx * 0.2 }}
-            >
-              <div className="text--center">
-                <FeatureImage className={styles.featureSvg} role="img" alt={feature.title} />
-              </div>
-              <div className="text--center padding-horiz--md">
-                <h3 className={styles.featureTitle}>{feature.title}</h3>
-                <p className={styles.featureText}>{feature.description}</p>
-              </div>
-            </motion.div>
-          ))}
-        </div>
-      </div>
-    </section>
-  );
-}

package/docs-site/src/components/HomepageFeatures/index.module.css

@@ -1,57 +0,0 @@
-/**
- * Version: 1.4.1
- * Description: HomepageFeatures styles with consistent spacing, mint theming, and animation polish
- * Author: Ali Kahwaji
- */
-
- .features {
-  padding: 4rem 0;
-  background-color: var(--ifm-background-color);
-  transition: background-color 0.3s ease;
-}
-
-.feature {
-  text-align: center;
-  padding: 2rem 1rem;
-  transition: transform 0.3s ease;
-}
-
-.feature:hover {
-  transform: translateY(-4px);
-}
-
-.featureSvg {
-  height: 100px;
-  width: auto;
-  margin-bottom: 1rem;
-  fill: var(--ifm-color-primary);
-}
-
-.featureTitle {
-  font-size: 1.25rem;
-  font-weight: 600;
-  color: var(--ifm-heading-color);
-  margin-bottom: 0.5rem;
-}
-
-.featureText {
-  font-size: 0.95rem;
-  line-height: 1.6;
-  color: var(--ifm-font-color-base);
-  max-width: 280px;
-  margin: 0 auto;
-}
-
-@media (max-width: 768px) {
-  .features {
-    padding: 2rem 0;
-  }
-
-  .feature {
-    padding: 1.5rem 0.5rem;
-  }
-
-  .featureSvg {
-    height: 80px;
-  }
-}

package/docs-site/src/components/HomepageHeader/index.js

@@ -1,46 +0,0 @@
-/**
- * Version: 2.4.2
- * Description: Crash-proof homepage header with full fallback safety
- * Author: Ali Kahwaji
- */
-
-import React from 'react';
-import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
-import Link from '@docusaurus/Link';
-import clsx from 'clsx';
-import styles from './index.module.css';
-import Logo from '@site/static/img/logo.svg';
-
-export default function HomepageHeader() {
-  let siteConfig = { title: 'RAG Pipeline Utils', tagline: 'Composable pipelines for LLMs' };
-
-  try {
-    const context = useDocusaurusContext();
-    if (context && context.siteConfig) {
-      siteConfig = {
-        title: context.siteConfig.title || siteConfig.title,
-        tagline: context.siteConfig.tagline || siteConfig.tagline,
-      };
-    }
-  } catch (e) {
-    console.warn('useDocusaurusContext failed:', e);
-  }
-
-  return (
-    <header className={clsx('hero', styles.heroBanner)}>
-      <div className="container text--center">
-        <Logo className={styles.logo} role="img" alt="RAG Utils Logo" />
-        <h1 className="hero__title">{siteConfig.title}</h1>
-        <p className="hero__subtitle">{siteConfig.tagline}</p>
-        <div className={styles.buttons}>
-          <Link className="button button--primary button--lg" to="/docs/Introduction">
-            Get Started
-          </Link>
-          <Link className="button button--outline button--lg" to="/blog">
-            Visit Blog
-          </Link>
-        </div>
-      </div>
-    </header>
-  );
-}

package/docs-site/src/components/HomepageHeader/index.module.css

@@ -1,77 +0,0 @@
-/**
- * Version: 1.4.0
- * Path: docs-site/src/components/HomepageHeader/index.module.css
- * Description: Styles for responsive hero banner with mint green CTA
- * Author: Ali Kahwaji
- */
-
- :root {
-  --hero-accent: #3EF4B6;
-}
-
-.heroBanner {
-  padding: 5rem 2rem;
-  background: var(--ifm-background-color);
-  text-align: center;
-}
-
-.heroTitle {
-  font-size: 3rem;
-  font-weight: 700;
-  color: var(--ifm-heading-color);
-  margin-bottom: 1rem;
-  line-height: 1.2;
-}
-
-.heroSubtitle {
-  font-size: 1.2rem;
-  color: var(--ifm-font-color-base);
-  max-width: 720px;
-  margin: 0 auto 2rem auto;
-}
-
-.buttons {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 1rem;
-  justify-content: center;
-}
-
-.ctaButton {
-  border-radius: 8px;
-  font-weight: 600;
-  padding: 0.75rem 2rem;
-  transition: all 0.25s ease-in-out;
-}
-
-.ctaButton.button--primary {
-  background-color: var(--hero-accent);
-  border: none;
-  color: black;
-}
-
-.ctaButton.button--primary:hover {
-  background-color: #33e3a6;
-  box-shadow: 0 0 0 4px rgba(62, 244, 182, 0.3);
-}
-
-.ctaButton.button--outline {
-  border-color: var(--hero-accent);
-  color: var(--hero-accent);
-}
-
-.ctaButton.button--outline:hover {
-  background-color: rgba(62, 244, 182, 0.1);
-  border-color: var(--hero-accent);
-}
-
-/* Mobile adjustments */
-@media (max-width: 768px) {
-  .heroTitle {
-    font-size: 2.25rem;
-  }
-
-  .heroSubtitle {
-    font-size: 1rem;
-  }
-}

package/docs-site/src/css/custom.css

@@ -1,104 +0,0 @@
-/**
- * Version: 1.4.2
- * Path: docs-site/src/css/custom.css
- * Description: Robust theme override for SSR support in Docusaurus static build with correct light/dark contrast.
- * Author: Ali Kahwaji
- */
-
-/* ----------------------
- * Explicit Light Theme Scope (SSR Safe)
- * ---------------------- */
- html[data-theme='light'],
- :root {
-   --ifm-color-primary: #3EF4B6;
-   --ifm-color-primary-dark: #33e3a6;
-   --ifm-color-primary-darker: #2fd29b;
-   --ifm-color-primary-light: #55f7c0;
-   --ifm-color-primary-lighter: #69f9ca;
-   --ifm-color-primary-lightest: #86fbd6;
- 
-   --ifm-background-color: #ffffff;
-   --ifm-navbar-background-color: #f8f8f8;
-   --ifm-footer-background-color: #f4f4f4;
- 
-   --ifm-font-color-base: #1a1a1a;
-   --ifm-heading-color: #121212;
-   --ifm-link-color: var(--ifm-color-primary);
- }
- 
- /* ----------------------
-  * Dark Theme Overrides
-  * ---------------------- */
- html[data-theme='dark'] {
-   --ifm-background-color: #0d0d0d;
-   --ifm-navbar-background-color: #151515;
-   --ifm-footer-background-color: #121212;
- 
-   --ifm-font-color-base: #f2f2f2;
-   --ifm-heading-color: #ffffff;
-   --ifm-link-color: var(--ifm-color-primary);
- }
- 
- /* ------------------
-  * Typography
-  * ------------------ */
- body {
-   font-family: 'Inter', system-ui, sans-serif;
-   line-height: 1.6;
-   font-size: 16px;
-   background-color: var(--ifm-background-color);
-   color: var(--ifm-font-color-base);
-   transition: background-color 0.3s ease, color 0.3s ease;
- }
- 
- /* ------------------
-  * Buttons
-  * ------------------ */
- .button--primary {
-   background-color: var(--ifm-color-primary);
-   color: black;
-   border: none;
-   font-weight: 500;
-   transition: background-color 0.2s ease;
- }
- .button--primary:hover {
-   background-color: var(--ifm-color-primary-dark);
-   box-shadow: 0 0 0 3px rgba(62, 244, 182, 0.25);
- }
- .button--outline {
-   border: 2px solid var(--ifm-color-primary);
-   color: var(--ifm-color-primary);
- }
- .button--outline:hover {
-   background-color: rgba(62, 244, 182, 0.05);
- }
- 
- /* ------------------
-  * Code Blocks
-  * ------------------ */
- pre {
-   background-color: #f5f5f5;
-   border-radius: 8px;
-   padding: 1rem;
-   font-size: 0.95rem;
-   overflow-x: auto;
- }
- html[data-theme='dark'] pre {
-   background-color: #1e1e1e;
- }
- 
- /* ------------------
-  * Scrollbars
-  * ------------------ */
- ::-webkit-scrollbar {
-   width: 8px;
-   height: 8px;
- }
- ::-webkit-scrollbar-thumb {
-   background-color: rgba(62, 244, 182, 0.45);
-   border-radius: 4px;
- }
- ::-webkit-scrollbar-track {
-   background: transparent;
- }
- 

package/docs-site/src/pages/index.js

@@ -1,20 +0,0 @@
-// docs-site/src/pages/index.js
-
-import React from 'react';
-import Layout from '@theme/Layout';
-import HomepageHeader from '@site/src/components/HomepageHeader';
-import HomepageFeatures from '@site/src/components/HomepageFeatures';
-
-export default function Home() {
-  return (
-    <Layout
-      title="RAG Pipeline Utils"
-      description="Composable RAG pipelines, dashboards, and plugin architecture for Node.js"
-    >
-      <HomepageHeader />
-      <main>
-        <HomepageFeatures />
-      </main>
-    </Layout>
-  );
-}

package/docs-site/src/pages/index.module.css

@@ -1,23 +0,0 @@
-/**
- * CSS files with the .module.css suffix will be treated as CSS modules
- * and scoped locally.
- */
-
-.heroBanner {
-  padding: 4rem 0;
-  text-align: center;
-  position: relative;
-  overflow: hidden;
-}
-
-@media screen and (max-width: 996px) {
-  .heroBanner {
-    padding: 2rem;
-  }
-}
-
-.buttons {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}

package/docs-site/src/pages/markdown-page.md

@@ -1,7 +0,0 @@
----
-title: Markdown page example
----
-
-# Markdown page example
-
-You don't need React to write simple standalone pages.

package/docs-site/static/img/logo.svg

@@ -1,6 +0,0 @@
-<!-- docs-site/static/img/logo.svg -->
-<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <circle cx="32" cy="32" r="30" stroke="#3EF4B6" stroke-width="4"/>
-  <path d="M22 32C22 26.48 26.48 22 32 22C37.52 22 42 26.48 42 32C42 37.52 37.52 42 32 42C26.48 42 22 37.52 22 32Z" fill="#3EF4B6"/>
-  <line x1="44" y1="44" x2="58" y2="58" stroke="#3EF4B6" stroke-width="4" stroke-linecap="round"/>
-</svg>

package/jest.config.js

@@ -1,24 +0,0 @@
-/**
- * Version: 0.1.0
- * Path: /jest.config.js
- * Description: Jest configuration for native ESM test support
- * Author: Ali Kahwaji
- */
-
-// jest.config.js
-
-export default {
-  transform: {
-    '^.+\\.[t|j]sx?$': 'babel-jest', // Existing transform for JS files
-    '\\.(png|jpg|jpeg|gif|eot|ttf|woff|woff2)$': 'jest-transform-stub', // this for static files
-  },
-  verbose: true,
-  testEnvironment: 'node',
-  collectCoverage: true,
-  coverageDirectory: 'coverage',
-  moduleFileExtensions: ['js', 'json'],
-  testMatch: ['**/__tests__/**/*.test.js'],
-  roots: ['<rootDir>/__tests__'],
-};
-
-  

package/plugin.config.json

@@ -1,14 +0,0 @@
-{
-  "loader": {
-    "pdf": "./src/mocks/pdf-loader.js"
-  },
-  "embedder": {
-    "openai": "./src/mocks/openai-embedder.js"
-  },
-  "retriever": {
-    "pinecone": "./src/mocks/pinecone-retriever.js"
-  },
-  "llm": {
-    "openai-gpt-4": "./src/mocks/openai-llm.js"
-  }
-}

package/public/src/App.jsx

@@ -1,57 +0,0 @@
-/**
- * Version: 0.1.0
- * Path: /public/src/App.jsx
- * Description: Evaluation results dashboard UI
- * Author: Ali Kahwaji
- */
-
-import { useEffect, useState } from 'react';
-
-export default function App() {
-  const [results, setResults] = useState([]);
-  const [summary, setSummary] = useState({ passRate: 0, avgBLEU: 0, avgROUGE: 0 });
-
-  useEffect(() => {
-    fetch('/results/sample-eval.json')
-      .then(res => res.json())
-      .then(data => {
-        setResults(data);
-
-        const total = data.length;
-        const passCount = data.filter(r => r.success).length;
-        const avgBLEU = data.reduce((s, r) => s + r.scores.bleu, 0) / total;
-        const avgROUGE = data.reduce((s, r) => s + r.scores.rouge, 0) / total;
-
-        setSummary({
-          passRate: (passCount / total * 100).toFixed(1),
-          avgBLEU: avgBLEU.toFixed(2),
-          avgROUGE: avgROUGE.toFixed(2)
-        });
-      });
-  }, []);
-
-  return (
-    <main className="max-w-6xl mx-auto p-6">
-      <h1 className="text-3xl font-bold mb-4">RAG Evaluation Dashboard</h1>
-
-      <div className="mb-6 p-4 border rounded shadow bg-white">
-        <h2 className="text-xl font-semibold mb-2">Summary</h2>
-        <p> Pass Rate: <strong>{summary.passRate}%</strong></p>
-        <p> Avg BLEU: <strong>{summary.avgBLEU}</strong></p>
-        <p> Avg ROUGE: <strong>{summary.avgROUGE}</strong></p>
-      </div>
-
-      {results.map((res, i) => (
-        <div key={i} className="mb-4 p-4 border-l-4 rounded bg-white shadow border-l-gray-300">
-          <h3 className="font-bold text-lg">Prompt {i + 1}</h3>
-          <p className="mt-2"><strong>Prompt:</strong> {res.prompt}</p>
-          <p><strong>Expected:</strong> {res.expected}</p>
-          <p><strong>Actual:</strong> {res.actual}</p>
-          <p> BLEU: <strong>{res.scores.bleu.toFixed(2)}</strong></p>
-          <p> ROUGE: <strong>{res.scores.rouge.toFixed(2)}</strong></p>
-          <p>Pass: <strong className={res.success ? 'text-green-600' : 'text-red-600'}>{res.success ? 'Yes' : 'No'}</strong></p>
-        </div>
-      ))}
-    </main>
-  );
-}

package/release.config.js

@@ -1,36 +0,0 @@
-/**
- * Version: 0.1.0
- * Description: Semantic Release configuration for CI/CD automation with changelog, versioning, GitHub releases, and npm publishing.
- * Author: Ali Kahwaji
- */
-
-export default {
-  branches: ['main'],
-  repositoryUrl: 'https://github.com/DevilsDev/rag-pipeline-utils',
-
-  plugins: [
-    '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
-    [
-      '@semantic-release/changelog',
-      {
-        changelogFile: 'CHANGELOG.md',
-        changelogTitle: '# Changelog',
-      },
-    ],
-    [
-      '@semantic-release/npm',
-      {
-        npmPublish: true,
-      },
-    ],
-    [
-      '@semantic-release/git',
-      {
-        assets: ['package.json', 'package-lock.json', 'CHANGELOG.md'],
-        message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
-      },
-    ],
-    '@semantic-release/github',
-  ],
-};