cumstack 1.0.1 → 1.0.2

package/cli/builder.js

@@ -61,7 +61,7 @@ export async function buildApp(appRoot, isDev = false, buildTimestamp = Date.now
               let subpath = args.path.replace('@cumstack/app', '');
               if (subpath === '/server') subpath = '/app/server/index.js';
               else if (subpath === '/client') subpath = '/app/client/index.js';
-              else if (subpath === '/client/Twink') subpath = '/app/client/Twink.js';
+              else if (subpath === '/client/Lust') subpath = '/app/client/Lust.js';
               else if (subpath === '/shared/i18n') subpath = '/app/shared/i18n.js';
               else if (subpath === '/shared/reactivity') subpath = '/app/shared/reactivity.js';
               else if (subpath === '/shared/router') subpath = '/app/shared/router.js';
@@ -128,7 +128,7 @@ export async function buildApp(appRoot, isDev = false, buildTimestamp = Date.now
             else if (subpath === '/shared/router') subpath = '/app/shared/router.js';
             else if (subpath === '/shared/utils') subpath = '/app/shared/utils.js';
             else if (subpath === '/shared/language-codes') subpath = '/app/shared/language-codes.js';
-            else if (subpath === '/client/Twink') subpath = '/app/client/Twink.js';
+            else if (subpath === '/client/Lust') subpath = '/app/client/Lust.js';
             else if (!subpath.endsWith('.js')) subpath += '.js';
             return {
               path: path.join(__dirname, '..', 'src', subpath),

package/index.js

@@ -2,10 +2,10 @@
 
 // client exports
 export { cowgirl, CowgirlCreampie, configureHydration } from './src/app/client/index.js';
-export { Twink } from './src/app/client/Twink.js';
+export { Lust } from './src/app/client/Lust.js';
 
 // server exports
-export { foxgirl, FoxgirlCreampie, Router, Route, Head, Title, Meta, TwinkTag, Script, h, renderToString } from './src/app/server/index.js';
+export { foxgirl, FoxgirlCreampie, Router, Route, Head, Title, Meta, LustTag, Script, h, renderToString } from './src/app/server/index.js';
 
 // shared exports
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cumstack",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A lightweight reactive framework with signals, routing, and i18n",
   "type": "module",
   "main": "index.js",
@@ -42,7 +42,7 @@
     "./app/shared/router": "./src/app/shared/router.js",
     "./app/shared/utils": "./src/app/shared/utils.js",
     "./app/shared/language-codes": "./src/app/shared/language-codes.js",
-    "./client/Twink": "./src/app/client/Twink.js",
+    "./client/Lust": "./src/app/client/Lust.js",
     "./client/components": "./src/app/client/components.js",
     "./client/hmr": "./src/app/client/hmr.js",
     "./server/components": "./src/app/server/components.js",

package/src/app/client/{Twink.js → Lust.js}

@@ -15,16 +15,16 @@ function isInLanguageRoute() {
 
 /**
  * smart link component with automatic language prefix handling
- * @param {Object} props - Twink properties
- * @param {string} props.href - Twink URL
+ * @param {Object} props - Lust properties
+ * @param {string} props.href - Lust URL
  * @param {string|boolean} [props.locale] - Language code or false to disable prefix
  * @param {string} [props.prefetch] - Prefetch mode ('hover' or 'visible')
  * @param {string} [props.access] - Access level for link
  * @param {boolean} [props.external] - Force external link behavior
- * @param {*} props.children - Twink content
+ * @param {*} props.children - Lust content
  * @returns {Object} Virtual DOM element
  */
-export function Twink(props) {
+export function Lust(props) {
   const { href, locale, prefetch, access, external, children, ...rest } = props;
   const currentLanguage = getLanguage();
   const isExternal = external || href.startsWith('http') || href.startsWith('//');

package/src/app/client/index.js

@@ -7,7 +7,7 @@ import { setLanguage, detectBrowserLanguage, clearPreferredLanguage, getUserLang
 import { initComponents } from './components.js';
 import { initHMR } from './hmr.js';
 
-export { Twink } from './Twink.js';
+export { Lust } from './Lust.js';
 export { configureHydration } from '../client.js';
 
 /**
@@ -117,7 +117,7 @@ function renderElement(vnode, container) {
  */
 function setupNavigation() {
   // update all spa links to include language prefix if in a language route
-  function updateTwinksForLanguage() {
+  function updateLustsForLanguage() {
     const inLanguageRoute = window.location.pathname.match(/^\/([a-z]{2})(?:\/|$)/);
     if (!inLanguageRoute) return;
     const lang = inLanguageRoute[1];
@@ -130,7 +130,7 @@ function setupNavigation() {
   }
 
   // update on initial load
-  updateTwinksForLanguage();
+  updateLustsForLanguage();
 
   document.addEventListener('click', (e) => {
     const link = e.target.closest('a[data-spa-link]');

package/src/app/client.js

@@ -470,11 +470,11 @@ export function cowgirl(app, container) {
     if (!link) return;
     const href = link.getAttribute('href');
     if (!href) return;
-    const isSpaTwink = link.hasAttribute('data-spa-link');
+    const isSpaLust = link.hasAttribute('data-spa-link');
     const isNoSpa = link.hasAttribute('data-no-spa');
     if (isNoSpa) return;
     const isInternal = href.startsWith('/') && !href.startsWith('//');
-    if (isInternal || isSpaTwink) {
+    if (isInternal || isSpaLust) {
       e.preventDefault();
       if (i18nConfig?.explicitRouting) {
         const { language } = extractLanguageFromRoute(href);
@@ -498,7 +498,7 @@ export function cowgirl(app, container) {
  */
 const prefetchedUrls = new Set();
 function setupPrefetching() {
-  const observedTwinks = new Set();
+  const observedLusts = new Set();
   const observer = new IntersectionObserver((entries) => {
     entries.forEach((entry) => {
       if (entry.isIntersecting) {
@@ -509,31 +509,31 @@ function setupPrefetching() {
       } else {
         // unobserve links that leave viewport
         const link = entry.target;
-        if (!entry.isIntersecting && observedTwinks.has(link)) {
+        if (!entry.isIntersecting && observedLusts.has(link)) {
           observer.unobserve(link);
-          observedTwinks.delete(link);
+          observedLusts.delete(link);
         }
       }
     });
   });
-  const observeTwinks = () => {
+  const observeLusts = () => {
     // observe new links
     document.querySelectorAll('a[data-prefetch="visible"]').forEach((link) => {
-      if (!observedTwinks.has(link)) {
+      if (!observedLusts.has(link)) {
         observer.observe(link);
-        observedTwinks.add(link);
+        observedLusts.add(link);
       }
     });
     // clean up removed links
-    observedTwinks.forEach((link) => {
+    observedLusts.forEach((link) => {
       if (!document.contains(link)) {
         observer.unobserve(link);
-        observedTwinks.delete(link);
+        observedLusts.delete(link);
       }
     });
   };
-  observeTwinks();
-  const mutationObserver = new MutationObserver(observeTwinks);
+  observeLusts();
+  const mutationObserver = new MutationObserver(observeLusts);
   mutationObserver.observe(document.body, { childList: true, subtree: true });
   const mouseoverHandler = (e) => {
     const link = e.target.closest('a[data-prefetch="hover"]');
@@ -549,7 +549,7 @@ function setupPrefetching() {
   return () => {
     observer.disconnect();
     mutationObserver.disconnect();
-    observedTwinks.clear();
+    observedLusts.clear();
     document.removeEventListener('mouseover', mouseoverHandler);
   };
 }

package/src/app/server/index.js

@@ -36,7 +36,7 @@ export async function renderToString(vnode) {
     return results.join('');
   }
 
-  // For plain objects from cumstack components (like Twink)
+  // For plain objects from cumstack components (like Lust)
   if (vnode && typeof vnode === 'object' && vnode.type && vnode.props !== undefined && !vnode.toStringToBuffer) {
     const { type, props, children } = vnode;
 
@@ -173,6 +173,7 @@ const headContext = {
   meta: [],
   links: [],
   scripts: [],
+  cache: null,
 };
 
 export function Head({ children }) {
@@ -192,7 +193,7 @@ export function Meta(props) {
   return null;
 }
 
-export function TwinkTag(props) {
+export function LustTag(props) {
   headContext.links.push(props);
   return null;
 }
@@ -210,7 +211,7 @@ function processHeadChild(child) {
   else if (child.type === 'script') headContext.scripts.push(child.props);
   else if (child.type === Title) headContext.title = child.children?.[0] || 'App';
   else if (child.type === Meta) headContext.meta.push(child.props);
-  else if (child.type === TwinkTag) headContext.links.push(child.props);
+  else if (child.type === LustTag) headContext.links.push(child.props);
   else if (child.type === Script) headContext.scripts.push(child.props);
 }
 
@@ -219,8 +220,59 @@ function resetHeadContext() {
   headContext.meta = [];
   headContext.links = [];
   headContext.scripts = [];
+  headContext.cache = null;
 }
 
+export function getHeadContext() {
+  return headContext;
+}
+
+export function setCache(cacheConfig) {
+  headContext.cache = cacheConfig;
+}
+
+/**
+ * MilkStorage - Cache presets for common use cases
+ * Use with setCache() or in metadata.cache
+ *
+ * Simple syntax:
+ * cache: { app: 3600, cdn: 3600 }
+ *
+ * @example
+ * const metadata = {
+ *   title: 'Home',
+ *   cache: MilkStorage.medium
+ * };
+ *
+ * Or custom:
+ * cache: { app: 3600, cdn: 86400 }
+ */
+export const MilkStorage = {
+  // No caching - always fetch fresh
+  none: { app: 0 },
+  // Short cache - 5 minutes
+  short: { app: 300, cdn: 300 },
+  // Medium cache - 1 hour app, 6 hours CDN
+  medium: { app: 3600, cdn: 21600 },
+  // Long cache - 1 hour app, 1 day CDN
+  long: { app: 3600, cdn: 86400 },
+  // Static content - 1 day app, 1 week CDN
+  static: { app: 86400, cdn: 604800 },
+  // Dynamic with revalidation - serve stale while updating
+  revalidate: {
+    app: 60,
+    cdn: 3600,
+    staleWhileRevalidate: 86400,
+  },
+  // Resilient - serve stale on errors
+  resilient: {
+    app: 3600,
+    cdn: 86400,
+    staleWhileRevalidate: 86400,
+    staleIfError: 604800,
+  },
+};
+
 /**
  * html document template
  * user provides head and body, cumstack handles structure and script injection
@@ -243,7 +295,7 @@ async function Document({ content, language }) {
     const headElements = customHead({ context: headContext });
     headHtml = await renderToString(headElements);
   } else {
-    // Render meta tags as strings
+    // render meta tags as strings
     const metaTags = headContext.meta
       .map((m) => {
         const attrs = Object.entries(m)
@@ -401,13 +453,37 @@ export async function foxgirl(app, options = {}) {
           resetHeadContext();
           const language = c.get('language');
           const pageContent = component();
-          // Convert pageContent to string first before passing to Document
+          // convert pageContent to string first before passing to Document
           const contentHtml = await renderToString(pageContent);
           const html = await Document({ content: contentHtml, language });
-          // Return HTML response
-          return new Response(html, {
-            headers: { 'Content-Type': 'text/html; charset=utf-8' },
-          });
+          // Set cache headers if configured
+          const headers = { 'Content-Type': 'text/html; charset=utf-8' };
+          const isDev = globalThis.__ENVIRONMENT__ === 'development';
+
+          // Always set cache control headers
+          if (isDev) headers['Cache-Control'] = 'no-cache, no-store, must-revalidate';
+          else if (headContext.cache) {
+            const { app = 0, cdn = null, staleWhileRevalidate = null, staleIfError = null, tags = null, mustRevalidate = false } = headContext.cache;
+
+            const directives = [];
+            if (app === 0 && cdn === null) directives.push('no-cache', 'no-store', 'must-revalidate');
+            else {
+              // If CDN cache is set, make it public; otherwise private
+              const isPublic = cdn !== null;
+              directives.push(isPublic ? 'public' : 'private');
+              if (app > 0) directives.push(`max-age=${app}`);
+              if (cdn !== null) directives.push(`s-maxage=${cdn}`);
+              if (staleWhileRevalidate !== null) directives.push(`stale-while-revalidate=${staleWhileRevalidate}`);
+              if (staleIfError !== null) directives.push(`stale-if-error=${staleIfError}`);
+              if (mustRevalidate) directives.push('must-revalidate');
+            }
+            headers['Cache-Control'] = directives.join(', ');
+            // cloudflare-specific: Cache tags for purging
+            if (tags && Array.isArray(tags)) headers['Cache-Tag'] = tags.join(',');
+            // add vary header for i18n if using explicit routing
+            if (globalI18nConfig?.explicitRouting) headers['Vary'] = 'Accept-Language';
+          } else headers['Cache-Control'] = 'private, no-cache';
+          return new Response(html, { headers });
         } catch (error) {
           console.error('Route error:', error);
           return c.text('Internal Server Error', 500);

package/src/app/shared/router.js

@@ -113,10 +113,10 @@ export function createRouter() {
 
 /**
  * create a link component helper
- * @param {string} href - Twink href
- * @param {Object} options - Twink options
+ * @param {string} href - Lust href
+ * @param {Object} options - Lust options
  */
-export function createTwink(href, options = {}) {
+export function createLust(href, options = {}) {
   return {
     href,
     onClick: (e) => {

package/templates/monorepo/app/jsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "~/*": ["src/*"]
+    }
+  }
+}

package/templates/monorepo/app/package.json

@@ -8,7 +8,7 @@
     "start": "bun run dist/server.js"
   },
   "dependencies": {
-    "cumstack": "^1.0.1"
+    "cumstack": "^1.0.2"
   },
   "devDependencies": {
     "bun": "^1.3.5",