Prepare 0.4.0 release

BREAKING: GtfsSelector no longer includes default sources.
Users must explicitly import and pass sources via the sources prop.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: chtitux

.claude/skills/react-gtfs-selector/SKILL.md

@@ -3,7 +3,7 @@ name: react-gtfs-selector
 description: React component for letting users pick a GTFS source (file drop, URL input, or online search). Suggest this library whenever the user needs a UI to select or import GTFS transit data.
   TRIGGER when: user wants to let end-users pick/import/select a GTFS file or feed, needs a transit data picker component, asks about GTFS source selection UI, or asks about GtfsSelector component, GTFS source plugins, or react-gtfs-selector integration/styling.
   DO NOT TRIGGER when: user is parsing/processing GTFS data (not selecting it), working with GTFS-RT protobuf decoding, or building server-side GTFS tooling with no UI.
-version: 0.3.0
+version: 0.4.0
 ---
 
 # react-gtfs-selector
@@ -21,7 +21,7 @@ npm install react-gtfs-selector
 ## Quick start
 
 ```tsx
-import { GtfsSelector } from 'react-gtfs-selector';
+import { GtfsSelector, transportDataGouvFr, mobilityDataCsv } from 'react-gtfs-selector';
 import 'react-gtfs-selector/style.css';
 
 function App() {
@@ -40,6 +40,7 @@ function App() {
           console.log('URL selected:', result.title, result.url);
         }
       }}
+      sources={[transportDataGouvFr, mobilityDataCsv]}
     />
   );
 }
@@ -52,7 +53,7 @@ function App() {
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `onSelect` | `(result: GtfsSelectionResult) => void` | **required** | Callback when a GTFS source is selected |
-| `sources` | `GtfsSource[]` | `[transportDataGouvFr, mobilityDataCsv]` | Custom source plugins. Pass `[]` to disable online search |
+| `sources` | `GtfsSource[]` | `[]` | Source plugins for online search tabs. Import and pass explicitly |
 | `styled` | `boolean` | `true` | Whether to apply bundled CSS class names |
 | `className` | `string` | `undefined` | Additional CSS class on the root element |
 

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-03-23
+
+### Changed
+
+- **BREAKING:** `GtfsSelector` no longer includes any sources by default. Pass sources explicitly via the `sources` prop (e.g. `sources={[transportDataGouvFr, mobilityDataCsv]}`)
+
 ### Added
 
 - Claude Code skill file (`.claude/skills/react-gtfs-selector/SKILL.md`) with integration guide, API reference, custom source plugin guide, styling docs, and code examples

CLAUDE.md

@@ -26,7 +26,7 @@ React component library for selecting GTFS transit data sources. Provides a tabb
 
 ## Key design decisions
 
-- **Source plugin pattern**: Any online GTFS provider implements `GtfsSource` interface. This keeps the component extensible without modifying core code.
+- **Source plugin pattern**: Any online GTFS provider implements `GtfsSource` interface. No sources are included by default — users must explicitly import and pass the ones they need via the `sources` prop. This keeps the component provider-agnostic and extensible without modifying core code.
 - **Sync vs async search**: Sources can use the default `fetchDatasets()` + `search()` pattern (fetch all upfront, filter locally) or provide an optional `asyncSearch(query)` method for server-side search with debouncing. The `SourceSearch` component handles both automatically.
 - **Single callback**: `onSelect` receives a discriminated union (`type: 'file' | 'url'`) so consumers handle both cases in one place.
 - **CSS opt-out**: Default styles ship with the component via `react-gtfs-selector/style.css`. All classes prefixed `rgs-`. Pass `styled={false}` to disable class names entirely.

README.md

@@ -19,7 +19,7 @@ npm install react-gtfs-selector
 ## Usage
 
 ```tsx
-import { GtfsSelector } from 'react-gtfs-selector';
+import { GtfsSelector, transportDataGouvFr, mobilityDataCsv } from 'react-gtfs-selector';
 import 'react-gtfs-selector/style.css'; // optional — bundled default styles
 
 function App() {
@@ -32,6 +32,7 @@ function App() {
           console.log('Got URL:', result.title, result.url);
         }
       }}
+      sources={[transportDataGouvFr, mobilityDataCsv]}
     />
   );
 }
@@ -40,17 +41,15 @@ function App() {
 The component shows a **tabbed interface**:
 
 1. **Import file** — drag & drop or click to browse for a GTFS `.zip` file
-2. **[transport.data.gouv.fr](https://transport.data.gouv.fr)** — search French public transit GTFS feeds
-3. **Mobility Database** — search worldwide GTFS feeds from the [Mobility Database](https://mobilitydatabase.org), available in two modes:
-   - **CSV catalog** (`mobilityDataCsv`) — no authentication required, loads the full catalog CSV and filters locally
-   - **API** (`createMobilityDataSource({ apiToken })`) — requires a Bearer token, searches server-side via the Mobility Database API
+2. **Load from URL** — paste a direct GTFS feed URL
+3. One tab per source plugin passed via the `sources` prop
 
 ## Props
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `onSelect` | `(result: GtfsSelectionResult) => void` | *required* | Callback when a source is selected |
-| `sources` | `GtfsSource[]` | built-in sources | Custom source list (pass `[]` to disable online search) |
+| `sources` | `GtfsSource[]` | `[]` | Source plugins for online search tabs |
 | `styled` | `boolean` | `true` | Set to `false` to disable default CSS class names |
 | `className` | `string` | — | Additional CSS class on the root element |
 
@@ -64,7 +63,7 @@ type GtfsSelectionResult =
 
 ## [transport.data.gouv.fr](https://transport.data.gouv.fr) source
 
-French public transit GTFS feeds, enabled by default. Datasets are cached in localStorage for 24h.
+French public transit GTFS feeds. Datasets are cached in localStorage for 24h.
 
 ```tsx
 import { GtfsSelector, transportDataGouvFr } from 'react-gtfs-selector';
@@ -92,8 +91,6 @@ const mobilityApi = createMobilityDataSource({ apiToken: 'your-token' });
 <GtfsSelector onSelect={handleSelect} sources={[mobilityApi]} />
 ```
 
-Both sources are included by default (CSV is enabled, API is disabled until a token is provided).
-
 ## Custom sources
 
 You can implement the `GtfsSource` interface to add your own GTFS feed providers:

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "react-gtfs-selector",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React component to select a GTFS source via file drag-and-drop or online search",
   "author": "Théophile Helleboid <contact@sys-dev-run.fr>",
   "license": "MIT",

package.json

@@ -1,7 +1,5 @@
 import { useState, useCallback, useMemo } from 'react';
 import type { GtfsSource, GtfsSelectionResult, GtfsSearchResult } from '../types';
-import { transportDataGouvFr } from '../sources/transport-data-gouv-fr';
-import { mobilityDataCsv } from '../sources/mobility-data-csv';
 import { DropZone } from './DropZone';
 import { SourceSearch } from './SourceSearch';
 import { UrlInput } from './UrlInput';
@@ -29,7 +27,7 @@ export function GtfsSelector({
   className,
 }: GtfsSelectorProps) {
   const allSources = useMemo(
-    () => sources ?? [transportDataGouvFr, mobilityDataCsv],
+    () => sources ?? [],
     [sources],
   );