@fullstackunicorn/create-root 1.0.27 → 1.0.29

package/assets/root.fullstackunicorn.dev/frontend/imports/client.js

@@ -109,7 +109,7 @@ class Client {
         if (isFresh) return cachedResponse
 
         config.timeout = 10000
-        if (etag) {
+        if (etag && cachedItem) {
             if (!config.headers) config.headers = {}
             config.headers['If-None-Match'] = etag
         }
@@ -121,6 +121,7 @@ class Client {
                 : await axios[method](endpoint, data, config)
 
             if (cachedItem && response.status === 304) {
+                await cache.setMeta(key, response.headers['etag'] || etag)
                 return cachedResponse
             }
 
@@ -139,21 +140,25 @@ class Client {
 
         const cacheStore = await cache.open(this.cacheNameImg)
         const cachedBlob = await cache.get(cacheStore, key, true)
-        if (!cachedBlob) return null
-        return { key, blob: cachedBlob }
+        if (!cachedBlob?.size) return null
+        return { key, blob: cachedBlob, isCached: true }
 
     }
 
     cacheImgSet = async ({ key, endpoint, config = {} }) => {
         const cacheStore = await cache.open(this.cacheNameImg)
         const cachedBlob = await cache.get(cacheStore, key, true)
-        const cachedResponse = cachedBlob ? { key, blob: cachedBlob } : undefined
+        const cachedResponse = cachedBlob?.size ? { key, blob: cachedBlob, isCached: true } : undefined
         const { etag, timestamp } = await cache.getMeta(key)
 
+        const age = (Date.now() - timestamp) / 1000
+        const isFresh = cachedResponse && age < this.cacheStale
+        if (isFresh) return { ...cachedResponse, isFresh: true }
+
         config.responseType = 'arraybuffer'
         config.timeout = 10000
 
-        if (etag) {
+        if (etag && cachedResponse) {
             if (!config.headers) config.headers = {}
             config.headers['If-None-Match'] = etag
         }
@@ -161,15 +166,19 @@ class Client {
         try {
             const response = await axios.get(endpoint, config)
 
-            if (cachedBlob && response.status === 304) return cachedResponse
+            if (cachedResponse && response.status === 304) {
+                await cache.setMeta(key, response.headers['etag'] || etag)
+                return { ...cachedResponse, isRevalidated: true }
+            }
 
             const blob = cache.getBlob(response.data, response.headers['content-type'])
             await cache.set(cacheStore, key, blob, true)
             await cache.setMeta(key, response.headers['etag'])
 
-            return { key, blob }
+            return { key, blob, isUpdated: true }
 
         } catch (error) {
+            if (error?.code === 'ERR_CANCELED' || config.signal?.aborted) return cachedResponse || { isCanceled: true }
             return await err.cache(error, cachedResponse)
         }
     }
@@ -178,7 +187,7 @@ class Client {
 
         const cacheStore = await cache.open(this.cacheNameFiles)
         const cachedBlob = await cache.get(cacheStore, key, true)
-        const cachedResponse = cachedBlob ? { key, blob: cachedBlob } : undefined
+        const cachedResponse = cachedBlob?.size ? { key, blob: cachedBlob } : undefined
         const { etag, timestamp } = await cache.getMeta(key)
 
         const age = (Date.now() - timestamp) / 1000
@@ -188,7 +197,7 @@ class Client {
         config.responseType = 'arraybuffer'
         config.timeout = 10000
 
-        if (etag) {
+        if (etag && cachedResponse) {
             if (!config.headers) config.headers = {}
             config.headers['If-None-Match'] = etag
         }
@@ -198,7 +207,10 @@ class Client {
                 ? await axios.get(endpoint, config)
                 : await axios[method](endpoint, data, config)
 
-            if (cachedBlob && response.status === 304) return cachedResponse
+            if (cachedResponse && response.status === 304) {
+                await cache.setMeta(key, response.headers['etag'] || etag)
+                return cachedResponse
+            }
 
             const blob = cache.getBlob(response.data, response.headers['content-type'])
             await cache.set(cacheStore, key, blob, true)

package/assets/root.fullstackunicorn.dev/frontend/imports/core/Img.js

@@ -6,6 +6,34 @@ import { api } from '#@/client/@api.js'
 
 export const ImgData = (props) => <ImgDataPod {...props} />
 
+const inFlightImages = new Map()
+
+const retainImageRequest = (src) => {
+    let entry = inFlightImages.get(src)
+
+    if (!entry) {
+        const controller = new AbortController()
+        const promise = api.statics.image(src, 'set', { signal: controller.signal })
+            .finally(() => inFlightImages.delete(src))
+
+        entry = { controller, promise, retainers: 0 }
+        inFlightImages.set(src, entry)
+    }
+
+    let released = false
+    entry.retainers += 1
+
+    const release = () => {
+        if (released) return
+        released = true
+
+        entry.retainers = Math.max(0, entry.retainers - 1)
+        if (entry.retainers === 0) entry.controller.abort()
+    }
+
+    return { promise: entry.promise, release }
+}
+
 export const NoImg = (props) => {
     const statics = useGetStatics()
     return <NoImgPod {...props} svg={statics.visual.svg.picture} />
@@ -19,9 +47,12 @@ export const Img = ({ classes, inline, picture = {} }) => {
     const [isSlow, setIsSlow] = useState(false)
 
     useEffect(() => {
+        if (image.isNoImage || !image.src) return
+
         let mounted = true
         let objectUrl = null
         let slowTimer = null
+        let releaseRequest = null
 
         setSrc(undefined)
         setIsLoaded(false)
@@ -31,25 +62,45 @@ export const Img = ({ classes, inline, picture = {} }) => {
             if (mounted) setIsSlow(true)
         }, 150)
 
+        const setBlob = (blob) => {
+            clearTimeout(slowTimer)
+            if (objectUrl) URL.revokeObjectURL(objectUrl)
+            objectUrl = URL.createObjectURL(blob)
+            setSrc(objectUrl)
+            setIsLoaded(true)
+            setIsSlow(false)
+        }
+
+        const fetchImage = async ({ updateOnly = false } = {}) => {
+            const request = retainImageRequest(image.src)
+            releaseRequest = request.release
+
+            const fetched = await request.promise
+            releaseRequest()
+            releaseRequest = null
+
+            if (fetched?.isCanceled) return fetched
+            if (!mounted) return fetched
+            if (!fetched?.blob) return fetched
+            if (updateOnly && !fetched.isUpdated) return fetched
+
+            setBlob(fetched.blob)
+            return fetched
+        }
+
         const load = async () => {
             const cached = await api.statics.image(image.src, 'get')
 
             if (mounted && cached?.blob) {
-                clearTimeout(slowTimer)
-                objectUrl = URL.createObjectURL(cached.blob)
-                setSrc(objectUrl)
-                setIsLoaded(true)
-                setIsSlow(false)
+                setBlob(cached.blob)
+                fetchImage({ updateOnly: true })
                 return
             }
 
-            const fetched = await api.statics.image(image.src, 'set')
+            const fetched = await fetchImage()
+            if (fetched?.isCanceled) return
 
             if (mounted && fetched?.blob) {
-                clearTimeout(slowTimer)
-                objectUrl = URL.createObjectURL(fetched.blob)
-                setSrc(objectUrl)
-                setIsLoaded(true)
                 return
             }
 
@@ -68,6 +119,7 @@ export const Img = ({ classes, inline, picture = {} }) => {
         return () => {
             mounted = false
             clearTimeout(slowTimer)
+            if (releaseRequest) releaseRequest()
             if (objectUrl) URL.revokeObjectURL(objectUrl)
         }
     }, [image.src])

package/assets/root.fullstackunicorn.dev/frontend/imports/core/Img.pod.js

@@ -17,7 +17,7 @@ export const NoImgPod = ({ classes, inline, svg }) => {
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
     S.box = [...classes, c.base_NN_W700]
-    S.svg = [s.XY, c.item_NN_W750]
+    S.svg = [s.XY100p, c.item_NN_W750]
 
     return (
         <View classes={S.box} inline={inline}>
@@ -37,9 +37,9 @@ export const ImgPod = ({
     B.imgTransition = isSlow ? { transition: '0.3s all ease-in-out', ...inline } : { ...inline }
     B.blurhashTransition = { transition: '0.3s all ease-in-out' }
 
-    S.image = [s.relative, s.overflowXYh, s.row_cXcY, ...classes]
-    S.blurhash = [s.absolute, s.XY, ...B.blurhashOpacity]
-    S.box = [s.absolute, s.XY, s.row_cXcY]
+    S.image = [s.positionRelative, s.overflowHidden, s.row_cXcY, ...classes]
+    S.blurhash = [s.positionAbsolute, s.XY100p, ...B.blurhashOpacity]
+    S.box = [s.positionAbsolute, s.XY100p, s.row_cXcY]
     S.img = [...B.imgOpacity, ...classes]
 
     I.image = { objectFit: 'cover', aspectRatio: ratio, ...inline }

package/assets/root.fullstackunicorn.dev/frontend/imports/core/Scrollable.js

@@ -7,9 +7,18 @@ export const Scrollable = ({
     scrollRef,
     onScroll,
     isPage,
+    x,
+    y,
+    xy,
 }) => {
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
+    B.axis = xy || (x && y) ? 'xy' : x ? 'x' : 'y'
+    B.isXY = B.axis === 'xy' ? [s.overflowScroll] : []
+    B.isX = B.axis === 'x' ? [s.overflowXScroll, s.overflowYHidden] : []
+    B.isY = B.axis === 'y' ? [s.overflowYScroll] : []
+    B.scroll = [...B.isXY, ...B.isX, ...B.isY]
+
     const pageInline = isPage
         ? { paddingBottom: 'env(safe-area-inset-bottom, 0px)' }
         : {}
@@ -22,7 +31,7 @@ export const Scrollable = ({
     return (
         <div
             ref={scrollRef}
-            className={[...classes, s.overflowYs].join(' ')}
+            className={[...classes, ...B.scroll].join(' ')}
             style={{ ...scrollInline, ...inline, ...pageInline }}
             onScroll={onScroll}
         >

package/assets/root.fullstackunicorn.dev/frontend/imports/core/Text.js

@@ -37,9 +37,14 @@ export const Text = (props = {}) => {
 
     F.font = useGetFont(props.font, props.language)
     B.select = props.isNoSelect ? [s.noSelect] : []
+    B.mode = props.ellipsis || props.oneLine
+        ? [s.textline]
+        : props.wrap || props.preserveWhitespace
+            ? [s.textwrap]
+            : [s.textblock]
 
     const next = { ...props }
-    next.classes = [...classes, ...B.select, s.textblock, F.font]
+    next.classes = [...classes, ...B.select, ...B.mode, F.font]
 
     if (props.tag) return <TextTag {...next} />
     else return <TextSpan {...next} />
@@ -62,6 +67,10 @@ export const Textline = (props = {}) => {
     else return <TextSpan {...next} />
 }
 
+export const TextEllipsis = (props = {}) => {
+    return <Textline {...props} ellipsis />
+}
+
 // use it for inline code where u need to pass the style to a span
 export const TextFont = (props = {}) => {
 
@@ -85,7 +94,7 @@ export const TextCodeView = ({
     F.font = useGetFont(f.m1)
 
     B.isInline = type === 'inline' ? [s.textblock] : []
-    B.isBlock = type === 'block' ? [s.textwrap, s.overflowYs] : []
+    B.isBlock = type === 'block' ? [s.textwrap, s.overflowYScroll] : []
     B.isView = type === 'view' ? [s.textwrap] : []
 
     S.classes = [...classes, F.font, ...B.isInline, ...B.isBlock, ...B.isView].join(' ')

package/assets/root.fullstackunicorn.dev/frontend/imports/device.js

@@ -0,0 +1,46 @@
+export const getSubmitMetadata = async ({ clientId, deviceId }) => {
+    const battery = navigator.getBattery ? await navigator.getBattery() : {}
+    const metadataObj = {
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        language: window.navigator.language,
+        pageTitle: document.title,
+        referrer: document.referrer,
+        pageURL: window.location.href,
+        platform: window.navigator.platform,
+        deviceMemory: navigator.deviceMemory,
+        screenWidth: window.screen.width,
+        screenHeight: window.screen.height,
+        colorDepth: window.screen.colorDepth,
+        maxScreenWidth: window.screen.width * window.devicePixelRatio,
+        maxScreenHeight: window.screen.height * window.devicePixelRatio,
+        pixelRatio: window.devicePixelRatio,
+        screenOrientation: screen?.orientation?.type,
+        hardwareConcurrency: navigator.hardwareConcurrency,
+        touchSupport: 'ontouchstart' in window || navigator.maxTouchPoints > 0,
+        colorGamut: window.matchMedia("(color-gamut: srgb)").matches
+            ? "srgb"
+            : window.matchMedia("(color-gamut: p3)").matches
+                ? "p3"
+                : window.matchMedia("(color-gamut: rec2020)").matches
+                    ? "rec2020"
+                    : "unknown",
+        rtt: navigator?.connection?.rtt,
+        hasGamepad: navigator.getGamepads ? navigator.getGamepads().length > 0 : false,
+        keyboardEnabled: "onkeydown" in document,
+        cookieEnabled: navigator.cookieEnabled,
+        javaEnabled: navigator.javaEnabled ? navigator.javaEnabled() : false,
+        doNotTrack: navigator.doNotTrack,
+        networkType: navigator?.connection?.effectiveType,
+        downlinkSpeed: navigator?.connection?.downlink,
+        batteryLevel: battery?.level * 100,
+        batteryCharging: battery?.charging
+    }
+
+    return {
+        submit_timestamp: new Date().toISOString(),
+        submit_device_id: deviceId,
+        submit_client_id: clientId,
+        submit_user_agent: window.navigator.userAgent,
+        submit_metadata: Object.entries(metadataObj).map(([key, value]) => `${key}:${value ? value : 'unknown'}`).join(" | ")
+    }
+}

package/assets/root.fullstackunicorn.dev/frontend/imports/router.js

@@ -7,6 +7,8 @@ export {
 
 export const useNavigateUrl = () => url => window.location.href = url
 
+export const getCurrentHref = () => window.location.href
+
 import { useLocation } from 'react-router-dom'
 
 export const useGetUrl = () => {

package/assets/root.fullstackunicorn.dev/frontend/imports/service.js

@@ -20,8 +20,8 @@ class Service {
         const response = await store.match(key)
         if (!response) return true
         const lastDay = (await response.text()).trim()
-        return true // lastDay < this.todayUTC()
+        return lastDay < this.todayUTC()
     }
 }
 
-export const service = new Service()
+export const service = new Service()

package/assets/root.fullstackunicorn.dev/frontend/index.html

@@ -12,13 +12,13 @@
     <meta http-equiv="Expires" content="0">
 
     <meta content="#ffffff" name="msapplication-TileColor" />
-    <meta content="/icons/icon-512.png" name="msapplication-TileImage" />
+    <meta content="/get/media/icons/icon-512.png" name="msapplication-TileImage" />
     <meta content="Carlo" name="apple-mobile-web-app-title" />
-    <link href="/icons/icon-180.png" rel="apple-touch-icon" sizes="180x180" />
+    <link href="/get/media/icons/icon-180.png" rel="apple-touch-icon" sizes="180x180" />
     <link href="/index.webmanifest" rel="manifest" />
     
-    <link href="/favicon.ico" rel="shortcut icon" />
-    <link href="/icons/favicon.png" rel="icon" type="image/png" />
+    <link href="/get/media/icons/favicon.ico" rel="shortcut icon" />
+    <link href="/get/media/icons/favicon.png" rel="icon" type="image/png" />
     
     <!-- {{metadata}} -->
     <!-- {{languages}} -->
@@ -33,4 +33,4 @@
     <script type="module" src="/App.js"></script>
 </body>
 
-</html>
+</html>

package/assets/root.fullstackunicorn.dev/frontend/modules/base/ComingSoon.pod.js

@@ -6,8 +6,8 @@ export const ComingSoonPod = ({ picture }) => {
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.box = [s.col_cXsY, s.XY, s.marginB8]
-    S.image = [s.X, s.radiusB16]
+    S.box = [s.col_cXsY, s.XY100p, s.marginB8]
+    S.image = [s.X100p, s.radiusB16]
 
     return (
         <View classes={S.box}>

package/assets/root.fullstackunicorn.dev/frontend/modules/base/PageTitle.pod.js

@@ -6,7 +6,7 @@ export const PageTitlePod = ({ title }) => {
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.textbox = [s.row_cXcY, s.Y48, s.X]
+    S.textbox = [s.row_cXcY, s.Y48, s.X100p]
     S.text = t.root.page.title
 
     if (!title) return null

package/assets/root.fullstackunicorn.dev/frontend/modules/layout/Wrapper.pod.js

@@ -5,7 +5,7 @@ export const WrapperPod = ({ paddingX, children }) => {
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.box = [s.X]
+    S.box = [s.X100p]
     S.wrap = []
 
     I.wrap = {

package/assets/root.fullstackunicorn.dev/frontend/modules/modals/select/SelectItem.pod.js

@@ -14,7 +14,7 @@ export const SelectItemPod = ({ onPress=()=>{}, slug, value, img, isHover, setIs
     
     S.item = [s.row_sXcY, s.Y48, s.radius8, s.marginB4, ...B.background, ...B.img]
     S.imgBox = [s.X26, s.Y20, s.marginX7, s.marginY18, s.radius5, s.border1, c.line_NN, c.item_NN_B400]
-    S.img = [s.X24, s.Y18, s.overflowXYh, s.radius4]
+    S.img = [s.X24, s.Y18, s.overflowHidden, s.radius4]
     S.text = [...F.text, s.row_sXcY, s.paddingE12, c.item_NN_B400] 
     
     return (

package/assets/root.fullstackunicorn.dev/frontend/modules/modals/select/SelectPicked.pod.js

@@ -17,7 +17,7 @@ export const SelectPickedPod = ({ value, slug, img, isHover, setIsHover=()=>{},
     
     S.item = [s.row_sXcY, s.Y40, s.radius8, s.Xmin80, s.border1, c.line_NN_W500, ...B.hover, ...B.img]
     S.imgBox = [s.X26, s.Y20, s.marginX7, s.radius5, s.border1, c.line_NN, c.item_NN_B400]
-    S.img = [s.X24, s.Y18, s.overflowXYh, s.radius4]
+    S.img = [s.X24, s.Y18, s.overflowHidden, s.radius4]
     S.textBox = [s.row_cY]
     S.text = [...F.text, s.Xr, c.item_NN_B400] 
     S.icon = [s.XY40, B.icon]

package/assets/root.fullstackunicorn.dev/frontend/panels/slideshows/Slideshow.pod.js

@@ -11,8 +11,8 @@ export const SlideshowPod = ({ svg, onNext, onPrevious, aspectRatio, children })
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.slider = [s.row_cXcY, s.X, s.relative]
-    S.controls = [s.row, s.XY, s.Z3]
+    S.slider = [s.row_cXcY, s.X100p, s.positionRelative]
+    S.controls = [s.row, s.XY100p, s.Z3]
     S.one = [s.row_sXcY, s.XYr]
     S.iconOneBox = [s.XY64, s.col_cXcY, s.Z2]
     S.iconOne = [s.XY40, s.Z2, s.marginX8, c.item_NN_B400, s.radius8, c.base_WW_50]
@@ -46,7 +46,7 @@ export const SlideshowTextualPod = ({ subhead, title, description, href, fontSiz
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.box = [s.row_sXcY, s.absolute, s.XY, s.top0]
+    S.box = [s.row_sXcY, s.positionAbsolute, s.XY100p, s.top0]
     S.textual = [s.col_sXsY]
     S.outline = [s.paddingX4, s.paddingY2, s.margin4, c.item_WW]
 
@@ -76,7 +76,7 @@ export const SlideshowItemPod = ({ isActive, picture, children, aspectRatio, tra
 
     const { s, c, f, t, F, B, S, I, H } = useStyle()
 
-    S.image = [s.X]
+    S.image = [s.X100p]
     I.image = { aspectRatio }
 
     return (

package/assets/root.fullstackunicorn.dev/frontend/templates/cards.js

@@ -5,18 +5,18 @@ export const getCards = (s, c, t) => {
 
     cards.squared = {}
     cards.squared.link = []
-    cards.squared.box = [s.X, s.radius24, s.overflowXYh, c.base_WW]
-    cards.squared.pictureWrap = [s.X, s.padding8]
-    cards.squared.pictureBox = [s.X, s.ratio, s.overflowXYh, s.radius16]
-    cards.squared.picture = [s.cover]
+    cards.squared.box = [s.X100p, s.radius24, s.overflowHidden, c.base_WW]
+    cards.squared.pictureWrap = [s.X100p, s.padding8]
+    cards.squared.pictureBox = [s.X100p, s.ratio, s.overflowHidden, s.radius16]
+    cards.squared.picture = [s.objectCover]
     cards.squared.content = [s.paddingX16, s.paddingY16, s.col]
 
     cards.portrait = {}
-    cards.portrait.link = [s.Y]
-    cards.portrait.box = [s.X, s.Y, s.col, s.padding24, s.radius24, s.overflowXYh, s.border1, c.base_WW, c.line_NN_W600]
-    cards.portrait.pictureWrap = [s.X]
-    cards.portrait.pictureBox = [s.X, s.overflowXYh, s.radius16]
-    cards.portrait.picture = [s.X]
+    cards.portrait.link = [s.Y100p]
+    cards.portrait.box = [s.X100p, s.Y100p, s.col, s.padding24, s.radius24, s.overflowHidden, s.border1, c.base_WW, c.line_NN_W600]
+    cards.portrait.pictureWrap = [s.X100p]
+    cards.portrait.pictureBox = [s.X100p, s.overflowHidden, s.radius16]
+    cards.portrait.picture = [s.X100p]
     cards.portrait.content = [s.paddingT16, s.col, s.Yc] 
     cards.portrait.title = []
     cards.portrait.price = [s.marginT16]

package/assets/root.fullstackunicorn.dev/frontend/templates/page.js

@@ -6,10 +6,10 @@ export const getPage = (s, c, t) => {
 
     page.home = [s.col, s.XYc]
     page.fluid = [s.col, s.XYc]
-    page.fixed = [s.col_cXsY, s.Yc, s.Xx, s.Xmax540, s.paddingX16]
-    page.fixedL = [s.col_cXsY, s.Yc, s.Xx, s.Xmax672, s.paddingX16]
-    page.fixedXL = [s.col_cXsY, s.Yc, s.Xx, s.Xmax960, s.paddingX16]
-    page.docs = [s.col_cXsY, s.Yc, s.Xx, s.Xmax540, s.paddingX16, s.marginT16]
+    page.fixed = [s.col_cXsY, s.Yc, s.Xx100p, s.Xmax540, s.paddingX16]
+    page.fixedL = [s.col_cXsY, s.Yc, s.Xx100p, s.Xmax672, s.paddingX16]
+    page.fixedXL = [s.col_cXsY, s.Yc, s.Xx100p, s.Xmax960, s.paddingX16]
+    page.docs = [s.col_cXsY, s.Yc, s.Xx100p, s.Xmax540, s.paddingX16, s.marginT16]
     page.card = [s.col_cX, s.Yc, s.paddingX16]
 
     return page

package/assets/root.fullstackunicorn.dev/frontend/templates/root.js

@@ -21,7 +21,7 @@ export const getRoot = (s, c, t) => {
     root.cards.text.title = [s.textS, s.fs16, s.lh24, s.fw700]
     root.cards.text.description = [s.textS, s.fs16, s.lh20, s.fw400]
     root.cards.text.label = [s.textS, s.fs16, s.lh24, s.fw600]
-    root.cards.box = [s.col, s.X]
+    root.cards.box = [s.col, s.X100p]
     root.cards.top = [s.col, s.paddingT16, s.paddingB8]
     root.cards.title = [...root.cards.text.title, c.item_NN_B400]
     root.cards.description = [...root.cards.text.description, c.item_NN_B400]

package/assets/root.fullstackunicorn.dev/manager/modules/pulse.js

@@ -0,0 +1,22 @@
+class Pulse {
+
+    get = async () => this.formatDate(new Date())
+
+    formatDate = date => {
+        const parts = new Intl.DateTimeFormat('en-GB', {
+            weekday: 'short',
+            day: '2-digit',
+            month: 'short',
+            year: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            hour12: false,
+            timeZone: 'UTC'
+        }).formatToParts(date)
+
+        const value = type => parts.find(part => part.type === type)?.value ?? ''
+        return `${value('weekday')} ${value('day')} ${value('month')} ${value('year')} ${value('hour')}:${value('minute')}`
+    }
+}
+
+export { Pulse }

package/assets/root.fullstackunicorn.dev/manager/server/router.js

@@ -1,11 +1,21 @@
 import { Router } from '#@/index.dep.js'
 import { middleware } from '#@/server/middleware.js'
 import { resolver } from '#@/server/resolvers.js'
+import { Pulse } from '#@/modules/pulse.js'
 import { sync } from '#@/modules/sync.server.js'
 import { clone } from '#@/modules/clone.js'
 
 const rs = {}
 
+// pulse
+
+rs.pulse = {}
+rs.pulse.method = 'get'
+rs.pulse.name = 'pulse'
+rs.pulse.path = '/pulse'
+rs.pulse.resolve = async (...args) => await resolver.resolve(new Pulse().get, rs.pulse.path, ...args)
+rs.pulse.funcs = [ rs.pulse.resolve ]
+
 rs.sync_current = {}
 rs.sync_current.method = 'post'
 rs.sync_current.name = 'sync_current'
@@ -55,4 +65,4 @@ rs.clone.funcs = [rs.clone.auth, rs.clone.resolve]
 
 const router = Router()
 for ( const r of Object.values(rs)) router[r.method](r.path, ...r.funcs)
-export { router, rs as routes }
+export { router, rs as routes }

package/assets/root.fullstackunicorn.dev/workspace/config/workers.json

@@ -15,6 +15,12 @@
             "input": "media/trademarks",
             "output": "get/media/trademarks"
         },
+        "media/graphic": {
+            "worker": "media_graphic",
+            "input": "media/graphic",
+            "output": "get/media/graphic",
+            "file": "get/data/root/statics/@graphic.json"
+        },
         "media/images": {
             "worker": "media_images",
             "input": "media/images",
@@ -25,6 +31,11 @@
             "input": "media/covers",
             "output": "get/media/covers"
         },
+        "docs/pdf": {
+            "worker": "docs_pdf",
+            "input": "docs/pdf",
+            "output": "get/docs/pdf"
+        },
         "data/root": {
             "worker": "data_statics",
             "input": "data/root",
@@ -51,7 +62,8 @@
             "isPublisher": true,
             "worker": "tabulars",
             "input":"tabulars_data_content",
-            "output": "get/data/content"
+            "output": "get/data/content",
+            "outputModules": "get/data/modules"
         }
     }
-}
+}

package/index.cmd.help.js

@@ -0,0 +1,33 @@
+export const help = `
+@fullstackunicorn/create-root
+
+Create a new FullstackUnicorn root scaffold.
+
+Usage:
+  yarn create @fullstackunicorn/root <foldername>
+
+Example:
+  yarn create @fullstackunicorn/root example.project.dev
+
+What this command does:
+  - creates <foldername> in the current working directory
+  - copies the bundled root scaffold
+  - does not initialize dependencies
+  - does not copy client data
+  - does not run root upgrade
+
+After create-root:
+  1. copy the prepared client root.config.app.js into <foldername>/root.config.app.js
+  2. copy prepared icons into <foldername>/workspace/volume/media/icons/
+  3. copy prepared trademarks into <foldername>/workspace/volume/media/trademarks/
+  4. cd <foldername>
+  5. yarn initialize:all
+  6. yarn root upgrade
+
+AI safety rules:
+  - always ask for the target parent path before running this command
+  - always ask for the client data folder before initialization or root upgrade
+  - the client data folder must contain root.config.app.js, icons/, and trademarks/
+  - do not run this command with --help, -help, or help as a folder name
+  - options beginning with "-" are not valid folder names
+`