@jxsuite/starters 3.4.0 → 3.6.0

package/sites/portfolio/components/pv-hero.jxn

@@ -0,0 +1,109 @@
+/- kdl-version 2
+
+pv-hero {
+    state {
+        eyebrow ""
+        heading ""
+        subheading ""
+        cta "View the Work"
+        ctaHref "/work/"
+        cta2 ""
+        cta2Href "/contact/"
+        bg type=string format=image default=""
+    }
+    style {
+        display block
+        position relative
+        height "100vh"
+        minHeight "620px"
+        color "var(--color-text-white)"
+        backgroundColor "var(--color-bg)"
+        backgroundImage "url('${state.bg}')"
+        backgroundSize cover
+        backgroundPosition center
+    }
+    div {
+        style {
+            position absolute
+            inset "0"
+            background "linear-gradient(180deg, rgba(12,12,13,0.6) 0%, rgba(12,12,13,0.1) 26%, rgba(12,12,13,0.3) 62%, rgba(12,12,13,0.92) 100%)"
+        }
+    }
+    div {
+        style {
+            position relative
+            zIndex "10"
+            display flex
+            flexDirection column
+            justifyContent flex-end
+            height "100%"
+            maxWidth "var(--max-width)"
+            margin "0 auto"
+            padding "0 clamp(1.5rem, 4vw, 4rem) clamp(3rem, 7vw, 5.5rem)"
+        }
+        div {
+            style display=flex alignItems=center gap="1rem" marginBottom="1.5rem"
+            span {
+                style width="3rem" height="1px" backgroundColor="var(--color-primary)"
+            }
+            p "${state.eyebrow}" {
+                style {
+                    margin "0"
+                    textTransform uppercase
+                    letterSpacing "0.28em"
+                    fontSize "0.72rem"
+                    fontWeight "500"
+                    color "var(--color-primary)"
+                }
+            }
+        }
+        h1 "${state.heading}" {
+            style {
+                fontFamily "var(--font-heading)"
+                fontWeight "400"
+                fontSize "clamp(3rem, 8.5vw, 7rem)"
+                lineHeight "0.98"
+                letterSpacing "-0.01em"
+                margin "0 0 1.5rem"
+                maxWidth "16ch"
+            }
+        }
+        div {
+            style {
+                display flex
+                alignItems flex-end
+                justifyContent space-between
+                gap "2rem"
+                flexWrap wrap
+            }
+            p "${state.subheading}" {
+                style {
+                    margin "0"
+                    fontSize "clamp(1rem, 1.6vw, 1.2rem)"
+                    lineHeight "1.6"
+                    color "var(--color-text-white)"
+                    opacity "0.82"
+                    maxWidth "44ch"
+                }
+            }
+            a href="${state.ctaHref}" "${state.cta} →" {
+                style {
+                    display inline-flex
+                    alignItems center
+                    gap "0.6rem"
+                    whiteSpace nowrap
+                    fontSize "0.78rem"
+                    fontWeight "600"
+                    textTransform uppercase
+                    letterSpacing "0.18em"
+                    color "var(--color-text-white)"
+                    textDecoration none
+                    borderBottom "1px solid var(--color-primary)"
+                    paddingBottom "0.5rem"
+                    transition "gap 0.2s, color 0.15s"
+                    :hover gap="1.1rem" color="var(--color-primary)"
+                }
+            }
+        }
+    }
+}

package/sites/portfolio/components/pv-nav.jxn

@@ -0,0 +1,76 @@
+/- kdl-version 2
+
+pv-nav {
+    state brand=Aperture
+    style {
+        position fixed
+        top "0"
+        left "0"
+        right "0"
+        zIndex "50"
+        display block
+        backgroundColor "rgba(12, 12, 13, 0.55)"
+        backdropFilter "blur(14px)"
+        borderBottom "1px solid rgba(255, 255, 255, 0.08)"
+    }
+    div {
+        style {
+            maxWidth "var(--max-width)"
+            margin "0 auto"
+            padding "1.1rem 2rem"
+            display flex
+            alignItems center
+            justifyContent space-between
+            gap "1.5rem"
+            @--sm padding="0.9rem 1.25rem"
+        }
+        a href="/" "${state.brand}" {
+            style {
+                fontFamily "var(--font-label)"
+                fontWeight "400"
+                fontSize "0.95rem"
+                letterSpacing "0.42em"
+                textTransform uppercase
+                color "var(--color-text-primary)"
+                textDecoration none
+                paddingLeft "0.42em"
+            }
+        }
+        nav {
+            style {
+                display flex
+                alignItems center
+                gap "2.25rem"
+                fontSize "0.7rem"
+                fontWeight "500"
+                letterSpacing "0.2em"
+                textTransform uppercase
+                @--sm gap="1.25rem"
+            }
+            a href="/work/" Work {
+                style {
+                    color "var(--color-text-primary)"
+                    textDecoration none
+                    opacity "0.85"
+                    transition "opacity 0.15s, color 0.15s"
+                    :hover color="var(--color-primary)" opacity="1"
+                }
+            }
+            a href="/about/" About {
+                style {
+                    color "var(--color-text-primary)"
+                    textDecoration none
+                    opacity "0.85"
+                    transition "opacity 0.15s, color 0.15s"
+                    @--sm display=none
+                    :hover color="var(--color-primary)" opacity="1"
+                }
+            }
+            a href="/contact/" Inquire {
+                style color="var(--color-primary)" textDecoration=none transition="opacity 0.15s" {
+                    :hover opacity="0.7"
+                }
+            }
+        }
+    }
+}

package/sites/portfolio/components/pv-project-card.jxn

@@ -0,0 +1,118 @@
+/- kdl-version 2
+
+pv-project-card {
+    state {
+        number ""
+        title ""
+        category ""
+        year ""
+        href "#"
+        cover type=string format=image default=""
+        alt ""
+    }
+    style display=block minWidth="0"
+    a href="${state.href}" {
+        style {
+            position relative
+            display block
+            height "100%"
+            overflow hidden
+            textDecoration none
+            color "var(--color-text-white)"
+            backgroundColor "var(--color-bg-elev)"
+            ":hover img" transform="scale(1.06)"
+            ":hover figcaption" transform="translateY(0)" opacity="1"
+        }
+        img src="${state.cover}" alt="${state.alt}" loading=lazy {
+            style {
+                position absolute
+                inset "0"
+                width "100%"
+                height "100%"
+                objectFit cover
+                display block
+                transition "transform 0.8s cubic-bezier(0.22, 1, 0.36, 1)"
+            }
+        }
+        div {
+            style {
+                position absolute
+                inset "0"
+                background "linear-gradient(to top, rgba(10,10,11,0.82) 0%, rgba(10,10,11,0.25) 40%, transparent 68%)"
+            }
+        }
+        div {
+            style {
+                position absolute
+                left "0"
+                right "0"
+                bottom "0"
+                padding "clamp(1.25rem, 2.5vw, 2rem)"
+            }
+            div {
+                style display=flex alignItems=center gap="0.7rem" marginBottom="0.6rem"
+                span "${state.number}" {
+                    style {
+                        fontFamily "var(--font-label)"
+                        fontSize "0.72rem"
+                        letterSpacing "0.1em"
+                        color "var(--color-primary)"
+                    }
+                }
+                span {
+                    style {
+                        width "1.5rem"
+                        height "1px"
+                        backgroundColor "var(--color-primary)"
+                        opacity "0.7"
+                    }
+                }
+                span "${state.category}" {
+                    style {
+                        display "${state.category ? 'inline' : 'none'}"
+                        fontSize "0.66rem"
+                        fontWeight "600"
+                        letterSpacing "0.2em"
+                        textTransform uppercase
+                        color "var(--color-text-white)"
+                        opacity "0.75"
+                    }
+                }
+            }
+            div {
+                style display=flex alignItems=baseline justifyContent=space-between gap="1rem"
+                h3 "${state.title}" {
+                    style {
+                        fontFamily "var(--font-heading)"
+                        fontWeight "500"
+                        fontSize "clamp(1.6rem, 2.8vw, 2.4rem)"
+                        lineHeight "1.05"
+                        margin "0"
+                    }
+                }
+                span "${state.year}" {
+                    style {
+                        display "${state.year ? 'inline' : 'none'}"
+                        fontSize "0.8rem"
+                        color "var(--color-text-white)"
+                        opacity "0.6"
+                        whiteSpace nowrap
+                    }
+                }
+            }
+            figcaption "View project →" {
+                style {
+                    marginTop "0.75rem"
+                    fontSize "0.72rem"
+                    fontWeight "600"
+                    textTransform uppercase
+                    letterSpacing "0.18em"
+                    color "var(--color-primary)"
+                    transform "translateY(0.75rem)"
+                    opacity "0"
+                    transition "transform 0.3s, opacity 0.3s"
+                }
+            }
+        }
+    }
+}

package/sites/portfolio/components/pv-project-grid.jxn

@@ -0,0 +1,29 @@
+/- kdl-version 2
+
+pv-project-grid {
+    state {}
+    style {
+        display grid
+        gridTemplateColumns "repeat(12, 1fr)"
+        gridAutoRows "clamp(230px, 32vw, 460px)"
+        gap "0.5rem"
+        padding "0 0.5rem"
+        "& pv-project-card" gridColumn="span 6"
+        "& pv-project-card:nth-of-type(6n + 1)" gridColumn="span 7"
+        "& pv-project-card:nth-of-type(6n + 2)" gridColumn="span 5"
+        "& pv-project-card:nth-of-type(6n + 3)" gridColumn="span 5"
+        "& pv-project-card:nth-of-type(6n + 4)" gridColumn="span 7"
+        "& pv-project-card:nth-of-type(6n + 5)" gridColumn="span 6"
+        "& pv-project-card:nth-of-type(6n + 6)" gridColumn="span 6"
+        @--sm gridTemplateColumns="1fr" gridAutoRows="68vw" {
+            "& pv-project-card" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 1)" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 2)" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 3)" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 4)" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 5)" gridColumn="span 1"
+            "& pv-project-card:nth-of-type(6n + 6)" gridColumn="span 1"
+        }
+    }
+    slot
+}

package/sites/portfolio/components/pv-section-header.jxn

@@ -0,0 +1,65 @@
+/- kdl-version 2
+
+pv-section-header {
+    state eyebrow="" heading="" subheading=""
+    style {
+        display block
+        maxWidth "var(--max-width)"
+        margin "0 auto"
+        padding "0 clamp(1.5rem, 4vw, 4rem)"
+    }
+    div {
+        style {
+            display flex
+            alignItems flex-end
+            justifyContent space-between
+            gap "2rem"
+            flexWrap wrap
+            borderBottom "1px solid var(--color-line)"
+            paddingBottom "1.5rem"
+        }
+        div {
+            div {
+                style {
+                    display "${state.eyebrow ? 'flex' : 'none'}"
+                    alignItems center
+                    gap "0.85rem"
+                    marginBottom "1.1rem"
+                }
+                span {
+                    style width="2.25rem" height="1px" backgroundColor="var(--color-primary)"
+                }
+                span "${state.eyebrow}" {
+                    style {
+                        textTransform uppercase
+                        letterSpacing "0.24em"
+                        fontSize "0.7rem"
+                        fontWeight "500"
+                        color "var(--color-primary)"
+                    }
+                }
+            }
+            h2 "${state.heading}" {
+                style {
+                    fontFamily "var(--font-heading)"
+                    fontSize "clamp(2.2rem, 5vw, 3.6rem)"
+                    fontWeight "400"
+                    lineHeight "1.02"
+                    letterSpacing "-0.01em"
+                    margin "0"
+                    color "var(--color-text-primary)"
+                }
+            }
+        }
+        p "${state.subheading}" {
+            style {
+                display "${state.subheading ? 'block' : 'none'}"
+                fontSize "1.02rem"
+                lineHeight "1.7"
+                color "var(--color-text-muted)"
+                margin "0"
+                maxWidth "40ch"
+            }
+        }
+    }
+}

package/sites/portfolio/document.schema.json

@@ -303,7 +303,13 @@
         },
         "FunctionDef": {
           "additionalProperties": false,
-          "description": "A function declaration. $prototype must be \"Function\". body (inline) and $src (external) are mutually exclusive. First parameter is always state (the reactive scope).",
+          "description": "A function declaration. $prototype must be \"Function\". body (inline) and $src (external) are mutually exclusive; declaring both is an error. First parameter is always state (the reactive scope).",
+          "not": {
+            "required": [
+              "body",
+              "$src"
+            ]
+          },
           "properties": {
             "$export": {
               "description": "Named export in $src module. Defaults to the state key name.",
@@ -339,11 +345,12 @@
               "type": "array"
             },
             "body": {
-              "description": "Inline function body: an opaque JS source string (first implicit parameter is state), or a structured statement array (spec §20) — explicit structured function declaration, analyzable by tooling and editable visually. The escalation ladder within the shape is structured statements → JS string.",
+              "description": "Inline function body: a source string in erasable TypeScript, which plain JavaScript already is (spec §23.1; types are erased before it is analysed or run; first implicit parameter is state), or a structured statement array (spec §20) — explicit structured function declaration, analyzable by tooling and editable visually. The escalation ladder within the shape is structured statements → source string.",
               "examples": [
                 "state.count++",
                 "state.items.push({ id: Date.now(), text: \"\", done: false })",
                 "return state.score >= 90 ? \"gold\" : \"silver\"",
+                "const input = event.target as HTMLInputElement; state.label = input.value",
                 [
                   {
                     "operator": "push",
@@ -604,6 +611,7 @@
               "type": "string"
             },
             "body": {
+              "description": "The member's body in erasable TypeScript, which plain JavaScript already is (spec §23.1), as one string or as an array of lines.",
               "oneOf": [
                 {
                   "type": "string"
@@ -675,6 +683,7 @@
               "type": "string"
             },
             "body": {
+              "description": "The member's body in erasable TypeScript, which plain JavaScript already is (spec §23.1), as one string or as an array of lines.",
               "oneOf": [
                 {
                   "type": "string"
@@ -28596,6 +28605,21 @@
             }
           ]
         },
+        "$script": {
+          "additionalProperties": false,
+          "description": "This document's own modules, as TypeScript module text (spec.md §23.2). A state entry names an export of one with `$src: \"#client\"` or `$src: \"#server\"`. `client` runs in the browser; `server` runs only on the server and is never sent to one.",
+          "properties": {
+            "client": {
+              "description": "The module the browser runs. A Function entry with `$src: \"#client\"` is one of its exports.",
+              "type": "string"
+            },
+            "server": {
+              "description": "The module the server runs. A `timing: \"server\"` entry with `$src: \"#server\"` is one of its exports, called with `(args, env)`.",
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
         "$shadow": {
           "description": "Render this component into a shadow root instead of the light DOM (spec.md §16.6). Off unless set: a shadow root isolates the component's styles from the page and replaces the <slot> emulation with real slot distribution, so it changes how the component composes. Overrides `defaults.shadow` in both directions — `false` opts one component out of a project that opted in.",
           "oneOf": [

package/sites/portfolio/layouts/base.jxn

@@ -0,0 +1,12 @@
+/- kdl-version 2
+$elements (ref)"../components/pv-nav.jxn" (ref)"../components/pv-footer.jxn"
+
+div {
+    style minHeight="100vh" display=flex flexDirection=column backgroundColor="var(--color-bg)"
+    pv-nav
+    main {
+        style flex="1"
+        slot
+    }
+    pv-footer
+}

package/sites/portfolio/package.json

@@ -9,10 +9,10 @@
     "dev": "jx dev"
   },
   "dependencies": {
-    "@jxsuite/parser": "^4.3.3"
+    "@jxsuite/parser": "^5.0.0"
   },
   "devDependencies": {
-    "@jxsuite/compiler": "^8.5.0",
-    "@jxsuite/runtime": "^6.2.2"
+    "@jxsuite/compiler": "^8.7.0",
+    "@jxsuite/runtime": "^7.0.0"
   }
 }

package/sites/portfolio/pages/[slug].jxn

@@ -0,0 +1,177 @@
+/- kdl-version 2
+$paths contentType=projects param=slug field=slug
+$head {
+    meta name=description content="${state.entry.data.title} — a ${state.entry.data.category} project by Aperture Studio."
+}
+
+$element .title="${state.entry.data.title} — Aperture Studio" {
+    state {
+        entry {
+            $prototype ContentEntry
+            contentType projects
+            field slug
+            id (ref)"#/$params/slug"
+            $src "@jxsuite/parser/ContentEntry.class.json"
+        }
+    }
+    article {
+        style {
+            maxWidth "var(--max-width-narrow)"
+            margin "0 auto"
+            padding "clamp(7rem, 11vw, 9rem) 1.5rem clamp(3.5rem, 8vw, 6rem)"
+        }
+        a href="/work/" "← All work" {
+            style {
+                display inline-block
+                color "var(--color-primary)"
+                textDecoration none
+                fontWeight "600"
+                fontSize "0.85rem"
+                letterSpacing "0.05em"
+                textTransform uppercase
+                marginBottom "2rem"
+                :hover textDecoration=underline
+            }
+        }
+        header {
+            style marginBottom="2.5rem"
+            div {
+                style display=flex alignItems=center gap="0.85rem" marginBottom="1.25rem"
+                span "${state.entry.data.category}" {
+                    style {
+                        display inline-block
+                        padding "0.3rem 0.8rem"
+                        border "1px solid var(--color-border)"
+                        borderRadius "999px"
+                        fontSize "0.72rem"
+                        fontWeight "600"
+                        letterSpacing "0.14em"
+                        textTransform uppercase
+                        color "var(--color-primary)"
+                        backgroundColor "var(--color-bg-cream)"
+                    }
+                }
+                span "${state.entry.data.year}" {
+                    style fontSize="0.85rem" color="var(--color-text-muted)" letterSpacing="0.05em"
+                }
+            }
+            h1 "${state.entry.data.title}" {
+                style {
+                    fontFamily "var(--font-heading)"
+                    fontSize "clamp(2.5rem, 6vw, 4rem)"
+                    fontWeight "600"
+                    lineHeight "1.06"
+                    letterSpacing "-0.01em"
+                    margin "0"
+                }
+            }
+        }
+        img src="${state.entry.data.cover}" alt="${state.entry.data.title}" {
+            style {
+                width "100%"
+                maxHeight "34rem"
+                objectFit cover
+                borderRadius "var(--radius)"
+                display "${state.entry.data.cover ? 'block' : 'none'}"
+                marginBottom "2.75rem"
+            }
+        }
+        div {
+            style {
+                fontSize "1.15rem"
+                lineHeight "1.85"
+                color "var(--color-text-primary)"
+                maxWidth "62ch"
+                margin "0 0 3.5rem"
+            }
+            .children "${state.entry.$children ?? []}"
+        }
+        section {
+            h2 "Selected frames" {
+                style {
+                    fontFamily "var(--font-heading)"
+                    fontSize "1.75rem"
+                    fontWeight "600"
+                    margin "0 0 1.5rem"
+                    paddingBottom "0.6rem"
+                    borderBottom "2px solid var(--color-ink)"
+                }
+            }
+            div {
+                style display=grid gridTemplateColumns="repeat(3, 1fr)" gap="1rem" {
+                    @--sm gridTemplateColumns="1fr"
+                }
+                img src="/images/project-2.jpg" alt="${state.entry.data.title} — frame" loading=lazy {
+                    style {
+                        width "100%"
+                        aspectRatio "4 / 5"
+                        objectFit cover
+                        borderRadius "var(--radius)"
+                        display block
+                    }
+                }
+                img src="/images/project-4.jpg" alt="${state.entry.data.title} — frame" loading=lazy {
+                    style {
+                        width "100%"
+                        aspectRatio "4 / 5"
+                        objectFit cover
+                        borderRadius "var(--radius)"
+                        display block
+                    }
+                }
+                img src="/images/project-6.jpg" alt="${state.entry.data.title} — frame" loading=lazy {
+                    style {
+                        width "100%"
+                        aspectRatio "4 / 5"
+                        objectFit cover
+                        borderRadius "var(--radius)"
+                        display block
+                    }
+                }
+            }
+        }
+        div {
+            style {
+                marginTop "3.5rem"
+                padding "clamp(2.5rem, 6vw, 3.5rem)"
+                backgroundColor "var(--color-bg-dark)"
+                color "var(--color-text-white)"
+                borderRadius "var(--radius)"
+                textAlign center
+            }
+            h2 "Planning something similar?" {
+                style {
+                    fontFamily "var(--font-heading)"
+                    fontSize "clamp(1.75rem, 4vw, 2.5rem)"
+                    fontWeight "600"
+                    margin "0 0 1rem"
+                }
+            }
+            p "Tell us about your project and we'll be in touch to talk through the details." {
+                style {
+                    fontSize "1.1rem"
+                    lineHeight "1.7"
+                    opacity "0.82"
+                    margin "0 auto 2rem"
+                    maxWidth "48ch"
+                }
+            }
+            a href="/contact/" "Start a Project" {
+                style {
+                    display inline-block
+                    backgroundColor "var(--color-primary)"
+                    color "var(--color-text-white)"
+                    padding "0.9rem 2.25rem"
+                    borderRadius "var(--radius)"
+                    fontSize "0.95rem"
+                    fontWeight "600"
+                    letterSpacing "0.05em"
+                    textTransform uppercase
+                    textDecoration none
+                    transition "background-color 0.15s"
+                    :hover backgroundColor="var(--color-primary-hover)"
+                }
+            }
+        }
+    }
+}

package/sites/portfolio/project.jxn

@@ -4,7 +4,7 @@ project "Aperture Studio"
 
 url "https://example.com"
 
-defaults layout="./layouts/base.json" lang=en
+defaults layout="./layouts/base.jxn" lang=en
 
 $head {
     meta name=viewport content="width=device-width, initial-scale=1"