odoro 1.0.0 → 1.0.2

package/templates/react-ts/_variantes/avec-moteur/src/fond.tsx

@@ -0,0 +1,118 @@
+/**
+ * Le fond decoratif, en surface WebGL.
+ *
+ * Cette version remplace le degrade statique parce que le moteur a ete retenu a
+ * la creation. Le reste de la page est inchange : elle place `<Fond />` et ne
+ * sait pas ce qu'il y a derriere.
+ *
+ * ## Ce que le moteur apporte, et qu'un degrade ne peut pas
+ *
+ * **Un arbitre.** La surface est demandee au gestionnaire du moteur, qui la
+ * refuse si le navigateur n'a pas WebGL, si trop de contextes sont deja
+ * ouverts, ou si l'appareil ne suivrait pas. Le refus est une valeur, pas une
+ * exception : on affiche alors le degrade, et la page tient.
+ *
+ * **Le mouvement reduit.** Sous cette preference, rien n'est monte : le fond
+ * n'apportait que son mouvement, et la carte graphique n'a pas a s'allumer pour
+ * un visiteur qui a demande le calme.
+ *
+ * **Les couleurs du theme.** Les teintes sont lues dans les jetons, pas ecrites
+ * dans le nuanceur. Une bascule clair / sombre les relit, et changer
+ * `--o-palette-brand-500` repeint le fond sans toucher a ce fichier.
+ *
+ * ## Pourquoi des styles en ligne
+ *
+ * Ce fichier est pose quel que soit le reste : un projet qui a decoche les
+ * bibliotheques n'a pas les classes `o-*`, et une classe absente ne peint rien
+ * — le fond aurait alors une hauteur nulle, sans que rien ne le signale. Les
+ * quelques regles de placement sont donc ecrites ou elles sont sures.
+ *
+ * @module
+ */
+
+import {
+  AURORA_FRAGMENT,
+  readTokenColour,
+  useMotionState,
+  useShaderSurface,
+  type ShaderColour,
+} from '@odoro-cli/engine'
+import { useEffect, useMemo, useState, type ReactElement } from 'react'
+
+/** Les jetons lus pour teinter la nappe. */
+const TEINTES = ['--o-palette-brand-500', '--o-palette-brand-300', '--o-theme-bg'] as const
+
+/** Le degrade servi tant que la surface n'est pas la — ou pour toujours. */
+function Degrade(): ReactElement {
+  return (
+    <div
+      style={{
+        position: 'absolute',
+        inset: 0,
+        opacity: 0.28,
+        filter: 'blur(64px)',
+        background:
+          'radial-gradient(60% 60% at 50% 0%, var(--o-palette-brand-500, #3b82f6), transparent)',
+      }}
+    />
+  )
+}
+
+/** Une nappe animee derriere le haut de la page. */
+export function Fond(): ReactElement {
+  const { quality, reduced } = useMotionState()
+  const [hote, setHote] = useState<HTMLElement | null>(null)
+  const [teintes, setTeintes] = useState<readonly ShaderColour[]>([])
+
+  // Relues quand l'hote apparait et quand le theme bascule — ce dernier cas
+  // passe par la politique de mouvement, qui se renouvelle a chaque etat.
+  useEffect(() => {
+    if (hote === null) return
+    setTeintes(TEINTES.map((jeton) => readTokenColour(jeton, hote)))
+  }, [hote, reduced, quality])
+
+  const uniforms = useMemo(() => {
+    const [a, b, c] = teintes
+    if (a === undefined || b === undefined || c === undefined) return undefined
+    // Le fond du theme domine, la marque n'est qu'un reflet : ces trois
+    // couleurs vont dans un melange, et deux teintes de marque sur trois
+    // donneraient une nappe pleine page plutot qu'un halo.
+    return { uColorA: c, uColorB: c, uColorC: a, uSpeed: 0.1, uScale: 1.4, uOctaves: 3 }
+  }, [teintes])
+
+  const { ref, ready, refused } = useShaderSurface<HTMLDivElement>({
+    fragment: AURORA_FRAGMENT,
+    uniforms: uniforms ?? {},
+    name: 'fond-accueil',
+  })
+
+  const repli = !ready || refused !== undefined || uniforms === undefined
+
+  return (
+    <div
+      aria-hidden="true"
+      ref={(element) => {
+        setHote(element)
+        ref.current = element
+      }}
+      style={{
+        position: 'absolute',
+        insetInline: 0,
+        top: 0,
+        height: '42rem',
+        overflow: 'hidden',
+        pointerEvents: 'none',
+        // Un fond decoratif se remarque quand on le cherche, pas avant. A
+        // pleine intensite la nappe passe devant le titre qu'elle est censee
+        // porter ; a un cinquieme, elle le souligne.
+        opacity: 0.2,
+        // Le bas se dissout dans la page : une surface qui s'arrete net dessine
+        // une ligne horizontale que rien ne justifie.
+        maskImage: 'linear-gradient(to bottom, black 45%, transparent)',
+        WebkitMaskImage: 'linear-gradient(to bottom, black 45%, transparent)',
+      }}
+    >
+      {repli ? <Degrade /> : null}
+    </div>
+  )
+}

package/templates/react-ts/_variantes/sans-libs/src/App.tsx

@@ -1,71 +1,271 @@
-import { useState } from 'react'
+/**
+ * Toute la page, en un fichier.
+ *
+ * ## Sans les bibliotheques
+ *
+ * Elles n'ont pas ete retenues a la creation : pas de classes `o-*`, pas de
+ * jetons, pas de routeur. Le dessin est celui de la version complete — meme
+ * barre en gelules, meme titre, memes cartes — porte par `styles.css` en CSS
+ * ordinaire.
+ *
+ * Pour les ajouter plus tard : `npm i @odoro-cli/libs`, puis importer
+ * `@odoro-cli/libs/styles.css` dans `main.tsx` avant cette feuille.
+ *
+ * @module
+ */
+
+import { useState, type ReactElement } from 'react'
+
+import { Fond } from '@/fond'
+
+/* -------------------------------------------------------------------------- */
+/*  Marque                                                                     */
+/* -------------------------------------------------------------------------- */
+
+/** Le signe de la marque, a la taille demandee. */
+function Signe({ taille = '1.75rem' }: { readonly taille?: string }): ReactElement {
+  return (
+    <svg
+      viewBox="0 0 100 100"
+      fill="none"
+      aria-hidden="true"
+      style={{ width: taille, height: taille, flexShrink: 0 }}
+    >
+      <path
+        d="M20.25 20.25H50a29.75 29.75 0 1 1-29.75 29.75Z"
+        stroke="currentColor"
+        strokeWidth="10.5"
+        strokeLinejoin="miter"
+      />
+    </svg>
+  )
+}
+
+/* -------------------------------------------------------------------------- */
+/*  Barre de navigation                                                        */
+/* -------------------------------------------------------------------------- */
+
+/** La barre : la marque en gelule, et le lien vers le site. */
+function Barre(): ReactElement {
+  return (
+    <header className="barre">
+      <div className="barre-contenu">
+        <span className="gelule marque">
+          <span className="marque-signe">
+            <Signe />
+          </span>
+          <span className="marque-mot">ODORO</span>
+        </span>
+
+        <a
+          href="https://odoro.dev"
+          target="_blank"
+          rel="noreferrer"
+          className="gelule gelule-lien"
+        >
+          odoro.dev
+        </a>
+      </div>
+    </header>
+  )
+}
+
+/* -------------------------------------------------------------------------- */
+/*  Sections                                                                   */
+/* -------------------------------------------------------------------------- */
+
+/** Trois faits, pas trois slogans. */
+const FAITS = ['Zero configuration', 'TypeScript strict', 'Rechargement a chaud']
+
+/** Ce que la fenetre du produit montre. */
+const EXTRAIT = `export function App() {
+  return (
+    <h1 className="hero-titre">
+      Votre premiere page.
+    </h1>
+  )
+}`
+
+/** Une fenetre de navigateur miniature. */
+function Fenetre(): ReactElement {
+  return (
+    <div className="fenetre">
+      <div className="fenetre-barre">
+        <span className="fenetre-pastilles" aria-hidden="true">
+          <span />
+          <span />
+          <span />
+        </span>
+        <span className="fenetre-chemin">src/App.tsx</span>
+      </div>
+      <pre className="fenetre-code">{EXTRAIT}</pre>
+    </div>
+  )
+}
+
+/** Le hero : la promesse, les actions, et la fenetre du produit. */
+function Hero(): ReactElement {
+  return (
+    <section className="hero">
+      <div className="contenu">
+        <span className="pastille-marque">
+          <Signe taille="0.9rem" />
+          Genere par odoro create
+        </span>
+
+        <h1 className="hero-titre">
+          Votre premiere page, <span className="accent">deja vivante</span>.
+        </h1>
+
+        <p className="hero-chapeau">
+          Le serveur de developpement, la compilation et le rechargement a chaud
+          viennent de <code>odoro</code>. Le systeme de style est le votre.
+        </p>
 
-/** Trois arguments mis en avant. */
-const FEATURES = [
+        <div className="hero-actions">
+          <a href="#piliers" className="bouton bouton-primaire">
+            Voir ce qui est inclus
+          </a>
+          <a
+            href="https://odoro.dev/docs"
+            target="_blank"
+            rel="noreferrer"
+            className="bouton bouton-secondaire"
+          >
+            Documentation
+          </a>
+        </div>
+
+        <div className="faits">
+          {FAITS.map((fait) => (
+            <span key={fait} className="fait">
+              {fait}
+            </span>
+          ))}
+        </div>
+
+        <div className="hero-fenetre">
+          <Fenetre />
+        </div>
+      </div>
+    </section>
+  )
+}
+
+/** Ce que le projet a deja sous la main. */
+const PILIERS = [
   {
-    title: 'Compilation',
-    body: 'Un serveur de developpement a rechargement a chaud, et une compilation de production.',
+    titre: 'Compilation',
+    texte:
+      'Un serveur de developpement a rechargement a chaud, et une compilation de production.',
   },
   {
-    title: 'TypeScript',
-    body: 'Types stricts, alias de chemins, et verification sans emission.',
+    titre: 'TypeScript',
+    texte: 'Types stricts, alias de chemins, et verification sans emission.',
   },
   {
-    title: 'A vous de jouer',
-    body: 'Aucun systeme de style impose : le votre prend toute la place.',
+    titre: 'A vous de jouer',
+    texte: 'Aucun systeme de style impose : le votre prend toute la place.',
   },
 ]
 
-/**
- * Racine de l'application.
- *
- * Les bibliotheques Odoro n'ont pas ete retenues a la creation : pas de
- * classes `o-*`, pas de jetons, pas de routeur. Les styles de cette page sont
- * dans `styles.css`, en CSS ordinaire.
- *
- * Pour les ajouter plus tard : `npm i @odoro-cli/libs`, puis importer
- * `@odoro-cli/libs/styles.css` dans `main.tsx`.
- */
-export function App() {
-  const [count, setCount] = useState(0)
-
+/** La section des piliers. */
+function Piliers(): ReactElement {
   return (
-    <div className="app-shell">
-      <nav className="nav">
-        <span className="marque">Odoro</span>
-      </nav>
-
-      <main className="contenu">
-        <h1>Un point de depart maitrise.</h1>
-        <p className="chapeau">
-          Ce projet a ete genere par <code>odoro create</code>. Le moteur de
-          developpement et la compilation viennent de <code>odoro</code>.
-        </p>
-
+    <section id="piliers" className="section">
+      <div className="contenu">
+        <h2 className="sur-titre">Ce qui est deja la</h2>
         <div className="grille">
-          {FEATURES.map((feature) => (
-            <article key={feature.title} className="carte">
-              <h2>{feature.title}</h2>
-              <p>{feature.body}</p>
+          {PILIERS.map((pilier, index) => (
+            <article key={pilier.titre} className="carte">
+              <span className="carte-numero">{String(index + 1).padStart(2, '0')}</span>
+              <h3>{pilier.titre}</h3>
+              <p>{pilier.texte}</p>
             </article>
           ))}
         </div>
+      </div>
+    </section>
+  )
+}
+
+/** La commande que l'on copie le plus souvent. */
+const COMMANDE = 'npm i @odoro-cli/libs'
+
+/** La cloture : une commande, et la porte vers la documentation. */
+function Cloture(): ReactElement {
+  const [copie, setCopie] = useState(false)
+
+  return (
+    <section className="section section-centre">
+      <div className="contenu-etroit">
+        <h2 className="cloture-titre">Ajoutez le systeme de style quand vous voudrez.</h2>
+        <p className="cloture-chapeau">
+          Les jetons, les utilitaires et les composants vivent dans un paquet a part. Ce
+          projet tourne sans eux, et les accueille sans rien casser.
+        </p>
 
-        <div className="ligne">
+        <div className="commande">
+          <code>{COMMANDE}</code>
           <button
             type="button"
-            className="bouton"
+            className="bouton bouton-fantome"
             onClick={() => {
-              setCount((value) => value + 1)
+              // Le presse-papiers peut etre refuse — hors contexte sur, ou
+              // permission retiree. L'echec ne casse pas la page : le libelle
+              // ne change simplement pas.
+              void navigator.clipboard
+                ?.writeText(COMMANDE)
+                .then(() => {
+                  setCopie(true)
+                  setTimeout(() => {
+                    setCopie(false)
+                  }, 1600)
+                })
+                .catch(() => undefined)
             }}
           >
-            Compter
+            {copie ? 'Copie' : 'Copier'}
           </button>
-          <span className="compteur">{count}</span>
         </div>
-      </main>
 
-      <footer className="pied">Construit avec Odoro.</footer>
+        <a
+          href="https://odoro.dev/docs/installation"
+          target="_blank"
+          rel="noreferrer"
+          className="lien-discret"
+        >
+          Lire la marche a suivre
+        </a>
+      </div>
+    </section>
+  )
+}
+
+/* -------------------------------------------------------------------------- */
+/*  Racine                                                                     */
+/* -------------------------------------------------------------------------- */
+
+/** Racine de l'application. */
+export function App(): ReactElement {
+  return (
+    <div className="app-shell">
+      <Barre />
+      <main className="principal">
+        <Fond />
+        <Hero />
+        <Piliers />
+        <Cloture />
+      </main>
+      <footer className="pied">
+        <span className="marque">
+          <span className="marque-signe">
+            <Signe taille="1.1rem" />
+          </span>
+          <span className="marque-mot">ODORO</span>
+        </span>
+        <span>Construit avec Odoro.</span>
+      </footer>
     </div>
   )
 }

package/templates/react-ts/_variantes/sans-libs/src/fond.tsx

@@ -0,0 +1,23 @@
+/**
+ * Le fond decoratif de la page.
+ *
+ * Deux nappes de couleur de marque, tres diluees. Rien ne bouge : c'est un
+ * degrade, pas une animation.
+ *
+ * Si le moteur a ete retenu, ce fichier est remplace par une version qui ouvre
+ * une surface WebGL animee. `App.tsx` place `<Fond />` et n'en demande pas plus.
+ *
+ * @module
+ */
+
+import type { ReactElement } from 'react'
+
+/** Deux nappes de marque derriere le haut de la page. */
+export function Fond(): ReactElement {
+  return (
+    <div className="fond" aria-hidden="true">
+      <div className="fond-nappe fond-nappe-haute" />
+      <div className="fond-nappe fond-nappe-droite" />
+    </div>
+  )
+}