Phase 1: scaffold, types, schema, layout shell

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Falkan
2026-03-16 21:22:34 -04:00
parent 3dc336b5ae
commit 65f8bc1b9f
23 changed files with 2022 additions and 1 deletions

23
.gitignore vendored Normal file
View File

@@ -0,0 +1,23 @@
node_modules
# Output
.output
.vercel
.netlify
.wrangler
/.svelte-kit
/build
# OS
.DS_Store
Thumbs.db
# Env
.env
.env.*
!.env.example
!.env.test
# Vite
vite.config.js.timestamp-*
vite.config.ts.timestamp-*

1
.npmrc Normal file
View File

@@ -0,0 +1 @@
engine-strict=true

3
.vscode/extensions.json vendored Normal file
View File

@@ -0,0 +1,3 @@
{
"recommendations": ["svelte.svelte-vscode"]
}

View File

@@ -1 +1,42 @@
# humor-units
# sv
Everything you need to build a Svelte project, powered by [`sv`](https://github.com/sveltejs/cli).
## Creating a project
If you're seeing this, you've probably already done this step. Congrats!
```sh
# create a new project
npx sv create my-app
```
To recreate this project with the same configuration:
```sh
# recreate this project
npx sv@0.12.7 create --template minimal --types ts --no-install .
```
## Developing
Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:
```sh
npm run dev
# or start the server and open the app in a new browser tab
npm run dev -- --open
```
## Building
To create a production version of your app:
```sh
npm run build
```
You can preview the production build with `npm run preview`.
> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment.

1697
package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

28
package.json Normal file
View File

@@ -0,0 +1,28 @@
{
"name": "humor-units",
"private": true,
"version": "0.0.1",
"type": "module",
"scripts": {
"dev": "vite dev",
"build": "vite build",
"preview": "vite preview",
"prepare": "svelte-kit sync || echo ''",
"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch"
},
"devDependencies": {
"@sveltejs/adapter-static": "^3.0.10",
"@sveltejs/kit": "^2.50.2",
"@sveltejs/vite-plugin-svelte": "^6.2.4",
"@types/big.js": "^6.2.2",
"svelte": "^5.51.0",
"svelte-check": "^4.4.2",
"typescript": "^5.9.3",
"vite": "^7.3.1"
},
"dependencies": {
"@picocss/pico": "^2.1.1",
"big.js": "^7.0.1"
}
}

13
src/app.d.ts vendored Normal file
View File

@@ -0,0 +1,13 @@
// See https://svelte.dev/docs/kit/types#app.d.ts
// for information about these interfaces
declare global {
namespace App {
// interface Error {}
// interface Locals {}
// interface PageData {}
// interface PageState {}
// interface Platform {}
}
}
export {};

11
src/app.html Normal file
View File

@@ -0,0 +1,11 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
%sveltekit.head%
</head>
<body data-sveltekit-preload-data="hover">
<div style="display: contents">%sveltekit.body%</div>
</body>
</html>

View File

@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="107" height="128" viewBox="0 0 107 128"><title>svelte-logo</title><path d="M94.157 22.819c-10.4-14.885-30.94-19.297-45.792-9.835L22.282 29.608A29.92 29.92 0 0 0 8.764 49.65a31.5 31.5 0 0 0 3.108 20.231 30 30 0 0 0-4.477 11.183 31.9 31.9 0 0 0 5.448 24.116c10.402 14.887 30.942 19.297 45.791 9.835l26.083-16.624A29.92 29.92 0 0 0 98.235 78.35a31.53 31.53 0 0 0-3.105-20.232 30 30 0 0 0 4.474-11.182 31.88 31.88 0 0 0-5.447-24.116" style="fill:#ff3e00"/><path d="M45.817 106.582a20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.503 18 18 0 0 1 .624-2.435l.49-1.498 1.337.981a33.6 33.6 0 0 0 10.203 5.098l.97.294-.09.968a5.85 5.85 0 0 0 1.052 3.878 6.24 6.24 0 0 0 6.695 2.485 5.8 5.8 0 0 0 1.603-.704L69.27 76.28a5.43 5.43 0 0 0 2.45-3.631 5.8 5.8 0 0 0-.987-4.371 6.24 6.24 0 0 0-6.698-2.487 5.7 5.7 0 0 0-1.6.704l-9.953 6.345a19 19 0 0 1-5.296 2.326 20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.502 17.99 17.99 0 0 1 8.13-12.052l26.081-16.623a19 19 0 0 1 5.3-2.329 20.72 20.72 0 0 1 22.237 8.243 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-.624 2.435l-.49 1.498-1.337-.98a33.6 33.6 0 0 0-10.203-5.1l-.97-.294.09-.968a5.86 5.86 0 0 0-1.052-3.878 6.24 6.24 0 0 0-6.696-2.485 5.8 5.8 0 0 0-1.602.704L37.73 51.72a5.42 5.42 0 0 0-2.449 3.63 5.79 5.79 0 0 0 .986 4.372 6.24 6.24 0 0 0 6.698 2.486 5.8 5.8 0 0 0 1.602-.704l9.952-6.342a19 19 0 0 1 5.295-2.328 20.72 20.72 0 0 1 22.237 8.242 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-8.13 12.053l-26.081 16.622a19 19 0 0 1-5.3 2.328" style="fill:#fff"/></svg>

After

Width:  |  Height:  |  Size: 1.5 KiB

22
src/lib/config.ts Normal file
View File

@@ -0,0 +1,22 @@
/**
* Number display configuration.
* Adjust these constants to change how conversion results are formatted.
*/
/** If set, zero-pads the integer part to this many digits. Unset = show as-is. */
export const INTEGER_DIGITS: number | undefined = undefined;
/** Number of decimal places to show (fixed-point). */
export const FRACTIONAL_DIGITS: number = 8;
/**
* Output grid layout configuration.
* Grid uses CSS Grid repeat(auto-fill, minmax(MIN_COLUMN_WIDTH, 1fr)).
* Column count is automatic — determined by available width ÷ (MIN_COLUMN_WIDTH + GRID_GAP).
*/
/** Minimum tile width for the output grid. Controls automatic column count. */
export const MIN_COLUMN_WIDTH: string = '160px';
/** Gap between output grid tiles. Used for both row and column gaps. */
export const GRID_GAP: string = '1rem';

31
src/lib/convert.ts Normal file
View File

@@ -0,0 +1,31 @@
import { Big } from 'big.js';
import type { Unit } from './types';
/**
* Convert a value from one unit to another using canonical base-unit factors.
* Uses big.js for all arithmetic to avoid floating-point precision loss.
* Pure function — no side effects, no imports of the unit registry.
*/
export function convert(value: Big, from: Unit, to: Unit): Big {
if (from.id === to.id) return value;
const inBase = value.times(from.toBase);
return inBase.div(to.toBase);
}
/**
* Convert a value using unit IDs, looking up from a provided registry.
* Accepts a number or Big for the input value.
* Throws if either ID is not found.
*/
export function convertById(
value: number | Big,
fromId: string,
toId: string,
units: Unit[]
): Big {
const from = units.find((u) => u.id === fromId);
const to = units.find((u) => u.id === toId);
if (!from) throw new Error(`Unknown unit id: ${fromId}`);
if (!to) throw new Error(`Unknown unit id: ${toId}`);
return convert(Big(value), from, to);
}

1
src/lib/index.ts Normal file
View File

@@ -0,0 +1 @@
// place files you want to import through the `$lib` alias in this folder.

34
src/lib/types.ts Normal file
View File

@@ -0,0 +1,34 @@
/**
* A single unit in the custom unit system.
* All conversion passes through the canonical base unit (toBase factor).
*/
export interface Unit {
/** Machine identifier. Stable, kebab-case. Never shown to user. */
id: string;
/** Human-readable singular display name. Shown in UI labels. */
label: string;
/** Human-readable plural display name. Used in result rows ("12 blurbs"). */
labelPlural: string;
/** Short symbol or abbreviation for compact display. */
symbol: string;
/**
* Conversion factor to canonical base unit for this group.
* The base unit itself has toBase = 1.0.
* To convert A → B: result = valueA * A.toBase / B.toBase
*/
toBase: number;
/** Optional grouping tag for multi-group converters. */
group?: string;
}
/** A named collection of units sharing a base unit. */
export interface UnitGroup {
id: string;
label: string;
units: Unit[];
}

View File

@@ -0,0 +1,40 @@
import type { Unit } from '../types';
/**
* Invented unit group: Florp measurement system.
* Base unit: "blurb" (toBase = 1.0). All others defined relative to it.
*/
export const florpUnits: Unit[] = [
{
id: 'blurb',
label: 'Blurb',
labelPlural: 'Blurbs',
symbol: 'bl',
toBase: 1.0,
group: 'florp',
},
{
id: 'snorp',
label: 'Snorp',
labelPlural: 'Snorps',
symbol: 'sn',
toBase: 7.5,
group: 'florp',
},
{
id: 'krumble',
label: 'Krumble',
labelPlural: 'Krumbles',
symbol: 'kr',
toBase: 0.25,
group: 'florp',
},
{
id: 'wobbit',
label: 'Wobbit',
labelPlural: 'Wobbits',
symbol: 'wb',
toBase: 144.0,
group: 'florp',
},
];

26
src/routes/+layout.svelte Normal file
View File

@@ -0,0 +1,26 @@
<script lang="ts">
import '@picocss/pico/css/pico.min.css';
let { children } = $props();
</script>
<header>
<nav class="container">
<ul>
<li><strong>Humor Units</strong></li>
</ul>
<ul>
<li><a href="/">Converter</a></li>
<li><a href="/about">About</a></li>
<li><a href="/contact">Contact</a></li>
</ul>
</nav>
</header>
<main class="container">
{@render children()}
</main>
<footer class="container">
<small>Humor Units — invented conversions for invented purposes</small>
</footer>

1
src/routes/+layout.ts Normal file
View File

@@ -0,0 +1 @@
export const prerender = true;

1
src/routes/+page.svelte Normal file
View File

@@ -0,0 +1 @@
<h1>Humor Units</h1>

View File

@@ -0,0 +1 @@
<h1>About</h1>

View File

@@ -0,0 +1 @@
<h1>Contact</h1>

3
static/robots.txt Normal file
View File

@@ -0,0 +1,3 @@
# allow crawling everything by default
User-agent: *
Disallow:

16
svelte.config.js Normal file
View File

@@ -0,0 +1,16 @@
import adapter from '@sveltejs/adapter-static';
/** @type {import('@sveltejs/kit').Config} */
const config = {
kit: {
adapter: adapter({
fallback: '404.html'
})
},
vitePlugin: {
dynamicCompileOptions: ({ filename }) =>
filename.includes('node_modules') ? undefined : { runes: true }
}
};
export default config;

20
tsconfig.json Normal file
View File

@@ -0,0 +1,20 @@
{
"extends": "./.svelte-kit/tsconfig.json",
"compilerOptions": {
"rewriteRelativeImportExtensions": true,
"allowJs": true,
"checkJs": true,
"esModuleInterop": true,
"forceConsistentCasingInFileNames": true,
"resolveJsonModule": true,
"skipLibCheck": true,
"sourceMap": true,
"strict": true,
"moduleResolution": "bundler"
}
// Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
// except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
//
// To make changes to top-level options such as include and exclude, we recommend extending
// the generated config; see https://svelte.dev/docs/kit/configuration#typescript
}

6
vite.config.ts Normal file
View File

@@ -0,0 +1,6 @@
import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [sveltekit()]
});