eddev 0.2.26 → 0.2.29

package/docs_old/docs/tooling/_category_.json

@@ -1,4 +0,0 @@
-{
-  "label": "🛠 Tooling",
-  "position": 2
-}

package/docs_old/docs/views/1.overview.md

@@ -1,31 +0,0 @@
-# Views Overview
-
-Views represent the different page types of the site. WordPress will choose which view to use based on the URL of the page. If for example, it identifies that the url `/blog/my-first-post` is a "post" object, it'll first look for `views/single-post.tsx`, followed by `views/single.tsx`. If it doesn't find either of those, it'll use `views/_404.tsx`. The naming of view files follows WordPress' [Template Hierarchy](https://developer.wordpress.org/themes/basics/template-hierarchy/).
-
-Views exist within the `views` directory as `.tsx` files, often with a paired `.graphql` file.
-
-The standard `views/page.tsx` looks like this:
-
-```tsx title="views/page.tsx"
-import { Heading } from "@components/atoms/Heading"
-import { Container } from "@components/layout/Grid"
-import { defineView } from "eddev/views"
-import { ContentBlocks } from "eddev"
-
-export default defineView("page", (props) => {
-  return (
-    <Container>
-      <Heading variant="h1" css={{ pb: "$6" }}>
-        {props.page?.title}
-      </Heading>
-      <ContentBlocks blocks={props.page?.contentBlocks} />
-    </Container>
-  )
-})
-```
-
-You'll notice above the following:
-
-- The file exports a view defined with the `defineView` function, and the first argument passed to it is the name of the view. This MUST be consistent with the name of the file. The general rule is `views/{name}.tsx`. We just care about the name part!
-- We're getting some data from props — `props.page.title` and `props.page.contentBlocks`. These are coming from the linked query file (see the next section)
-- The code itself is quite lean. It wouldn't be strange to have a more complex file, but in general it's better to move as much code as possible into separate component files. This encourages reusability and makes it easier to maintain.

package/docs_old/docs/views/2.queries.md

@@ -1,18 +0,0 @@
-# View Queries
-
-Views typically need to access data about the current page or object, as well as other arbitrary content from the CMS. To do so, create a `.graphql` file with the same name as the `.tsx` file. The GraphQL query will be executed every request, and the data is automatically passed to the view when it is rendered. You never need to handle the loading process yourself!
-
-To query the current page or post being viewed, use `$postId` as an input variable.
-
-```graphql title="views/page.graphql"
-query Page($postId: ID!) {
-  page(id: $postId, idType: DATABASE_ID) {
-    title
-    slug
-    template {
-      templateName
-    }
-    contentBlocks
-  }
-}
-```

package/docs_old/docs/views/3.content-blocks.md

@@ -1,36 +0,0 @@
-# Content Blocks
-
-To allow Gutenberg blocks on your page, you'll need to do two things:
-
-1. Ensure you've got a `.graphql` file which selects the `contentBlocks` field from the your post type.
-2. Pass the `contentBlocks` field to the `blocks` prop of the `<ContentBlocks />` component.
-
-The `ContentBlocks` component is much like `InnerBlocks`, except that blocks are passed in as an array, rather than implictly.
-
-```graphql title="views/page.graphql"
-query Page($postId: ID!) {
-  page(id: $postId, idType: DATABASE_ID) {
-    title
-    slug
-    template {
-      templateName
-    }
-    contentBlocks
-  }
-}
-```
-
-```tsx title="views/page.jsx"
-import { Container } from "@components/layout/Grid"
-import { defineView } from "eddev/views"
-import { ContentBlocks } from "eddev"
-
-export default defineView("page", (props) => {
-  return (
-    <Container>
-      <h1>{props.title!}</h1>
-      <ContentBlocks blocks={props.page?.contentBlocks} />
-    </Container>
-  )
-})
-```

package/docs_old/docs/views/4.app-view.md

@@ -1,35 +0,0 @@
-# 'App' View
-
-The `views/_app.tsx` view is a special kind of view. It's always rendered, as the wrapper around your entire frontend. It's usually where you'd put your header/footer and other global elements, as well as where you'll load global styles.
-
-```tsx
-import { PageLoadIndicator } from "@components/generic/PageLoadIndicator"
-import { AdminBar } from "eddev"
-import { Header } from "@components/site/Header"
-import { defineView } from "eddev/views"
-import { fontFaceGlobalStyles, frontendGlobalStyles } from "@theme"
-import { Footer } from "@components/site/Footer"
-
-fontFaceGlobalStyles()
-frontendGlobalStyles()
-
-export default defineView("_app", ({ children }) => {
-  return (
-    <>
-      <PageLoadIndicator />
-      <AdminBar />
-      <Header />
-      {children}
-      <Footer />
-    </>
-  )
-})
-```
-
-## App Query
-
-You can write an `views/_app.graphql` file, and the result will be available on every page, via the `useAppData()` hook. The result _wont_ be passed in as props, so be sure to use the hook if you need to access it.
-
-Note that the `_app.graphql` query only runs _once_ — when the user first loads the page.
-
-This is especially useful for things like menus, which are often used on every page, and should be accessible from anywhere on the first render of the page.

package/docs_old/docs/views/5.page-templates.md

@@ -1,20 +0,0 @@
-# Page Templates
-
-Page templates are special views, which are selectable from the 'Page Template' dropdown in the page editor.
-
-To create a page template, create a new view in the 'views/templates/' folder. It should export a view created with the `defineView` function, and also needs some special comments at the top of the file to identify it as a page template. Just like regular WordPress PHP templates.
-
-```tsx title="views/templates/special.tsx"
-/**
- * Template Name: Special
- */
-import { defineView } from "eddev/views"
-
-export default defineView("templates/special", () => {
-  return (
-    <div>
-      <h1>Special Template!</h1>
-    </div>
-  )
-})
-```

package/docs_old/docs/views/_category_.json

@@ -1,4 +0,0 @@
-{
-  "label": "📄 Views",
-  "position": 3
-}

package/docs_old/docusaurus.config.js

@@ -1,119 +0,0 @@
-// @ts-check
-// Note: type annotations allow type checking and IDEs autocompletion
-
-const lightCodeTheme = require("prism-react-renderer/themes/github")
-const darkCodeTheme = require("prism-react-renderer/themes/dracula")
-
-/** @type {import('@docusaurus/types').Config} */
-const config = {
-  title: "dev.ed.studio",
-  tagline: "WordPress + React 2021",
-  url: "https://devtools.ed.studio",
-  baseUrl: "/",
-  onBrokenLinks: "throw",
-  onBrokenMarkdownLinks: "warn",
-  noIndex: true,
-  favicon: "img/favicon.ico",
-  organizationName: "facebook", // Usually your GitHub org/user name.
-  projectName: "eddev-docs", // Usually your repo name.
-
-  presets: [
-    [
-      "@docusaurus/preset-classic",
-      /** @type {import('@docusaurus/preset-classic').Options} */
-      ({
-        docs: {
-          sidebarPath: require.resolve("./sidebars.js"),
-          // Please change this to your repo.
-          editUrl: "https://github.com/ed-digital/eddev/edit/main/docs/",
-        },
-        blog: {
-          showReadingTime: true,
-          // Please change this to your repo.
-          editUrl: "https://github.com/facebook/docusaurus/edit/main/blog/",
-        },
-        theme: {
-          customCss: require.resolve("./src/css/custom.css"),
-        },
-      }),
-    ],
-  ],
-
-  themeConfig:
-    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
-    ({
-      navbar: {
-        title: "Dev Wiki",
-        logo: {
-          alt: "ED. Dev Wiki",
-          srcDark: "img/logo-white.svg",
-          src: "img/logo-black.svg",
-        },
-        items: [
-          {
-            type: "doc",
-            docId: "intro",
-            position: "left",
-            label: "Docs",
-          },
-          // { to: "/blog", label: "Blog", position: "left" },
-          {
-            href: "https://github.com/ed-digital/eddev",
-            label: "GitHub",
-            position: "right",
-          },
-        ],
-      },
-      // footer: {
-      //   style: "dark",
-      //   links: [
-      //     {
-      //       title: "Docs",
-      //       items: [
-      //         {
-      //           label: "Tutorial",
-      //           to: "/docs/intro",
-      //         },
-      //       ],
-      //     },
-      //     {
-      //       title: "Community",
-      //       items: [
-      //         {
-      //           label: "Stack Overflow",
-      //           href: "https://stackoverflow.com/questions/tagged/docusaurus",
-      //         },
-      //         {
-      //           label: "Discord",
-      //           href: "https://discordapp.com/invite/docusaurus",
-      //         },
-      //         {
-      //           label: "Twitter",
-      //           href: "https://twitter.com/docusaurus",
-      //         },
-      //       ],
-      //     },
-      //     {
-      //       title: "More",
-      //       items: [
-      //         {
-      //           label: "Blog",
-      //           to: "/blog",
-      //         },
-      //         {
-      //           label: "GitHub",
-      //           href: "https://github.com/facebook/docusaurus",
-      //         },
-      //       ],
-      //     },
-      //   ],
-      //   copyright: `Copyright © ${new Date().getFullYear()} My Project, Inc. Built with Docusaurus.`,
-      // },
-      prism: {
-        theme: lightCodeTheme,
-        darkTheme: darkCodeTheme,
-      },
-    }),
-}
-
-module.exports = config

package/docs_old/package.json

@@ -1,40 +0,0 @@
-{
-  "name": "eddev-docs",
-  "version": "0.0.0",
-  "private": true,
-  "scripts": {
-    "docusaurus": "docusaurus",
-    "start": "docusaurus start",
-    "build": "docusaurus build",
-    "swizzle": "docusaurus swizzle",
-    "deploy": "docusaurus deploy",
-    "clear": "docusaurus clear",
-    "serve": "docusaurus serve",
-    "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids"
-  },
-  "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.6",
-    "@docusaurus/preset-classic": "2.0.0-beta.6",
-    "@mdx-js/react": "^1.6.21",
-    "@svgr/webpack": "^5.5.0",
-    "clsx": "^1.1.1",
-    "file-loader": "^6.2.0",
-    "prism-react-renderer": "^1.2.1",
-    "react": "^17.0.1",
-    "react-dom": "^17.0.1",
-    "url-loader": "^4.1.1"
-  },
-  "browserslist": {
-    "production": [
-      ">0.5%",
-      "not dead",
-      "not op_mini all"
-    ],
-    "development": [
-      "last 1 chrome version",
-      "last 1 firefox version",
-      "last 1 safari version"
-    ]
-  }
-}

package/docs_old/sidebars.js

@@ -1,26 +0,0 @@
-/**
- * Creating a sidebar enables you to:
- - create an ordered group of docs
- - render a sidebar for each doc of that group
- - provide next/previous navigation
-
- The sidebars can be generated from the filesystem, or explicitly defined here.
-
- Create as many sidebars as you want.
- */
-
-module.exports = {
-  // By default, Docusaurus generates a sidebar from the docs folder structure
-  tutorialSidebar: [{ type: "autogenerated", dirName: "." }],
-
-  // But you can create a sidebar manually
-  /*
-  tutorialSidebar: [
-    {
-      type: 'category',
-      label: 'Tutorial',
-      items: ['hello'],
-    },
-  ],
-   */
-};

package/docs_old/src/components/HomepageFeatures.js

@@ -1,64 +0,0 @@
-import React from 'react';
-import clsx from 'clsx';
-import styles from './HomepageFeatures.module.css';
-
-const FeatureList = [
-  {
-    title: 'Easy to Use',
-    Svg: require('../../static/img/undraw_docusaurus_mountain.svg').default,
-    description: (
-      <>
-        Docusaurus was designed from the ground up to be easily installed and
-        used to get your website up and running quickly.
-      </>
-    ),
-  },
-  {
-    title: 'Focus on What Matters',
-    Svg: require('../../static/img/undraw_docusaurus_tree.svg').default,
-    description: (
-      <>
-        Docusaurus lets you focus on your docs, and we&apos;ll do the chores. Go
-        ahead and move your docs into the <code>docs</code> directory.
-      </>
-    ),
-  },
-  {
-    title: 'Powered by React',
-    Svg: require('../../static/img/undraw_docusaurus_react.svg').default,
-    description: (
-      <>
-        Extend or customize your website layout by reusing React. Docusaurus can
-        be extended while reusing the same header and footer.
-      </>
-    ),
-  },
-];
-
-function Feature({Svg, title, description}) {
-  return (
-    <div className={clsx('col col--4')}>
-      <div className="text--center">
-        <Svg className={styles.featureSvg} alt={title} />
-      </div>
-      <div className="text--center padding-horiz--md">
-        <h3>{title}</h3>
-        <p>{description}</p>
-      </div>
-    </div>
-  );
-}
-
-export default function HomepageFeatures() {
-  return (
-    <section className={styles.features}>
-      <div className="container">
-        <div className="row">
-          {FeatureList.map((props, idx) => (
-            <Feature key={idx} {...props} />
-          ))}
-        </div>
-      </div>
-    </section>
-  );
-}

package/docs_old/src/components/HomepageFeatures.module.css

@@ -1,11 +0,0 @@
-.features {
-  display: flex;
-  align-items: center;
-  padding: 2rem 0;
-  width: 100%;
-}
-
-.featureSvg {
-  height: 200px;
-  width: 200px;
-}

package/docs_old/src/css/custom.css

@@ -1,28 +0,0 @@
-/**
- * Any CSS included here will be global. The classic template
- * bundles Infima by default. Infima is a CSS framework designed to
- * work well for content-centric websites.
- */
-
-/* You can override the default Infima variables here. */
-:root {
-  --ifm-color-primary: #25c2a0;
-  --ifm-color-primary-dark: rgb(33, 175, 144);
-  --ifm-color-primary-darker: rgb(31, 165, 136);
-  --ifm-color-primary-darkest: rgb(26, 136, 112);
-  --ifm-color-primary-light: rgb(70, 203, 174);
-  --ifm-color-primary-lighter: rgb(102, 212, 189);
-  --ifm-color-primary-lightest: rgb(146, 224, 208);
-  --ifm-code-font-size: 95%;
-}
-
-.docusaurus-highlight-code-line {
-  background-color: rgba(0, 0, 0, 0.1);
-  display: block;
-  margin: 0 calc(-1 * var(--ifm-pre-padding));
-  padding: 0 var(--ifm-pre-padding);
-}
-
-html[data-theme='dark'] .docusaurus-highlight-code-line {
-  background-color: rgba(0, 0, 0, 0.3);
-}

package/docs_old/src/pages/index.js

@@ -1,36 +0,0 @@
-import React from "react"
-import clsx from "clsx"
-import Layout from "@theme/Layout"
-import Link from "@docusaurus/Link"
-import useDocusaurusContext from "@docusaurus/useDocusaurusContext"
-import styles from "./index.module.css"
-import HomepageFeatures from "../components/HomepageFeatures"
-
-function HomepageHeader() {
-  const { siteConfig } = useDocusaurusContext()
-  return (
-    <header className={clsx("hero hero--primary", styles.heroBanner)}>
-      <div className="container">
-        <h1 className="hero__title">{siteConfig.title}</h1>
-        <p className="hero__subtitle">{siteConfig.tagline}</p>
-        <div className={styles.buttons}>
-          <Link className="button button--secondary button--lg" to="/docs/intro">
-            Read the docs
-          </Link>
-        </div>
-      </div>
-    </header>
-  )
-}
-
-export default function Home() {
-  const { siteConfig } = useDocusaurusContext()
-  return (
-    <Layout title={`Hello from ${siteConfig.title}`} description="Description will go into a meta tag in <head />">
-      <HomepageHeader />
-      {/* <main>
-        <HomepageFeatures />
-      </main> */}
-    </Layout>
-  )
-}

package/docs_old/src/pages/index.module.css

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

package/docs_old/src/pages/markdown-page.md

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

package/docs_old/static/img/logo-black.svg

@@ -1,4 +0,0 @@
-<svg width="60" height="32" viewBox="-5 -5 70 42" fill="none"
-  xmlns="http://www.w3.org/2000/svg">
-  <path fill-rule="evenodd" clip-rule="evenodd" d="M8.08382 24.3519H21.7138V31.8623H0V0H21.6675V7.51035H8.08382V12.1534H21.3853V19.71H8.08382V24.3519ZM36.1892 0C47.0467 0 52.498 8.01157 52.498 15.9769C52.498 23.9421 47.0467 31.8623 36.1892 31.8623H23.7807V0H36.1892ZM36.1892 24.4434C41.7354 24.4434 44.5553 20.165 44.5553 15.9769C44.5553 11.7888 41.7354 7.37376 36.1892 7.37376H31.772V24.4434H36.1892ZM55.0955 32C57.6332 32 59.4665 29.9511 59.4665 27.9485C59.4665 25.5361 57.6321 23.897 55.0955 23.897C52.7464 23.897 50.8657 25.5361 50.8657 27.9485C50.8657 29.9511 52.7464 32 55.0955 32Z" fill="black"/>
-</svg>

package/docs_old/static/img/logo-white.svg

@@ -1,4 +0,0 @@
-<svg width="60" height="32" viewBox="-5 -5 70 42" fill="none"
-  xmlns="http://www.w3.org/2000/svg">
-  <path fill-rule="evenodd" clip-rule="evenodd" d="M8.08382 24.3519H21.7138V31.8623H0V0H21.6675V7.51035H8.08382V12.1534H21.3853V19.71H8.08382V24.3519ZM36.1892 0C47.0467 0 52.498 8.01157 52.498 15.9769C52.498 23.9421 47.0467 31.8623 36.1892 31.8623H23.7807V0H36.1892ZM36.1892 24.4434C41.7354 24.4434 44.5553 20.165 44.5553 15.9769C44.5553 11.7888 41.7354 7.37376 36.1892 7.37376H31.772V24.4434H36.1892ZM55.0955 32C57.6332 32 59.4665 29.9511 59.4665 27.9485C59.4665 25.5361 57.6321 23.897 55.0955 23.897C52.7464 23.897 50.8657 25.5361 50.8657 27.9485C50.8657 29.9511 52.7464 32 55.0955 32Z" fill="white"/>
-</svg>