@plateerlab/xgen-gallery 0.1.0

package/README.md

@@ -0,0 +1,61 @@
+# xgen-gallery
+
+GitHub organization의 레포지토리를 보여주는 React 컴포넌트.
+
+## Install
+
+```bash
+npm install xgen-gallery
+```
+
+## Usage
+
+```tsx
+import { XgenGallery } from 'xgen-gallery';
+
+function App() {
+  return (
+    <XgenGallery
+      org="PlateerLab"
+      token="ghp_xxx"  // optional, raises rate limit
+      theme="dark"     // "dark" | "light"
+    />
+  );
+}
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `org` | `string` | required | GitHub organization name |
+| `token` | `string` | - | GitHub personal access token |
+| `theme` | `"dark" \| "light"` | `"dark"` | Color theme |
+| `limit` | `number` | - | Max repos to show |
+| `onRepoClick` | `(repo: Repo) => void` | - | Custom click handler (overrides built-in detail view) |
+
+## Features
+
+- Repo list with search & language filter
+- Repo detail with README rendering
+- Demo tab: auto-extracts Python code blocks from README, `examples/`, or `demo.json`
+- Dark/Light theme
+- Zero config — just pass `org`
+
+## Demo Data Convention
+
+Repos can provide curated demos by adding `.xgen-gallery/demo.json`:
+
+```json
+{
+  "snippets": [
+    {
+      "label": "Basic Usage",
+      "code": "from my_package import hello\nprint(hello())",
+      "expectedOutput": "Hello, World!"
+    }
+  ]
+}
+```
+
+Priority: `demo.json` > `examples/*.py` > README python blocks

package/dist/index.d.mts

@@ -0,0 +1,37 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface Repo {
+    name: string;
+    full_name: string;
+    description: string | null;
+    html_url: string;
+    language: string | null;
+    stargazers_count: number;
+    forks_count: number;
+    topics: string[];
+    fork: boolean;
+    archived: boolean;
+    updated_at: string;
+    homepage: string | null;
+}
+interface GalleryProps {
+    /** GitHub organization name */
+    org: string;
+    /** GitHub personal access token (optional, raises rate limit) */
+    token?: string;
+    /** Theme: dark or light */
+    theme?: "dark" | "light";
+    /** Max repos to show */
+    limit?: number;
+    /** Callback when a repo card is clicked */
+    onRepoClick?: (repo: Repo) => void;
+}
+interface DemoSnippet {
+    label: string;
+    code: string;
+    expectedOutput?: string;
+}
+
+declare function XgenGallery({ org, token, theme: themeName, limit, onRepoClick }: GalleryProps): react_jsx_runtime.JSX.Element;
+
+export { type DemoSnippet, type GalleryProps, type Repo, XgenGallery };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface Repo {
+    name: string;
+    full_name: string;
+    description: string | null;
+    html_url: string;
+    language: string | null;
+    stargazers_count: number;
+    forks_count: number;
+    topics: string[];
+    fork: boolean;
+    archived: boolean;
+    updated_at: string;
+    homepage: string | null;
+}
+interface GalleryProps {
+    /** GitHub organization name */
+    org: string;
+    /** GitHub personal access token (optional, raises rate limit) */
+    token?: string;
+    /** Theme: dark or light */
+    theme?: "dark" | "light";
+    /** Max repos to show */
+    limit?: number;
+    /** Callback when a repo card is clicked */
+    onRepoClick?: (repo: Repo) => void;
+}
+interface DemoSnippet {
+    label: string;
+    code: string;
+    expectedOutput?: string;
+}
+
+declare function XgenGallery({ org, token, theme: themeName, limit, onRepoClick }: GalleryProps): react_jsx_runtime.JSX.Element;
+
+export { type DemoSnippet, type GalleryProps, type Repo, XgenGallery };