Merge pull request #21 from Wintus/formatter

formatter

Author: Wintus

.cline/rules/functional-style-guide.md

@@ -5,38 +5,45 @@ This guide outlines the preferred functional programming practices for this proj
 ## Core Principles
 
 1. **Pure Functions Over Classes**
+
 	- Prefer standalone functions over class methods
 	- Export individual functions rather than object/class collections
 	- Example: Using `export function fetchAllRevisions()` instead of `WikipediaAPI.getAllRevisions()`
 
 2. **Dependency Injection**
+
 	- Pass dependencies explicitly as function parameters
 	- Avoid direct imports within functions when the dependency can be injected
 	- Example: `function findOneOccurrence(targetText, fetcher, revisions)` instead of directly using WikipediaAPI
 
 3. **Function Composition**
+
 	- Build complex operations from small, reusable functions
 	- Use function composition to create data processing pipelines
 	- Example: `const revisions = getPageRevisions(data).map(convert)`
 
 4. **Immutability**
+
 	- Treat data as immutable whenever possible
 	- Create new objects/arrays instead of modifying existing ones
 	- Use ReadonlyArray<T> type for parameters to signal immutability
 	- Example: `const shuffled = [...array]; // Shallow copy to avoid modifying the original array`
 
 5. **Type Safety**
+
 	- Use explicit TypeScript types and interfaces
 	- Leverage const assertions and satisfies operators
 	- Create default constants for complex objects
 	- Example: `export const defaultSearchResult = {...} as const satisfies SearchResult`
 
 6. **Single Responsibility**
+
 	- Each function should do one thing and do it well
 	- Extract helper functions for reusable logic
 	- Example: Splitting sampling logic into its own function
 
 7. **Generator Functions**
+
 	- Use generator functions for lazy evaluation of sequences
 	- Example: `function* batches<T>(batchSize, array): Generator<ReadonlyArray<T>>`
 

.editorconfig

@@ -0,0 +1,11 @@
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+# Use tab indentation
+[*]
+indent_style = tab

.prettierrc.json

@@ -1,5 +1,5 @@
 {
-  "useTabs": true,
-  "trailingComma": "es5",
-  "singleQuote": true
+	"useTabs": true,
+	"trailingComma": "es5",
+	"singleQuote": true
 }

dev-log-20250302.md

@@ -3,23 +3,27 @@
 This file contains a condensed summary of the development process for the Wikipedia Blame tool. For detailed implementation notes, see `implementation-notes.md`.
 
 ## Initial Request
+
 - Create a Wikipedia Blame web app to find when specific text was added to Wikipedia articles
 - Similar functionality to git blame
 - Support for English and Japanese Wikipedia
 
 ## Project Planning
+
 - Decided on React with TypeScript and Vite for the frontend
 - Planned a minimal SPA without router or complex frameworks
 - Designed core algorithm with randomized sampling and exhaustive search fallback
 - Structured project with components, services, utilities, and types
 
 ## Implementation
+
 - Created core WikipediaAPI service for interacting with Wikipedia API
 - Implemented RevisionFinder utility with efficient search algorithm
 - Developed React components: SearchForm, LanguageSelector, ResultView
 - Added CSS styling with variables for theming
 
 ## Technical Highlights
+
 - Used ReadonlyArray for better immutability
 - Implemented input trimming on change
 - Added language selector with base URLs displayed

eslint.config.js

@@ -1,28 +1,28 @@
-import js from '@eslint/js'
-import globals from 'globals'
-import reactHooks from 'eslint-plugin-react-hooks'
-import reactRefresh from 'eslint-plugin-react-refresh'
-import tseslint from 'typescript-eslint'
+import js from '@eslint/js';
+import globals from 'globals';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+import tseslint from 'typescript-eslint';
 
 export default tseslint.config(
-  { ignores: ['dist'] },
-  {
-    extends: [js.configs.recommended, ...tseslint.configs.recommended],
-    files: ['**/*.{ts,tsx}'],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.browser,
-    },
-    plugins: {
-      'react-hooks': reactHooks,
-      'react-refresh': reactRefresh,
-    },
-    rules: {
-      ...reactHooks.configs.recommended.rules,
-      'react-refresh/only-export-components': [
-        'warn',
-        { allowConstantExport: true },
-      ],
-    },
-  },
-)
+	{ ignores: ['dist'] },
+	{
+		extends: [js.configs.recommended, ...tseslint.configs.recommended],
+		files: ['**/*.{ts,tsx}'],
+		languageOptions: {
+			ecmaVersion: 2020,
+			globals: globals.browser,
+		},
+		plugins: {
+			'react-hooks': reactHooks,
+			'react-refresh': reactRefresh,
+		},
+		rules: {
+			...reactHooks.configs.recommended.rules,
+			'react-refresh/only-export-components': [
+				'warn',
+				{ allowConstantExport: true },
+			],
+		},
+	}
+);

implementation-notes.md

@@ -1,6 +1,7 @@
 # Wikipedia Blame Implementation Notes
 
 ## Search Algorithm Implementation
+
 - Randomized sampling approach (10% of revisions or at least 5 revisions) for efficiency
 - Fallback to exhaustive batch search when needed
 - Parallel fetching of revisions using Promise.all to improve performance
@@ -9,51 +10,57 @@
 ## Key Components
 
 ### WikipediaAPI Service
+
 ```typescript
 // Core functions for interacting with Wikipedia API
 async getRevisionTexts(revIds: ReadonlyArray<number>, lang: WikiLanguage = 'en'): Promise<ReadonlyArray<RevisionResult>>
 async getAllRevisions(pageTitle: string, lang: WikiLanguage = 'en'): Promise<ReadonlyArray<number>>
 ```
 
 ### RevisionFinder Utility
+
 ```typescript
 // Non-destructive Fisher-Yates shuffle
-function shuffleArray<T>(array: ReadonlyArray<T>): ReadonlyArray<T>
+function shuffleArray<T>(array: ReadonlyArray<T>): ReadonlyArray<T>;
 
 // Main search function with sampling approach
 async function findOneOccurrence(
-  targetText: string,
-  revList: ReadonlyArray<number>,
-  lang: WikiLanguage = 'en'
-): Promise<number | null>
+	targetText: string,
+	revList: ReadonlyArray<number>,
+	lang: WikiLanguage = 'en'
+): Promise<number | null>;
 
 // Fallback exhaustive search
 async function exhaustiveSearch(
-  revList: ReadonlyArray<number>,
-  targetText: string,
-  lang: WikiLanguage = 'en'
-): Promise<number | null>
+	revList: ReadonlyArray<number>,
+	targetText: string,
+	lang: WikiLanguage = 'en'
+): Promise<number | null>;
 ```
 
 ### React Components
+
 - **SearchForm**: Handles user input with trimming on change
 - **LanguageSelector**: Toggles between English and Japanese Wikipedia with base URLs displayed
 - **ResultView**: Displays search results with links to the specific revision
 
 ## Technical Decisions
+
 - Used ReadonlyArray for better immutability throughout the codebase
 - Implemented trimming of input strings on change rather than just on submit
 - Added language selector with base URLs displayed for clarity (en.wikipedia.org/ja.wikipedia.org)
 - Structured the app as a minimal SPA without router or complex frameworks
 - Used TypeScript types instead of interfaces for consistency
 
 ## Implementation Progress
+
 - Core functionality for finding one text occurrence implemented
 - Basic UI with search form and results display
 - CSS styling with CSS variables for theming and responsive design
 - Error handling for API calls and search process
 
 ## Future Work
+
 - Implement tests using real Wikipedia endpoints (with mocking)
 - Add functionality to find first/last addition/deletion of text
 - Add user selection to search further

index.html

@@ -1,13 +1,13 @@
 <!doctype html>
 <html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Wikipedia Blame</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
+	<head>
+		<meta charset="UTF-8" />
+		<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+		<title>Wikipedia Blame</title>
+	</head>
+	<body>
+		<div id="root"></div>
+		<script type="module" src="/src/main.tsx"></script>
+	</body>
 </html>