[alan-turing][m] - cleanup

.gitignore

@@ -16,7 +16,6 @@ node_modules
 *.launch
 .settings/
 *.sublime-workspace
-.obsidian
 
 # IDE - VSCode
 .vscode/*

examples/alan-turing-portal/README.md

@@ -0,0 +1,19 @@
+## Getting started
+
+To get started with this template, first install the npm dependencies:
+
+```bash
+npm install
+```
+
+Next, run the development server:
+
+```bash
+npm run dev
+```
+
+Finally, open [http://localhost:3000](http://localhost:3000) in your browser to view the website.
+
+## License
+
+This site template is a commercial product and is licensed under the [Tailwind UI license](https://tailwindui.com/license).

examples/alan-turing-portal/components/Footer.jsx

@@ -21,7 +21,7 @@ export function Footer() {
           <Container.Inner>
             <div className="flex flex-col items-center justify-between gap-6 sm:flex-row">
               <p className="text-sm font-medium text-zinc-800 dark:text-zinc-200">
-                Built with <a href='https://portaljs.org'>PortalJS 🌀</a>
+                hatespeechdata maintained by <a href='https://github.com/leondz'>leondz</a>
               </p>
               <p className="text-sm text-zinc-400 dark:text-zinc-500">
                 &copy; {new Date().getFullYear()} Leon Derczynski. All rights

examples/alan-turing-portal/components/Header.jsx

@@ -0,0 +1,109 @@
+import { useRef } from 'react'
+import { useRouter } from 'next/router'
+
+import { Container } from '../components/Container'
+
+function SunIcon(props) {
+  return (
+    <svg
+      viewBox="0 0 24 24"
+      strokeWidth="1.5"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      aria-hidden="true"
+      {...props}
+    >
+      <path d="M8 12.25A4.25 4.25 0 0 1 12.25 8v0a4.25 4.25 0 0 1 4.25 4.25v0a4.25 4.25 0 0 1-4.25 4.25v0A4.25 4.25 0 0 1 8 12.25v0Z" />
+      <path
+        d="M12.25 3v1.5M21.5 12.25H20M18.791 18.791l-1.06-1.06M18.791 5.709l-1.06 1.06M12.25 20v1.5M4.5 12.25H3M6.77 6.77 5.709 5.709M6.77 17.73l-1.061 1.061"
+        fill="none"
+      />
+    </svg>
+  )
+}
+
+function MoonIcon(props) {
+  return (
+    <svg viewBox="0 0 24 24" aria-hidden="true" {...props}>
+      <path
+        d="M17.25 16.22a6.937 6.937 0 0 1-9.47-9.47 7.451 7.451 0 1 0 9.47 9.47ZM12.75 7C17 7 17 2.75 17 2.75S17 7 21.25 7C17 7 17 11.25 17 11.25S17 7 12.75 7Z"
+        strokeWidth="1.5"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  )
+}
+
+function ModeToggle() {
+  function disableTransitionsTemporarily() {
+    document.documentElement.classList.add('[&_*]:!transition-none')
+    window.setTimeout(() => {
+      document.documentElement.classList.remove('[&_*]:!transition-none')
+    }, 0)
+  }
+
+  function toggleMode() {
+    disableTransitionsTemporarily()
+
+    let darkModeMediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
+    let isSystemDarkMode = darkModeMediaQuery.matches
+    let isDarkMode = document.documentElement.classList.toggle('dark')
+
+    if (isDarkMode === isSystemDarkMode) {
+      delete window.localStorage.isDarkMode
+    } else {
+      window.localStorage.isDarkMode = isDarkMode
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      aria-label="Toggle dark mode"
+      className="group rounded-full bg-white/90 px-3 py-2 shadow-lg shadow-zinc-800/5 ring-1 ring-zinc-900/5 backdrop-blur transition dark:bg-zinc-800/90 dark:ring-white/10 dark:hover:ring-white/20"
+      onClick={toggleMode}
+    >
+      <SunIcon className="h-6 w-6 fill-zinc-100 stroke-zinc-500 transition group-hover:fill-zinc-200 group-hover:stroke-zinc-700 dark:hidden [@media(prefers-color-scheme:dark)]:fill-teal-50 [@media(prefers-color-scheme:dark)]:stroke-teal-500 [@media(prefers-color-scheme:dark)]:group-hover:fill-teal-50 [@media(prefers-color-scheme:dark)]:group-hover:stroke-teal-600" />
+      <MoonIcon className="hidden h-6 w-6 fill-zinc-700 stroke-zinc-500 transition dark:block [@media(prefers-color-scheme:dark)]:group-hover:stroke-zinc-400 [@media_not_(prefers-color-scheme:dark)]:fill-teal-400/10 [@media_not_(prefers-color-scheme:dark)]:stroke-teal-500" />
+    </button>
+  )
+}
+
+export function Header() {
+  let isHomePage = useRouter().pathname === '/'
+
+  let headerRef = useRef()
+
+  return (
+    <>
+      <header
+        className="pointer-events-none relative z-50 flex flex-col"
+        style={{
+          height: 'var(--header-height)',
+          marginBottom: 'var(--header-mb)',
+        }}
+      >
+        <div
+          ref={headerRef}
+          className="top-0 z-10 h-16 pt-6"
+          style={{ position: 'var(--header-position)' }}
+        >
+          <Container
+            className="top-[var(--header-top,theme(spacing.6))] w-full"
+            style={{ position: 'var(--header-inner-position)' }}
+          >
+            <div className="relative flex gap-4">
+              <div className="flex justify-end md:flex-1">
+                <div className="pointer-events-auto">
+                  <ModeToggle />
+                </div>
+              </div>
+            </div>
+          </Container>
+        </div>
+      </header>
+      {isHomePage && <div style={{ height: 'var(--content-offset)' }} />}
+    </>
+  )
+}

examples/alan-turing-portal/content/abusive-language-detection-on-arabic-social-media-al-jazeera.md

@@ -12,5 +12,3 @@ platform: ["AlJazeera"]
 medium: ["Text"]
 reference: "Mubarak, H., Darwish, K. and Magdy, W., 2017. Abusive Language Detection on Arabic Social Media. In: Proceedings of the First Workshop on Abusive Language Online. Vancouver, Canada: Association for Computational Linguistics, pp.52-56."
 ---
-
-SOMETHING TEST

examples/alan-turing-portal/content/hate-speech-detection-in-the-bengali-language-a-dataset-and-its-baseline-evaluation.md

@@ -12,4 +12,3 @@ platform: ["Youtube", "Facebook"]
 medium: ["Text"]
 reference: "Romim, N., Ahmed, M., Talukder, H., & Islam, M. S. (2021). Hate speech detection in the bengali language: A dataset and its baseline evaluation. In Proceedings of International Joint Conference on Advances in Computational Intelligence (pp. 457-468). Springer, Singapore."
 ---
-

examples/alan-turing-portal/content/index.md

@@ -0,0 +1,9 @@
+This page catalogues datasets annotated for hate speech, online abuse, and offensive language. They may be useful for e.g. training a natural language processing system to detect this language.
+
+The list is maintained by Leon Derczynski, Bertie Vidgen, Hannah Rose Kirk, Pica Johansson, Yi-Ling Chung, Mads Guldborg Kjeldgaard Kongsbak, Laila Sprejer, and Philine Zeinert.
+
+We provide a list of datasets and keywords. If you would like to contribute to our catalogue or add your dataset, please see the instructions for contributing.
+
+If you use these resources, please cite (and read!) our paper: Directions in Abusive Language Training Data: Garbage In, Garbage Out. And if you would like to find other resources for researching online hate, visit The Alan Turing Institute’s Online Hate Research Hub or read The Alan Turing Institute’s Reading List on Online Hate and Abuse Research.
+
+If you’re looking for a good paper on online hate training datasets (beyond our paper, of course!) then have a look at ‘Resources and benchmark corpora for hate speech detection: a systematic review’ by Poletto et al. in Language Resources and Evaluation.

examples/alan-turing-portal/package.json

@@ -12,50 +12,29 @@
   },
   "browserslist": "defaults, not ie <= 11",
   "dependencies": {
-    "@flowershow/core": "^0.4.10",
     "@flowershow/markdowndb": "^0.1.1",
-    "@flowershow/remark-callouts": "^1.0.0",
-    "@flowershow/remark-embed": "^1.0.0",
-    "@flowershow/remark-wiki-link": "^1.1.2",
     "@headlessui/react": "^1.7.13",
-    "@heroicons/react": "^2.0.17",
     "@mapbox/rehype-prism": "^0.8.0",
     "@mdx-js/loader": "^2.1.5",
     "@mdx-js/react": "^2.1.5",
     "@next/mdx": "^13.0.2",
-    "@opentelemetry/api": "^1.4.0",
     "@tailwindcss/forms": "^0.5.3",
     "@tailwindcss/typography": "^0.5.4",
-    "@tanstack/react-table": "^8.8.5",
     "autoprefixer": "^10.4.12",
     "clsx": "^1.2.1",
     "fast-glob": "^3.2.11",
     "feed": "^4.2.2",
     "flexsearch": "^0.7.31",
     "focus-visible": "^5.2.0",
-    "gray-matter": "^4.0.3",
-    "hastscript": "^7.2.0",
-    "mdx-mermaid": "^2.0.0-rc7",
-    "mermaid": "^10.1.0",
-    "next": "13.2.1",
-    "next-mdx-remote": "^4.4.1",
+    "next": "13.3.0",
     "next-router-mock": "^0.9.3",
     "next-superjson-plugin": "^0.5.7",
-    "papaparse": "^5.4.1",
     "postcss-focus-visible": "^6.0.4",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-hook-form": "^7.43.9",
     "react-markdown": "^8.0.7",
-    "react-vega": "^7.6.0",
-    "rehype-autolink-headings": "^6.1.1",
-    "rehype-katex": "^6.0.3",
-    "rehype-prism-plus": "^1.5.1",
-    "rehype-slug": "^5.1.0",
     "remark-gfm": "^3.0.1",
-    "remark-math": "^5.1.1",
-    "remark-smartypants": "^2.0.0",
-    "remark-toc": "^8.0.1",
     "superjson": "^1.12.3",
     "tailwindcss": "^3.3.0"
   },
@@ -63,9 +42,6 @@
     "eslint": "8.26.0",
     "eslint-config-next": "13.0.2",
     "prettier": "^2.8.7",
-    "prettier-plugin-tailwindcss": "^0.2.6",
-    "@types/node": "18.16.0",
-    "@types/react": "18.2.0",
-    "@types/react-dom": "18.2.0"
+    "prettier-plugin-tailwindcss": "^0.2.6"
   }
 }

examples/alan-turing-portal/pages/_document.jsx

@@ -1,17 +1,25 @@
 import { Head, Html, Main, NextScript } from 'next/document'
 
 const modeScript = `
+  let darkModeMediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
+
   updateMode()
+  darkModeMediaQuery.addEventListener('change', updateModeWithoutTransitions)
   window.addEventListener('storage', updateModeWithoutTransitions)
 
   function updateMode() {
-    let isDarkMode = window.localStorage.isDarkMode === 'true'
+    let isSystemDarkMode = darkModeMediaQuery.matches
+    let isDarkMode = window.localStorage.isDarkMode === 'true' || (!('isDarkMode' in window.localStorage) && isSystemDarkMode)
 
     if (isDarkMode) {
       document.documentElement.classList.add('dark')
     } else {
       document.documentElement.classList.remove('dark')
     }
+
+    if (isDarkMode === isSystemDarkMode) {
+      delete window.localStorage.isDarkMode
+    }
   }
 
   function disableTransitionsTemporarily() {

examples/alan-turing-portal/pages/index.jsx

@@ -0,0 +1,182 @@
+import Head from 'next/head'
+import fs from 'fs'
+
+import { Card } from '../components/Card'
+import { Container } from '../components/Container'
+import clientPromise from '@/lib/mddb'
+import ReactMarkdown from 'react-markdown'
+import { Index } from 'flexsearch'
+import { useForm } from 'react-hook-form'
+
+function DatasetCard({ dataset }) {
+  return (
+    <Card as="article">
+      <Card.Title>{dataset.title}</Card.Title>
+      <Card.Description>
+        <span className="font-semibold">Link to publication: </span>{' '}
+        <a
+          className="underline transition hover:text-teal-400 dark:hover:text-teal-900 text-ellipsis"
+          href={dataset['link-to-publication']}
+        >
+          {dataset['link-to-publication']}
+        </a>
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Link to data: </span>
+        <a
+          className="underline transition hover:text-teal-600 dark:hover:text-teal-900 text-ellipsis"
+          href={dataset['link-to-data']}
+        >
+          {dataset['link-to-data']}
+        </a>
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Task Description: </span>
+        {dataset['task-description']}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Details of Task: </span>{' '}
+        {dataset['details-of-task']}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Size of Dataset: </span>{' '}
+        {dataset['size-of-dataset']}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Percentage Abusive: </span>
+        {dataset['percentage-abusive']}%
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Language: </span>
+        {dataset['language']}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Level of Annotation: </span>
+        {dataset['level-of-annotation'].join(', ')}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Platform: </span>
+        {dataset['platform'].join(', ')}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Medium: </span>
+        {dataset['medium'].join(', ')}
+      </Card.Description>
+      <Card.Description>
+        <span className="font-semibold">Reference: </span>
+        {dataset['reference']}
+      </Card.Description>
+    </Card>
+  )
+}
+export default function Home({ datasets, indexText, availableLanguages, availablePlatforms }) {
+  const index = new Index()
+  datasets.forEach((dataset) => index.add(dataset.id, `${dataset.title} ${dataset['task-description']} ${dataset['details-of-task']} ${dataset['reference']}`))
+  const { register, watch } = useForm({ defaultValues: {
+    searchTerm: '',
+    lang: '',
+    platform: ''
+  }})
+  return (
+    <>
+      <Head>
+        <title>Hate Speech Dataset Catalogue</title>
+        <meta
+          name="description"
+          content="Catalog of abusive language data (PLoS 2020)"
+        />
+      </Head>
+      <Container className="mt-9">
+        <div className="max-w-2xl">
+          <h1 className="text-4xl font-bold tracking-tight text-zinc-800 dark:text-zinc-100 sm:text-5xl">
+            Hate Speech Dataset Catalogue
+          </h1>
+          <article className="mt-6 flex flex-col gap-y-2 text-base text-zinc-600 dark:text-zinc-400">
+            <ReactMarkdown>{indexText}</ReactMarkdown>
+          </article>
+        </div>
+      </Container>
+      <Container className="mt-24 md:mt-28">
+        <div className="mx-auto grid max-w-xl grid-cols-1 gap-y-8 lg:max-w-none">
+          <form className="rounded-2xl border border-zinc-100 px-4 py-6 sm:p-6 dark:border-zinc-700/40">
+            <p className="mt-2 text-lg font-semibold text-zinc-600 dark:text-zinc-100">
+              Search for datasets
+            </p>
+            <div className="mt-6 flex flex-col sm:flex-row gap-3">
+              <input
+                placeholder="Search here"
+                aria-label="Hate speech on Twitter"
+                required
+                {...register('searchTerm')}
+                className="min-w-0 flex-auto appearance-none rounded-md border border-zinc-900/10 bg-white px-3 py-[calc(theme(spacing.2)-1px)] shadow-md shadow-zinc-800/5 placeholder:text-zinc-600 focus:border-teal-500 focus:outline-none focus:ring-4 focus:ring-teal-500/10 dark:border-zinc-700 dark:bg-zinc-700/[0.15] dark:text-zinc-200 dark:placeholder:text-zinc-200 dark:focus:border-teal-400 dark:focus:ring-teal-400/10 sm:text-sm"
+              />
+              <select
+                placeholder="Language"
+                defaultValue=""
+                className="min-w-0 flex-auto text-zinc-600 appearance-none rounded-md border border-zinc-900/10 bg-white px-3 py-[calc(theme(spacing.2)-1px)] shadow-md shadow-zinc-800/5 placeholder:text-zinc-400 focus:border-teal-500 focus:outline-none focus:ring-4 focus:ring-teal-500/10 dark:border-zinc-700 dark:bg-zinc-700/[0.15] dark:text-zinc-200 dark:placeholder:text-zinc-500 dark:focus:border-teal-400 dark:focus:ring-teal-400/10 sm:text-sm"
+                {...register('lang')}
+              >
+                <option value="" disabled hidden>Filter by language</option>
+                {availableLanguages.map((lang) => (
+                  <option key={lang} className='dark:bg-white dark:text-black' value={lang}>{lang}</option>
+                ))}
+              </select>
+              <select
+                placeholder="Platform"
+                defaultValue=""
+                className="min-w-0 flex-auto text-zinc-600 appearance-none rounded-md border border-zinc-900/10 bg-white px-3 py-[calc(theme(spacing.2)-1px)] shadow-md shadow-zinc-800/5 placeholder:text-zinc-400 focus:border-teal-500 focus:outline-none focus:ring-4 focus:ring-teal-500/10 dark:border-zinc-700 dark:bg-zinc-700/[0.15] dark:text-zinc-200 dark:placeholder:text-zinc-500 dark:focus:border-teal-400 dark:focus:ring-teal-400/10 sm:text-sm"
+                {...register('platform')}
+              >
+                <option value="" disabled hidden>Filter by platform</option>
+                {availablePlatforms.map((platform) => (
+                  <option key={platform} className='dark:bg-white dark:text-black' value={platform}>{platform}</option>
+                ))}
+              </select>
+            </div>
+          </form>
+          <div className="flex flex-col gap-16">
+            {datasets
+              .filter((dataset) =>
+                watch().searchTerm && watch().searchTerm !== ''
+                  ? index.search(watch().searchTerm).includes(dataset.id)
+                  : true
+              )
+              .filter((dataset) =>
+                watch().lang && watch().lang !== ''
+                  ? dataset.language === watch().lang
+                  : true
+              )
+              .filter((dataset) =>
+                watch().platform && watch().platform !== ''
+                  ? dataset.platform.includes(watch().platform)
+                  : true
+              )
+              .map((dataset) => (
+                <DatasetCard key={dataset.title} dataset={dataset} />
+              ))}
+          </div>
+        </div>
+      </Container>
+    </>
+  )
+}
+
+export async function getStaticProps() {
+  const mddb = await clientPromise
+  const allPages = await mddb.getFiles({ extensions: ['md', 'mdx'] })
+  const datasets = allPages
+    .filter((page) => page.url_path !== '/')
+    .map((page) => ({ ...page.metadata, id: page._id }))
+  const index = allPages.filter((page) => page.url_path === '/')[0]
+  const source = fs.readFileSync(index.file_path, { encoding: 'utf-8' })
+  const availableLanguages = [... new Set(datasets.map((dataset) => dataset.language))]
+  const availablePlatforms = [... new Set(datasets.map((dataset) => dataset.platform).flat())]
+  return {
+    props: {
+      indexText: source,
+      datasets,
+      availableLanguages,
+      availablePlatforms,
+    },
+  }
+}

examples/alan-turing-portal/styles/tailwind.css

@@ -2,12 +2,3 @@
 @import 'tailwindcss/components';
 @import './prism.css';
 @import 'tailwindcss/utilities';
-
-.index-text ul,
-.index-text p {
-  margin: 0;
-}
-
-.index-text h2 {
-  margin-top: 1rem;
-}

examples/alan-turing-portal/tailwind.config.js

@@ -2,7 +2,6 @@
 module.exports = {
   content: [
     "./app/**/*.{js,ts,jsx,tsx,mdx}",
-    "./content/**/*.{js,ts,jsx,tsx,mdx}",
     "./pages/**/*.{js,ts,jsx,tsx,mdx}",
     "./components/**/*.{js,ts,jsx,tsx,mdx}",
   ],

examples/ckan-example/package.json

@@ -10,24 +10,24 @@
   },
   "dependencies": {
     "@heroicons/react": "^2.0.17",
+    "@types/node": "18.16.0",
+    "@types/react": "18.0.38",
+    "@types/react-dom": "18.0.11",
+    "eslint": "8.39.0",
+    "eslint-config-next": "13.3.1",
     "next": "13.3.1",
     "next-seo": "^6.0.0",
     "octokit": "^2.0.14",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-markdown": "^8.0.7",
-    "remark-gfm": "^3.0.1"
+    "remark-gfm": "^3.0.1",
+    "typescript": "5.0.4"
   },
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.9",
     "autoprefixer": "^10.4.14",
     "postcss": "^8.4.23",
-    "tailwindcss": "^3.3.1",
-    "eslint": "8.39.0",
-    "eslint-config-next": "13.3.1",
-    "typescript": "5.0.4",
-    "@types/node": "18.16.0",
-    "@types/react": "18.0.38",
-    "@types/react-dom": "18.0.11"
+    "tailwindcss": "^3.3.1"
   }
 }

examples/fivethirtyeight/.gitignore

@@ -1,35 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env*.local
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts

examples/fivethirtyeight/README.md

@@ -1,44 +0,0 @@
-This is a replica of the awesome data.fivethirtyeight.com using PortalJS.
-
-You might be asking why we did that, there are three main reasons:
-
-- The website has a great UI, with multiple datasets being displayed elegantly and with simplicity.
-- PortalJS allows us to add more functionality to it e.g dataset previews and search functionality.
-- The project follows our same principles of open sourcing and free data, with every dataset being publicly available on Github.
-
-## Getting Started
-
-First, run the development server:
-
-```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
-
-You can start editing the page by modifying `pages/index.tsx`. The page auto-updates as you edit the file.
-
-[API routes](https://nextjs.org/docs/api-routes/introduction) can be accessed on [http://localhost:3000/api/hello](http://localhost:3000/api/hello). This endpoint can be edited in `pages/api/hello.ts`.
-
-The `pages/api` directory is mapped to `/api/*`. Files in this directory are treated as [API routes](https://nextjs.org/docs/api-routes/introduction) instead of React pages.
-
-This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
-
-## Learn More
-
-To learn more about Next.js, take a look at the following resources:
-
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
-
-## Deploy on Vercel
-
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
-
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.

examples/fivethirtyeight/components/Breadcrumbs.tsx

@@ -1,23 +0,0 @@
-import Link from "next/link";
-
-function HomeIcon({ className = "" }) {
-  return <div className={`inline-block w-4 ${className}`}><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">    <path d="M 12 2 A 1 1 0 0 0 11.289062 2.296875 L 1.203125 11.097656 A 0.5 0.5 0 0 0 1 11.5 A 0.5 0.5 0 0 0 1.5 12 L 4 12 L 4 20 C 4 20.552 4.448 21 5 21 L 9 21 C 9.552 21 10 20.552 10 20 L 10 14 L 14 14 L 14 20 C 14 20.552 14.448 21 15 21 L 19 21 C 19.552 21 20 20.552 20 20 L 20 12 L 22.5 12 A 0.5 0.5 0 0 0 23 11.5 A 0.5 0.5 0 0 0 22.796875 11.097656 L 12.716797 2.3027344 A 1 1 0 0 0 12.710938 2.296875 A 1 1 0 0 0 12 2 z"/></svg></div>
-}
-
-export default function Breadcrumbs({ links }: { links: { title: string, href?: string, target?: string }[] }) {
-  const current = links.at(-1);
-
-  return <div className="flex items-center uppercase font-black text-xs">
-    <Link className="flex items-center" href='/'><HomeIcon /></Link>
-
-    {/* {links.length > 1 && links.slice(0, -1).map((link) => {
-      return <>
-        <span className="mx-4">/</span>
-        <Link href={link.href}>{link.title}</Link>
-      </>
-    })} */}
-
-    <span className="mx-4">/</span>
-    <span>{current?.title}</span>
-  </div >
-}

examples/fivethirtyeight/lib/octokit.ts

@@ -1,38 +0,0 @@
-import { Octokit } from 'octokit';
-
-export interface GithubProject {
-  owner: string;
-  repo: string;
-  branch: string;
-  files: string[];
-  readme: string;
-  description?: string;
-  name?: string;
-}
-
-export async function getProjectReadme(
-  owner: string,
-  repo: string,
-  branch: string,
-  readme: string,
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const response = await octokit.rest.repos.getContent({
-      owner,
-      repo,
-      path: readme,
-      ref: branch,
-    });
-    const data = response.data as { content?: string };
-    const fileContent = data.content ? data.content : '';
-    if (fileContent === '') {
-      return null;
-    }
-    const decodedContent = Buffer.from(fileContent, 'base64').toString();
-    return decodedContent;
-  } catch (error) {
-    return null;
-  }
-}

examples/fivethirtyeight/next.config.js

@@ -1,9 +0,0 @@
-/** @type {import('next').NextConfig} */
-const nextConfig = {
-  reactStrictMode: true,
-  serverRuntimeConfig: {
-    github_pat: process.env.GITHUB_PAT ? process.env.GITHUB_PAT : null,
-  },
-}
-
-module.exports = nextConfig

examples/fivethirtyeight/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "fiverthirtyeight-example",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
-  "dependencies": {
-    "@portaljs/components": "^0.1.0",
-    "@tailwindcss/typography": "^0.5.9",
-    "@types/node": "20.1.1",
-    "@types/react": "18.2.6",
-    "@types/react-dom": "18.2.4",
-    "autoprefixer": "10.4.14",
-    "eslint": "8.40.0",
-    "eslint-config-next": "13.4.1",
-    "flexsearch": "^0.7.31",
-    "next": "13.4.1",
-    "next-mdx-remote": "^4.4.1",
-    "next-seo": "^6.0.0",
-    "octokit": "^2.0.14",
-    "postcss": "8.4.23",
-    "react": "18.2.0",
-    "react-dom": "18.2.0",
-    "react-markdown": "^8.0.7",
-    "remark-code-frontmatter": "^1.0.0",
-    "remark-extract-frontmatter": "^3.2.0",
-    "remark-frontmatter": "^4.0.1",
-    "remark-gfm": "^3.0.1",
-    "tailwindcss": "3.3.2",
-    "timeago.js": "^4.0.2",
-    "typescript": "5.0.4"
-  }
-}

examples/fivethirtyeight/pages/_app.tsx

@@ -1,8 +0,0 @@
-import '@/styles/globals.css'
-import '@portaljs/components/styles.css'
-
-import type { AppProps } from 'next/app'
-
-export default function App({ Component, pageProps }: AppProps) {
-  return <Component {...pageProps} />
-}

examples/fivethirtyeight/pages/_document.tsx

@@ -1,96 +0,0 @@
-import { Html, Head, Main, NextScript } from 'next/document';
-
-export default function Document() {
-  return (
-    <Html lang="en">
-      <Head>
-        <link
-          rel="icon"
-          type="image/x-icon"
-          href="https://projects.fivethirtyeight.com/shared/favicon.ico"
-        />
-        <meta
-          property="og:image"
-          content="https://portaljs-fivethirtyeight.vercel.app/share_image.png"
-        />
-        <meta
-          property="twitter:image"
-          content="https://portaljs-fivethirtyeight.vercel.app/share_image.png"
-        />
-      </Head>
-      <body>
-        <div className="px-2 max-w-5xl mx-auto pb-2">
-          <div className="mt-2 px-2 bg-[#3c3c3c] text-white">
-            <div className="p-2 text-center">
-              This is a replica to the awesome{' '}
-              <a
-                className="hover:underline font-bold"
-                href="https://data.fivethirtyeight.com"
-              >
-                data.fivethirtyeight.com
-              </a>{' '}
-              website.{' '}
-              <a
-                className="hover:underline font-bold"
-                href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
-              >
-                Read more here
-              </a>{' '}
-            </div>
-          </div>
-        </div>
-        <header className="max-w-5xl mx-auto mt-8 w-full">
-          <div className="border-b-2 pb-2.5 mx-2 border-zinc-800 flex justify-between">
-            <h1 className="flex gap-x-1 items-end">
-              <span className="sr-only">FiveThirtyEight</span>
-              <img
-                width="197"
-                height="25"
-                alt="FiveThirtyEight"
-                src="data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0MjEgNTMuNzYiPjxkZWZzPjxzdHlsZT4uY2xzLTF7ZmlsbDojMDEwMTAxO308L3N0eWxlPjwvZGVmcz48dGl0bGU+QXJ0Ym9hcmQgOTU8L3RpdGxlPjxwYXRoIGNsYXNzPSJjbHMtMSIgZD0iTTAgMGgyNXY4SDl2MTBoMTV2OEg5djE3SDBWMHpNMzEgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdIMzF6bTUtMzZoOHY4aC04ek0xNzkgMzZoNVYxOGgtNXYtOGgxM3YyNmg0djdoLTE3em01LTM2aDh2OGgtOHpNMzE2IDM2aDVWMThoLTV2LThoMTN2MjZoNHY3aC0xN3ptNS0zNmg4djhoLTh6TTU0IDI3VjEwaDh2MTVsNCA5Ljk4aDFMNzEgMjVWMTBoOHYxN2wtNyAxNkg2MWwtNy0xNnpNMTExIDQzSDk3LjQyQzg5LjIzIDQzIDg1IDM5LjE5IDg1IDMxLjE3VjIyYzAtNy41NyA0LjMtMTMgMTMtMTMgOS4zMyAwIDEzIDUuMDcgMTMgMTR2N0g5NHYxLjc0YzAgMi42MiAxIDQuMjYgMy40MiA0LjI2SDExMXpNOTQgMjNoOHYtMS41NWMwLTIuNjItMS4wNi01LjQ1LTQuMTMtNS40NS0yLjc5IDAtMy44NyAyLjItMy44NyA1LjQ1ek0xMjUgOGgtMTBWMGgyOXY4aC0xMHYzNWgtOVY4ek0yMDIgNDNWMTBoOHY0YzEuMTQtMi40NSAzLjc1LTQgNy4yMi00SDIyMHY4aC02Yy0yLjg0IDAtNCAuOTQtNCAzLjlWNDN6TTI0NSA0M2gtNC44NEMyMzMuMDUgNDMgMjMwIDM5LjMxIDIzMCAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0gyNDV6TTQyMSA0M2gtNC44NEM0MDkuMDUgNDMgNDA2IDM5LjMxIDQwNiAzMS44NVYxOGgtNnYtOGg2VjNoOHY3aDd2OGgtN2wtLjA3IDEzLjkzYzAgMi4yMi45MyA0LjA3IDMuNjYgNC4wN0g0MjF6TTI1NC4yNiA1My43Nmw0LjYxLTkuNUwyNTEgMjdWMTBoOHYxNWw0IDEwaDFsNC0xMFYxMGg4djE3bC0xMi4zIDI2Ljc2aC05LjQ0ek0yODQgMGgyNXY4aC0xNnY5aDE1djhoLTE1djEwaDE2djhoLTI1VjB6TTMzNyA0OHYtMmgxNi4xYzIgMCAyLjktLjE4IDIuOS0xLjI3di0uMzRjMC0xLjA4LS45MS0xLjM5LTIuOS0xLjM5SDM0MHYtNWw1LTVjLTUuMjktMS40OC04LTUuNDMtOC0xMXYtMWMwLTcuNTYgNC40NC0xMiAxNC0xMmEyMS45MyAyMS45MyAwIDAgMSA1Ljk1IDFMMzYxIDRsNSAzLTQgNmMxLjM3IDEuOTMgMyA0LjkzIDMgOHYxYzAgNy0zLjMgMTAuNjYtMTIgMTFsLTMgNGg2YzUuOTIgMCA5IDIuNjIgOSA3LjY4di4xMWMwIDUuMDYtMi43MSA4LjIxLTguNjIgOC4yMWgtMTNjLTQuMjkgMC02LjM4LTEuODQtNi4zOC01em0xOS0yNXYtM2MwLTMuMy0xLjMzLTQtNS00cy01IC43LTUgNHYzYzAgMy4zIDEuMzkgNCA1IDRzNS0uNyA1LTR6TTM4MCA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuNC00IDctNCA2LjI2IDAgOSAzLjA4IDkgMTAuNzZWNDNoLThWMjJjMC0zLjEzLTEuMDctNS00LTVzLTQgMS44Ny00IDV6TTE1NyA0M2gtOFYwaDh2MTRjMS4xNC0yLjY3IDMuOTEtNCA3LjQ5LTQgNi4yNiAwIDguNTEgMy4xMyA4LjUxIDEwLjgxVjQzaC04VjIxYzAtMy4xMy0xLjA3LTQuNDQtNC00LjQ0cy00IDIuMjYtNCA1LjM5eiIvPjwvc3ZnPg=="
-              />{' '}
-              <span className="-mb-0.5 text-[#3c3c3c]">replica</span>
-            </h1>
-            <div className="md:flex items-center gap-x-3 text-[#3c3c3c] -mb-1 hidden">
-              <a
-                className="hover:opacity-75 transition"
-                href="https://portaljs.org"
-              >
-                Built with 🌀PortalJS
-              </a>
-              <hr className="h-[80%] border border-[#3c3c3c] opacity-75 my-2"></hr>
-              <a
-                className="hover:opacity-75 transition"
-                href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
-              >
-                Github
-              </a>
-            </div>
-          </div>
-          <div className="mx-2 py-1.5 text-[14px] text-[#3c3c3c] md:hidden">
-            <ul className="flex gap-x-4">
-              <li>
-                <a
-                  className="hover:opacity-75 transition"
-                  href="https://portaljs.org"
-                >
-                  PortalJS
-                </a>
-              </li>
-              <li>
-                <a
-                  className="hover:opacity-75 transition"
-                  href="https://github.com/datopian/portaljs/tree/main/examples/fivethirtyeight"
-                >
-                  View on Github
-                </a>
-              </li>
-            </ul>
-          </div>
-        </header>
-        <Main />
-        <NextScript />
-      </body>
-    </Html>
-  );
-}

examples/fivethirtyeight/pages/datasets/[datasetName].tsx

@@ -1,131 +0,0 @@
-import { NextSeo } from 'next-seo';
-import { promises as fs } from 'fs';
-import path from 'path';
-import getConfig from 'next/config';
-import { getProjectReadme, GithubProject } from '@/lib/octokit';
-import remarkGfm from 'remark-gfm';
-import extract from 'remark-extract-frontmatter';
-import { Dataset } from '..';
-import { GetStaticProps } from 'next';
-import { Table } from '@portaljs/components';
-import Breadcrumbs from '@/components/Breadcrumbs';
-import { ReactMarkdown } from 'react-markdown/lib/react-markdown';
-import remarkFrontmatter from 'remark-frontmatter';
-
-export default function DatasetPage({
-  dataset,
-}: {
-  dataset: Dataset & {
-    readme: string | null;
-  };
-}) {
-  return (
-    <>
-      <NextSeo title={`${dataset.name} page`} />
-      <main className="max-w-5xl px-2 prose mx-auto my-8 prose-thead:border-b-4 prose-table:max-w-5xl prose-table:overflow-scroll prose-thead:overflow-scroll prose-tbody:overflow-scroll prose-thead:pb-2 prose-thead:border-zinc-900 prose-th:uppercase prose-th:text-left prose-th:font-light prose-th:text-xs">
-        <Breadcrumbs links={[{ title: dataset.name, href: '' }]} />
-        <h1 className="uppercase mb-0 mt-16">{dataset.name}</h1>
-        <p className="mb-8">
-          <span className="font-semibold">Repository:</span>{' '}
-          <a target="_blank" href={dataset.url}>
-            {dataset.url}
-          </a>
-        </p>
-
-        <h2 className="mb-0 mt-10">FILES</h2>
-        <div className="inline-block min-w-full py-2 align-middle">
-          <table className="min-w-full divide-y divide-gray-300">
-            <thead className="border-b-4 pb-2 border-zinc-900">
-              <tr>
-                <th
-                  className="uppercase text-left font-light text-xs pb-3"
-                  scope="col"
-                >
-                  Name
-                </th>
-              </tr>
-            </thead>
-            <tbody className="divide-y divide-gray-200">
-              {dataset.files?.map((file) => (
-                <tr key={file}>
-                  <td className="whitespace-nowrap text-left py-4 text-sm text-gray-500">
-                    <a href={file}>{file.split('/').slice(-1)}</a>
-                  </td>
-                </tr>
-              ))}
-            </tbody>
-          </table>
-        </div>
-        {dataset.files && dataset.files.length > 0 && (
-          <>
-            <h2 className="mb-0 mt-10">DATA PREVIEWS</h2>
-            {dataset.files?.map((file) => (
-              <div key={file} className="preview-table my-8">
-                <h3>{file.split('/').slice(-1)}</h3>
-                <Table url={file} />
-              </div>
-            ))}
-          </>
-        )}
-        {dataset.readme && (
-          <>
-            <h2 className="uppercase font-black">Readme</h2>
-            {dataset.readme && (
-              <ReactMarkdown
-                remarkPlugins={[
-                  remarkFrontmatter,
-                  remarkGfm,
-                  [extract, { remove: true }],
-                ]}
-              >
-                {dataset.readme}
-              </ReactMarkdown>
-            )}
-          </>
-        )}
-      </main>
-    </>
-  );
-}
-
-export async function getStaticPaths() {
-  const datasetsFile = path.join(process.cwd(), 'datasets.json');
-  const datasets = await fs.readFile(datasetsFile, 'utf8');
-
-  return {
-    paths: JSON.parse(datasets).map((dataset: Dataset) => {
-      return {
-        params: { datasetName: dataset.name },
-      };
-    }),
-    fallback: false, // can also be true or 'blocking'
-  };
-}
-
-export const getStaticProps: GetStaticProps = async ({ params }) => {
-  const datasetsFile = path.join(process.cwd(), 'datasets.json');
-  const datasetsString = await fs.readFile(datasetsFile, 'utf8');
-  const datasets: Dataset[] = JSON.parse(datasetsString);
-  const dataset: Dataset | undefined = datasets.find(
-    (_dataset) => _dataset.name === params?.datasetName
-  );
-  const github_pat = getConfig().serverRuntimeConfig.github_pat;
-  const readmes = await Promise.all(['/README.md', '/readme.md', '/Readme.md'].map(async (readme) => await getProjectReadme(
-    'fivethirtyeight',
-    'data',
-    'master',
-    dataset?.name + readme,
-    github_pat
-  )));
-  const readme = readmes.find(item => item !== null)
-  if (!readme) console.log('Readme not found for ' + dataset?.name)
-  return {
-    props: {
-      dataset: {
-        ...dataset,
-        readme,
-        files: dataset && dataset.files ? dataset.files : null,
-      },
-    },
-  };
-};

examples/fivethirtyeight/pages/index.tsx

@@ -1,211 +0,0 @@
-import Image from 'next/image';
-import { Inter } from 'next/font/google';
-import { format } from 'timeago.js';
-import { promises as fs } from 'fs';
-import path from 'path';
-import { NextSeo } from 'next-seo';
-
-const inter = Inter({ subsets: ['latin'] });
-
-export interface Article {
-  date: string;
-  title: string;
-  url: string;
-}
-
-export interface Dataset {
-  url: string;
-  name: string;
-  displayName: string;
-  articles: Article[];
-  files?: string[];
-}
-
-// Request a weekday along with a long date
-const options = {
-  year: 'numeric',
-  month: 'long',
-  day: 'numeric',
-} as const;
-
-export function MobileItem({ dataset }: { dataset: Dataset }) {
-  return (
-    <div className="flex gap-x-2 pb-2 py-4 items-center justify-between border-b border-zinc-600">
-      <div className="flex flex-col">
-        <span className="font-mono font-light">{dataset.name}</span>
-        {dataset.articles.map((article) => (
-          <div key={article.title} className="py-1 flex flex-col">
-            <span className="font-bold hover:underline">{article.title}</span>
-            <span className="font-light text-base">
-              {format(article.date).includes('years')
-                ? new Date(article.date).toLocaleString('en-US', options)
-                : format(article.date)}
-            </span>{' '}
-          </div>
-        ))}
-      </div>
-      <div className="flex flex-col justify-start">
-        <a
-          className="ml-2 border border-zinc-900 font-light px-4 py-1 text-sm transition hover:bg-zinc-900 hover:text-white"
-          href={dataset.url}
-        >
-          info
-        </a>
-        {/*
-                <button>
-                  <svg
-                    xmlns="http://www.w3.org/2000/svg"
-                    viewBox="0 0 24 24"
-                    fill="currentColor"
-                    className="w-12 h-12 text-blue-400 hover:text-blue-300 transition mt-1"
-                  >
-                    <path
-                      fillRule="evenodd"
-                      d="M12 2.25c-5.385 0-9.75 4.365-9.75 9.75s4.365 9.75 9.75 9.75 9.75-4.365 9.75-9.75S17.385 2.25 12 2.25zm-.53 14.03a.75.75 0 001.06 0l3-3a.75.75 0 10-1.06-1.06l-1.72 1.72V8.25a.75.75 0 00-1.5 0v5.69l-1.72-1.72a.75.75 0 00-1.06 1.06l3 3z"
-                      clipRule="evenodd"
-                    />
-                  </svg>
-                </button> */}
-      </div>
-    </div>
-  );
-}
-
-export function DesktopItem({ dataset }: { dataset: Dataset }) {
-  return (
-    <>
-      {dataset.articles.map((article, index) => (
-        <tr
-          key={article.url}
-          className={`${
-            index === dataset.articles.length - 1 ? 'border-b' : ''
-          } border-zinc-400`}
-        >
-          <td className="py-8 font-light font-mono text-[13px] text-zinc-700">
-            {index === 0 ? dataset.name : ''}
-          </td>
-          <td>
-            <a
-              className="py-8 font-bold hover:underline pr-2"
-              href={article.url}
-            >
-              {article.title}
-            </a>
-          </td>
-          <td className="py-8 font-light text-[14px] min-w-[138px] font-mono text-[#999]">
-            {format(article.date).includes('years')
-              ? new Date(article.date).toLocaleString('en-US', options)
-              : format(article.date)}
-          </td>
-          <td className="py-8">
-            {index === 0 && (
-              <a
-                className="ml-2 border border-zinc-900 font-light px-[25px] py-2.5 text-sm transition hover:bg-zinc-900 hover:text-white"
-                href={dataset.url}
-              >
-                info
-              </a>
-            )}
-          </td>
-          {/*
-              <td>
-                <button>
-                  <svg
-                    xmlns="http://www.w3.org/2000/svg"
-                    viewBox="0 0 24 24"
-                    fill="currentColor"
-                    className="w-12 h-12 text-blue-400 hover:text-blue-300 transition mt-1"
-                  >
-                    <path
-                      fillRule="evenodd"
-                      d="M12 2.25c-5.385 0-9.75 4.365-9.75 9.75s4.365 9.75 9.75 9.75 9.75-4.365 9.75-9.75S17.385 2.25 12 2.25zm-.53 14.03a.75.75 0 001.06 0l3-3a.75.75 0 10-1.06-1.06l-1.72 1.72V8.25a.75.75 0 00-1.5 0v5.69l-1.72-1.72a.75.75 0 00-1.06 1.06l3 3z"
-                      clipRule="evenodd"
-                    />
-                  </svg>
-                </button>
-              </td>*/}
-        </tr>
-      ))}
-    </>
-  );
-}
-
-export async function getStaticProps() {
-  const jsonDirectory = path.join(process.cwd(), '/datasets.json');
-  const datasetString = await fs.readFile(jsonDirectory, 'utf8');
-  const datasets = JSON.parse(datasetString);
-  return {
-    props: { datasets },
-  };
-}
-
-export default function Home({ datasets }: { datasets: Dataset[] }) {
-  return (
-    <>
-      <NextSeo title="FiveThirtyEight tribute by PortalJS" />
-      <main
-        className={`flex min-h-screen flex-col items-center max-w-5xl mx-auto pt-20 px-2.5 ${inter.className}`}
-      >
-        <div>
-          <h1 className="text-[40px] font-bold text-zinc-800 text-center">
-            Our Data
-          </h1>
-          <p className="max-w-[600px] text-[17px] text-center text-[#6d6f71]">
-            We’re sharing the data and code behind some of our articles and
-            graphics. We hope you’ll use it to check our work and to create
-            stories and visualizations of&nbsp;your&nbsp;own.
-          </p>
-        </div>
-        <article className="w-full px-2 md:hidden py-4">
-          {datasets.map((dataset) => (
-            <MobileItem key={dataset.name} dataset={dataset} />
-          ))}
-        </article>
-        <table className="w-full mt-10 mb-4 hidden md:table">
-          <thead className="border-b-4 pb-2 border-zinc-900">
-            <tr>
-              <th className="uppercase text-left font-normal text-xs pb-3">
-                data set
-              </th>
-              <th className="uppercase text-left font-normal text-xs pb-3">
-                related content
-              </th>
-              <th className="uppercase text-left font-normal text-xs pb-3">
-                last updated
-              </th>
-            </tr>
-          </thead>
-          <tbody>
-            {datasets.map((dataset) => (
-              <DesktopItem key={dataset.name} dataset={dataset} />
-            ))}
-          </tbody>
-        </table>
-        <p className="text-[13px] py-8">
-          Unless otherwise noted, our data sets are available under the{' '}
-          <a
-            className="text-blue-400 hover:underline"
-            href="http://creativecommons.org/licenses/by/4.0/"
-          >
-            Creative Commons Attribution 4.0 International license
-          </a>
-          , and the code is available under the{' '}
-          <a
-            className="text-blue-400 hover:underline"
-            href="http://opensource.org/licenses/MIT"
-          >
-            MIT license
-          </a>
-          . If you find this information useful, please{' '}
-          <a
-            className="text-blue-400 hover:underline"
-            href="mailto:data@fivethirtyeight.com"
-          >
-            let us know
-          </a>
-          .
-        </p>
-      </main>
-    </>
-  );
-}

examples/fivethirtyeight/public/next.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

examples/fivethirtyeight/public/vercel.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 283 64"><path fill="black" d="M141 16c-11 0-19 7-19 18s9 18 20 18c7 0 13-3 16-7l-7-5c-2 3-6 4-9 4-5 0-9-3-10-7h28v-3c0-11-8-18-19-18zm-9 15c1-4 4-7 9-7s8 3 9 7h-18zm117-15c-11 0-19 7-19 18s9 18 20 18c6 0 12-3 16-7l-8-5c-2 3-5 4-8 4-5 0-9-3-11-7h28l1-3c0-11-8-18-19-18zm-10 15c2-4 5-7 10-7s8 3 9 7h-19zm-39 3c0 6 4 10 10 10 4 0 7-2 9-5l8 5c-3 5-9 8-17 8-11 0-19-7-19-18s8-18 19-18c8 0 14 3 17 8l-8 5c-2-3-5-5-9-5-6 0-10 4-10 10zm83-29v46h-9V5h9zM37 0l37 64H0L37 0zm92 5-27 48L74 5h10l18 30 17-30h10zm59 12v10l-3-1c-6 0-10 4-10 10v15h-9V17h9v9c0-5 6-9 13-9z"/></svg>

examples/fivethirtyeight/styles/globals.css

@@ -1,8 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-.preview-table > div {
-  overflow-x: scroll;
-  overflow-y: hidden;
-}

examples/fivethirtyeight/tailwind.config.js

@@ -1,18 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-module.exports = {
-  content: [
-    './pages/**/*.{js,ts,jsx,tsx,mdx}',
-    './components/**/*.{js,ts,jsx,tsx,mdx}',
-    './app/**/*.{js,ts,jsx,tsx,mdx}',
-  ],
-  theme: {
-    extend: {
-      backgroundImage: {
-        'gradient-radial': 'radial-gradient(var(--tw-gradient-stops))',
-        'gradient-conic':
-          'conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))',
-      },
-    },
-  },
-  plugins: [require('@tailwindcss/typography')],
-};

examples/fivethirtyeight/tsconfig.json

@@ -1,23 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es5",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "node",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "preserve",
-    "incremental": true,
-    "paths": {
-      "@/*": ["./*"]
-    }
-  },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
-  "exclude": ["node_modules"]
-}

examples/github-backed-catalog/.eslintrc.json

@@ -1,29 +0,0 @@
-{
-  "extends": ["next", "next/core-web-vitals"],
-  "ignorePatterns": ["!**/*", ".next/**/*"],
-  "overrides": [
-    {
-      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
-      "rules": {
-        "@next/next/no-html-link-for-pages": [
-          "error",
-          "examples/simple-example/pages"
-        ]
-      }
-    },
-    {
-      "files": ["*.ts", "*.tsx"],
-      "rules": {}
-    },
-    {
-      "files": ["*.js", "*.jsx"],
-      "rules": {}
-    }
-  ],
-  "rules": {
-    "@next/next/no-html-link-for-pages": "off"
-  },
-  "env": {
-    "jest": true
-  }
-}

examples/github-backed-catalog/.prettierignore

@@ -1,7 +0,0 @@
-node_modules
-**/.next/**
-**/_next/**
-**/dist/**
-**/__tmp__/**
-lerna.json
-.github

examples/github-backed-catalog/.prettierrc.json

@@ -1 +0,0 @@
-{}

examples/github-backed-catalog/README.md

@@ -1,101 +0,0 @@
-# A data catalog with data on GitHub
-
-This example showcases a simple data catalog that get its data from a list of GitHub repos that serve as datasets.
-
-A `datasets.json` file is used to specify which datasets are going to be part of the data catalog.
-
-The application contains an index page, which lists all the datasets specified in the `datasets.json` file, and users can see more information about each dataset, such as the list of data files in it and the README, by clicking the "info" button on the list.
-
-You can read more about it on the [Data catalog with data on GitHub](https://portaljs.org/docs/examples/github-backed-catalog) blog post.
-
-## Demo
-
-https://example.portaljs.org/
-
-## Deploy your own
-
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fdatopian%2Fportaljs%2Ftree%2Fmain%2Fexamples%2Fgithub-backed-catalog)
-
-By clicking on this button, you will be redirected to a page which will allow you to clone the content into your own GitHub/GitLab/Bitbucket account and automatically deploy everything.
-
-## How to use
-
-### Install
-
-Execute `create-next-app` to bootstrap the example:
-
-```
-npx create-next-app <app-name> --example https://github.com/datopian/portaljs/tree/main/examples/github-backed-catalog
-cd <app-name>
-```
-
-### Set environment variables
-
-This project uses the GitHub API, which for anonymous users will cap at 50 requests per hour, so you might want to get a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) and add it to a `.env` file inside the folder like so
-
-```
-GITHUB_PAT=<github token>
-```
-
-### Change datasets
-
-You can change the datasets that will be displayed in the data catalog by editing the file `datasets.json`. Some examples can be found inside [this repo](https://github.com/datasets).
-
-### Run in development mode
-
-Run the app using:
-
-```
-npm run dev
-```
-
-Open http://localhost:3000 from your browser. You should see something similar to this:
-
-![](https://i.imgur.com/jAljJ9C.png)
-
-If click on the `info` button for a dataset you will see a page similar to this:
-
-![](https://i.imgur.com/AoJd4O0.png)
-
-## Notes
-
-### Structure of `datasets.json`
-
-The `datasets.json` file is simply a list of datasets, below you can see a minimal example of a dataset:
-
-```json
-{
-  "owner": "fivethirtyeight",
-  "repo": "data",
-  "branch": "master",
-  "files": ["nba-raptor/historical_RAPTOR_by_player.csv", "nba-raptor/historical_RAPTOR_by_team.csv"],
-  "readme": "nba-raptor/README.md"
-}
-```
-
-It has:
-
-- A `owner` which is going to be the github repo owner
-- A `repo` which is going to be the github repo name
-- A `branch` which is going to be the branch to which we need to get the files and the readme
-- A list of `files` which is going to be a list of paths with files that you want to show to the world
-- A `readme` which is going to be the path to your data description, it can also be a subpath eg: `example/README.md`
-
-You can also add:
-
-- A `description` which is useful if you have more than one dataset for each repo, if not provided we are just going to use the repo description
-- A `Name` which is useful if you want to give your dataset a nice name, if not provided we are going to use the junction of the `owner` the `repo` + the path of the README, in the exaple above it will be `fivethirtyeight/data/nba-raptor`
-
-### Extra commands
-
-You can also build the project for production with:
-
-```
-npm run build
-```
-
-And run the production build with:
-
-```
-npm run start
-```

examples/github-backed-catalog/components/_shared/Breadcrumbs.tsx

@@ -1,28 +0,0 @@
-import Link from "next/link";
-import HomeIcon from "../icons/HomeIcon";
-
-export default function Breadcrumbs({
-  links,
-}: {
-  links: { title: string; href?: string; target?: string }[];
-}) {
-  const current = links.at(-1);
-
-  return (
-    <div className="flex items-center uppercase font-black text-xs">
-      <Link className="flex items-center" href="/">
-        <HomeIcon />
-      </Link>
-
-      {/* {links.length > 1 && links.slice(0, -1).map((link) => {
-      return <>
-        <span className="mx-4">/</span>
-        <Link href={link.href}>{link.title}</Link>
-      </>
-    })} */}
-
-      <span className="mx-4">/</span>
-      <span>{current.title}</span>
-    </div>
-  );
-}

examples/github-backed-catalog/components/icons/ExternalLinkIcon.tsx

@@ -1,13 +0,0 @@
-export default function ExternalLinkIcon({ className = "" }) {
-  return (
-    <div className={`inline-block w-4 ${className}`}>
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 64 64"
-        fill="currentColor"
-      >
-        <path d="M 40 10 C 38.896 10 38 10.896 38 12 C 38 13.104 38.896 14 40 14 L 47.171875 14 L 30.585938 30.585938 C 29.804938 31.366938 29.804938 32.633063 30.585938 33.414062 C 30.976938 33.805063 31.488 34 32 34 C 32.512 34 33.023063 33.805062 33.414062 33.414062 L 50 16.828125 L 50 24 C 50 25.104 50.896 26 52 26 C 53.104 26 54 25.104 54 24 L 54 12 C 54 10.896 53.104 10 52 10 L 40 10 z M 18 12 C 14.691 12 12 14.691 12 18 L 12 46 C 12 49.309 14.691 52 18 52 L 46 52 C 49.309 52 52 49.309 52 46 L 52 34 C 52 32.896 51.104 32 50 32 C 48.896 32 48 32.896 48 34 L 48 46 C 48 47.103 47.103 48 46 48 L 18 48 C 16.897 48 16 47.103 16 46 L 16 18 C 16 16.897 16.897 16 18 16 L 30 16 C 31.104 16 32 15.104 32 14 C 32 12.896 31.104 12 30 12 L 18 12 z" />
-      </svg>
-    </div>
-  );
-}

examples/github-backed-catalog/components/icons/HomeIcon.tsx

@@ -1,10 +0,0 @@
-export default function HomeIcon({ className = "" }) {
-  return (
-    <div className={`inline-block w-4 ${className}`}>
-      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-        {" "}
-        <path d="M 12 2 A 1 1 0 0 0 11.289062 2.296875 L 1.203125 11.097656 A 0.5 0.5 0 0 0 1 11.5 A 0.5 0.5 0 0 0 1.5 12 L 4 12 L 4 20 C 4 20.552 4.448 21 5 21 L 9 21 C 9.552 21 10 20.552 10 20 L 10 14 L 14 14 L 14 20 C 14 20.552 14.448 21 15 21 L 19 21 C 19.552 21 20 20.552 20 20 L 20 12 L 22.5 12 A 0.5 0.5 0 0 0 23 11.5 A 0.5 0.5 0 0 0 22.796875 11.097656 L 12.716797 2.3027344 A 1 1 0 0 0 12.710938 2.296875 A 1 1 0 0 0 12 2 z" />
-      </svg>
-    </div>
-  );
-}

examples/github-backed-catalog/index.d.ts

@@ -1,6 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-declare module "*.svg" {
-  const content: any;
-  export const ReactComponent: any;
-  export default content;
-}

examples/github-backed-catalog/next.config.js

@@ -1,17 +0,0 @@
-const nextConfig = {
-  async rewrites() {
-    return {
-      beforeFiles: [
-        {
-          source: "/@:org/:project*",
-          destination: "/@org/:org/:project*",
-        },
-      ],
-    };
-  },
-  serverRuntimeConfig: {
-    github_pat: process.env.GITHUB_PAT ? process.env.GITHUB_PAT : null,
-  },
-};
-
-module.exports = nextConfig;

examples/github-backed-catalog/pages/_app.tsx

@@ -1,18 +0,0 @@
-import { AppProps } from "next/app";
-import Head from "next/head";
-import "./styles.css";
-
-function CustomApp({ Component, pageProps }: AppProps) {
-  return (
-    <>
-      <Head>
-        <title>GitHub Datasets</title>
-      </Head>
-      <main className="app">
-        <Component {...pageProps} />
-      </main>
-    </>
-  );
-}
-
-export default CustomApp;

examples/github-backed-catalog/pages/index.tsx

@@ -1,139 +0,0 @@
-import { promises as fs } from "fs";
-import path from "path";
-import { getProject } from "../lib/octokit";
-import getConfig from "next/config";
-import ExternalLinkIcon from "../components/icons/ExternalLinkIcon";
-import TimeAgo from "react-timeago";
-import Link from "next/link";
-import { NextSeo } from "next-seo";
-
-export async function getStaticProps() {
-  const jsonDirectory = path.join(process.cwd(), "/datasets.json");
-  const repos = await fs.readFile(jsonDirectory, "utf8");
-  const github_pat = getConfig().serverRuntimeConfig.github_pat;
-
-  const projects = await Promise.all(
-    JSON.parse(repos).map(async (repo) => {
-      const project = await getProject(repo, github_pat);
-      return { ...project, repo_config: repo };
-    })
-  );
-  return {
-    props: {
-      projects,
-    },
-  };
-}
-
-export function Datasets({ projects }) {
-  return (
-    <>
-      <NextSeo title="GitHub Datasets" />
-      <div className="bg-white min-h-screen">
-        <div className="mx-auto max-w-7xl px-6 py-16 sm:py-24 lg:px-8">
-          <div className="text-center">
-            <h2 className="text-3xl font-bold leading-10 tracking-tight">
-              GitHub Datasets
-            </h2>
-            <p className="mt-3 mx-auto max-w-2xl text-base leading-7 text-gray-500">
-              Data catalog with datasets hosted on GitHub by{" "}
-              <Link
-                target="_blank"
-                className="underline"
-                href="https://portaljs.org/"
-              >
-                🌀 PortalJS
-              </Link>
-            </p>
-          </div>
-          <div className="mt-20">
-            <div className="-mx-4 -my-2 overflow-x-auto sm:-mx-6 lg:-mx-8">
-              <div className="inline-block min-w-full py-2 align-middle sm:px-6 lg:px-8">
-                <table className="min-w-full divide-y divide-gray-300">
-                  <thead>
-                    <tr>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Name
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Repository
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Description
-                      </th>
-                      <th
-                        scope="col"
-                        className="px-3 py-3.5 text-left text-sm font-semibold text-gray-900"
-                      >
-                        Last updated
-                      </th>
-                      <th
-                        scope="col"
-                        className="relative py-3.5 pl-3 pr-4 sm:pr-0"
-                      ></th>
-                    </tr>
-                  </thead>
-                  <tbody className="divide-y divide-gray-200">
-                    {projects.map((project) => (
-                      <tr key={project.id}>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                          {project.repo_config.name
-                            ? project.repo_config.name
-                            : project.full_name +
-                              (project.base_path === "/"
-                                ? ""
-                                : "/" + project.base_path)}
-                        </td>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm group text-gray-500 hover:text-gray-900 transition-all duration-250">
-                          <a
-                            href={project.html_url}
-                            target="_blank"
-                            className="flex items-center"
-                          >
-                            @{project.full_name}{" "}
-                            <ExternalLinkIcon className="ml-1" />
-                          </a>
-                        </td>
-                        <td className="px-3 py-4 text-sm text-gray-500">
-                          {project.repo_config.description
-                            ? project.repo_config.description
-                            : project.description}
-                        </td>
-                        <td className="whitespace-nowrap px-3 py-6 text-sm text-gray-500">
-                          <TimeAgo date={new Date(project.last_updated)} />
-                        </td>
-                        <td className="relative whitespace-nowrap py-6 pl-3 pr-4 text-right text-sm font-medium sm:pr-0">
-                          <a
-                            href={`/@${project.repo_config.owner}/${
-                              project.repo_config.repo
-                            }/${
-                              project.base_path === "/" ? "" : project.base_path
-                            }`}
-                            className="border border-gray-900 text-gray-900 px-4 py-2 transition-all hover:bg-gray-900 hover:text-white"
-                          >
-                            info
-                          </a>
-                        </td>
-                      </tr>
-                    ))}
-                  </tbody>
-                </table>
-              </div>
-            </div>
-          </div>
-        </div>
-      </div>
-    </>
-  );
-}
-
-export default Datasets;

examples/github-backed-catalog/pages/styles.css

@@ -1,80 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-html {
-  -webkit-text-size-adjust: 100%;
-  font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
-    Segoe UI, Roboto, Helvetica Neue, Arial, Noto Sans, sans-serif,
-    Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji;
-  line-height: 1.5;
-  tab-size: 4;
-  scroll-behavior: smooth;
-}
-body {
-  font-family: inherit;
-  line-height: inherit;
-  margin: 0;
-}
-h1,
-h2,
-p,
-pre {
-  margin: 0;
-}
-*,
-::before,
-::after {
-  box-sizing: border-box;
-  border-width: 0;
-  border-style: solid;
-  border-color: currentColor;
-}
-h1,
-h2 {
-  font-size: inherit;
-  font-weight: inherit;
-}
-a {
-  color: inherit;
-  text-decoration: inherit;
-}
-pre {
-  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
-    Liberation Mono, Courier New, monospace;
-}
-svg {
-  display: block;
-  vertical-align: middle;
-  shape-rendering: auto;
-  text-rendering: optimizeLegibility;
-}
-pre {
-  background-color: rgba(55, 65, 81, 1);
-  border-radius: 0.25rem;
-  color: rgba(229, 231, 235, 1);
-  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
-    Liberation Mono, Courier New, monospace;
-  overflow: scroll;
-  padding: 0.5rem 0.75rem;
-}
-
-.shadow {
-  box-shadow: 0 0 #0000, 0 0 #0000, 0 10px 15px -3px rgba(0, 0, 0, 0.1),
-    0 4px 6px -2px rgba(0, 0, 0, 0.05);
-}
-.rounded {
-  border-radius: 1.5rem;
-}
-.wrapper {
-  width: 100%;
-}
-.container {
-  margin-left: auto;
-  margin-right: auto;
-  max-width: 768px;
-  padding-bottom: 3rem;
-  padding-left: 1rem;
-  padding-right: 1rem;
-  color: rgba(55, 65, 81, 1);
-  width: 100%;
-}

examples/github-backed-catalog/postcss.config.js

@@ -1,6 +0,0 @@
-module.exports = {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

examples/github-backed-catalog/tailwind.config.js

@@ -1,12 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-module.exports = {
-  content: [
-    "./app/**/*.{js,ts,jsx,tsx,mdx}",
-    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
-    "./components/**/*.{js,ts,jsx,tsx,mdx}",
-  ],
-  theme: {
-    extend: {},
-  },
-  plugins: [require("@tailwindcss/typography")],
-};

examples/learn-example/components/DRD.tsx

@@ -7,12 +7,13 @@ import { Mermaid } from '@flowershow/core';
 // to handle import statements. Instead, you must include components in scope
 // here.
 const components = {
-  Table: dynamic(() => import('@portaljs/components').then(mod => mod.Table)),
-  Catalog: dynamic(() => import('@portaljs/components').then(mod => mod.Catalog)),
+  Table: dynamic(() => import('./Table')),
   mermaid: Mermaid,
-  Vega: dynamic(() => import('@portaljs/components').then(mod => mod.Vega)),
-  VegaLite: dynamic(() => import('@portaljs/components').then(mod => mod.VegaLite)),
-  LineChart: dynamic(() => import('@portaljs/components').then(mod => mod.LineChart)),
+  // Excel: dynamic(() => import('../components/Excel')),
+  // TODO: try and make these dynamic ...
+  Vega: dynamic(() => import('./Vega')),
+  VegaLite: dynamic(() => import('./VegaLite')),
+  LineChart: dynamic(() => import('./LineChart')),
 } as any;
 
 export default function DRD({ source }: { source: any }) {

examples/learn-example/components/LineChart.tsx

@@ -0,0 +1,55 @@
+import VegaLite from "./VegaLite";
+
+export default function LineChart({
+  data = [],
+  fullWidth = false,
+  title = "",
+  xAxis = "x",
+  yAxis = "y",
+}) {
+  var tmp = data;
+  if (Array.isArray(data)) {
+    tmp = data.map((r, i) => {
+      return { x: r[0], y: r[1] };
+    });
+  }
+  const vegaData = { table: tmp };
+  const spec = {
+    $schema: "https://vega.github.io/schema/vega-lite/v5.json",
+    title,
+    width: "container",
+    height: 300,
+    mark: {
+      type: "line",
+      color: "black",
+      strokeWidth: 1,
+      tooltip: true,
+    },
+    data: {
+      name: "table",
+    },
+    selection: {
+      grid: {
+        type: "interval",
+        bind: "scales",
+      },
+    },
+    encoding: {
+      x: {
+        field: xAxis,
+        timeUnit: "year",
+        type: "temporal",
+      },
+      y: {
+        field: yAxis,
+        type: "quantitative",
+      },
+    },
+  };
+  if (typeof data === 'string') {
+    spec.data = { "url": data } as any
+    return <VegaLite fullWidth={fullWidth} spec={spec} />;
+  }
+
+  return <VegaLite fullWidth={fullWidth} data={vegaData} spec={spec} />;
+}

examples/learn-example/components/Table.tsx

@@ -7,7 +7,7 @@ import {
   getPaginationRowModel,
   getSortedRowModel,
   useReactTable,
-} from '@tanstack/react-table';
+} from "@tanstack/react-table";
 
 import {
   ArrowDownIcon,
@@ -16,29 +16,21 @@ import {
   ChevronDoubleRightIcon,
   ChevronLeftIcon,
   ChevronRightIcon,
-} from '@heroicons/react/24/solid';
+} from "@heroicons/react/24/solid";
 
-import React, { useEffect, useMemo, useState } from 'react';
+import React, { useEffect, useMemo, useState } from "react";
 
-import parseCsv from '../lib/parseCsv';
-import DebouncedInput from './DebouncedInput';
-import loadData from '../lib/loadData';
+import parseCsv from "../lib/parseCsv";
+import DebouncedInput from "./DebouncedInput";
+import loadData from "../lib/loadData";
 
-export type TableProps = {
-  data?: Array<{ [key: string]: number | string }>;
-  cols?: Array<{ [key: string]: string }>;
-  csv?: string;
-  url?: string;
-  fullWidth?: boolean;
-};
-
-export const Table = ({
+const Table = ({
   data: ogData = [],
   cols: ogCols = [],
-  csv = '',
-  url = '',
+  csv = "",
+  url = "",
   fullWidth = false,
-}: TableProps) => {
+}) => {
   if (csv) {
     const out = parseCsv(csv);
     ogData = out.rows;
@@ -47,19 +39,19 @@ export const Table = ({
 
   const [data, setData] = React.useState(ogData);
   const [cols, setCols] = React.useState(ogCols);
-  // const [error, setError] = React.useState(""); //  TODO: add error handling
+  const [error, setError] = React.useState(""); //  TODO: add error handling
 
   const tableCols = useMemo(() => {
     const columnHelper = createColumnHelper();
     return cols.map((c) =>
-      columnHelper.accessor<any, string>(c.key, {
+      columnHelper.accessor(c.key, {
         header: () => c.name,
         cell: (info) => info.getValue(),
       })
     );
   }, [data, cols]);
 
-  const [globalFilter, setGlobalFilter] = useState('');
+  const [globalFilter, setGlobalFilter] = useState("");
 
   const table = useReactTable({
     data,
@@ -86,24 +78,24 @@ export const Table = ({
   }, [url]);
 
   return (
-    <div className={`${fullWidth ? 'w-[90vw] ml-[calc(50%-45vw)]' : 'w-full'}`}>
+    <div className={`${fullWidth ? "w-[90vw] ml-[calc(50%-45vw)]" : "w-full"}`}>
       <DebouncedInput
-        value={globalFilter ?? ''}
-        onChange={(value: any) => setGlobalFilter(String(value))}
+        value={globalFilter ?? ""}
+        onChange={(value) => setGlobalFilter(String(value))}
         className="p-2 text-sm shadow border border-block"
         placeholder="Search all columns..."
       />
-      <table className="w-full mt-10">
-        <thead className="text-left border-b border-b-slate-300">
+      <table>
+        <thead>
           {table.getHeaderGroups().map((hg) => (
             <tr key={hg.id}>
               {hg.headers.map((h) => (
-                <th key={h.id} className="pr-2 pb-2">
+                <th key={h.id}>
                   <div
                     {...{
                       className: h.column.getCanSort()
-                        ? 'cursor-pointer select-none'
-                        : '',
+                        ? "cursor-pointer select-none"
+                        : "",
                       onClick: h.column.getToggleSortingHandler(),
                     }}
                   >
@@ -126,9 +118,9 @@ export const Table = ({
         </thead>
         <tbody>
           {table.getRowModel().rows.map((r) => (
-            <tr key={r.id} className="border-b border-b-slate-200">
+            <tr key={r.id}>
               {r.getVisibleCells().map((c) => (
-                <td key={c.id} className="py-2">
+                <td key={c.id}>
                   {flexRender(c.column.columnDef.cell, c.getContext())}
                 </td>
               ))}
@@ -136,10 +128,10 @@ export const Table = ({
           ))}
         </tbody>
       </table>
-      <div className="flex gap-2 items-center justify-center mt-10">
+      <div className="flex gap-2 items-center justify-center">
         <button
           className={`w-6 h-6 ${
-            !table.getCanPreviousPage() ? 'opacity-25' : 'opacity-100'
+            !table.getCanPreviousPage() ? "opacity-25" : "opacity-100"
           }`}
           onClick={() => table.setPageIndex(0)}
           disabled={!table.getCanPreviousPage()}
@@ -148,7 +140,7 @@ export const Table = ({
         </button>
         <button
           className={`w-6 h-6 ${
-            !table.getCanPreviousPage() ? 'opacity-25' : 'opacity-100'
+            !table.getCanPreviousPage() ? "opacity-25" : "opacity-100"
           }`}
           onClick={() => table.previousPage()}
           disabled={!table.getCanPreviousPage()}
@@ -158,13 +150,13 @@ export const Table = ({
         <span className="flex items-center gap-1">
           <div>Page</div>
           <strong>
-            {table.getState().pagination.pageIndex + 1} of{' '}
+            {table.getState().pagination.pageIndex + 1} of{" "}
             {table.getPageCount()}
           </strong>
         </span>
         <button
           className={`w-6 h-6 ${
-            !table.getCanNextPage() ? 'opacity-25' : 'opacity-100'
+            !table.getCanNextPage() ? "opacity-25" : "opacity-100"
           }`}
           onClick={() => table.nextPage()}
           disabled={!table.getCanNextPage()}
@@ -173,7 +165,7 @@ export const Table = ({
         </button>
         <button
           className={`w-6 h-6 ${
-            !table.getCanNextPage() ? 'opacity-25' : 'opacity-100'
+            !table.getCanNextPage() ? "opacity-25" : "opacity-100"
           }`}
           onClick={() => table.setPageIndex(table.getPageCount() - 1)}
           disabled={!table.getCanNextPage()}
@@ -189,7 +181,9 @@ const globalFilterFn: FilterFn<any> = (row, columnId, filterValue: string) => {
   const search = filterValue.toLowerCase();
 
   let value = row.getValue(columnId) as string;
-  if (typeof value === 'number') value = String(value);
+  if (typeof value === "number") value = String(value);
 
   return value?.toLowerCase().includes(search);
 };
+
+export default Table;

examples/learn-example/components/Vega.tsx

@@ -1,6 +1,6 @@
 //  Wrapper for the Vega component
 import { Vega as VegaOg } from "react-vega";
 
-export function Vega(props) {
+export default function Vega(props) {
   return <VegaOg {...props} />;
 }

examples/learn-example/components/VegaLite.tsx

@@ -2,7 +2,7 @@
 import { VegaLite as VegaLiteOg } from "react-vega";
 import applyFullWidthDirective from "../lib/applyFullWidthDirective";
 
-export function VegaLite(props) {
+export default function VegaLite(props) {
   const Component = applyFullWidthDirective({ Component: VegaLiteOg });
 
   return <Component {...props} />;

examples/learn-example/lib/markdown.js

@@ -22,7 +22,7 @@ import { serialize } from "next-mdx-remote/serialize";
  * @format: used to indicate to next-mdx-remote which format to use (md or mdx)
  * @returns: { mdxSource: mdxSource, frontMatter: ...}
  */
-const parse = async function (source, format, scope) {
+const parse = async function (source, format) {
   const { content, data, excerpt } = matter(source, {
     excerpt: (file, options) => {
       // Generate an excerpt for the file
@@ -91,7 +91,7 @@ const parse = async function (source, format, scope) {
         ],
         format,
       },
-      scope,
+      scope: data,
     }
   );
 

examples/learn-example/lib/parseCsv.ts

@@ -0,0 +1,16 @@
+import papa from "papaparse";
+
+const parseCsv = (csv) => {
+  csv = csv.trim();
+  const rawdata = papa.parse(csv, { header: true });
+  const cols = rawdata.meta.fields.map((r, i) => {
+    return { key: r, name: r };
+  });
+
+  return {
+    rows: rawdata.data,
+    fields: cols,
+  };
+};
+
+export default parseCsv;

examples/learn-example/package.json

@@ -6,22 +6,21 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "next lint",
-    "export": "npm run build && next export -o out",
-    "prebuild": "npm run mddb",
-    "mddb": "mddb ./content"
+    "lint": "next lint"
   },
   "dependencies": {
     "@flowershow/core": "^0.4.10",
-    "@flowershow/markdowndb": "^0.1.1",
     "@flowershow/remark-callouts": "^1.0.0",
     "@flowershow/remark-embed": "^1.0.0",
     "@flowershow/remark-wiki-link": "^1.1.2",
     "@heroicons/react": "^2.0.17",
     "@opentelemetry/api": "^1.4.0",
-    "@portaljs/components": "^0.1.0",
     "@tanstack/react-table": "^8.8.5",
-    "flexsearch": "0.7.21",
+    "@types/node": "18.16.0",
+    "@types/react": "18.2.0",
+    "@types/react-dom": "18.2.0",
+    "eslint": "8.39.0",
+    "eslint-config-next": "13.3.1",
     "gray-matter": "^4.0.3",
     "hastscript": "^7.2.0",
     "mdx-mermaid": "2.0.0-rc7",
@@ -30,7 +29,6 @@
     "papaparse": "^5.4.1",
     "react": "18.2.0",
     "react-dom": "18.2.0",
-    "react-hook-form": "^7.43.9",
     "react-vega": "^7.6.0",
     "rehype-autolink-headings": "^6.1.1",
     "rehype-katex": "^6.0.3",
@@ -44,13 +42,7 @@
   },
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.9",
-    "@types/flexsearch": "^0.7.3",
-    "@types/node": "18.16.0",
-    "@types/react": "18.2.0",
-    "@types/react-dom": "18.2.0",
     "autoprefixer": "^10.4.14",
-    "eslint": "8.39.0",
-    "eslint-config-next": "13.3.1",
     "postcss": "^8.4.23",
     "tailwindcss": "^3.3.1"
   }

examples/learn-example/pages/[[...path]].tsx

@@ -1,125 +1,45 @@
-import { existsSync, promises as fs } from 'fs';
+import { promises as fs } from 'fs';
 import path from 'path';
 import parse from '../lib/markdown';
+import DRD from '../components/DRD';
 
-import DataRichDocument from '../components/DataRichDocument';
-import clientPromise from '../lib/mddb';
-
-export const getStaticPaths = async () => {
-  const contentDir = path.join(process.cwd(), '/content/');
-  const contentFolders = await fs.readdir(contentDir, 'utf8');
-  const paths = contentFolders.map((folder: string) =>
-    folder === 'index.md'
-      ? { params: { path: [] } }
-      : { params: { path: [folder] } }
-  );
-  return {
-    paths,
-    fallback: false,
-  };
-};
-
-export const getStaticProps = async (context) => {
+export const getServerSideProps = async (context) => {
   let pathToFile = 'index.md';
   if (context.params.path) {
     pathToFile = context.params.path.join('/') + '/index.md';
   }
 
-  let datasets = [];
-  const mddbFileExists = existsSync('markdown.db');
-  if (mddbFileExists) {
-    const mddb = await clientPromise;
-    const datasetsFiles = await mddb.getFiles({
-      extensions: ['md', 'mdx'],
-    });
-    datasets = datasetsFiles
-      .filter((dataset) => dataset.url_path !== '/')
-      .map((dataset) => ({
-        _id: dataset._id,
-        url_path: dataset.url_path,
-        file_path: dataset.file_path,
-        metadata: dataset.metadata,
-      }));
-  }
-
   const indexFile = path.join(process.cwd(), '/content/' + pathToFile);
   const readme = await fs.readFile(indexFile, 'utf8');
-
-  let { mdxSource, frontMatter } = await parse(readme, '.mdx', { datasets });
-
+  let { mdxSource, frontMatter } = await parse(readme, '.mdx');
   return {
     props: {
       mdxSource,
-      frontMatter: JSON.stringify(frontMatter),
+      frontMatter,
     },
   };
 };
 
 export default function DatasetPage({ mdxSource, frontMatter }) {
-  frontMatter = JSON.parse(frontMatter);
   return (
-    <div className="prose dark:prose-invert mx-auto py-8">
+    <div className="prose mx-auto">
       <header>
         <div className="mb-6">
           <>
-            <h1 className="mb-2">{frontMatter.title}</h1>
+            <h1>{frontMatter.title}</h1>
             {frontMatter.author && (
-              <p className="my-0">
-                <span className="font-semibold">Author: </span>
-                <span className="my-0">{frontMatter.author}</span>
-              </p>
+              <div className="-mt-6">
+                <p className="opacity-60 pl-1">{frontMatter.author}</p>
+              </div>
             )}
             {frontMatter.description && (
-              <p className="my-0">
-                <span className="font-semibold">Description: </span>
-                <span className="description my-0">
-                  {frontMatter.description}
-                </span>
-              </p>
-            )}
-            {frontMatter.modified && (
-              <p className="my-0">
-                <span className="font-semibold">Modified: </span>
-                <span className="description my-0">
-                  {new Date(frontMatter.modified).toLocaleDateString()}
-                </span>
-              </p>
-            )}
-            {frontMatter.files && (
-              <section className="py-6">
-                <h2 className="mt-0">Data files</h2>
-                <table className="table-auto">
-                  <thead>
-                    <tr>
-                      <th>File</th>
-                      <th>Format</th>
-                    </tr>
-                  </thead>
-                  <tbody>
-                    {frontMatter.files.map((f) => {
-                      const fileName = f.split('/').slice(-1);
-                      return (
-                        <tr key={`resources-list-${f}`}>
-                          <td>
-                            <a target="_blank" href={f}>
-                              {fileName}
-                            </a>
-                          </td>
-                          <td>
-                            {fileName[0].split('.').slice(-1)[0].toUpperCase()}
-                          </td>
-                        </tr>
-                      );
-                    })}
-                  </tbody>
-                </table>
-              </section>
+              <p className="description">{frontMatter.description}</p>
             )}
           </>
         </div>
       </header>
       <main>
-        <DataRichDocument source={mdxSource} />
+        <DRD source={mdxSource} />
       </main>
     </div>
   );

examples/learn-example/pages/_app.tsx

@@ -1,6 +1,4 @@
 import '../styles/globals.css'
-import '@portaljs/components/styles.css'
-
 import type { AppProps } from 'next/app'
 
 export default function App({ Component, pageProps }: AppProps) {

examples/learn-example/pages/_document.tsx

@@ -7,7 +7,7 @@ class MyDocument extends Document {
         <Head>
           <link rel="icon" href="/favicon.png" />
         </Head>
-        <body className='bg-white dark:bg-gray-900'>
+        <body>
           <Main />
           <NextScript />
         </body>

examples/learn-example/tsconfig.json

@@ -1,6 +1,6 @@
 {
   "compilerOptions": {
-    "target": "es6",
+    "target": "es5",
     "lib": ["dom", "dom.iterable", "esnext"],
     "allowJs": true,
     "skipLibCheck": true,

examples/openspending/.gitignore

@@ -1,35 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env*.local
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts

examples/openspending/README.md

@@ -1,102 +0,0 @@
-# A data catalog with data on GitHub
-
-This example showcases a simple data catalog that get its data from a list of GitHub repos that serve as datasets.
-
-A `datasets.json` file is used to specify which datasets are going to be part of the data catalog.
-
-The application contains an index page, which lists all the datasets specified in the `datasets.json` file, and users can see more information about each dataset, such as the list of data files in it and the README, by clicking the "info" button on the list.
-
-You can read more about it on the [Data catalog with data on GitHub](https://portaljs.org/docs/examples/github-backed-catalog) blog post.
-
-## Demo
-
-https://example.portaljs.org/
-
-## Deploy your own
-
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fdatopian%2Fportaljs%2Ftree%2Fmain%2Fexamples%2Fgithub-backed-catalog)
-
-By clicking on this button, you will be redirected to a page which will allow you to clone the content into your own GitHub/GitLab/Bitbucket account and automatically deploy everything.
-
-## How to use
-
-### Install
-
-Execute `create-next-app` to bootstrap the example:
-
-```
-npx create-next-app <app-name> --example https://github.com/datopian/portaljs/tree/main/examples/github-backed-catalog
-cd <app-name>
-```
-
-### Set environment variables
-
-This project uses the GitHub API, which for anonymous users will cap at 50 requests per hour, so you might want to get a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) and add it to a `.env` file inside the folder like so
-
-```
-GITHUB_PAT=<github token>
-```
-
-### Change datasets
-
-You can change the datasets that will be displayed in the data catalog by editing the file `datasets.json`. Some examples can be found inside [this repo](https://github.com/datasets).
-
-### Run in development mode
-
-Run the app using:
-
-```
-npm run dev
-```
-
-Open http://localhost:3000 from your browser. You should see something similar to this:
-
-![](https://i.imgur.com/jAljJ9C.png)
-
-If click on the `info` button for a dataset you will see a page similar to this:
-
-![](https://i.imgur.com/AoJd4O0.png)
-
-## Notes
-
-### Structure of `datasets.json`
-
-The `datasets.json` file is simply a list of datasets, below you can see a minimal example of a dataset:
-
-```json
-{
-  "owner": "fivethirtyeight",
-  "repo": "data",
-  "branch": "master",
-  "files": ["nba-raptor/historical_RAPTOR_by_player.csv", "nba-raptor/historical_RAPTOR_by_team.csv"],
-  "readme": "nba-raptor/README.md"
-}
-```
-
-It has:
-
-- A `owner` which is going to be the github repo owner
-- A `repo` which is going to be the github repo name
-- A `branch` which is going to be the branch to which we need to get the files and the readme
-- A list of `files` which is going to be a list of paths with files that you want to show to the world
-- A `readme` which is going to be the path to your data description, it can also be a subpath eg: `example/README.md`
-
-You can also add:
-
-- A `description` which is useful if you have more than one dataset for each repo, if not provided we are just going to use the repo description
-- A `Name` which is useful if you want to give your dataset a nice name, if not provided we are going to use the junction of the `owner` the `repo` + the path of the README, in the exaple above it will be `fivethirtyeight/data/nba-raptor`
-
-### Extra commands
-
-You can also build the project for production with:
-
-```
-npm run build
-```
-
-And run the production build with:
-
-```
-npm run start
-```
-

examples/openspending/__tests__/os-data.test.ts

@@ -1,138 +0,0 @@
-import { expect, test } from 'vitest';
-import { getAllProjectsFromOrg, getProjectDataPackage } from '../lib/project';
-import { loadDataPackage } from '../lib/loader';
-import { getProjectMetadata } from '../lib/project';
-import { getCsv, parseCsv } from '../components/Table';
-
-test(
-  'Test OS-Data',
-  async () => {
-    const repos = await getAllProjectsFromOrg(
-      'os-data',
-      'main',
-      process.env.VITE_GITHUB_PAT
-    );
-    if (repos.failed.length > 0) console.log(repos.failed);
-    expect(repos.failed.length).toBe(0);
-  },
-  { timeout: 100000 }
-);
-
-test(
-  'Test Gift-Data',
-  async () => {
-    const repos = await getAllProjectsFromOrg(
-      'gift-data',
-      'main',
-      process.env.VITE_GITHUB_PAT
-    );
-    if (repos.failed.length > 0) console.log(repos.failed);
-    expect(repos.failed.length).toBe(0);
-  },
-  { timeout: 100000 }
-);
-
-test(
-  'Test getting one dataset from github',
-  async () => {
-    const datapackage = await getProjectDataPackage(
-      'os-data',
-      'berlin-berlin',
-      'main',
-      process.env.VITE_GITHUB_PAT
-    );
-    const repo = await getProjectMetadata(
-      'os-data',
-      'berlin-berlin',
-      process.env.VITE_GITHUB_PAT
-    );
-    const project = loadDataPackage(datapackage, repo);
-    delete project['datapackage'];
-    delete project.files[0]['dialect'];
-    delete project.files[0]['schema'];
-    expect(project).toStrictEqual({
-      name: 'berlin-berlin',
-      title: 'Berlin-Berlin',
-      description: null,
-      owner: {
-        name: 'os-data',
-        logo: 'https://avatars.githubusercontent.com/u/13695166?v=4',
-        title: 'os-data',
-      },
-      repo: {
-        name: 'berlin-berlin',
-        full_name: 'os-data/berlin-berlin',
-        url: 'https://github.com/os-data/berlin-berlin',
-      },
-      files: [
-        {
-          name: 'berlin-gesamt',
-          format: 'csv',
-          path: 'https://storage.openspending.org/berlin-berlin/berlin-gesamt.csv',
-          mediatype: 'text/csv',
-          bytes: 81128743,
-          encoding: 'utf-8',
-        },
-      ],
-      author: 'Michael Peters <michael.peters@okfn.de>',
-      cityCode: 'Berlin',
-      countryCode: 'DE',
-      fiscalPeriod: { start: '2014-01-01', end: '2019-12-31' },
-      readme: '',
-    });
-  },
-  { timeout: 100000 }
-);
-
-test(
-  'Test getting one section of csv from R2',
-  async () => {
-    const rawCsv = await getCsv(
-      'https://storage.openspending.org/state-of-minas-gerais-brazil-planned-budget/__os_imported__br-mg-ppagloc.csv'
-    );
-    const parsedCsv = await parseCsv(rawCsv);
-    expect(parsedCsv.errors.length).toBe(1);
-    expect(parsedCsv.data.length).toBe(10165);
-    expect(parsedCsv.meta.fields).toStrictEqual([
-      'function_name',
-      'function_label',
-      'product_name',
-      'product_label',
-      'area_name',
-      'area_label',
-      'subaction_name',
-      'subaction_label',
-      'region_label_map',
-      'region_reg_map',
-      'region_name',
-      'region_label',
-      'municipality_map_id',
-      'municipality_name',
-      'municipality_map_code',
-      'municipality_label',
-      'municipality_map_name_simple',
-      'municipality_map_name',
-      'cofog1_label_en',
-      'cofog1_name',
-      'cofog1_label',
-      'amount',
-      'subprogramme_name',
-      'subprogramme_label',
-      'time_name',
-      'time_year',
-      'time_month',
-      'time_day',
-      'time_week',
-      'time_yearmonth',
-      'time_quarter',
-      'time',
-      'action_name',
-      'action_label',
-      'subfunction_name',
-      'subfunction_label',
-      'programme_name',
-      'programme_label',
-    ]);
-  },
-  { timeout: 100000 }
-);

examples/openspending/components/Button.tsx

@@ -1,15 +0,0 @@
-import Link from 'next/link';
-import clsx from 'clsx';
-
-export function Button({ href, className = '', ...props }) {
-  className = clsx(
-    'inline-flex justify-center rounded-2xl bg-emerald-600 p-4 text-base font-semibold text-white hover:bg-emerald-500 focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-emerald-500 active:text-white/70',
-    className
-  );
-
-  return href ? (
-    <Link scroll={false} href={href} className={className} {...props} />
-  ) : (
-    <button className={className} {...props} />
-  );
-}

examples/openspending/components/Container.tsx

@@ -1,10 +0,0 @@
-import clsx from 'clsx'
-
-export function Container({ className = "", ...props }) {
-  return (
-    <div
-      className={clsx('mx-auto max-w-7xl px-4 sm:px-6 lg:px-8', className)}
-      {...props}
-    />
-  )
-}

examples/openspending/components/DatasetCard.tsx

@@ -1,76 +0,0 @@
-import Link from 'next/link';
-import { Project } from '../lib/project.interface';
-import ExternalLinkIcon from './icons/ExternalLinkIcon';
-
-export default function DatasetCard({ dataset }: { dataset: Project }) {
-  return (
-    <div
-      key={dataset.name}
-      className="overflow-hidden rounded-xl border border-gray-200"
-    >
-      <Link
-        href={`/@${dataset.owner.name}/${dataset.repo.name}`}
-        className="flex items-center gap-x-4 border-b border-gray-900/5 bg-gray-50 p-6"
-      >
-        <img
-          src={dataset.owner.logo || '/assets/org-icon.svg'}
-          alt={dataset.owner.name}
-          className="h-12 w-12 flex-none rounded-lg bg-white object-cover ring-1 ring-gray-900/10 p-2"
-        />
-        <div className="text-sm font-medium leading-6">
-          <div className="text-gray-900 line-clamp-1">{dataset.title}</div>
-          <div className="text-gray-500 line-clamp-1">
-            {dataset.owner.title}
-          </div>
-        </div>
-      </Link>
-      <dl className="-my-3 divide-y divide-gray-100 px-6 py-4 text-sm leading-6">
-        <div className="flex justify-between gap-x-4 py-3">
-          <dt className="text-gray-500">Name</dt>
-          <dd className="flex items-start gap-x-2">
-            <div className="font-medium text-gray-900 line-clamp-1">
-              {dataset.name}
-            </div>
-          </dd>
-        </div>
-        <div className="flex justify-between gap-x-4 py-3">
-          <dt className="text-gray-500">Country</dt>
-          <dd className="flex items-start gap-x-2">
-            <div className="font-medium text-gray-900">
-              {dataset.countryCode}
-            </div>
-          </dd>
-        </div>
-        <div className="flex justify-between gap-x-4 py-3">
-          <dt className="text-gray-500">Fiscal Period</dt>
-          <dd className="text-gray-700">
-            {dataset.fiscalPeriod?.start &&
-              new Date(dataset.fiscalPeriod.start).getFullYear()}
-            {dataset.fiscalPeriod?.end &&
-              dataset.fiscalPeriod?.start !== dataset.fiscalPeriod?.end && (
-                <>
-                  {' - '}
-                  {new Date(dataset.fiscalPeriod.end).getFullYear()}
-                </>
-              )}
-          </dd>
-        </div>
-        <div className="flex justify-between gap-x-4 py-3">
-          <dt className="text-gray-500">Metadata</dt>
-          <dd className="flex items-start gap-x-2">
-            <div className="font-medium text-gray-900">
-              <Link
-                // TODO: this link may be incorrect for some datasets
-                href={`https://github.com/${dataset.owner.name}/${dataset.repo.name}/blob/main/datapackage.json`}
-                target="_blank"
-                className="flex items-center hover:text-gray-700"
-              >
-                datapackage.json <ExternalLinkIcon className="ml-1" />
-              </Link>
-            </div>
-          </dd>
-        </div>
-      </dl>
-    </div>
-  );
-}

examples/openspending/components/DatasetsGrid.tsx

@@ -1,19 +0,0 @@
-import { Project } from '../lib/project.interface';
-import DatasetCard from './DatasetCard';
-
-export default function DatasetsGrid({ datasets }: { datasets: Project[] }) {
-  return (
-    <ul
-      className="grid gap-x-6 gap-y-8 grid-cols-1 sm:grid-cols-2 md:grid-cols-3"
-      role="list"
-    >
-      {datasets.map((dataset, idx) => {
-        return (
-          <li key={`datasets-grid-item-${idx}`}>
-            <DatasetCard dataset={dataset} />
-          </li>
-        );
-      })}
-    </ul>
-  );
-}

examples/openspending/components/DatasetsSearch.tsx

@@ -1,206 +0,0 @@
-import { useForm } from 'react-hook-form';
-import DatasetsGrid from './DatasetsGrid';
-import { Project } from '../lib/project.interface';
-import { Index } from 'flexsearch';
-import {
-  ChevronDoubleLeftIcon,
-  ChevronDoubleRightIcon,
-  ChevronLeftIcon,
-  ChevronRightIcon,
-} from '@heroicons/react/24/solid';
-import { useState } from 'react';
-
-export default function DatasetsSearch({
-  datasets,
-  availableCountries,
-}: {
-  datasets: Project[];
-  availableCountries;
-}) {
-  const itemsPerPage = 6;
-  const [page, setPage] = useState(1);
-
-  const index = new Index({ tokenize: 'full' });
-
-  datasets.forEach((dataset: Project) =>
-    index.add(
-      dataset.name,
-      `${dataset.repo} ${dataset.name} ${dataset.title} ${dataset.author} ${dataset.title} ${dataset.cityCode} ${dataset.fiscalPeriod?.start} ${dataset.fiscalPeriod?.end}`
-    )
-  );
-
-  const { register, watch, handleSubmit, reset, resetField } = useForm({
-    defaultValues: {
-      searchTerm: '',
-      country: '',
-      minDate: '',
-      maxDate: '',
-    },
-  });
-
-  const filteredDatasets = datasets
-    .filter((dataset: Project) =>
-      watch().searchTerm && watch().searchTerm !== ''
-        ? index.search(watch().searchTerm).includes(dataset.name)
-        : true
-    )
-    .filter((dataset) =>
-      watch().country && watch().country !== ''
-        ? dataset.countryCode === watch().country
-        : true
-    )
-    // TODO: Does that really makes sense?
-    // What if the fiscalPeriod is 2015-2017 and inputs are
-    // set to 2015-2016. It's going to be filtered out but
-    // it shouldn't.
-    .filter((dataset) =>
-      watch().minDate && watch().minDate !== ''
-        ? dataset.fiscalPeriod?.start >= watch().minDate
-        : true
-    )
-    .filter((dataset) =>
-      watch().maxDate && watch().maxDate !== ''
-        ? dataset.fiscalPeriod?.end <= watch().maxDate
-        : true
-    );
-
-  const paginatedDatasets = filteredDatasets.slice(
-    (page - 1) * itemsPerPage,
-    (page - 1) * itemsPerPage + itemsPerPage
-  );
-
-  const pageCount = Math.ceil(filteredDatasets.length / itemsPerPage) || 1;
-
-  return (
-    <>
-      <div className="flex flex-col gap-3 sm:flex-row">
-        <div className="min-w-0 flex-auto">
-          <br />
-          <div className="relative">
-            <input
-              placeholder="Search datasets"
-              aria-label="Search datasets"
-              {...register('searchTerm', { onChange: () => setPage(1) })}
-              className="h-[3em] relative w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
-            />
-            {watch().searchTerm !== '' && (
-              <button
-                onClick={() => resetField('searchTerm')}
-                className="absolute right-3 top-1/2 -translate-y-1/2 text-gray-500"
-              >
-                <CloseIcon />
-              </button>
-            )}
-          </div>
-        </div>
-        <div className="sm:basis-1/6">
-          {/* TODO: nicer select e.g. headlessui example */}
-          <label className="text-sm text-gray-600 font-medium">Country</label>
-          <select
-            className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
-            {...register('country', { onChange: () => setPage(1) })}
-          >
-            <option value="">All</option>
-            {availableCountries.map((country) => {
-              return (
-                <option key={country.code} value={country.code}>
-                  {country.title}
-                </option>
-              );
-            })}
-          </select>
-        </div>
-        <div className="sm:basis-1/6">
-          <label className="text-sm text-gray-600 font-medium">Min. date</label>
-          <div className="relative">
-            <input
-              aria-label="Min. date"
-              type="date"
-              {...register('minDate', { onChange: () => setPage(1) })}
-              className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
-            />
-          </div>
-        </div>
-        <div className="sm:basis-1/6">
-          <label className="text-sm text-gray-600 font-medium">Max. date</label>
-          <div className="relative">
-            <input
-              aria-label="Max. date"
-              type="date"
-              {...register('maxDate', { onChange: () => setPage(1) })}
-              className="h-[3em] w-full rounded-lg bg-white py-2 pl-3 pr-10 text-left shadow-md focus:outline-none focus-visible:border-emerald-500 focus-visible:ring-2 focus-visible:ring-white focus-visible:ring-opacity-75 focus-visible:ring-offset-2 focus-visible:ring-offset-emerald-400 sm:text-sm"
-            />
-          </div>
-        </div>
-      </div>
-      <div className="mt-5 mb-5">
-        <span className="text-lg font-medium">
-          {filteredDatasets.length} datasets found
-        </span>
-      </div>
-      <div className="min-w-full align-middle">
-        <DatasetsGrid datasets={paginatedDatasets} />
-        <div className="w-full flex justify-center mt-10">
-          <button
-            onClick={() => setPage(1)}
-            disabled={page <= 1}
-            className="disabled:text-gray-400"
-          >
-            <ChevronDoubleLeftIcon className="w-6 h-6" />
-          </button>
-          <button
-            onClick={() => {
-              if (page > 1) setPage((prev) => --prev);
-            }}
-            disabled={page <= 1}
-            className="disabled:text-gray-400"
-          >
-            <ChevronLeftIcon className="w-6 h-6" />
-          </button>
-          <span className="mx-5">
-            Page {page} of {pageCount}
-          </span>
-          <button
-            onClick={() => {
-              if (page < pageCount) setPage((prev) => ++prev);
-            }}
-            disabled={page >= pageCount}
-            className="disabled:text-gray-400"
-          >
-            <ChevronRightIcon className="w-6 h-6" />
-          </button>
-          <button
-            onClick={() => setPage(pageCount)}
-            disabled={page >= pageCount}
-            className="disabled:text-gray-400"
-          >
-            <ChevronDoubleRightIcon className="w-6 h-6" />
-          </button>
-        </div>
-      </div>
-    </>
-  );
-}
-
-const CloseIcon = () => {
-  return (
-    <svg
-      width={20}
-      height={20}
-      viewBox="0 0 24 24"
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg"
-    >
-      <g id="Menu / Close_MD">
-        <path
-          id="Vector"
-          d="M18 18L12 12M12 12L6 6M12 12L18 6M12 12L6 18"
-          stroke="currentColor"
-          stroke-width="2"
-          stroke-linecap="round"
-          stroke-linejoin="round"
-        />
-      </g>
-    </svg>
-  );
-};

examples/openspending/components/Header.tsx

@@ -1,82 +0,0 @@
-import Image from 'next/image';
-import { Container } from './Container';
-import logo from '../public/logo.svg';
-import Link from 'next/link';
-import { useRouter } from 'next/router';
-import { Bars3Icon } from '@heroicons/react/24/outline';
-import { useState } from 'react';
-
-export function Header() {
-  const [menuOpen, setMenuOpen] = useState<boolean>(false);
-
-  const router = useRouter();
-
-  const isActive = (navLink) => {
-    return router.asPath.split('?')[0] == navLink.href;
-  };
-
-  const navLinks = [
-    {
-      title: 'Home',
-      href: '/',
-    },
-    {
-      title: 'Datasets',
-      href: '/#datasets',
-    },
-    // {
-    //   title: "Community",
-    //   href: "https://community.openspending.org/"
-    // }
-  ];
-
-  return (
-    <header className="relative z-50 pb-11 lg:pt-11">
-      <Container className="flex flex-wrap items-center justify-between lg:flex-nowrap mt-10 lg:mt-0">
-        <Link href="/" className="lg:mt-0 lg:grow lg:basis-0 flex items-center">
-          <Image src={logo} alt="OpenSpending" className="h-12 w-auto" />
-        </Link>
-        <ul className="hidden list-none sm:flex gap-x-5 text-base font-medium">
-          {navLinks.map((link, i) => (
-            <li key={`nav-link-${i}`}>
-              <Link
-                className={`text-emerald-900 hover:text-emerald-600 ${
-                  isActive(link) ? 'text-emerald-600' : ''
-                }`}
-                href={link.href}
-                scroll={false}
-              >
-                {link.title}
-              </Link>
-            </li>
-          ))}
-        </ul>
-        <div className="hidden xl:block xl:grow"></div>
-        <div className="sm:hidden sm:mt-10 lg:mt-0 lg:grow lg:basis-0 lg:justify-end">
-          <button onClick={() => setMenuOpen(!menuOpen)}>
-            <Bars3Icon className="w-8 h-8" />
-          </button>
-        </div>
-        {menuOpen && (
-          <div className={`sm:hidden basis-full mt-5 text-center`}>
-            <ul className="gap-x-5 text-base font-medium">
-              {navLinks.map((link, i) => (
-                <li key={`nav-link-${i}`}>
-                  <Link
-                    className={`text-emerald-900 hover:text-emerald-600 ${
-                      isActive(link) ? 'text-emerald-600' : ''
-                    }`}
-                    href={link.href}
-                    scroll={false}
-                  >
-                    {link.title}
-                  </Link>
-                </li>
-              ))}
-            </ul>
-          </div>
-        )}
-      </Container>
-    </header>
-  );
-}

examples/openspending/components/Hero.tsx

@@ -1,50 +0,0 @@
-import { Button } from './Button';
-import { Container } from './Container';
-
-export function Hero({ countriesCount, datasetsCount, filesCount }) {
-  return (
-    <div className="relative pb-20 pt-10 sm:py-40" id="hero">
-      <div className="absolute inset-x-0 -bottom-14 -top-48 overflow-hidden bg-green-50 bg-opacity-50">
-        <div className="absolute inset-x-0 top-0 h-40 bg-gradient-to-b from-white" />
-        <div className="absolute inset-x-0 bottom-0 h-40 bg-gradient-to-t from-white" />
-      </div>
-      <Container className="relative">
-        <div className="mx-auto max-w-2xl lg:max-w-4xl lg:px-12">
-          <h1 className="font-display text-5xl font-bold tracking-tighter text-emerald-600 sm:text-7xl">
-            It's our money!
-          </h1>
-          <div className="mt-6 space-y-6 font-display text-2xl tracking-tight text-emerald-900">
-            <p>
-              By understanding how governments spend money in our name can we
-              have a say in how that money will affect our own lives. The
-              journey starts here.
-            </p>
-            <p>
-              OpenSpending is a free, open and global platform to search,
-              visualise and analyse fiscal data in the public sphere.
-            </p>
-          </div>
-          <Button href="#datasets" className="mt-10">
-            Search datasets
-          </Button>
-          <dl className="mt-10 grid grid-cols-2 gap-x-10 gap-y-6 sm:mt-16 sm:gap-x-16 sm:gap-y-10 sm:text-center lg:auto-cols-auto lg:grid-flow-col lg:grid-cols-none lg:justify-start lg:text-left">
-            {[
-              //  Added the plus sign because some datasets do not
-              //  contain defined countries
-              ['Countries', '+' + countriesCount],
-              ['Datasets', datasetsCount],
-              ['Files', filesCount],
-            ].map(([name, value]) => (
-              <div key={name}>
-                <dt className="font-mono text-sm text-emerald-600">{name}</dt>
-                <dd className="mt-0.5 text-2xl font-semibold tracking-tight text-emerald-900">
-                  {value}
-                </dd>
-              </div>
-            ))}
-          </dl>
-        </div>
-      </Container>
-    </div>
-  );
-}

examples/openspending/components/Table.tsx

@@ -1,94 +0,0 @@
-import {
-  QueryClient,
-  QueryClientProvider,
-  useQuery,
-  useQueryClient,
-} from 'react-query';
-import Papa from 'papaparse';
-import { Grid } from '@githubocto/flat-ui';
-
-const queryClient = new QueryClient();
-
-export async function getCsv(url: string) {
-  const response = await fetch(url, {
-    headers: {
-      Range: 'bytes=0-5132288',
-    },
-  });
-  const data = await response.text();
-  return data;
-}
-
-export async function parseCsv(file: string): Promise<any> {
-  return new Promise((resolve, reject) => {
-    Papa.parse(file, {
-      header: true,
-      dynamicTyping: true,
-      skipEmptyLines: true,
-      transform: (value: string): string => {
-        return value.trim();
-      },
-      complete: (results: any) => {
-        return resolve(results);
-      },
-      error: (error: any) => {
-        return reject(error);
-      },
-    });
-  });
-}
-
-const Spinning = () => {
-  return (
-    <div role="status w-fit mx-auto">
-      <svg
-        aria-hidden="true"
-        className="w-8 h-8 mr-2 text-gray-200 animate-spin dark:text-gray-600 fill-emerald-600"
-        viewBox="0 0 100 101"
-        fill="none"
-        xmlns="http://www.w3.org/2000/svg"
-      >
-        <path
-          d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z"
-          fill="currentColor"
-        />
-        <path
-          d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z"
-          fill="currentFill"
-        />
-      </svg>
-      <span className="sr-only">Loading...</span>
-    </div>
-  );
-};
-
-export const Table: React.FC<{ url: string }> = ({ url }) => {
-  return (
-    // Provide the client to your App
-    <QueryClientProvider client={queryClient}>
-      <TableInner url={url} />
-    </QueryClientProvider>
-  );
-};
-
-const TableInner: React.FC<{ url: string }> = ({ url }) => {
-  const { data: csvString, isLoading: isDownloadingCSV } = useQuery(
-    ['dataCsv', url],
-    () => getCsv(url)
-  );
-  const { data: parsedData, isLoading: isParsing } = useQuery(
-    ['dataPreview', csvString],
-    () => parseCsv(csvString),
-    { enabled: !!csvString }
-  );
-  if (isParsing || isDownloadingCSV)
-    <div className="w-full">
-      <Spinning />
-    </div>;
-  if (parsedData)
-    return (
-      <div className="h-[500px] overflow-scroll">
-        <Grid data={parsedData.data} />
-      </div>
-    );
-};

examples/openspending/components/_shared/Breadcrumbs.tsx

@@ -1,20 +0,0 @@
-import Link from "next/link";
-import HomeIcon from "../icons/HomeIcon";
-
-export default function Breadcrumbs({ links }: { links: { title: string, href?: string, target?: string }[] }) {
-  const current = links.at(-1);
-
-  return <div className="flex items-center uppercase font-black text-xs">
-    <Link className="flex items-center" href='/'><HomeIcon /></Link>
-
-    {/* {links.length > 1 && links.slice(0, -1).map((link) => {
-      return <>
-        <span className="mx-4">/</span>
-        <Link href={link.href}>{link.title}</Link>
-      </>
-    })} */}
-
-    <span className="mx-4">/</span>
-    <span>{current.title}</span>
-  </div >
-}

examples/openspending/components/_shared/Layout.tsx

@@ -1,10 +0,0 @@
-import { Header } from '../Header';
-
-export default function Layout({ children }) {
-  return (
-    <div className="bg-white min-h-screen">
-      <Header />
-      {children}
-    </div>
-  );
-}

examples/openspending/components/icons/ExternalLinkIcon.tsx

@@ -1,3 +0,0 @@
-export default function ExternalLinkIcon({ className = "" }) {
-  return <div className={`inline-block w-4 ${className}`}><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="currentColor"><path d="M 40 10 C 38.896 10 38 10.896 38 12 C 38 13.104 38.896 14 40 14 L 47.171875 14 L 30.585938 30.585938 C 29.804938 31.366938 29.804938 32.633063 30.585938 33.414062 C 30.976938 33.805063 31.488 34 32 34 C 32.512 34 33.023063 33.805062 33.414062 33.414062 L 50 16.828125 L 50 24 C 50 25.104 50.896 26 52 26 C 53.104 26 54 25.104 54 24 L 54 12 C 54 10.896 53.104 10 52 10 L 40 10 z M 18 12 C 14.691 12 12 14.691 12 18 L 12 46 C 12 49.309 14.691 52 18 52 L 46 52 C 49.309 52 52 49.309 52 46 L 52 34 C 52 32.896 51.104 32 50 32 C 48.896 32 48 32.896 48 34 L 48 46 C 48 47.103 47.103 48 46 48 L 18 48 C 16.897 48 16 47.103 16 46 L 16 18 C 16 16.897 16.897 16 18 16 L 30 16 C 31.104 16 32 15.104 32 14 C 32 12.896 31.104 12 30 12 L 18 12 z"/></svg></div>
-}

examples/openspending/components/icons/HomeIcon.tsx

@@ -1,3 +0,0 @@
-export default function HomeIcon({ className = "" }) {
-  return <div className={`inline-block w-4 ${className}`}><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">    <path d="M 12 2 A 1 1 0 0 0 11.289062 2.296875 L 1.203125 11.097656 A 0.5 0.5 0 0 0 1 11.5 A 0.5 0.5 0 0 0 1.5 12 L 4 12 L 4 20 C 4 20.552 4.448 21 5 21 L 9 21 C 9.552 21 10 20.552 10 20 L 10 14 L 14 14 L 14 20 C 14 20.552 14.448 21 15 21 L 19 21 C 19.552 21 20 20.552 20 20 L 20 12 L 22.5 12 A 0.5 0.5 0 0 0 23 11.5 A 0.5 0.5 0 0 0 22.796875 11.097656 L 12.716797 2.3027344 A 1 1 0 0 0 12.710938 2.296875 A 1 1 0 0 0 12 2 z"/></svg></div>
-}

examples/openspending/lib/datapackage.interface.ts

@@ -1,289 +0,0 @@
-/**
- * Fiscal Data Package is a simple specification for data access and delivery of fiscal data.
- */
-export type FiscalDataPackage = TabularDataPackage & {
-  countryCode?: ISO31661Alpha2CountryCode
-  regionCode?: string
-  cityCode?: string
-  author?: string
-  readme?: string
-  granularity?: GranularityOfResources
-  fiscalPeriod?: FiscalPeriodForTheBudget
-  [k: string]: unknown
-}
-/**
- * The profile of this descriptor.
- */
-export type Profile = "tabular-data-package"
-/**
- * An identifier string. Lower case characters with `.`, `_`, `-` and `/` are allowed.
- */
-export type Name = string
-/**
- * A property reserved for globally unique identifiers. Examples of identifiers that are unique include UUIDs and DOIs.
- */
-export type ID = string
-/**
- * A human-readable title.
- */
-export type Title = string
-/**
- * A text description. Markdown is encouraged.
- */
-export type Description = string
-/**
- * The home on the web that is related to this data package.
- */
-export type HomePage = string
-/**
- * The datetime on which this descriptor was created.
- */
-export type Created = string
-/**
- * The contributors to this descriptor.
- */
-export type Contributors = [Contributor, ...Contributor[]]
-/**
- * A human-readable title.
- */
-export type Title1 = string
-/**
- * A fully qualified URL, or a POSIX file path.
- */
-export type Path = string
-/**
- * An email address.
- */
-export type Email = string
-/**
- * An organizational affiliation for this contributor.
- */
-export type Organization = string
-/**
- * A list of keywords that describe this package.
- */
-export type Keywords = [string, ...string[]]
-/**
- * A image to represent this package.
- */
-export type Image = string
-/**
- * The license(s) under which this package is published.
- */
-export type Licenses = [License, ...License[]]
-/**
- * A license for this descriptor.
- */
-export type License =
-  | {
-      [k: string]: unknown
-    }
-  | {
-      [k: string]: unknown
-    }
-/**
- * An `array` of Tabular Data Resource objects, each compliant with the [Tabular Data Resource](/tabular-data-resource/) specification.
- *
-/**
- * A Tabular Data Resource.
- */
-export interface TabularDataResource {
-  format?: string;
-  name: string;
-  description?: string;
-  title?: string;
-  schema?: Schema;
-  sample?: any[];
-  profile?: string;
-  key?: string;
-  path?: string;
-  size?: number;
-  bytes?: number;
-}
-
-export interface Field {
-  name: string;
-  type: FieldType;
-}
-
-export interface Schema {
-  fields: Field[];
-}
-
-export const OptionsFields = [
-  "any",
-  "array",
-  "boolean",
-  "date",
-  "datetime",
-  "duration",
-  "geojson",
-  "geopoint",
-  "integer",
-  "number",
-  "object",
-  "string",
-  "time",
-  "year",
-  "yearmonth",
-] as const;
-
-type FieldType = typeof OptionsFields[number];
-/**
- * A human-readable title.
- */
-export type Title2 = string
-/**
- * A fully qualified URL, or a POSIX file path.
- */
-export type Path1 = string
-/**
- * An email address.
- */
-export type Email1 = string
-/**
- * The raw sources for this resource.
- */
-export type Sources = Source[]
-
-/**
- * A keyword that represents the direction of the spend, either expenditure or revenue.
- */
-export type DirectionOfTheSpending = "expenditure" | "revenue"
-/**
- * A keyword that represents the phase of the data, can be proposed for a budget proposal, approved for an approved budget, adjusted for modified budget or executed for the enacted budget
- */
-export type BudgetPhase = "proposed" | "approved" | "adjusted" | "executed"
-/**
- * Either an array of strings corresponding to the name attributes in a set of field objects in the fields array or a single string corresponding to one of these names. The value of primaryKey indicates the primary key or primary keys for the dimension.
- */
-export type PrimaryKey = string | [string, ...string[]]
-/**
- * Describes what kind of a dimension it is.
- */
-export type DimensionType =
-  | "datetime"
-  | "entity"
-  | "classification"
-  | "activity"
-  | "fact"
-  | "location"
-  | "other"
-/**
- * The type of the classification.
- */
-export type ClassificationType = "functional" | "administrative" | "economic"
-/**
- * A valid 2-digit ISO country code (ISO 3166-1 alpha-2), or, an array of valid ISO codes.
- */
-export type ISO31661Alpha2CountryCode = string | [string, ...string[]]
-/**
- * A keyword that represents the type of spend data, eiter aggregated or transactional
- */
-export type GranularityOfResources = "aggregated" | "transactional"
-
-/**
- * Tabular Data Package
- */
-export interface TabularDataPackage {
-  profile: Profile
-  name?: Name
-  id?: ID
-  title?: Title
-  description?: Description
-  homepage?: HomePage
-  created?: Created
-  contributors?: Contributors
-  keywords?: Keywords
-  image?: Image
-  licenses?: Licenses
-  resources: TabularDataResource[]
-  sources?: Sources
-  [k: string]: unknown
-}
-/**
- * A contributor to this descriptor.
- */
-export interface Contributor {
-  title: Title1
-  path?: Path
-  email?: Email
-  organization?: Organization
-  role?: string
-  [k: string]: unknown
-}
-/**
- * A source file.
- */
-export interface Source {
-  title: Title2
-  path?: Path1
-  email?: Email1
-  [k: string]: unknown
-}
-/**
- * Measures are numerical and correspond to financial amounts in the source data.
- */
-export interface Measures {
-  [k: string]: Measure
-}
-/**
- * Measure.
- *
- * This interface was referenced by `Measures`'s JSON-Schema definition
- * via the `patternProperty` "^\w+".
- */
-export interface Measure {
-  source: string
-  resource?: string
-  currency: string
-  factor?: number
-  direction?: DirectionOfTheSpending
-  phase?: BudgetPhase
-  [k: string]: unknown
-}
-/**
- * Dimensions are groups of related fields. Dimensions cover all items other than the measure.
- */
-export interface Dimensions {
-  [k: string]: Dimension
-}
-/**
- * Dimension.
- *
- * This interface was referenced by `Dimensions`'s JSON-Schema definition
- * via the `patternProperty` "^\w+".
- */
-export interface Dimension {
-  attributes: Attributes
-  primaryKey: PrimaryKey
-  dimensionType?: DimensionType
-  classificationType?: ClassificationType
-  [k: string]: unknown
-}
-/**
- * Attribute objects that make up the dimension
- */
-export interface Attributes {
-  /**
-   * This interface was referenced by `Attributes`'s JSON-Schema definition
-   * via the `patternProperty` "^\w+".
-   */
-  [k: string]: {
-    source: string
-    resource?: string
-    constant?: string | number
-    parent?: string
-    labelfor?: string
-    [k: string]: unknown
-  }
-}
-/**
- * The fiscal period of the dataset
- */
-export interface FiscalPeriodForTheBudget {
-  start: string
-  end?: string
-  [k: string]: unknown
-}
-

examples/openspending/lib/loader.ts

@@ -1,35 +0,0 @@
-import { FiscalDataPackage } from './datapackage.interface';
-import { Project } from './project.interface';
-
-export function loadDataPackage(datapackage: FiscalDataPackage, repo): Project {
-  return {
-    name: datapackage.name,
-    title: datapackage.title,
-    description: datapackage.description || null,
-    owner: {
-      name: repo.owner.login,
-      logo: repo.owner.avatar_url,
-      // TODO: make this title work
-      title: repo.owner.login,
-    },
-    repo: { name: repo.name, full_name: repo.full_name, url: repo.html_url },
-    files: datapackage.resources,
-    author: datapackage.author ? datapackage.author : null,
-    cityCode: datapackage.cityCode ? datapackage.cityCode : null,
-    countryCode: datapackage.countryCode
-      ? (datapackage.countryCode as string)
-      : null,
-    fiscalPeriod: datapackage.fiscalPeriod
-      ? {
-          start: datapackage.fiscalPeriod.start
-            ? datapackage.fiscalPeriod.start
-            : null,
-          end: datapackage.fiscalPeriod.end
-            ? datapackage.fiscalPeriod.end
-            : null,
-        }
-      : null,
-    readme: datapackage.readme ? datapackage.readme : '',
-    datapackage,
-  };
-}

examples/openspending/lib/project.interface.ts

@@ -1,22 +0,0 @@
-import {
-  FiscalDataPackage,
-  TabularDataResource,
-} from './datapackage.interface';
-
-export interface Project {
-  owner: { name: string; logo?: string; title?: string }; // Info about the owner of the data repo
-  repo: { name: string; full_name: string; url: string }; // Info about the the data repo
-  files: TabularDataResource[];
-  name: string;
-  title?: string;
-  description?: string;
-  author?: string;
-  cityCode?: string;
-  countryCode?: string;
-  fiscalPeriod?: {
-    start: string;
-    end: string;
-  };
-  readme?: string;
-  datapackage: FiscalDataPackage;
-}

examples/openspending/lib/project.ts

@@ -1,225 +0,0 @@
-import { Octokit } from 'octokit';
-
-export interface GithubProject {
-  owner: string;
-  repo: string;
-  branch: string;
-  files: string[];
-  readme: string;
-  description?: string;
-  name?: string;
-}
-
-export async function getProjectReadme(
-  owner: string,
-  repo: string,
-  branch: string = 'main',
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const response = await octokit.rest.repos.getContent({
-      owner,
-      repo,
-      path: 'README.md',
-      ref: branch,
-    });
-    const data = response.data as { content?: string };
-    const fileContent = data.content ? data.content : '';
-    if (fileContent === '') {
-      return null;
-    }
-    const decodedContent = Buffer.from(fileContent, 'base64').toString();
-    return decodedContent;
-  } catch (error) {
-    console.log(error);
-    return null;
-  }
-}
-
-export async function getLastUpdated(
-  owner: string,
-  repo: string,
-  branch: string,
-  readme: string,
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const response = await octokit.rest.repos.listCommits({
-      owner,
-      repo,
-      path: readme,
-      ref: branch,
-    });
-    return response.data[0].commit.committer.date;
-  } catch (error) {
-    console.log(error);
-    return null;
-  }
-}
-export async function getProjectMetadata(
-  owner: string,
-  repo: string,
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const response = await octokit.rest.repos.get({
-      owner,
-      repo,
-    });
-    return response.data;
-  } catch (error) {
-    console.log(error);
-    return null;
-  }
-}
-
-export async function getRepoContents(
-  owner: string,
-  repo: string,
-  branch: string,
-  files: string[],
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const contents = [];
-    for (const path of files) {
-      const response = await octokit.rest.repos.getContent({
-        owner,
-        repo,
-        ref: branch,
-        path: path,
-      });
-      const data = response.data as {
-        download_url?: string;
-        name: string;
-        size: number;
-      };
-      contents.push({
-        download_url: data.download_url,
-        name: data.name,
-        size: data.size,
-      });
-    }
-    return contents;
-  } catch (error) {
-    console.log(error);
-    return null;
-  }
-}
-
-export async function getProject(project: GithubProject, github_pat?: string) {
-  const projectMetadata = await getProjectMetadata(
-    project.owner,
-    project.repo,
-    github_pat
-  );
-  if (!projectMetadata) {
-    return null;
-  }
-  const projectReadme = await getProjectReadme(
-    project.owner,
-    project.repo,
-    project.branch,
-    github_pat
-  );
-
-  const projectData = await getRepoContents(
-    project.owner,
-    project.repo,
-    project.branch,
-    project.files,
-    github_pat
-  );
-  if (!projectData) {
-    return null;
-  }
-
-  let projectBase = '',
-    last_updated = '';
-  if (projectReadme) {
-    projectBase =
-      project.readme.split('/').length > 1
-        ? project.readme.split('/').slice(0, -1).join('/')
-        : '/';
-    last_updated = await getLastUpdated(
-      project.owner,
-      project.repo,
-      project.branch,
-      projectBase,
-      github_pat
-    );
-  }
-  return {
-    ...projectMetadata,
-    files: projectData,
-    readmeContent: projectReadme,
-    last_updated,
-    base_path: projectBase,
-  };
-}
-
-export async function getProjectDataPackage(
-  owner: string,
-  repo: string,
-  branch: string,
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  try {
-    const response = await octokit.rest.repos.getContent({
-      owner,
-      repo,
-      path: 'datapackage.json',
-      ref: branch,
-    });
-    const data = response.data as { content?: string };
-    const fileContent = data.content ? data.content : '';
-    if (fileContent === '') {
-      return null;
-    }
-    const decodedContent = Buffer.from(fileContent, 'base64').toString();
-    const datapackage = JSON.parse(decodedContent);
-
-    return { ...datapackage, repo };
-  } catch (error) {
-    return null;
-  }
-}
-
-export async function getAllProjectsFromOrg(
-  org: string,
-  branch?: string,
-  github_pat?: string
-) {
-  const octokit = new Octokit({ auth: github_pat });
-  const repos = await octokit.rest.repos.listForOrg({
-    org,
-    type: 'public',
-    per_page: 100,
-  });
-  let failedProjects = [];
-  const projects = await Promise.all(
-    repos.data.map(async (_repo) => {
-      const project = await getProjectDataPackage(
-        org,
-        _repo.name,
-        branch ? branch : 'main',
-        github_pat
-      );
-      if (!project) {
-        failedProjects.push(_repo.name);
-        return null;
-      }
-
-      return { datapackage: project, repo: _repo };
-    })
-  );
-  return {
-    results: projects.filter((item) => item !== null),
-    failed: failedProjects,
-  };
-}

examples/openspending/orgs.json

@@ -1,3 +0,0 @@
-[
- "os-data"
-]