@taishods/core 0.0.0-stage → 0.15.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pablo Di Filippo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,8 @@
+TaishoDS Core
+Copyright (c) 2026 Pablo Di Filippo
+
+Este producto se distribuye bajo la licencia MIT (ver LICENSE).
+
+El nombre "Taisho", el logo y la identidad visual NO están cubiertos por esa
+licencia. El código se puede usar, modificar y redistribuir; no se puede presentar una
+versión propia como si fuera Taisho ni usar el nombre para identificarla.

package/README.en.md

@@ -0,0 +1,69 @@
+[Español](README.md) · **English**
+
+# @taishods/core
+
+*Consistency that scales.*
+
+TaishoDS Core: the system CSS, the tokens, and the behavior JavaScript, for any HTML page. Free, MIT license. No
+Svelte, no React.
+
+There are two ways to add it to your project. It's the same Core either way, and you can switch whenever you want.
+
+## 1. Via CDN: paste three lines
+
+It's the shortest path, with nothing to install. The version is pinned in the URL:
+
+```html
+<link rel="stylesheet" href="https://taisho.design/core/0.15.0/taisho.tokens.css" integrity="sha384-+2WHAtu42BCWEq7KajKLeexi0n+E4UXhDgH4f5iQLZWhC0WJf3DNRH2uBr4FrdIV" crossorigin="anonymous">
+<link rel="stylesheet" href="https://taisho.design/core/0.15.0/taisho.full.css" integrity="sha384-Q4p8fayuCmybnPl6l9HXyJZz4RweEW3ls0TT6mYaODd89tmBm/RhF5aMRrFXMJSb" crossorigin="anonymous">
+<script type="module" src="https://taisho.design/core/0.15.0/taisho.core.js" integrity="sha384-aDnCXLrAb0LOoe1+BB7FZmWSc9VilhinDNU4cu4E4m+NaiWTM539k3rhWDg23Ib5" crossorigin="anonymous"></script>
+```
+
+Order matters. The theme goes first, because it defines the variables; then the system CSS, which reads them; and
+the JS last, which initializes itself. Classes go on the same element as the `ts` scope class:
+`class="ts button size-md variant-primary"`.
+
+## 2. With the package and CLI: your brand in the CSS
+
+To get your colors and fonts into the CSS, and only the classes you use, install the package and run the `taisho`
+command from your project root (Node 22.18 or later):
+
+```bash
+npm i -D @taishods/core
+npx taisho init       # asks for the language, brand, theme name, fonts, and your own icons, and writes taisho.config.ts
+npx taisho generate   # compiles your CSS to ./taisho/
+```
+
+When it's done, `generate` prints the exact `<link>` tags to paste into your HTML. The behavior JS lives in
+`node_modules/@taishods/core/core.js` and loads with `<script type="module">`.
+
+If you'd rather not generate anything, you can also link the system theme and the full CSS straight from
+`node_modules`, in this order:
+
+```html
+<link rel="stylesheet" href="node_modules/@taishods/core/css/tokens/taisho.css">
+<link rel="stylesheet" href="node_modules/@taishods/core/css/taisho.full.css">
+<script type="module" src="node_modules/@taishods/core/core.js"></script>
+```
+
+## What's included
+
+- **Full CSS** — `css/taisho.full.css`, with every component and utility.
+- **System theme** — `css/tokens/taisho.css`.
+- **Behavior** — `core.js`: accordions, tabs, select, combobox, calendar, sortable table, and command palette,
+  wired up through `data-ts-*` attributes.
+- **Theming in the browser** — `createTheme()`: pass it a hex color and everything repaints, with dark mode and
+  accessible contrast derived for you.
+- **The `taisho` command** — `init`, `generate`, `watch`, `check`, and `migrate`: they compile the CSS with your brand, rebuild it on save, check your classes, and migrate from other systems.
+
+## What's not included
+
+Components for any particular framework: Core is HTML, CSS, and JavaScript, and works the same on any page. With a framework in the middle, it was tested in Astro, Next (App Router), and SvelteKit: the versions, the steps, and what wasn't tested are at https://taisho.design/docs/compatibility#frameworks.
+
+## Documentation
+
+Installation, every component, the tokens, and the utilities: https://taisho.design/en/docs/installation
+
+## License
+
+MIT. The “Taisho” trademark isn't included—see TRADEMARK.md.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+**Español** · [English](README.en.md)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @taishods/core
+
+*Coherencia que escala.*
+
+El Core de TaishoDS: el CSS del sistema, los tokens y el JavaScript de comportamiento, para
+usar en cualquier página HTML. Gratis, licencia MIT. Sin Svelte, sin React.
+
+Hay dos formas de tenerlo en tu proyecto. Son el mismo Core y se puede pasar de una a otra en cualquier momento.
+
+## 1. Por CDN: tres líneas
+
+Es la más corta, no instala nada. La versión va fija en la URL:
+
+```html
+<link rel="stylesheet" href="https://taisho.design/core/0.15.0/taisho.tokens.css" integrity="sha384-+2WHAtu42BCWEq7KajKLeexi0n+E4UXhDgH4f5iQLZWhC0WJf3DNRH2uBr4FrdIV" crossorigin="anonymous">
+<link rel="stylesheet" href="https://taisho.design/core/0.15.0/taisho.full.css" integrity="sha384-Q4p8fayuCmybnPl6l9HXyJZz4RweEW3ls0TT6mYaODd89tmBm/RhF5aMRrFXMJSb" crossorigin="anonymous">
+<script type="module" src="https://taisho.design/core/0.15.0/taisho.core.js" integrity="sha384-aDnCXLrAb0LOoe1+BB7FZmWSc9VilhinDNU4cu4E4m+NaiWTM539k3rhWDg23Ib5" crossorigin="anonymous"></script>
+```
+
+El orden importa: primero el tema, que define las variables; después el CSS del sistema, que las
+consulta; al final el JS, que se inicializa solo. Las clases se escriben con la llave `ts` en el
+mismo elemento: `class="ts button size-md variant-primary"`.
+
+## 2. Con este paquete: tu marca en el CSS
+
+Para que el CSS lleve tus colores y fuentes, y sólo las clases que se usan, se instala el paquete y
+se corre el comando `taisho` desde la raíz de tu proyecto (Node 22.18 o más nuevo):
+
+```bash
+npm i -D @taishods/core
+npx taisho init       # pregunta idioma, marca, nombre del tema, fuentes e íconos propios, y escribe taisho.config.ts
+npx taisho generate   # compila tu CSS a ./taisho/
+```
+
+Al terminar, `generate` imprime los `<link>` exactos para pegar en tu HTML. El JS de
+comportamiento queda en `node_modules/@taishods/core/core.js` y se carga con
+`<script type="module">`.
+
+Para no generar nada, el tema del sistema y el CSS completo también se pueden enlazar directo
+desde `node_modules`, en este orden:
+
+```html
+<link rel="stylesheet" href="node_modules/@taishods/core/css/tokens/taisho.css">
+<link rel="stylesheet" href="node_modules/@taishods/core/css/taisho.full.css">
+<script type="module" src="node_modules/@taishods/core/core.js"></script>
+```
+
+## Qué trae
+
+- **CSS completo** — `css/taisho.full.css`, con todos los componentes y utilidades.
+- **Tema del sistema** — `css/tokens/taisho.css`.
+- **Comportamiento** — `core.js`: acordeones, pestañas, select, combobox, calendario, tabla
+  ordenable y paleta de comandos, que se enganchan por atributos `data-ts-*`.
+- **Theming en el navegador** — `createTheme()`: se le pasa un color en hexadecimal y se repinta
+  todo, con modo oscuro y contrastes accesibles derivados solos.
+- **El comando `taisho`** — `init`, `generate`, `watch`, `check` y `migrate`: compilan el CSS con tu marca, lo recompilan al guardar, revisan las clases y migran desde otros sistemas.
+
+## Qué no trae
+
+Componentes de ningún framework: el Core es HTML, CSS y JavaScript, y se usa igual en cualquier página. Con un framework de por medio, se probó en Astro, Next (App Router) y SvelteKit: las versiones, los pasos y lo que no se probó están en https://taisho.design/docs/compatibility#frameworks.
+
+## Documentación
+
+Instalación, cada componente, los tokens y las utilidades: https://taisho.design/docs/installation
+
+## Licencia
+
+MIT. La marca "Taisho" no está incluida: ver TRADEMARK.md.

package/TRADEMARK.md

@@ -0,0 +1,57 @@
+# Política de marca — Taisho
+
+**El código es MIT. El nombre no.**
+
+`@taishods/core` se distribuye bajo licencia MIT: se puede usar, modificar, redistribuir y
+vender, sin pedir permiso ni pagar nada. Esta página trata de otra cosa: **la marca**.
+
+## Por qué hace falta este archivo
+
+Una licencia de copyright —MIT, Apache, la que sea— regula el **código**. No regula el
+**nombre**, el logo ni la identidad visual: eso es derecho de marcas, que es un régimen
+distinto y no se transmite con la licencia del software.
+
+Así que sin este documento la situación queda ambigua: alguien podría creer que MIT lo
+autoriza a publicar su fork como "Taisho", y no es así. Escribirlo no agrega una restricción
+al código — aclara un límite que ya existía.
+
+## Lo que se puede hacer, siempre
+
+- Usar Taisho en proyectos personales, comerciales o de clientes.
+- Forkearlo, modificarlo y publicar tu versión.
+- Decir con qué está construido tu producto: *"hecho con Taisho"*, *"basado en Taisho"*,
+  *"compatible con Taisho"*.
+- Escribir tutoriales, cursos, artículos y charlas que usen el nombre para referirse a esto.
+- Usar el nombre en comparaciones honestas con otros sistemas de diseño.
+
+No hace falta pedir permiso para nada de lo anterior.
+
+## Lo que no se puede hacer
+
+- **Llamar "Taisho" a tu fork o derivado**, ni ponerle un nombre que se confunda con él
+  (`Taisho UI`, `TaishoDS Pro`).
+- Usar el nombre o el logo de manera que sugiera que tu producto es **oficial**, que está
+  respaldado por Taisho o que salió de aquí.
+- Usar el logo como logo de tu propio producto o servicio.
+- Registrar "Taisho" —o algo suficientemente parecido— como marca, nombre de dominio, cuenta
+  de red social o paquete, en cualquier jurisdicción.
+
+La regla, en una línea: **se puede decir que un producto usa Taisho; no se puede decir que es Taisho.**
+
+## Alcance
+
+Cubre el nombre "Taisho", "TaishoDS", el logo, la marca gráfica y la identidad visual del
+sistema y de su documentación.
+
+**No** cubre el código, que es MIT y se rige por `LICENSE`.
+
+## Dudas y permisos
+
+Ante cualquier uso que no encaje claramente arriba, conviene preguntar antes: **pablo.difilippo@gmail.com**.
+La respuesta por defecto a un uso de buena fe es que sí.
+
+---
+
+*Esta política puede cambiar. Los cambios no son retroactivos sobre usos ya autorizados por
+escrito, y nunca afectan la licencia MIT del código, que es irrevocable para las versiones ya
+publicadas.*

package/bin/taisho

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+// src/generate-cli/node-minimo.ts
+var NODE_MINIMO = "22.18";
+function nodeSirve(version) {
+  const [mayor, menor] = version.split(".").map(Number);
+  return mayor > 22 || mayor === 22 && menor >= 18;
+}
+function idiomaDelArranque(argv, env) {
+  const i = argv.indexOf("--lang");
+  const pedido = i !== -1 ? argv[i + 1] : argv.find((a) => a.startsWith("--lang="))?.slice("--lang=".length);
+  if (pedido === "es" || pedido === "en") return pedido;
+  return /^es/i.test(env.LC_ALL || env.LC_MESSAGES || env.LANG || "") ? "es" : "en";
+}
+function mensajeNodeMinimo(version, argv, env) {
+  return idiomaDelArranque(argv, env) === "es" ? `taisho: hace falta Node ${NODE_MINIMO} o superior (esta es la ${version}). Actualiza Node y vuelve a correr el comando.` : `taisho: Node ${NODE_MINIMO} or newer is required (this is ${version}). Update Node and run the command again.`;
+}
+
+// src/bin/taisho.ts
+if (!nodeSirve(process.versions.node)) {
+  console.error(mensajeNodeMinimo(process.versions.node, process.argv.slice(2), process.env));
+  process.exitCode = 1;
+} else {
+  const { main } = await import("../cli.js");
+  await main().catch((err) => {
+    console.error("Error:", err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+  });
+}