fractalstyler2 0.1.0 → 0.4.0

package/templates/_09_utilities.sass

@@ -0,0 +1,207 @@
+// =============================================================================
+// 09_UTILITIES — the markup projection of atom & molecule fractals.
+// -----------------------------------------------------------------------------
+// Every utility class here is a direct 1:1 projection of an atom or molecule
+// mixin. Because this file is loaded after _08_blocks.sass in index.sass, utility
+// classes can be used on any element to set or override properties without
+// specificity wars.
+// =============================================================================
+
+@use 'sass:string'
+@use 'fractals' as *
+
+// --- Flow ------------------------------------------------------------------
+.box
+	+box
+.row
+	+row
+	&.wrap
+		+wrap
+
+// Alignment modifiers, semantic and axis-aware.
+.box
+	&.xcenter
+		align-items: center
+	&.xleft
+		align-items: flex-start
+	&.xright
+		align-items: flex-end
+	&.ycenter
+		justify-content: center
+	&.ytop
+		justify-content: flex-start
+	&.ybot
+		justify-content: flex-end
+	&.ybetween
+		justify-content: space-between
+	&.yevenly
+		justify-content: space-evenly
+
+.row
+	&.ycenter
+		align-items: center
+	&.ytop
+		align-items: flex-start
+	&.ybot
+		align-items: flex-end
+	&.xcenter
+		justify-content: center
+	&.xbetween
+		justify-content: space-between
+	&.xevenly
+		justify-content: space-evenly
+	&.xleft
+		justify-content: flex-start
+	&.xright
+		justify-content: flex-end
+
+// Fixed column grids.
+@for $n from 1 through 6
+	.grid-cols-#{$n}
+		+grid($n)
+
+.center
+	+center
+
+// --- Molecule Projections --------------------------------------------------
+.stack
+	+stack(s)
+
+.cluster
+	+cluster(xs)
+
+.frame
+	+frame('16 / 9')
+	&.square
+		+frame('1 / 1')
+	&.video
+		+frame('16 / 9')
+
+.reel
+	+reel(s)
+
+.center-column
+	+center-column
+
+// --- Spacing scale → gap-* / pad-* / margin-* ------------------------------
+@each $s in $space-steps
+	.gap-#{$s}
+		+gap($s)
+	.pad-#{$s}
+		+pad($s)
+	.px-#{$s}
+		+px($s)
+	.py-#{$s}
+		+py($s)
+	.pt-#{$s}, .padtop-#{$s}, .pad-top-#{$s}
+		padding-top: space($s)
+	.pb-#{$s}, .padbot-#{$s}, .pad-bottom-#{$s}
+		padding-bottom: space($s)
+	.pl-#{$s}, .padleft-#{$s}, .pad-left-#{$s}
+		padding-left: space($s)
+	.pr-#{$s}, .padright-#{$s}, .pad-right-#{$s}
+		padding-right: space($s)
+	.m-#{$s}
+		margin: space($s)
+	.mx-#{$s}
+		margin-inline: space($s)
+	.my-#{$s}
+		margin-block: space($s)
+	.mt-#{$s}, .margin-top-#{$s}
+		margin-top: space($s)
+	.mb-#{$s}, .margin-bottom-#{$s}
+		margin-bottom: space($s)
+
+.mx-auto
+	+mx-auto
+.my-auto
+	+my-auto
+
+// --- Radius / shadow / surface ---------------------------------------------
+@each $r in $radius-steps
+	.radius-#{$r}
+		+radius($r)
+
+@each $s in $shadow-steps
+	.shadow-#{$s}
+		+shadow($s)
+
+@each $role in $surface-roles
+	.bg-#{$role}
+		+bg($role)
+
+.border
+	+border
+@each $side in top right bottom left
+	.border-#{$side}
+		+border($side)
+
+// --- Type ------------------------------------------------------------------
+@each $t in $text-steps
+	.text-#{$t}
+		+type($t)
+
+.truncate
+	+truncate
+
+.clamp-1
+	+clamp-lines(1)
+.clamp-2
+	+clamp-lines(2)
+.clamp-3
+	+clamp-lines(3)
+
+.weight-400
+	+weight(400)
+.weight-500
+	+weight(500)
+.weight-600
+	+weight(600)
+.weight-700
+	+weight(700)
+
+.muted
+	+ink(secondary)
+.eyebrow
+	+type(sm)
+	+ink(muted)
+	text-transform: uppercase
+	letter-spacing: 0.06em
+	font-weight: 500
+
+// --- Sizing shortcuts ------------------------------------------------------
+.wfull
+	+w(100%)
+.hfull
+	+h(100%)
+.full
+	+full
+.grow
+	+grow
+.shrink-0
+	+shrink(0)
+.min0
+	+min0
+.relative
+	+relative
+.absolute
+	+absolute
+.overflow-hidden
+	overflow: hidden
+.cursor-pointer
+	cursor: pointer
+.block
+	display: block
+
+// --- Responsive Visibility -------------------------------------------------
+.hide-desktop
+	+at(lg)
+		display: none !important
+
+.hide-mobile
+	+below(lg)
+		display: none !important
+
+.only-mobile
+	+at(lg)
+		display: none !important

package/templates/_10_layouts.sass

@@ -0,0 +1,373 @@
+// =============================================================================
+// 10_LAYOUTS — the largest fractals. Same recipe move, page scale.
+// -----------------------------------------------------------------------------
+// Layouts compose molecule and atom fractals into structural arrangements.
+// State and responsive reflow are handled with +cols, +auto-grid, +cover.
+// =============================================================================
+
+@use 'fractals' as *
+
+// Column grid presets
+.grid-1
+	+cols((base: 1), s)
+
+.grid-2
+	+cols((base: 1, md: 2), m)
+
+.grid-3
+	+cols((base: 1, sm: 2, lg: 3), s)
+
+.grid-4
+	+cols((base: 1, sm: 2, lg: 4), s)
+
+.grid-6
+	+cols((base: 2, sm: 3, md: 4, lg: 6), xs)
+
+// A grid that never needs breakpoints: it fits as many columns as will hold
+// the min track. Reach for this when column count is negotiable.
+.card-grid
+	+auto-grid(16rem, s)
+
+// Hero — full-viewport cover with a centered, measured message.
+.hero
+	+cover(80vh, xl)
+	> .center
+		+stack(m, center)
+		text-align: center
+		max-width: 45ch
+
+// Holy grail — header / (nav · main · aside) / footer.
+.holy-grail
+	display: grid
+	min-height: 100vh
+	grid-template-rows: auto 1fr auto
+	grid-template-areas: 'header' 'main' 'footer'
+	> .hg-header
+		grid-area: header
+	> .hg-footer
+		grid-area: footer
+	> .hg-body
+		grid-area: main
+		display: grid
+		grid-template-columns: 1fr
+		+gap(m)
+		+pad(m)
+	+at(lg)
+		> .hg-body
+			grid-template-columns: var(--nav-w, 220px) minmax(0, 1fr) var(--aside-w, 260px)
+			> .hg-nav
+				+sticky(var(--space-m))
+				align-self: start
+			> .hg-aside
+				+sticky(var(--space-m))
+				align-self: start
+
+// Docs layout — responsive 3-column frame (nav · main · TOC).
+.docs
+	position: relative
+	display: grid
+	grid-template-columns: 1fr
+	min-height: calc(100vh - var(--header-height, 48px))
+
+	// Left Nav Rail (off-canvas drawer on mobile, sticky rail on desktop)
+	> .docs-nav
+		position: fixed
+		top: var(--header-height, 48px)
+		left: 0
+		z-index: var(--z-modal, 200)
+		width: min(85vw, 280px)
+		height: calc(100dvh - var(--header-height, 48px))
+		padding: var(--space-s)
+		overflow-y: auto
+		background: var(--bg)
+		+border(right)
+		transform: translateX(-105%)
+		transition: transform 200ms ease-out
+
+	&[data-drawer-open='true'] > .docs-nav
+		transform: translateX(0)
+
+	// Backdrop for mobile drawer
+	> .docs-backdrop
+		position: fixed
+		inset: var(--header-height, 48px) 0 0 0
+		z-index: calc(var(--z-modal, 200) - 1)
+		background: rgba(0, 0, 0, 0.5)
+		backdrop-filter: blur(2px)
+		border: none
+		cursor: pointer
+
+	// Center Reading Column
+	> .docs-main
+		+min0
+		+box
+		padding-block: var(--space-l)
+		padding-inline: var(--space-s)
+		> *
+			width: 100%
+			max-width: clamp(600px, 58vw, 760px)
+			margin-inline: auto
+
+	// Right TOC Rail (desktop only)
+	> .docs-toc
+		display: none
+
+	// Desktop Breakpoint (>= 1024px)
+	+at(lg)
+		--docs-nav-w: clamp(220px, 20vw, 270px)
+		--docs-toc-w: clamp(200px, 18vw, 240px)
+		grid-template-columns: var(--docs-nav-w) minmax(0, 1fr) var(--docs-toc-w)
+
+		> .docs-nav
+			position: sticky
+			top: var(--header-height, 48px)
+			width: auto
+			height: calc(100vh - var(--header-height, 48px))
+			transform: none
+			z-index: 10
+			padding: var(--space-m) var(--space-s)
+
+		> .docs-toc
+			display: block
+			position: sticky
+			top: var(--header-height, 48px)
+			height: calc(100vh - var(--header-height, 48px))
+			overflow-y: auto
+			padding: var(--space-m) var(--space-s)
+			+border(left)
+
+		> .docs-backdrop
+			display: none
+
+// NavTree styling
+.navtree
+	+box
+	+gap(m)
+
+.navtree-group
+	+box
+	+gap(3xs)
+
+.navtree-title
+	font-size: var(--text-xs)
+	font-weight: 600
+	text-transform: uppercase
+	letter-spacing: 0.06em
+	color: var(--text-muted)
+	padding: 6px 8px
+
+.navtree-link
+	+row(between, center)
+	padding: 6px 10px
+	font-size: var(--text-sm)
+	color: var(--text-secondary)
+	border-radius: var(--radius-4)
+	text-decoration: none
+	transition: all 120ms ease
+	&:hover
+		+bg(raised)
+		+ink(primary)
+	&[aria-current='page'], &[data-active='true']
+		+bg(surface)
+		color: var(--theme)
+		font-weight: 500
+		+border
+
+.navtree-sub
+	+box
+	+gap(3xs)
+	margin-left: 12px
+	padding-left: 8px
+	+border(left)
+
+// TOC styling
+.toc
+	+box
+	+gap(m)
+	height: 100%
+
+.toc-title
+	font-size: var(--text-xs)
+	font-weight: 600
+	text-transform: uppercase
+	letter-spacing: 0.06em
+	color: var(--text-muted)
+
+.toc-list
+	list-style: none
+	margin: 0
+	padding: 0
+	+box
+	+gap(2xs)
+
+.toc-link
+	display: block
+	font-size: var(--text-xs)
+	color: var(--text-muted)
+	text-decoration: none
+	padding: 3px 0
+	transition: color 120ms ease
+	&:hover
+		+ink(primary)
+	&[aria-current='true']
+		color: var(--theme)
+		font-weight: 500
+	&[data-depth='3']
+		padding-left: 10px
+
+.toc-footer
+	+partition(top, s)
+	+box
+	+gap(2xs)
+
+// Mobile TOC Disclosure
+.docs-mobile-toc
+	+box
+	+gap(xs)
+	+pad(xs)
+	+radius(6)
+	+bg(surface)
+	+border(all, var(--border))
+	summary
+		+row(between, center)
+		+weight(500)
+		+type(sm)
+		+ink(primary)
+		cursor: pointer
+		user-select: none
+		list-style: none
+		&::-webkit-details-marker
+			display: none
+	&[open]
+		+bg(raised)
+		summary
+			margin-bottom: var(--space-xs)
+			padding-bottom: var(--space-2xs)
+			+border(bottom, var(--border))
+
+// Prose Typography Container
+.prose
+	font-size: var(--text-sm)
+	line-height: 1.65
+	color: var(--text-secondary)
+
+	> * + *
+		margin-top: 1rem
+
+	h1
+		font-size: var(--text-3xl)
+		font-weight: 700
+		color: var(--text-primary)
+		line-height: 1.2
+		margin-top: 0
+		margin-bottom: 0.5rem
+
+	h2
+		font-size: var(--text-xl)
+		font-weight: 600
+		color: var(--text-primary)
+		line-height: 1.3
+		margin-top: 2rem
+		margin-bottom: 0.5rem
+		padding-bottom: 0.25rem
+		+border(bottom)
+
+	h3
+		font-size: var(--text-md)
+		font-weight: 600
+		color: var(--text-primary)
+		margin-top: 1.5rem
+		margin-bottom: 0.25rem
+
+	h4
+		font-size: var(--text-sm)
+		font-weight: 600
+		color: var(--text-primary)
+
+	p
+		margin-bottom: 1rem
+
+	ul, ol
+		padding-left: 1.25rem
+		margin-bottom: 1rem
+		li
+			margin-bottom: 0.25rem
+
+	code:not(pre code)
+		font-family: var(--font-mono)
+		font-size: 0.85em
+		padding: 2px 6px
+		background: var(--bg-raised)
+		border: 1px solid var(--border)
+		border-radius: var(--radius-3)
+		color: var(--text-primary)
+
+	pre
+		position: relative
+		background: var(--bg-surface)
+		border: 1px solid var(--border)
+		border-radius: var(--radius-6)
+		padding: var(--space-s)
+		overflow-x: auto
+		font-family: var(--font-mono)
+		font-size: var(--text-xs)
+		line-height: 1.5
+		color: var(--text-primary)
+		code
+			font-family: inherit
+			font-size: inherit
+			background: none
+			border: none
+			padding: 0
+
+	table
+		width: 100%
+		border-collapse: collapse
+		margin-block: 1.25rem
+		font-size: var(--text-sm)
+		th
+			text-align: left
+			padding: 8px 12px
+			border-bottom: 1px solid var(--border-subtle)
+			font-size: var(--text-xs)
+			font-weight: 600
+			text-transform: uppercase
+			letter-spacing: 0.04em
+			color: var(--text-primary)
+		td
+			padding: 8px 12px
+			border-bottom: 1px solid var(--border)
+			color: var(--text-secondary)
+
+	blockquote
+		margin: 1.25rem 0
+		padding: 8px 16px
+		border-left: 3px solid var(--theme)
+		background: var(--bg-raised)
+		border-radius: 0 var(--radius-4) var(--radius-4) 0
+		p
+			margin: 0
+			color: var(--text-primary)
+
+// App shell — sticky header, fluid body, footer.
+.app-shell
+	+box
+	+relative
+	isolation: isolate
+	min-height: 100vh
+	> .app-header
+		+row(null, center)
+		+sticky(0)
+		+px(m)
+		background: var(--bg)
+		z-index: var(--z-sticky)
+		height: var(--header-height)
+		+border(bottom)
+	> .app-main
+		+grow
+		+min0
+	> .app-footer
+		+row(null, center)
+		+px(m)
+		min-height: var(--footer-height)
+		+border(top)

package/templates/_11_own.sass

@@ -0,0 +1,21 @@
+// =============================================================================
+// 11_OWN — bespoke project-specific styles and micro-components.
+// =============================================================================
+
+@use 'fractals' as *
+
+.logomotif
+	height: 28px
+	width: 28px
+	filter: saturate(0)
+
+.logotype
+	height: 16px
+	filter: saturate(0)
+
+.header-nav
+	font-size: var(--text-sm)
+	text-decoration: none
+	color: var(--text-secondary)
+	&:hover
+		color: var(--theme-color)

package/templates/_fractals.sass

@@ -1,13 +1,14 @@
 // =============================================================================
-// FRACTALS — the pure API barrel. Emits NO css on its own.
+// FRACTALS — the pure API barrel. Emits NO CSS on its own.
 // -----------------------------------------------------------------------------
 // In any component partial or Svelte component:
 //   @use '$lib/styles/fractals' as *
 //   (or @use './fractals' as *)
-// then call fractals freely:  +surface(...)  +stack(...)  space(m) ...
+// then call fractals freely:  +surface(...)  +stack(...)  +card(...)
 // =============================================================================
 
-@forward 'config'
-@forward 'responsive'
-@forward 'atoms'
-@forward 'molecules'
+@forward '01_config'
+@forward '03_responsive'
+@forward '04_atoms'
+@forward '05_molecules'
+@forward '06_recipes'

package/templates/index.sass

@@ -1,20 +1,18 @@
 // =============================================================================
-// STYLES ENTRY — the full emitted stylesheet in cascade order.
+// FRACTALSTYLER2 — Master Stylesheet & Public Mixin API
 // -----------------------------------------------------------------------------
-//   1. tokens      the CSS custom properties (only literal values)
-//   2. base        fluid reset
-//   3. utilities   atom fractals projected to markup classes (optional layer)
-//   4. blocks      components composed from fractals
-//   5. layouts     page templates composed from fractals
-//
-// Consume from a SvelteKit app:  import '$lib/styles/index.sass'
-// or from package:               import 'fractalstyler2/styles'
-// The fractal mixins/functions themselves emit nothing until called, so output
-// contains only what you use.
+// 1. Public API: Forwards all pure mixins, functions, and atoms (0 bytes CSS)
+// 2. Cascade Order: Emits CSS rules in strict specificity sequence
 // =============================================================================
 
-@use './tokens'
-@use './base'
-@use './utilities'
-@use './blocks'
-@use './layouts'
+// Public Sass API — available to any file that @uses this module
+@forward 'fractals'
+
+// Global Stylesheet Cascade
+@use '02_fonts' as *
+@use '00_tokens' as *
+@use '07_base' as *
+@use '08_blocks' as *
+@use '09_utilities' as *
+@use '10_layouts' as *
+@use '11_own' as *