@getvitops/core 0.1.0

package/css/patterns/notification.css

@@ -0,0 +1,114 @@
+/**
+ * Notification — pattern partial migrated from old-css-lib.
+ * Consumes the generated token cascade (src/css/generated/tokens.css).
+ */
+
+/* ── Notification — toast with entry/exit + auto-dismiss progress bar ──────── */
+.notification {
+  --_p: var(--p-notification, var(--p-notification-group, var(--p-default)));
+  --_br: var(--br-notification, var(--br-notification-group, var(--br-default)));
+  --_ds: var(--ds-notification, var(--ds-notification-group, var(--ds-default)));
+  --_b: var(--b-notification, var(--b-notification-group, var(--b-default)));
+
+  position: relative;
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  padding: var(--_p);
+  border: var(--_b);
+  border-radius: var(--_br);
+  box-shadow: var(--_ds);
+  background: var(--color-surface-xxl);
+  color: var(--color-surface-xxd);
+  animation: notification-enter 0.3s ease;
+
+  &.notification--exiting {
+    animation: notification-exit 0.2s ease forwards;
+
+    @media (prefers-reduced-motion: reduce) {
+      opacity: 0;
+    }
+  }
+
+  .notification__icon {
+    flex-shrink: 0;
+    inline-size: 1.25rem;
+    block-size: 1.25rem;
+  }
+
+  .notification__content {
+    flex: 1;
+    min-inline-size: 0;
+  }
+
+  .notification__title {
+    font-weight: 600;
+    margin: 0 0 0.25em;
+  }
+
+  .notification__message {
+    margin: 0;
+    font-size: 0.875em;
+  }
+
+  .notification__actions {
+    display: flex;
+    gap: 0.5rem;
+    margin-block-start: 0.5rem;
+  }
+
+  .notification__close {
+    flex-shrink: 0;
+    align-self: flex-start;
+    padding: 0.25rem;
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    opacity: 0.5;
+    transition: opacity 0.15s ease;
+
+    &:hover {
+      opacity: 1;
+    }
+  }
+
+  .notification__progress {
+    position: absolute;
+    inset-block-end: 0;
+    inset-inline: 0;
+    block-size: 3px;
+    background: var(--color-brand-primary);
+    border-radius: 0 0 var(--_br) var(--_br);
+    transform-origin: left;
+    animation: notification-progress var(--notification-duration, 5s) linear forwards;
+  }
+}
+
+@keyframes notification-enter {
+  from {
+    opacity: 0;
+    translate: 1rem 0;
+  }
+  to {
+    opacity: 1;
+    translate: 0 0;
+  }
+}
+@keyframes notification-exit {
+  from {
+    opacity: 1;
+    translate: 0 0;
+  }
+  to {
+    opacity: 0;
+    translate: 1rem 0;
+  }
+}
+@keyframes notification-progress {
+  from {
+    scale: 1 1;
+  }
+  to {
+    scale: 0 1;
+  }
+}

package/css/patterns/overlay.css

@@ -0,0 +1,28 @@
+/**
+ * Overlay — decorative tint/filter layer that sits behind sibling content.
+ * Not one of the interactive overlay-family patterns (dialog/drawer/popover/
+ * tooltip/dropdown/notification/lightbox); this is a z-index:-1 backdrop tint.
+ * Ported from old-css-lib. Colour via --overlay, filter via --overlay-filter.
+ */
+
+.overlay {
+  position: absolute;
+  inset: 0;
+  isolation: isolate;
+  z-index: -1;
+  inline-size: 100%;
+
+  > * {
+    inline-size: 100%;
+    block-size: 100%;
+  }
+
+  &::before {
+    content: '';
+    position: absolute;
+    inset: 0;
+    background: var(--overlay, transparent);
+    filter: var(--overlay-filter, none);
+    pointer-events: none;
+  }
+}

package/css/patterns/popover.css

@@ -0,0 +1,68 @@
+/**
+ * Popover — pattern partial migrated from old-css-lib.
+ * Consumes the generated token cascade (src/css/generated/tokens.css).
+ */
+
+/* ── Popover — native Popover API reset + anchored position variants ───────── */
+[popover] {
+  padding: 0;
+  border: none;
+  background: transparent;
+  color: inherit;
+  overflow: visible;
+  inset: auto;
+
+  &:popover-open {
+    opacity: 1;
+  }
+
+  &:not(:popover-open):not([open]) {
+    display: none;
+  }
+
+  @starting-style {
+    &:popover-open {
+      opacity: 0;
+    }
+  }
+}
+
+.popover-anchor {
+  anchor-name: --popover-anchor;
+  position: relative;
+
+  [popover] {
+    position: absolute;
+    position-anchor: --popover-anchor;
+    inset: auto;
+  }
+
+  [popover].popover--top {
+    position-area: block-start center;
+    margin-block-end: 0.5rem;
+  }
+  [popover].popover--bottom {
+    position-area: block-end center;
+    margin-block-start: 0.5rem;
+  }
+  [popover].popover--left {
+    position-area: center inline-start;
+    margin-inline-end: 0.5rem;
+  }
+  [popover].popover--right {
+    position-area: center inline-end;
+    margin-inline-start: 0.5rem;
+  }
+  [popover].popover--top-start {
+    position-area: block-start span-inline-end;
+  }
+  [popover].popover--top-end {
+    position-area: block-start span-inline-start;
+  }
+  [popover].popover--bottom-start {
+    position-area: block-end span-inline-end;
+  }
+  [popover].popover--bottom-end {
+    position-area: block-end span-inline-start;
+  }
+}

package/css/patterns/pull-quote.css

@@ -0,0 +1,71 @@
+/**
+ * Pull Quote — pattern partial migrated from old-css-lib.
+ * Consumes the generated token cascade (src/css/generated/tokens.css).
+ */
+
+/* ── Pull quote — highlighted inline quote (not a blockquote) ─────────────── */
+.pull-quote {
+  --_fs: var(--fs-pull-quote, var(--fs-pull-quote-group, var(--fs-default)));
+  --_p: var(--p-pull-quote, var(--p-pull-quote-group, var(--p-default)));
+  --_br: var(--br-pull-quote, var(--br-pull-quote-group, var(--br-default)));
+  --_b: var(--b-pull-quote, var(--b-pull-quote-group, var(--b-default)));
+  --_ds: var(--ds-pull-quote, var(--ds-pull-quote-group, var(--ds-default)));
+
+  position: relative;
+  padding: var(--_p);
+  font-size: var(--_fs);
+  line-height: 1.4;
+  border: var(--_b);
+  border-radius: var(--_br);
+  box-shadow: var(--_ds);
+  font-style: italic;
+
+  &::before {
+    content: '\201C';
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: 0;
+    font-size: 4em;
+    line-height: 1;
+    opacity: 0.3;
+    font-style: normal;
+    font-family: Georgia, serif;
+  }
+
+  .pull-quote__attribution {
+    display: block;
+    margin-block-start: 1rem;
+    font-size: 0.875rem;
+    font-style: normal;
+    opacity: 0.7;
+
+    &::before {
+      content: '— ';
+    }
+  }
+
+  &.pull-quote--border {
+    border-inline-start: 4px solid currentColor;
+    padding-inline-start: 1.5rem;
+
+    &::before {
+      display: none;
+    }
+  }
+}
+
+figure.pull-quote-figure {
+  .pull-quote {
+    margin: 0;
+  }
+
+  figcaption {
+    font-size: 0.875rem;
+    opacity: 0.7;
+    margin-block-start: 0.75rem;
+
+    &::before {
+      content: '— ';
+    }
+  }
+}

package/css/patterns/scroll-based.css

@@ -0,0 +1,227 @@
+/**
+ * Scroll Based — pattern partial migrated from old-css-lib.
+ * Consumes the generated token cascade (src/css/generated/tokens.css).
+ */
+
+/* ── Scroll snap ──────────────────────────────────────────────────────────── */
+.scroll-snap {
+  --_snap-type: var(--snap-type, both mandatory);
+  --_snap-padding: var(--snap-padding, 0);
+
+  overflow: auto;
+  scroll-snap-type: var(--_snap-type);
+  scroll-padding: var(--_snap-padding);
+  overscroll-behavior: contain;
+
+  &.scroll-snap--x {
+    --_snap-type: x mandatory;
+    overflow-x: auto;
+    overflow-y: hidden;
+    display: flex;
+    flex-wrap: nowrap;
+  }
+
+  &.scroll-snap--y {
+    --_snap-type: y mandatory;
+    overflow-x: hidden;
+    overflow-y: auto;
+  }
+
+  &.scroll-snap--proximity {
+    --_snap-type: both proximity;
+  }
+
+  > * {
+    scroll-snap-align: var(--snap-align, start);
+    scroll-snap-stop: var(--snap-stop, normal);
+  }
+
+  &.scroll-snap--center > * {
+    scroll-snap-align: center;
+  }
+  &.scroll-snap--end > * {
+    scroll-snap-align: end;
+  }
+  &.scroll-snap--always > * {
+    scroll-snap-stop: always;
+  }
+
+  &.scroll-snap--hide-scrollbar {
+    scrollbar-width: none;
+
+    &::-webkit-scrollbar {
+      display: none;
+    }
+  }
+}
+
+/* ── Scroll spy — highlight nav via scroll-state() ────────────────────────── */
+.scroll-spy {
+  container-type: scroll-state;
+
+  .scroll-spy__section {
+    container-type: scroll-state;
+  }
+
+  @container scroll-state(snapped: block) {
+    .scroll-spy__link[data-active] {
+      color: var(--scroll-spy-active-color, currentColor);
+      font-weight: 600;
+    }
+  }
+}
+
+/* ── Parallax — scroll-driven layer offset ────────────────────────────────── */
+.parallax {
+  --_parallax-speed: var(--parallax-speed, 0.5);
+
+  overflow: hidden;
+  position: relative;
+
+  .parallax__layer {
+    position: absolute;
+    inset: calc(-50% * var(--_parallax-speed)) 0;
+    animation: parallax-scroll linear;
+    animation-timeline: scroll(root);
+
+    @media (prefers-reduced-motion: reduce) {
+      inset: 0;
+      animation: none;
+    }
+  }
+
+  .parallax__layer > img {
+    inline-size: 100%;
+    block-size: 100%;
+    object-fit: cover;
+  }
+
+  .parallax__content {
+    position: relative;
+    z-index: 1;
+  }
+}
+
+@keyframes parallax-scroll {
+  from {
+    translate: 0 calc(-25% * var(--_parallax-speed, 0.5));
+  }
+  to {
+    translate: 0 calc(25% * var(--_parallax-speed, 0.5));
+  }
+}
+
+/* ── Scroll progress bar ──────────────────────────────────────────────────── */
+.scroll-progress {
+  --_progress-height: var(--scroll-progress-height, 3px);
+
+  position: fixed;
+  inset-block-start: 0;
+  inset-inline: 0;
+  block-size: var(--_progress-height);
+  z-index: var(--z-tier-top);
+
+  .scroll-progress__bar {
+    block-size: 100%;
+    background: var(--scroll-progress-color, var(--color-brand-primary));
+    transform-origin: left;
+    animation: scroll-progress-grow linear;
+    animation-timeline: scroll(root);
+  }
+}
+
+@keyframes scroll-progress-grow {
+  from {
+    scale: 0 1;
+  }
+  to {
+    scale: 1 1;
+  }
+}
+
+/* ── Scroll reveal — view()-driven entrance ───────────────────────────────── */
+.scroll-reveal {
+  animation: scroll-reveal linear both;
+  animation-timeline: view();
+  animation-range: entry 0% cover 40%;
+
+  @media (prefers-reduced-motion: reduce) {
+    animation: none;
+    opacity: 1;
+  }
+
+  &.scroll-reveal--up {
+    animation-name: scroll-reveal-up;
+  }
+  &.scroll-reveal--down {
+    animation-name: scroll-reveal-down;
+  }
+  &.scroll-reveal--left {
+    animation-name: scroll-reveal-left;
+  }
+  &.scroll-reveal--right {
+    animation-name: scroll-reveal-right;
+  }
+  &.scroll-reveal--scale {
+    animation-name: scroll-reveal-scale;
+  }
+}
+
+@keyframes scroll-reveal {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+@keyframes scroll-reveal-up {
+  from {
+    opacity: 0;
+    translate: 0 2rem;
+  }
+  to {
+    opacity: 1;
+    translate: 0 0;
+  }
+}
+@keyframes scroll-reveal-down {
+  from {
+    opacity: 0;
+    translate: 0 -2rem;
+  }
+  to {
+    opacity: 1;
+    translate: 0 0;
+  }
+}
+@keyframes scroll-reveal-left {
+  from {
+    opacity: 0;
+    translate: -2rem 0;
+  }
+  to {
+    opacity: 1;
+    translate: 0 0;
+  }
+}
+@keyframes scroll-reveal-right {
+  from {
+    opacity: 0;
+    translate: 2rem 0;
+  }
+  to {
+    opacity: 1;
+    translate: 0 0;
+  }
+}
+@keyframes scroll-reveal-scale {
+  from {
+    opacity: 0;
+    scale: 0.9;
+  }
+  to {
+    opacity: 1;
+    scale: 1;
+  }
+}

package/css/patterns/scroll-target.css

@@ -0,0 +1,124 @@
+/**
+ * Scroll Target — pattern partial migrated from old-css-lib.
+ * Consumes the generated token cascade (src/css/generated/tokens.css).
+ */
+
+/* ── Scroll-target group — :target-current scroll-spy + TOC layout ────────── */
+.scroll-target-group {
+  scroll-target-group: auto;
+}
+
+.scroll-target-group a {
+  transition: var(--scroll-target-transition, color 0.3s ease, background-color 0.3s ease);
+  text-decoration: none;
+  color: var(--scroll-target-inactive-color, currentColor);
+}
+
+/* `.is-current` mirrors `:target-current` for the JS scroll-spy fallback
+   (deferred.ts) on engines without `scroll-target-group` support. */
+.scroll-target-group a:target-current,
+.scroll-target-group a.is-current {
+  color: var(--scroll-target-active-color, var(--color-brand-primary));
+}
+
+.scroll-target-group--indicator a {
+  position: relative;
+  padding-inline-start: calc(var(--scroll-target-indicator-size, 3px) * 3);
+}
+
+.scroll-target-group--indicator a::before,
+.scroll-target-group--bar a::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: 0;
+  background-color: transparent;
+  transition: var(--scroll-target-transition, color 0.3s ease, background-color 0.3s ease);
+}
+
+.scroll-target-group--indicator a::before {
+  top: 50%;
+  transform: translateY(-50%);
+  width: var(--scroll-target-indicator-size, 3px);
+  height: var(--scroll-target-indicator-size, 3px);
+  border-radius: 50%;
+}
+
+.scroll-target-group--indicator a:target-current::before,
+.scroll-target-group--bar a:target-current::before,
+.scroll-target-group--indicator a.is-current::before,
+.scroll-target-group--bar a.is-current::before {
+  background-color: var(--scroll-target-active-color, var(--color-brand-primary));
+}
+
+.scroll-target-group--bar a {
+  position: relative;
+  padding-inline-start: calc(var(--scroll-target-indicator-size, 3px) + 0.75rem);
+}
+
+.scroll-target-group--bar a::before {
+  top: 0;
+  bottom: 0;
+  width: var(--scroll-target-indicator-size, 3px);
+}
+
+@supports not (scroll-target-group: auto) {
+  .scroll-target-group--hide-unsupported {
+    display: none;
+  }
+}
+
+.toc-layout {
+  display: grid;
+  grid-template-columns: 1fr;
+
+  @container body (inline-size >= 64rem) {
+    grid-template-columns: 16rem 1fr;
+    gap: var(--gutter, 2rem);
+  }
+}
+
+.toc-sidebar {
+  display: none;
+
+  @container body (inline-size >= 64rem) {
+    display: block;
+    position: sticky;
+    top: calc(var(--top-offset, 0px) + var(--sticky-offset, 1rem));
+    height: fit-content;
+    max-height: calc(100svh - calc(var(--top-offset, 0px) + var(--sticky-offset, 1rem)) * 2);
+    overflow-y: auto;
+    padding-block: 1rem;
+  }
+}
+
+.toc-sidebar nav {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+
+.toc-sidebar a {
+  display: block;
+  padding: 0.375rem 0.75rem;
+  border-radius: 0.25rem;
+  font-size: 0.875rem;
+  transition: var(--scroll-target-transition, color 0.3s ease, background-color 0.3s ease);
+}
+
+.toc-sidebar a:target-current,
+.toc-sidebar a.is-current {
+  color: var(--scroll-target-active-color, var(--color-brand-primary));
+  font-weight: 500;
+}
+
+.toc-inline {
+  position: sticky;
+  top: var(--top-offset, 0);
+  z-index: var(--z-tier-sticky);
+  overflow-x: auto;
+  overscroll-behavior-x: contain;
+
+  @container body (inline-size >= 64rem) {
+    display: none;
+  }
+}