let-time-in

CDN-first utility that weathers UI elements over time.

CDN usage

<link rel="stylesheet" href="https://unpkg.com/let-time-in@1/let-time-in.css" />
<script src="https://unpkg.com/let-time-in@1/let-time-in.js" defer></script>

Markup

<div data-ages-as="paper" data-born="2007-06-29">Aging card</div>

• data-ages-as: paper | metal | plastic
• data-born: parsable date string or timestamp
• Runtime computes --age in range 0..1

Runtime behavior

• Auto-initializes in browser builds
• Re-scans DOM when data-born changes or new nodes are added
• Leaves empty data-born values untouched (manual --age control)

Optional JS API

import { init, refresh, calculateAge } from 'let-time-in';

init({ observe: true, lifespanYears: 20 });
refresh();
const age = calculateAge(new Date('2007-06-29'));

Local package commands

bun run build
bun run check
bun run fix

Publish model

let-time-in is consumed directly from CDN. The npm package is the distribution transport that enables unpkg/jsDelivr delivery of let-time-in.css and let-time-in.js.

First release checklist

1. Set the version in package.json.
2. Run bun run build and verify let-time-in.css + let-time-in.js (top-level).
3. Update CHANGELOG.md in repo root.
4. Commit, tag, and push (git tag vX.Y.Z && git push --tags).
5. Confirm CDN URLs load:
   • https://unpkg.com/let-time-in@1/let-time-in.css
   • https://unpkg.com/let-time-in@1/let-time-in.js