From 21348cc2b7e7c447353397111264e8dc45c7be9d Mon Sep 17 00:00:00 2001 From: Ritesh Kumar Date: Tue, 29 Sep 2026 01:20:41 +0530 Subject: [PATCH] Migrate Transform to TanStack Start --- .gitignore | 6 + .prettierignore | 1 + README.md | 35 +- pages/_app.tsx => components/AppShell.tsx | 61 +- components/ConversionPanel.tsx | 12 +- components/EditorPanel.tsx | 37 +- components/Form.tsx | 2 +- components/Meta.tsx | 26 - components/Navigator.tsx | 50 +- components/NoSSR.tsx | 10 +- components/Searchbox.tsx | 15 +- components/SvgConverter.tsx | 29 +- .../plans/2026-09-29-tanstack-start.md | 41 + .../specs/2026-09-29-tanstack-start-design.md | 7 + hooks/useData.ts | 2 +- hooks/useLocalStorage.ts | 9 +- next-env.d.ts | 2 - next.config.js | 46 - package.json | 43 +- pages/_document.tsx | 44 - pages/_error.tsx | 38 - pages/api/flow-to-javascript.ts | 32 - pages/api/flow-to-typescript.ts | 49 - pages/api/html-to-pug.ts | 13 - pages/api/json-schema-to-openapi-schema.ts | 16 - pages/api/typescript-to-flow.ts | 14 - pages/api/typescript-to-javascript.ts | 40 - pages/api/typescript-to-json-schema.ts | 31 - pages/api/typescript-to-zod.ts | 36 - pages/cadence-to-go.tsx | 56 +- pages/css-to-js.tsx | 2 +- pages/css-to-tailwind.tsx | 50 +- pages/graphql-to-components.tsx | 2 +- pages/graphql-to-flow.tsx | 2 +- pages/graphql-to-fragment-matcher.tsx | 2 +- pages/graphql-to-introspection-json.tsx | 2 +- pages/graphql-to-java.tsx | 2 +- pages/graphql-to-resolvers-signature.tsx | 2 +- pages/graphql-to-schema-ast.tsx | 2 +- pages/graphql-to-typescript-mongodb.tsx | 2 +- pages/graphql-to-typescript.tsx | 2 +- pages/html-to-jsx.tsx | 34 +- pages/index.tsx | 4 +- pages/js-object-to-typescript.tsx | 34 +- pages/json-schema-to-zod.tsx | 29 +- pages/json-to-flow.tsx | 29 +- pages/json-to-mobx-state-tree.tsx | 2 +- pages/json-to-proptypes.tsx | 2 +- pages/json-to-rust-serde.tsx | 29 +- pages/json-to-typescript.tsx | 29 +- pages/json-to-zod.tsx | 29 +- pages/jsonld-to-compacted.tsx | 2 +- pages/jsonld-to-flattened.tsx | 2 +- pages/jsonld-to-framed.tsx | 2 +- pages/object-styles-to-template-literal.tsx | 6 +- pages/svg-to-react-native.tsx | 6 +- pages/typescript-to-zod.tsx | 29 +- patches/htmltojsx+0.3.0.patch | 70 +- patches/json_typegen_wasm+0.7.0.patch | 17 - playwright.config.ts | 16 + routeTree.gen.ts | 1659 +++++++ router.tsx | 17 + routes/__root.tsx | 104 + routes/api.flow-to-javascript.ts | 6 + routes/api.flow-to-typescript.ts | 6 + routes/api.html-to-pug.ts | 6 + routes/api.json-schema-to-openapi-schema.ts | 6 + routes/api.typescript-to-flow.ts | 6 + routes/api.typescript-to-javascript.ts | 6 + routes/api.typescript-to-json-schema.ts | 6 + routes/api.typescript-to-zod.ts | 6 + routes/cadence-to-go.tsx | 6 + routes/css-to-js.tsx | 6 + routes/css-to-tailwind.tsx | 6 + routes/flow-to-javascript.tsx | 6 + routes/flow-to-typescript-declaration.tsx | 8 + routes/flow-to-typescript.tsx | 6 + routes/graphql-to-components.tsx | 6 + routes/graphql-to-flow.tsx | 6 + routes/graphql-to-fragment-matcher.tsx | 8 + routes/graphql-to-introspection-json.tsx | 8 + routes/graphql-to-java.tsx | 6 + routes/graphql-to-resolvers-signature.tsx | 8 + routes/graphql-to-schema-ast.tsx | 6 + routes/graphql-to-typescript-mongodb.tsx | 8 + routes/graphql-to-typescript.tsx | 6 + routes/html-to-jsx.tsx | 6 + routes/html-to-pug.tsx | 6 + routes/index.tsx | 6 + routes/js-object-to-json.tsx | 6 + routes/js-object-to-typescript.tsx | 8 + routes/json-schema-to-openapi-schema.tsx | 8 + routes/json-schema-to-protobuf.tsx | 8 + routes/json-schema-to-ts.tsx | 11 + routes/json-schema-to-typescript.tsx | 8 + routes/json-schema-to-zod.tsx | 6 + routes/json-to-big-query.tsx | 6 + routes/json-to-flow-types.tsx | 7 + routes/json-to-flow.tsx | 6 + routes/json-to-go-bson.tsx | 6 + routes/json-to-go.tsx | 6 + routes/json-to-graphql.tsx | 6 + routes/json-to-io-ts.tsx | 6 + routes/json-to-java.tsx | 6 + routes/json-to-jsdoc.tsx | 6 + routes/json-to-json-schema.tsx | 6 + routes/json-to-kotlin.tsx | 6 + routes/json-to-mobx-state-tree.tsx | 8 + routes/json-to-mongoose.tsx | 6 + routes/json-to-mysql.tsx | 6 + routes/json-to-proptypes.tsx | 6 + routes/json-to-rust-serde.tsx | 6 + routes/json-to-sarcastic.tsx | 6 + routes/json-to-scala-case-class.tsx | 8 + routes/json-to-toml.tsx | 6 + routes/json-to-ts-interface.tsx | 11 + routes/json-to-typescript.tsx | 6 + routes/json-to-yaml.tsx | 6 + routes/json-to-zod.tsx | 6 + routes/jsonld-to-compacted.tsx | 6 + routes/jsonld-to-expanded.tsx | 6 + routes/jsonld-to-flattened.tsx | 6 + routes/jsonld-to-framed.tsx | 6 + routes/jsonld-to-normalized.tsx | 6 + routes/jsonld-to-nquads.tsx | 6 + routes/markdown-to-html.tsx | 6 + routes/object-styles-to-template-literal.tsx | 8 + routes/svg-to-jsx.tsx | 7 + routes/svg-to-react-native.tsx | 6 + routes/toml-to-json.tsx | 6 + routes/toml-to-yaml.tsx | 6 + routes/typescript-to-flow.tsx | 6 + routes/typescript-to-javascript.tsx | 8 + routes/typescript-to-json-schema.tsx | 8 + .../typescript-to-typescript-declaration.tsx | 8 + routes/typescript-to-zod.tsx | 6 + routes/xml-to-json.tsx | 6 + routes/yaml-to-json.tsx | 6 + routes/yaml-to-toml.tsx | 6 + server/converters/flow-to-javascript.ts | 26 + server/converters/flow-to-typescript.ts | 39 + server/converters/html-to-pug.ts | 15 + server/converters/http.ts | 78 + .../json-schema-to-openapi-schema.ts | 15 + server/converters/typescript-to-flow.ts | 14 + server/converters/typescript-to-javascript.ts | 35 + .../converters/typescript-to-json-schema.ts | 49 + server/converters/typescript-to-zod.ts | 39 + tests/api.test.mjs | 204 + tests/browser/converters.spec.ts | 100 + tests/browser/routes.spec.ts | 33 + tests/browser/routing.spec.ts | 34 + tests/http.test.ts | 74 + tsconfig.json | 15 +- typings.d.ts | 52 +- typings/npm/evergreen-ui.d.ts | 5 +- utils/prettier.ts | 1 + utils/prettify.ts | 19 +- utils/request.ts | 3 +- utils/workerWrapper.ts | 2 - vercel.json | 8 +- vite.config.ts | 107 + workers/babel.worker.ts | 2 +- workers/cadence.worker.ts | 16 + workers/svgo.worker.ts | 9 +- workers/svgoPlugins.ts | 101 + workers/svgr.worker.ts | 11 +- yarn.lock | 3819 +++++++---------- 168 files changed, 5370 insertions(+), 3077 deletions(-) rename pages/_app.tsx => components/AppShell.tsx (79%) delete mode 100644 components/Meta.tsx create mode 100644 docs/superpowers/plans/2026-09-29-tanstack-start.md create mode 100644 docs/superpowers/specs/2026-09-29-tanstack-start-design.md delete mode 100644 next-env.d.ts delete mode 100644 next.config.js delete mode 100644 pages/_document.tsx delete mode 100644 pages/_error.tsx delete mode 100644 pages/api/flow-to-javascript.ts delete mode 100644 pages/api/flow-to-typescript.ts delete mode 100644 pages/api/html-to-pug.ts delete mode 100644 pages/api/json-schema-to-openapi-schema.ts delete mode 100644 pages/api/typescript-to-flow.ts delete mode 100644 pages/api/typescript-to-javascript.ts delete mode 100644 pages/api/typescript-to-json-schema.ts delete mode 100644 pages/api/typescript-to-zod.ts delete mode 100644 patches/json_typegen_wasm+0.7.0.patch create mode 100644 playwright.config.ts create mode 100644 routeTree.gen.ts create mode 100644 router.tsx create mode 100644 routes/__root.tsx create mode 100644 routes/api.flow-to-javascript.ts create mode 100644 routes/api.flow-to-typescript.ts create mode 100644 routes/api.html-to-pug.ts create mode 100644 routes/api.json-schema-to-openapi-schema.ts create mode 100644 routes/api.typescript-to-flow.ts create mode 100644 routes/api.typescript-to-javascript.ts create mode 100644 routes/api.typescript-to-json-schema.ts create mode 100644 routes/api.typescript-to-zod.ts create mode 100644 routes/cadence-to-go.tsx create mode 100644 routes/css-to-js.tsx create mode 100644 routes/css-to-tailwind.tsx create mode 100644 routes/flow-to-javascript.tsx create mode 100644 routes/flow-to-typescript-declaration.tsx create mode 100644 routes/flow-to-typescript.tsx create mode 100644 routes/graphql-to-components.tsx create mode 100644 routes/graphql-to-flow.tsx create mode 100644 routes/graphql-to-fragment-matcher.tsx create mode 100644 routes/graphql-to-introspection-json.tsx create mode 100644 routes/graphql-to-java.tsx create mode 100644 routes/graphql-to-resolvers-signature.tsx create mode 100644 routes/graphql-to-schema-ast.tsx create mode 100644 routes/graphql-to-typescript-mongodb.tsx create mode 100644 routes/graphql-to-typescript.tsx create mode 100644 routes/html-to-jsx.tsx create mode 100644 routes/html-to-pug.tsx create mode 100644 routes/index.tsx create mode 100644 routes/js-object-to-json.tsx create mode 100644 routes/js-object-to-typescript.tsx create mode 100644 routes/json-schema-to-openapi-schema.tsx create mode 100644 routes/json-schema-to-protobuf.tsx create mode 100644 routes/json-schema-to-ts.tsx create mode 100644 routes/json-schema-to-typescript.tsx create mode 100644 routes/json-schema-to-zod.tsx create mode 100644 routes/json-to-big-query.tsx create mode 100644 routes/json-to-flow-types.tsx create mode 100644 routes/json-to-flow.tsx create mode 100644 routes/json-to-go-bson.tsx create mode 100644 routes/json-to-go.tsx create mode 100644 routes/json-to-graphql.tsx create mode 100644 routes/json-to-io-ts.tsx create mode 100644 routes/json-to-java.tsx create mode 100644 routes/json-to-jsdoc.tsx create mode 100644 routes/json-to-json-schema.tsx create mode 100644 routes/json-to-kotlin.tsx create mode 100644 routes/json-to-mobx-state-tree.tsx create mode 100644 routes/json-to-mongoose.tsx create mode 100644 routes/json-to-mysql.tsx create mode 100644 routes/json-to-proptypes.tsx create mode 100644 routes/json-to-rust-serde.tsx create mode 100644 routes/json-to-sarcastic.tsx create mode 100644 routes/json-to-scala-case-class.tsx create mode 100644 routes/json-to-toml.tsx create mode 100644 routes/json-to-ts-interface.tsx create mode 100644 routes/json-to-typescript.tsx create mode 100644 routes/json-to-yaml.tsx create mode 100644 routes/json-to-zod.tsx create mode 100644 routes/jsonld-to-compacted.tsx create mode 100644 routes/jsonld-to-expanded.tsx create mode 100644 routes/jsonld-to-flattened.tsx create mode 100644 routes/jsonld-to-framed.tsx create mode 100644 routes/jsonld-to-normalized.tsx create mode 100644 routes/jsonld-to-nquads.tsx create mode 100644 routes/markdown-to-html.tsx create mode 100644 routes/object-styles-to-template-literal.tsx create mode 100644 routes/svg-to-jsx.tsx create mode 100644 routes/svg-to-react-native.tsx create mode 100644 routes/toml-to-json.tsx create mode 100644 routes/toml-to-yaml.tsx create mode 100644 routes/typescript-to-flow.tsx create mode 100644 routes/typescript-to-javascript.tsx create mode 100644 routes/typescript-to-json-schema.tsx create mode 100644 routes/typescript-to-typescript-declaration.tsx create mode 100644 routes/typescript-to-zod.tsx create mode 100644 routes/xml-to-json.tsx create mode 100644 routes/yaml-to-json.tsx create mode 100644 routes/yaml-to-toml.tsx create mode 100644 server/converters/flow-to-javascript.ts create mode 100644 server/converters/flow-to-typescript.ts create mode 100644 server/converters/html-to-pug.ts create mode 100644 server/converters/http.ts create mode 100644 server/converters/json-schema-to-openapi-schema.ts create mode 100644 server/converters/typescript-to-flow.ts create mode 100644 server/converters/typescript-to-javascript.ts create mode 100644 server/converters/typescript-to-json-schema.ts create mode 100644 server/converters/typescript-to-zod.ts create mode 100644 tests/api.test.mjs create mode 100644 tests/browser/converters.spec.ts create mode 100644 tests/browser/routes.spec.ts create mode 100644 tests/browser/routing.spec.ts create mode 100644 tests/http.test.ts create mode 100644 vite.config.ts create mode 100644 workers/cadence.worker.ts create mode 100644 workers/svgoPlugins.ts diff --git a/.gitignore b/.gitignore index 5505a6a..5101a00 100644 --- a/.gitignore +++ b/.gitignore @@ -9,3 +9,9 @@ public/static/monaco/*.worker.js.map heroku .vercel + +.output +.tanstack +.playwright-cli +test-results +playwright-report diff --git a/.prettierignore b/.prettierignore index ed8fa3e..72bc038 100644 --- a/.prettierignore +++ b/.prettierignore @@ -1 +1,2 @@ public/static/monaco +routeTree.gen.ts diff --git a/README.md b/README.md index c3355c1..26fa6e2 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,35 @@ +## Development + +Requires Node.js 22.12 or newer and Yarn 1.22. + +```sh +yarn install --frozen-lockfile +yarn dev +``` + +Open http://127.0.0.1:3000. The app uses TanStack Start, React 18, and Vite. Converter components live in `pages/`; file routes live in `routes/`. The document and page metadata render on the server, while the interactive Evergreen UI and Monaco editors render on the client. Heavy conversions run in browser workers or WebAssembly; the existing server-backed converters use `server/converters/`. + +```sh +yarn typecheck +yarn test +yarn build +yarn start +``` + +The production server uses Nitro and requires Node.js. `.output/` is a self-contained deployment artifact, including the older TypeScript compiler and declaration files needed by the converters. Vercel configuration retains the existing redirects; no deployment is needed for local development. + +With a development or production server running: + +```sh +TEST_BASE_URL=http://127.0.0.1:3000 yarn test:api +TEST_BASE_URL=http://127.0.0.1:3000 yarn test:browser +``` + +Browser tests use an installed Google Chrome. They cover every converter's default example, representative edited inputs, navigation/persistence, metadata, redirects, and 404 responses. Evergreen 4 and the existing Monaco wrapper still emit React deprecation warnings in development; upgrading that UI is separate from this framework migration. + ## Credits The logo has been designed by [mikicon](https://thenounproject.com/mikicon/). @@ -24,11 +53,9 @@ The logo has been designed by [mikicon](https://thenounproject.com/mikicon/). MIT @ Ritesh Kumar -## Development +## Adding a converter -- Run `yarn && yarn dev` for development. -- Every route is a diggerent file in the `pages/*` directory -- You can add a new transformer by adding a file there and adding the route in `utils/routes.tsx` +Add the converter component in `pages/`, a matching file route in `routes/`, and its navigation entry in `utils/routes.tsx`. TanStack Router regenerates `routeTree.gen.ts` during development and builds. ## Self Hosting diff --git a/pages/_app.tsx b/components/AppShell.tsx similarity index 79% rename from pages/_app.tsx rename to components/AppShell.tsx index 5f31f10..4f21420 100644 --- a/pages/_app.tsx +++ b/components/AppShell.tsx @@ -4,10 +4,7 @@ import Navigator from "@components/Navigator"; import "@styles/main.css"; import NProgress from "nprogress"; -import Router, { useRouter } from "next/router"; -import { activeRouteData } from "@utils/routes"; -import Head from "next/head"; -import { Meta } from "@components/Meta"; +import { Outlet, useRouterState } from "@tanstack/react-router"; import { useDarkMode } from "@hooks/useDarkMode"; const logo = ( @@ -31,57 +28,25 @@ const logo = ( ); -export default function App(props) { +export default function AppShell() { const { isDarkMode, toggleDarkMode } = useDarkMode(); - const router = useRouter(); + const isLoading = useRouterState({ select: state => state.isLoading }); + const pathname = useRouterState({ select: state => state.location.pathname }); useEffect(() => { - let timer; - - const stopProgress = () => { + if (!isLoading) { + NProgress.done(); + return; + } + const timer = setTimeout(() => NProgress.start(), 300); + return () => { clearTimeout(timer); NProgress.done(); }; - - const startProgress = () => NProgress.start(); - - const showProgressBar = () => { - timer = setTimeout(startProgress, 300); - router.events.on("routeChangeComplete", stopProgress); - router.events.on("routeChangeError", stopProgress); - }; - - router.events.on("routeChangeStart", showProgressBar); - - return () => { - router.events.off("routeChangeComplete", stopProgress); - router.events.off("routeChangeError", stopProgress); - router.events.off("routeChangeStart", showProgressBar); - timer && clearTimeout(timer); - }; - }, []); - - const { Component, pageProps } = props; - - const activeRoute = activeRouteData(router.pathname); + }, [isLoading]); return ( <> - {router.pathname === "/" || !router.pathname ? ( - - ) : ( - - )} - + + + ); diff --git a/components/ConversionPanel.tsx b/components/ConversionPanel.tsx index fa38a73..10c30ea 100644 --- a/components/ConversionPanel.tsx +++ b/components/ConversionPanel.tsx @@ -3,19 +3,19 @@ import EditorPanel, { EditorPanelProps } from "@components/EditorPanel"; import * as React from "react"; import { useEffect, useState } from "react"; import { Language, useData } from "@hooks/useData"; -import { useRouter } from "next/router"; +import { useRouterState } from "@tanstack/react-router"; import { activeRouteData } from "@utils/routes"; -import PrettierWorker from "@workers/prettier.worker"; +import PrettierWorker from "@workers/prettier.worker.ts?worker"; import { getWorker } from "@utils/workerWrapper"; let prettierWorker; -function getEditorLanguage(lang: Language) { +function getEditorLanguage(lang?: Language) { const mapping = { flow: "typescript" }; - return mapping[lang] || lang; + return lang ? mapping[lang] || lang : lang; } export type Transformer = (args: { @@ -67,8 +67,8 @@ const ConversionPanel: React.FunctionComponent = function( const [message, setMessage] = useState(""); const [showUpdateSpinner, toggleUpdateSpinner] = useState(false); - const router = useRouter(); - const route = activeRouteData(router.pathname); + const pathname = useRouterState({ select: state => state.location.pathname }); + const route = activeRouteData(pathname); let packageDetails; diff --git a/components/EditorPanel.tsx b/components/EditorPanel.tsx index 8c0ea14..1fb1ef3 100644 --- a/components/EditorPanel.tsx +++ b/components/EditorPanel.tsx @@ -11,7 +11,7 @@ import { Tooltip } from "evergreen-ui"; import React, { useCallback, useEffect, useRef, useState } from "react"; -import dynamic from "next/dynamic"; +import { lazy, Suspense } from "react"; import copy from "clipboard-copy"; import Npm from "@assets/svgs/Npm"; import { useDropzone } from "react-dropzone"; @@ -41,9 +41,7 @@ export interface EditorPanelProps { }; } -const Monaco = dynamic(() => import("../components/Monaco"), { - ssr: false -}); +const Monaco = lazy(() => import("./Monaco")); export default function EditorPanel({ editable = true, @@ -82,11 +80,6 @@ export default function EditorPanel({ [showSettingsDialogue] ); - useEffect(() => { - // @ts-ignore - window.__webpack_public_path__ = "/_next/static/"; - }, []); - const getSettings = useCallback( () => ( <> @@ -99,7 +92,7 @@ export default function EditorPanel({ Settings - {settingElement({ + {settingElement?.({ toggle: _toggleSettingsDialog, open: showSettingsDialogue })} @@ -115,7 +108,7 @@ export default function EditorPanel({ reader.readAsText(file, "utf-8"); reader.onload = () => { setValue(reader.result as string); - onChange(reader.result as string); + onChange?.(reader.result as string); close(); }; }, []); @@ -146,7 +139,7 @@ export default function EditorPanel({ setValue(value); setFetchingUrl(""); close(); - onChange(value); + onChange?.(value); })(); }, [fetchingUrl, onChange] @@ -283,15 +276,17 @@ export default function EditorPanel({ toggleSettings: _toggleSettingsDialog })} - { - setValue(value); - onChange(value); - }} - /> + Loading editor…}> + { + setValue(value); + onChange?.(value); + }} + /> + ); diff --git a/components/Form.tsx b/components/Form.tsx index 1c732d0..493dffb 100644 --- a/components/Form.tsx +++ b/components/Form.tsx @@ -59,7 +59,7 @@ const Form = ({ let FormField, select; if (type === InputType.TEXT_INPUT) FormField = TextInput; else if (type === InputType.SWITCH) FormField = Switch; - else if (type === InputType.SELECT) + else if (type === InputType.SELECT && options) select = (