optikos 0.0.0-stage → 0.2.0

package/dist/css/core.css

@@ -0,0 +1,88 @@
+@layer optikos {
+  :root {
+    --op-spinner-size: 1.5rem;
+    --op-spinner-stroke: 2px;
+  }
+
+  /* every Optikos element gets the themed font; zero specificity, so any component rule overrides it */
+  :where([class^='op-'], [class*=' op-']) {
+    font-family: var(--op-font-family);
+    font-size: var(--op-font-size);
+  }
+  .op-component,
+  .op-container {
+    color: var(--op-color-fg);
+  }
+
+  /* loading mask (Component.setLoading) */
+  .is-loading {
+    position: relative;
+  }
+  .op-mask {
+    position: absolute;
+    inset: 0;
+    z-index: 1;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--op-space-2);
+    background: var(--op-mask-bg, color-mix(in srgb, var(--op-color-surface) 70%, transparent));
+    color: var(--op-color-fg);
+  }
+
+  .op-spinner {
+    display: inline-block;
+    box-sizing: border-box;
+    width: var(--op-spinner-size);
+    height: var(--op-spinner-size);
+    border: var(--op-spinner-stroke) solid var(--op-color-border-strong);
+    border-top-color: var(--op-spinner-color, var(--op-color-primary));
+    border-radius: 50%;
+    animation: op-spin 700ms linear infinite;
+  }
+  @keyframes op-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .op-spinner {
+      animation-duration: 2s;
+    }
+  }
+
+  /* virtual lists (core/virtual.ts) */
+  .op-virtual {
+    position: relative;
+    inline-size: 100%;
+  }
+  .op-sr-only {
+    position: absolute;
+    inline-size: 0;
+    block-size: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  /* floating layer */
+  .op-layer {
+    position: fixed;
+    inset: 0;
+    z-index: var(--op-z-layer);
+    pointer-events: none;
+    font-family: var(--op-font-family);
+    font-size: var(--op-font-size);
+    line-height: var(--op-line-height);
+    color: var(--op-color-fg);
+  }
+  .op-layer > * {
+    pointer-events: auto;
+  }
+
+  :where(.op-component, .op-field, .op-container) :focus-visible {
+    outline: var(--op-focus-width) solid var(--op-color-focus);
+    outline-offset: var(--op-focus-offset);
+  }
+}

package/dist/css/dataview.css

@@ -0,0 +1,56 @@
+@layer optikos {
+  :root {
+    --op-dataview-item-width: 10rem;
+    --op-dataview-gap: var(--op-space-3);
+    --op-dataview-ring-width: 0.1875rem;
+  }
+  .op-dataview {
+    display: flex;
+    flex-direction: column;
+    gap: var(--op-space-3);
+    min-inline-size: 0;
+    min-block-size: 0;
+    overflow: auto;
+  }
+  .op-dataview__items {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(var(--op-dataview-item-width), 1fr));
+    /* every row is as tall as the tallest card, so rows line up whatever each card's text does */
+    grid-auto-rows: 1fr;
+    gap: var(--op-dataview-gap);
+    padding: var(--op-space-1);
+  }
+  .op-dataview__item {
+    position: relative;
+    min-inline-size: 0;
+    border-radius: var(--op-dataview-item-radius, var(--op-radius));
+    display: flex;
+    flex-direction: column;
+    cursor: pointer;
+    user-select: none;
+  }
+  /* the card fills its cell: a short card stretches to the row instead of leaving a gap under it */
+  .op-dataview__item > * {
+    flex: 1;
+    min-block-size: 0;
+  }
+  .op-dataview__item:focus-visible {
+    outline: var(--op-focus-width) solid var(--op-color-focus);
+    outline-offset: var(--op-focus-offset);
+  }
+  .op-dataview__item.is-selected {
+    box-shadow: 0 0 0 var(--op-dataview-ring-width) var(--op-dataview-selected-ring, var(--op-color-primary));
+  }
+  .op-dataview__empty {
+    padding: var(--op-space-6);
+    color: var(--op-color-fg-muted);
+    text-align: center;
+  }
+  .op-dataview__empty[hidden] {
+    display: none;
+  }
+  .op-dataview__pager {
+    flex: none;
+    padding: var(--op-space-2);
+  }
+}

package/dist/css/dial.css

@@ -0,0 +1,203 @@
+@layer optikos {
+  :root {
+    --op-dial-spacing: 0.75rem;
+    --op-dial-item-spacing: 3.5rem;
+    --op-dial-height: 3.75rem;
+    --op-dial-size: 13rem;
+    --op-dial-readout-size: 2.75rem;
+    --op-dial-readout-size-circle: 2rem;
+    --op-dial-roll-duration: 380ms;
+    --op-dial-tick-height: 0.75rem;
+    --op-dial-major-height: 1.375rem;
+    --op-dial-needle-width: 0.1875rem;
+    --op-dial-label-gap: 0.25rem;
+    --op-dial-ring-inset: 0.5rem;
+    --op-dial-hub: 0.625rem;
+    --op-dial-digit-height: 1em; /* one line of the readout: a reel moves by this per digit */
+  }
+  .op-dial {
+    --_sp: var(--op-dial-spacing);
+  }
+  .op-dial--list {
+    --_sp: var(--op-dial-item-spacing);
+  }
+  .op-dial__box {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: var(--op-space-2);
+  }
+
+  /* the readout: digits roll like an odometer (each reel is the column 0–9, moved by --d) */
+  .op-dial__readout {
+    display: flex;
+    justify-content: center;
+    min-block-size: var(--op-dial-digit-height);
+    color: var(--op-dial-readout-fg, var(--op-color-fg));
+    font-size: var(--op-dial-readout-size);
+    font-weight: var(--op-font-weight-bold);
+    font-variant-numeric: tabular-nums;
+    line-height: 1;
+    white-space: pre;
+  }
+  .op-dial__digit,
+  .op-dial__reel {
+    font-size: inherit; /* the global op-* rule would reset them to the base size */
+  }
+  .op-dial__digit {
+    display: inline-block;
+    block-size: var(--op-dial-digit-height);
+    overflow: hidden;
+  }
+  .op-dial__reel {
+    display: flex;
+    flex-direction: column;
+    transform: translateY(calc(var(--d, 0) * -10%));
+    transition: transform var(--op-dial-roll-duration) var(--op-motion-ease-out);
+  }
+  .op-dial__reel > span {
+    display: block;
+    block-size: var(--op-dial-digit-height);
+  }
+
+  /* the face: a flat ruler sliding under a fixed needle */
+  .op-dial__face {
+    position: relative;
+    inline-size: 100%;
+    block-size: var(--op-dial-height);
+    border-radius: var(--op-radius);
+    cursor: grab;
+    touch-action: none;
+    user-select: none;
+  }
+  .op-dial__face:focus-visible {
+    outline: var(--op-focus-width) solid var(--op-color-focus);
+    outline-offset: var(--op-focus-offset);
+  }
+  .op-dial.is-dragging .op-dial__face {
+    cursor: grabbing;
+  }
+  .op-dial__window {
+    position: absolute;
+    inset: 0;
+    overflow: hidden;
+    mask-image: linear-gradient(to right, transparent, black 20%, black 80%, transparent);
+  }
+  .op-dial__tape {
+    position: absolute;
+    inset-block: 0;
+    inset-inline-start: 50%;
+    /* --pos (set by the component) is the item under the needle, fractional while dragging */
+    transform: translateX(calc(var(--pos, 0) * -1 * var(--_sp)));
+    transition: transform var(--op-dial-roll-duration) var(--op-motion-ease-out);
+  }
+  .op-dial.is-dragging .op-dial__tape {
+    transition: none;
+  }
+  .op-dial.is-gliding .op-dial__tape {
+    transition-timing-function: var(--op-motion-ease-out);
+  }
+  .op-dial__tick {
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: calc(var(--i) * var(--_sp));
+    inline-size: var(--op-border-width);
+    block-size: var(--op-dial-tick-height);
+    background: var(--op-dial-tick-fg, var(--op-color-border-strong));
+    transform: translateX(-50%);
+  }
+  .op-dial__tick.is-major {
+    inline-size: calc(var(--op-border-width) * 2);
+    block-size: var(--op-dial-major-height);
+    background: var(--op-dial-major-fg, var(--op-color-fg-muted));
+  }
+  .op-dial__tick-label {
+    position: absolute;
+    inset-block-start: calc(100% + var(--op-dial-label-gap));
+    inset-inline-start: 50%;
+    color: var(--op-color-fg-muted);
+    font-size: var(--op-font-size-sm);
+    white-space: nowrap;
+    transform: translateX(-50%);
+    transition: color var(--op-duration) var(--op-easing);
+  }
+  .op-dial__tick.is-current .op-dial__tick-label {
+    color: var(--op-color-primary-text, var(--op-color-primary));
+    font-weight: var(--op-font-weight-bold);
+  }
+  .op-dial__needle {
+    position: absolute;
+    inset-block-start: 0;
+    inset-inline-start: 50%;
+    inline-size: var(--op-dial-needle-width);
+    block-size: calc(var(--op-dial-major-height) + var(--op-space-1));
+    background: var(--op-dial-needle, var(--op-color-primary));
+    border-radius: var(--op-radius-pill);
+    transform: translateX(-50%);
+    pointer-events: none;
+  }
+
+  /* circle: a clock face, the ticks around the ring and a hand from the center */
+  .op-dial--circle .op-dial__face {
+    inline-size: var(--op-dial-size);
+    block-size: var(--op-dial-size);
+    border: var(--op-border-width) solid var(--op-color-border);
+    border-radius: 50%;
+  }
+  .op-dial--circle .op-dial__window {
+    overflow: visible;
+    mask-image: none;
+  }
+  .op-dial--circle .op-dial__tape {
+    inset: 0;
+    transform: none;
+    transition: none;
+  }
+  .op-dial--circle .op-dial__tick {
+    inset-block-start: var(--op-dial-ring-inset);
+    inset-inline-start: 50%;
+    transform-origin: 50% calc(var(--op-dial-size) / 2 - var(--op-dial-ring-inset) - var(--op-border-width));
+    transform: translateX(-50%) rotate(var(--a));
+  }
+  .op-dial--circle .op-dial__tick-label {
+    transform: translateX(-50%) rotate(calc(var(--a) * -1));
+  }
+  .op-dial--circle .op-dial__needle {
+    inset-block-start: auto;
+    inset-block-end: 50%;
+    block-size: calc(var(--op-dial-size) / 2 - var(--op-dial-ring-inset) - var(--op-dial-major-height) - var(--op-space-5) - var(--op-space-2));
+    transform-origin: 50% 100%;
+    transition: transform var(--op-dial-roll-duration) var(--op-motion-ease-out);
+  }
+  .op-dial--circle.is-dragging .op-dial__needle {
+    transition: none;
+  }
+  /* the hub the hand turns on */
+  .op-dial--circle .op-dial__needle::after {
+    content: '';
+    position: absolute;
+    inset-block-end: calc(var(--op-dial-hub) / -2);
+    inset-inline-start: 50%;
+    inline-size: var(--op-dial-hub);
+    block-size: var(--op-dial-hub);
+    background: inherit;
+    border-radius: 50%;
+    transform: translateX(-50%);
+  }
+  .op-dial--circle .op-dial__readout {
+    font-size: var(--op-dial-readout-size-circle);
+  }
+
+  .op-dial.is-disabled .op-dial__face {
+    cursor: not-allowed;
+    opacity: 0.5;
+  }
+  .op-dial.is-readonly .op-dial__face {
+    cursor: default;
+  }
+  .op-motion-off .op-dial__reel,
+  .op-motion-off .op-dial__tape,
+  .op-motion-off .op-dial__needle {
+    transition: none;
+  }
+}

package/dist/css/dropdown.css

@@ -0,0 +1,13 @@
+@layer optikos {
+  .op-dropdown {
+    position: fixed;
+    box-sizing: border-box;
+    max-inline-size: calc(100vw - var(--op-space-4));
+    color: var(--op-dropdown-fg, var(--op-color-fg));
+    background: var(--op-dropdown-bg, var(--op-color-surface));
+    border: var(--op-border-width) solid var(--op-dropdown-border, var(--op-color-border));
+    border-radius: var(--op-dropdown-radius, var(--op-radius));
+    box-shadow: var(--op-dropdown-shadow, var(--op-shadow));
+    overflow: hidden;
+  }
+}

package/dist/css/field.css

@@ -0,0 +1,62 @@
+@layer optikos {
+  :root {
+    --op-field-label-width: 8rem;
+  }
+
+  .op-field {
+    --_label-fg: var(--op-field-label-fg, var(--op-color-fg));
+    display: flex;
+    flex-direction: column;
+    gap: var(--op-field-gap, var(--op-space-1));
+    font-family: var(--op-font-family);
+    font-size: var(--op-font-size);
+    color: var(--op-color-fg);
+    min-width: 0;
+  }
+  .op-field__label {
+    color: var(--_label-fg);
+    font-size: var(--op-field-label-size, var(--op-font-size));
+    font-weight: var(--op-field-label-weight, var(--op-font-weight-medium));
+  }
+  .op-field.is-required > .op-field__label::after {
+    content: ' *';
+    color: var(--op-color-danger);
+  }
+  .op-field__control {
+    min-width: 0;
+  }
+  .op-field__help {
+    color: var(--op-field-help-fg, var(--op-color-fg-muted));
+    font-size: var(--op-font-size-sm);
+  }
+  .op-field__error {
+    color: var(--op-field-error-fg, var(--op-color-danger));
+    font-size: var(--op-font-size-sm);
+  }
+  .op-field__error:empty {
+    display: none;
+  }
+  /* stableSize: the error line is always reserved, so a field does not grow when it becomes invalid */
+  .op-field.op-stable > .op-field__error:empty {
+    display: block;
+    min-block-size: calc(var(--op-font-size-sm) * var(--op-line-height));
+  }
+  .op-field--label-left {
+    display: grid;
+    grid-template-columns: var(--op-field-label-width) minmax(0, 1fr);
+    align-items: start;
+    column-gap: var(--op-space-3);
+  }
+  .op-field--label-left > .op-field__label {
+    padding-block: var(--op-space-2);
+    grid-column: 1;
+  }
+  .op-field--label-left > .op-field__control,
+  .op-field--label-left > .op-field__help,
+  .op-field--label-left > .op-field__error {
+    grid-column: 2;
+  }
+  .op-field.is-disabled {
+    color: var(--op-color-disabled-fg);
+  }
+}

package/dist/css/fieldgroup.css

@@ -0,0 +1,26 @@
+@layer optikos {
+  .op-fieldgroup__body {
+    --op-layout-gap: var(--op-fieldgroup-gap, var(--op-space-2));
+  }
+  /* the fields share the row; each still has its label for screen readers, but only the group's label shows */
+  .op-fieldgroup__body > .op-field {
+    flex: 1 1 0;
+    min-inline-size: 0;
+  }
+  .op-fieldgroup__body .op-field__label {
+    position: absolute;
+    inline-size: 0;
+    block-size: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+  .op-fieldgroup__body .op-field__help,
+  .op-fieldgroup__body .op-field__error,
+  .op-fieldgroup__body .op-field.op-stable > .op-field__error:empty {
+    display: none; /* the group has the one error line (and beats the reserved line of stableSize) */
+  }
+  .op-fieldgroup > .op-field__label {
+    cursor: default;
+  }
+}

package/dist/css/fieldlist.css

@@ -0,0 +1,84 @@
+@layer optikos {
+  .op-fieldlist__box {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    gap: var(--op-fieldlist-gap, var(--op-space-2));
+  }
+  .op-fieldlist__rows {
+    display: flex;
+    flex-direction: column;
+    gap: var(--op-fieldlist-row-gap, var(--op-space-2));
+    align-self: stretch;
+  }
+  .op-fieldlist__row {
+    --op-layout-gap: var(--op-space-2);
+  }
+  .op-fieldlist__row > .op-field {
+    flex: 1 1 0;
+    min-inline-size: 0;
+  }
+  /* the labels read as a column header: shown on the first row, kept for screen readers on the others */
+  .op-fieldlist__row:not(.is-first) .op-field__label {
+    position: absolute;
+    inline-size: 0;
+    block-size: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+  .op-fieldlist__row:not(.is-first) .op-field__help {
+    display: none;
+  }
+  .op-fieldlist__tools {
+    display: flex;
+    flex: none;
+    gap: var(--op-space-1);
+    align-self: flex-start;
+    min-block-size: var(--op-control-height);
+    align-items: center;
+  }
+  /* on the first row the tools line up with the inputs, under the labels */
+  .op-fieldlist__row.is-first > .op-fieldlist__tools {
+    margin-block-start: calc(var(--op-font-size) * var(--op-line-height) + var(--op-field-gap, var(--op-space-1)));
+  }
+  .op-fieldlist__tool,
+  .op-fieldlist__add {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--op-space-1);
+    color: var(--op-color-fg-muted);
+    background: transparent;
+    border: 0;
+    border-radius: var(--op-radius-sm);
+    font: inherit;
+    cursor: pointer;
+  }
+  .op-fieldlist__tool {
+    padding: var(--op-space-1);
+  }
+  .op-fieldlist__add {
+    padding: var(--op-space-1) var(--op-space-2);
+    color: var(--op-color-primary-text, var(--op-color-primary));
+    font-weight: var(--op-font-weight-medium);
+  }
+  .op-fieldlist__tool:hover:not(:disabled),
+  .op-fieldlist__add:hover:not(:disabled) {
+    color: var(--op-color-fg);
+    background: var(--op-color-hover);
+  }
+  .op-fieldlist__tool:disabled,
+  .op-fieldlist__add:disabled {
+    color: var(--op-color-disabled-fg);
+    cursor: not-allowed;
+  }
+  .op-fieldlist__tool:focus-visible,
+  .op-fieldlist__add:focus-visible {
+    outline: var(--op-focus-width) solid var(--op-color-focus);
+    outline-offset: var(--op-focus-offset);
+  }
+  .op-fieldlist__empty {
+    color: var(--op-color-fg-muted);
+    font-size: var(--op-font-size-sm);
+  }
+}

package/dist/css/fieldset.css

@@ -0,0 +1,68 @@
+@layer optikos {
+  .op-fieldset {
+    min-inline-size: 0;
+    margin: 0;
+    padding: var(--op-fieldset-padding, var(--op-space-3));
+    color: var(--op-color-fg);
+    border: var(--op-border-width) solid var(--op-fieldset-border, var(--op-color-border));
+    border-radius: var(--op-fieldset-radius, var(--op-radius));
+  }
+  .op-fieldset__legend {
+    display: flex;
+    align-items: center;
+    gap: var(--op-space-1);
+    padding-inline: var(--op-space-1);
+    color: var(--op-fieldset-legend-fg, var(--op-color-fg));
+    font-weight: var(--op-font-weight-bold);
+  }
+  .op-fieldset__toggle {
+    display: inline-flex;
+    padding: 0;
+    color: inherit;
+    background: transparent;
+    border: 0;
+    cursor: pointer;
+  }
+  .op-fieldset.is-collapsed .op-fieldset__toggle .op-icon {
+    transform: rotate(180deg);
+  }
+  .op-fieldset.is-collapsed {
+    padding-block-end: 0;
+  }
+  .op-fieldset__desc {
+    margin: 0 0 var(--op-space-3);
+    padding-inline: var(--op-space-1);
+    color: var(--op-color-fg-muted);
+    font-size: var(--op-font-size-sm);
+  }
+  .op-fieldset__body {
+    --op-layout-gap: var(--op-form-gap, var(--op-space-3));
+  }
+  /* line: no frame, a rule under the legend; plain: just the legend */
+  .op-fieldset--line,
+  .op-fieldset--plain {
+    padding: 0;
+    border: 0;
+    border-radius: 0;
+  }
+  .op-fieldset--line > .op-fieldset__legend,
+  .op-fieldset--plain > .op-fieldset__legend {
+    inline-size: 100%;
+    margin-block-end: var(--op-space-3);
+    padding: 0;
+  }
+  .op-fieldset--line > .op-fieldset__legend {
+    padding-block-end: var(--op-space-2);
+    border-block-end: var(--op-border-width) solid var(--op-fieldset-border, var(--op-color-border));
+  }
+  .op-fieldset--line > .op-fieldset__desc,
+  .op-fieldset--plain > .op-fieldset__desc {
+    margin-block-start: calc(var(--op-space-2) * -1);
+    padding: 0;
+  }
+  .op-fieldset--collapsible-title .op-fieldset__title,
+  .op-fieldset__toggle + .op-fieldset__title {
+    cursor: pointer;
+    user-select: none;
+  }
+}