@surflane/ui 0.4.0 → 0.6.0

package/dist/css/rules/app-shell.css

@@ -0,0 +1,220 @@
+/* App shell / Sidebar, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.components {
+  /* Application frame slots: navigation state and product routing remain caller-owned. */
+  .pui-app-shell {
+    --app-shell-radius: var(--radius-sheet);
+    --app-shell-inset: var(--space-3);
+    --app-shell-sidebar-width: 216px;
+    /* The collapsed sidebar's width. Set it on the shell for a narrower rail. */
+    --app-shell-rail-width: 64px;
+    display: grid;
+    grid-template-columns: var(--app-shell-sidebar-width) minmax(0, 1fr);
+    grid-template-rows: auto minmax(0, 1fr);
+    gap: var(--space-4);
+    min-inline-size: 0;
+    padding: var(--app-shell-inset);
+    background: var(--chrome);
+    border-radius: var(--app-shell-radius);
+  }
+  .pui-app-shell[data-sidebar='collapsed'] {
+    --app-shell-sidebar-width: var(--app-shell-rail-width);
+  }
+  .pui-app-shell-header {
+    grid-column: 1 / -1;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--space-3);
+    min-inline-size: 0;
+  }
+  .pui-app-shell-sidebar {
+    display: flex;
+    flex-direction: column;
+    gap: var(--space-3);
+    min-inline-size: 0;
+    min-block-size: 0;
+    padding-inline: var(--space-3);
+  }
+  .pui-app-shell-content {
+    min-inline-size: 0;
+    min-block-size: 0;
+    padding: var(--space-6);
+    background: var(--canvas);
+    border-radius: max(
+      0px,
+      calc(var(--app-shell-radius) - var(--app-shell-inset))
+    );
+    overflow-wrap: anywhere;
+  }
+  .pui-app-shell-footer {
+    margin-block-start: auto;
+    flex: none;
+  }
+  .pui-app-shell-link {
+    display: grid;
+    grid-template-columns: 40px minmax(0, 1fr);
+    align-items: center;
+    min-block-size: 40px;
+    border-radius: var(--radius-md);
+    text-decoration: none;
+    color: var(--ink-body);
+    transition: background-color var(--duration-fast) var(--ease-out);
+  }
+  .pui-app-shell-link:hover {
+    background: var(--interaction-hover-bg);
+  }
+  .pui-app-shell-link:active:not([aria-current='page']) {
+    background: var(--interaction-active-bg);
+  }
+  .pui-app-shell-link[aria-current='page'] {
+    background: var(--selected);
+    color: var(--ink);
+    font-weight: var(--weight-medium);
+  }
+  .pui-app-shell-link:focus-visible {
+    outline: var(--focus-ring-width) solid var(--interaction-focus);
+    outline-offset: var(--focus-ring-inset);
+  }
+  .pui-app-shell-icon {
+    display: grid;
+    place-items: center;
+    inline-size: 40px;
+  }
+  .pui-app-shell-label {
+    min-inline-size: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    padding-inline-end: var(--space-2);
+  }
+  .pui-app-shell[data-sidebar='collapsed'] .pui-app-shell-label {
+    position: absolute;
+    inline-size: 1px;
+    block-size: 1px;
+    padding: 0;
+    clip-path: inset(50%);
+    overflow: hidden;
+  }
+  @media (max-width: 760px) {
+    .pui-app-shell {
+      grid-template-columns: minmax(0, 1fr);
+      grid-template-rows: auto minmax(0, 1fr);
+    }
+    .pui-app-shell-sidebar {
+      display: none;
+    }
+    .pui-app-shell-content {
+      padding: var(--space-4);
+    }
+  }
+  @media (max-width: 760px), (pointer: coarse) {
+    .pui-app-shell-link {
+      min-block-size: var(--control-target-size);
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .pui-app-shell-link {
+      transition: none;
+    }
+  }
+  @media (forced-colors: active) {
+    .pui-app-shell-link[aria-current='page'] {
+      outline: 1px solid Highlight;
+    }
+  }
+  /* Workspace variant: product sidebar owns the brand; the content scrollport is caller-provided. */
+  .pui-app-shell[data-layout='workspace'] {
+    --app-shell-sidebar-width: 224px;
+    --app-shell-rail-width: 72px;
+    grid-template-rows: minmax(0, 1fr);
+    gap: 0;
+    padding: 0;
+    transition: grid-template-columns var(--duration-base) var(--ease-out);
+  }
+  .pui-app-shell[data-layout='workspace'][data-sidebar='collapsed'] {
+    --app-shell-sidebar-width: var(--app-shell-rail-width);
+  }
+  .pui-app-shell[data-layout='workspace'] > .pui-app-shell-sidebar {
+    position: relative;
+    grid-row: 1;
+    grid-column: 1;
+    gap: 0;
+    padding: 0;
+    z-index: 1;
+  }
+  .pui-app-shell[data-layout='workspace'] > .pui-app-shell-content {
+    grid-row: 1;
+    grid-column: 2;
+    margin: 0;
+    padding: 0;
+    background: transparent;
+    border-radius: 0;
+  }
+  /* The page surface: concentric with the shell, inset on every side but the
+   * sidebar's. Stretch or size it from its container: a percentage height here
+   * would resolve against a scroll content that sizes from the page itself. */
+  .pui-app-shell-page {
+    box-sizing: border-box;
+    min-inline-size: 0;
+    margin: var(--app-shell-inset);
+    margin-inline-start: 0;
+    padding: var(--space-6);
+    background: var(--canvas);
+    border-radius: max(
+      0px,
+      calc(var(--app-shell-radius) - var(--app-shell-inset))
+    );
+  }
+  /* Without the sidebar the page insets evenly. Below a mobile header it starts flush. */
+  @media (max-width: 760px) {
+    .pui-app-shell-page {
+      margin: var(--app-shell-inset);
+      padding: var(--space-4);
+    }
+    .pui-app-shell:has(> .pui-app-shell-header) .pui-app-shell-page {
+      margin-block-start: 0;
+    }
+  }
+  .pui-app-shell[data-layout='workspace'] .pui-app-shell-footer {
+    padding: var(--space-4);
+  }
+  .pui-app-shell[data-layout='workspace'] .pui-app-shell-label {
+    transition:
+      opacity 80ms var(--ease-out) 160ms,
+      visibility 0s 160ms;
+  }
+  .pui-app-shell[data-layout='workspace'][data-sidebar='collapsed']
+    .pui-app-shell-label {
+    opacity: 0;
+    visibility: hidden;
+    transition: none;
+  }
+  @media (min-width: 761px) {
+    .pui-app-shell[data-layout='workspace'] > .pui-app-shell-header {
+      display: none;
+    }
+  }
+  @media (max-width: 760px) {
+    .pui-app-shell[data-layout='workspace'] {
+      grid-template-columns: minmax(0, 1fr);
+      grid-template-rows: auto minmax(0, 1fr);
+    }
+    .pui-app-shell[data-layout='workspace'] > .pui-app-shell-header {
+      padding: var(--space-3);
+    }
+    .pui-app-shell[data-layout='workspace'] > .pui-app-shell-content {
+      grid-column: 1;
+      grid-row: 2;
+      margin: 0;
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .pui-app-shell[data-layout='workspace'],
+    .pui-app-shell[data-layout='workspace'] .pui-app-shell-label {
+      transition: none;
+    }
+  }
+}

package/dist/css/rules/autocomplete.css

@@ -0,0 +1,3 @@
+/* Autocomplete, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;

package/dist/css/rules/avatar.css

@@ -0,0 +1,17 @@
+/* Avatar, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.sizes {
+  :where([data-ui-size], [data-ui-size] *).pui-avatar {
+    width: var(--ui-avatar);
+    height: var(--ui-avatar);
+  }
+  :where([data-ui-size], [data-ui-size] *).pui-avatar[data-ui-size] {
+    font-size: clamp(
+      var(--type-caption-size),
+      calc(var(--ui-avatar) / 3),
+      var(--size-font-large)
+    );
+  }
+}

package/dist/css/rules/badge.css

@@ -0,0 +1,17 @@
+/* Badge / Status, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.sizes {
+  :where([data-ui-size], [data-ui-size] *).pui-badge {
+    padding: var(--ui-badge-padding-y) var(--ui-badge-padding-x);
+    font-size: var(--ui-badge-font);
+  }
+  @media (forced-colors: active) {
+    :where([data-ui-size], [data-ui-size] *).pui-badge {
+      border: 1px solid CanvasText;
+      padding: calc(var(--ui-badge-padding-y) - 1px)
+        calc(var(--ui-badge-padding-x) - 1px);
+    }
+  }
+}

package/dist/css/rules/bar.css

@@ -0,0 +1,38 @@
+/* Shared by ToggleGroup, Toolbar and Menubar, and the pressed state of their items. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.components {
+  .pui-toggle-group,
+  .pui-toolbar,
+  .pui-menubar {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--space-1);
+    min-width: 0;
+  }
+  .pui-toggle-group[data-orientation='vertical'],
+  .pui-toolbar[data-orientation='vertical'],
+  .pui-menubar[data-orientation='vertical'] {
+    flex-direction: column;
+    align-items: flex-start;
+    width: fit-content;
+    max-width: 100%;
+  }
+  .pui-toggle,
+  .pui-toolbar-button {
+    position: relative;
+  }
+  @media (forced-colors: active) {
+    .pui-toggle[data-pressed]::after,
+    .pui-toolbar-button[aria-pressed='true']::after {
+      content: '';
+      position: absolute;
+      inset: 3px;
+      border: 1px solid CanvasText;
+      border-radius: inherit;
+      pointer-events: none;
+    }
+  }
+}

package/dist/css/rules/base.css

@@ -0,0 +1,46 @@
+/* Shared by every component stylesheet: the tokens, and rules with no specificity. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.components {
+  @keyframes pui-progress-pulse {
+    50% {
+      opacity: 0.45;
+    }
+  }
+  /* Touch feedback is each control's own hover and pressed layer, drawn in its own
+     shape. The browser's tap highlight is a rectangle over the box, so it is off. */
+  :where(
+    .pui-button,
+    .pui-tabs-tab,
+    .pui-disclosure-trigger,
+    .pui-app-shell-link,
+    .pui-tree-item,
+    .pui-tree-toggle,
+    .pui-chart-legend-button,
+    .pui-checkbox,
+    .pui-radio,
+    .pui-switch,
+    .pui-choice-label,
+    .pui-select-trigger,
+    .pui-select-item,
+    .pui-combobox-item,
+    .pui-combobox-action,
+    .pui-combobox-chip-remove,
+    .pui-menu-item,
+    .pui-navigation-trigger,
+    .pui-navigation-link,
+    .pui-link,
+    .pui-breadcrumb-item a,
+    .pui-calendar-day,
+    .pui-calendar-nav,
+    .pui-date-trigger,
+    .pui-file-trigger,
+    .pui-number-step,
+    .pui-slider-control,
+    .pui-toast-action,
+    .pui-toast-close
+  ) {
+    -webkit-tap-highlight-color: transparent;
+  }
+}

package/dist/css/rules/bottom-navigation.css

@@ -0,0 +1,142 @@
+/* Bottom navigation, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.components {
+  /* The phone's chrome along the bottom edge, as the sidebar is on wider screens. It
+     shows where AppShell hides the sidebar, and pads the home indicator's safe area. */
+  .pui-bottom-nav {
+    box-sizing: border-box;
+    display: none;
+    inline-size: 100%;
+    padding-block-end: env(safe-area-inset-bottom, 0px);
+    border-block-start: 1px solid var(--line);
+    background: var(--chrome);
+  }
+  .pui-bottom-nav[data-visible='always'] {
+    display: block;
+  }
+  @media (max-width: 760px) {
+    .pui-bottom-nav {
+      display: block;
+    }
+  }
+  .pui-bottom-nav[data-position='fixed'] {
+    position: fixed;
+    inset-inline: 0;
+    inset-block-end: 0;
+    z-index: var(--layer-chrome);
+  }
+  .pui-bottom-nav-list {
+    display: flex;
+    block-size: var(--size-bottom-navigation);
+    margin: 0;
+    padding: 0 var(--space-1);
+    list-style: none;
+  }
+  .pui-bottom-nav-entry {
+    display: flex;
+    flex: 1 1 0;
+    min-inline-size: 0;
+  }
+  .pui-bottom-nav-item {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--space-1);
+    min-inline-size: 0;
+    min-block-size: var(--control-target-size);
+    color: var(--ink-muted);
+    font: var(--weight-medium)
+      var(--type-caption-size)/var(--type-caption-leading) var(--font-body);
+    letter-spacing: var(--type-caption-tracking);
+    text-decoration: none;
+    -webkit-tap-highlight-color: transparent;
+  }
+  /* The icon sits in a pill: the current destination fills it, touch presses it. */
+  .pui-bottom-nav-icon {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--space-1) var(--space-4);
+    border-radius: var(--radius-full);
+    transition: background-color var(--duration-fast) var(--ease-out);
+  }
+  /* Icons take the medium size here unless their own size prop sets one. */
+  .pui-bottom-nav-icon > .pui-icon:not([data-size]) {
+    width: var(--icon-size-md);
+    height: var(--icon-size-md);
+  }
+  .pui-bottom-nav-item[aria-current='page'] {
+    color: var(--ink);
+  }
+  .pui-bottom-nav-item[aria-current='page'] .pui-bottom-nav-icon {
+    background: var(--selected);
+  }
+  @media (hover: hover) {
+    .pui-bottom-nav-item:hover .pui-bottom-nav-icon {
+      background-image: linear-gradient(
+        var(--interaction-hover-bg),
+        var(--interaction-hover-bg)
+      );
+    }
+  }
+  .pui-bottom-nav-item:active .pui-bottom-nav-icon {
+    background-image: linear-gradient(
+      var(--interaction-active-bg),
+      var(--interaction-active-bg)
+    );
+  }
+  .pui-bottom-nav-item:focus-visible {
+    outline: var(--focus-ring-width) solid var(--interaction-focus);
+    outline-offset: var(--focus-ring-inset);
+    border-radius: var(--radius-md);
+  }
+  .pui-bottom-nav-label {
+    max-inline-size: 100%;
+    padding-inline: var(--space-1);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+  /* A count or a dot at the pill's top corner, in the danger color. */
+  .pui-bottom-nav-badge {
+    position: absolute;
+    inset-block-start: calc(-1 * var(--space-1));
+    inset-inline-start: calc(50% + var(--space-1));
+    box-sizing: border-box;
+    min-inline-size: calc(var(--type-caption-leading) * 1em);
+    padding-inline: var(--space-1);
+    border-radius: var(--radius-full);
+    background: var(--status-danger-fg);
+    color: var(--canvas);
+    font-variant-numeric: tabular-nums;
+    text-align: center;
+  }
+  .pui-bottom-nav-badge[data-dot] {
+    inset-block-start: 0;
+    min-inline-size: 0;
+    inline-size: var(--space-2);
+    block-size: var(--space-2);
+    padding: 0;
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .pui-bottom-nav-icon {
+      transition: none;
+    }
+  }
+  @media (forced-colors: active) {
+    .pui-bottom-nav {
+      border-block-start-color: CanvasText;
+    }
+    .pui-bottom-nav-item[aria-current='page'] .pui-bottom-nav-icon {
+      outline: 1px solid Highlight;
+    }
+    .pui-bottom-nav-badge {
+      border: 1px solid CanvasText;
+    }
+  }
+}

package/dist/css/rules/breadcrumbs.css

@@ -0,0 +1,9 @@
+/* Breadcrumbs, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.sizes {
+  :where([data-ui-size], [data-ui-size] *):is(.pui-breadcrumbs) {
+    font-size: var(--ui-font);
+  }
+}

package/dist/css/rules/button.css

@@ -0,0 +1,131 @@
+/* Button, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.components {
+  .pui-button {
+    box-sizing: border-box;
+    height: var(--control-height);
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--space-2);
+    min-height: var(--control-height);
+    padding: 0 var(--size-button-padding-default);
+    border: 1px solid transparent;
+    border-radius: var(--radius-full);
+    font: var(--weight-medium) var(--type-label-size)/var(--type-label-leading)
+      var(--font-body);
+    letter-spacing: var(--type-label-tracking);
+    color: var(--ink);
+    background: var(--canvas);
+    /* A link rendered as a button drops the user-agent underline. */
+    text-decoration: none;
+    cursor: pointer;
+  }
+  .pui-button:is([data-variant='default'], [data-variant='primary']) {
+    /* On the brand fill the layer is its ink: light ink barely moves bright cyan. */
+    --interaction-hover-bg: oklch(from var(--on-brand) l c h / 0.08);
+    --interaction-active-bg: oklch(from var(--on-brand) l c h / 0.14);
+    background: var(--brand);
+    border-color: transparent;
+    color: var(--on-brand);
+  }
+  .pui-button[data-variant='outline'] {
+    border-color: var(--line);
+    background: transparent;
+  }
+  .pui-button[data-variant='ghost'] {
+    border-color: transparent;
+    background: transparent;
+  }
+  /* Hover adds the state layer over the variant's own fill, so a primary, a
+     pressed toggle and a transparent toolbar button all step by the same amount. */
+  .pui-button:hover:not(:disabled, [data-disabled], [data-variant='link']) {
+    background-image: linear-gradient(
+      var(--interaction-hover-bg),
+      var(--interaction-hover-bg)
+    );
+  }
+  .pui-button[data-variant='link']:hover:not(:disabled, [data-disabled]) {
+    text-decoration-thickness: 2px;
+  }
+  .pui-button:focus-visible {
+    outline: var(--focus-ring-width) solid var(--interaction-focus);
+    outline-offset: var(--focus-ring-offset);
+  }
+  .pui-button:is(:disabled, [data-disabled], [aria-disabled='true']) {
+    opacity: var(--control-disabled-opacity);
+    cursor: not-allowed;
+  }
+  /* Touch targets grow on narrow screens and on touch, as --control-height does. */
+  @media (max-width: 760px), (pointer: coarse) {
+    .pui-button {
+      min-height: var(--control-target-size);
+    }
+  }
+  .pui-button[data-variant='secondary'] {
+    background: var(--selected);
+    color: var(--ink);
+  }
+  .pui-button[data-variant='destructive'] {
+    background: var(--status-danger-bg);
+    color: var(--status-danger-fg);
+    border-color: transparent;
+  }
+  .pui-button[data-variant='link'] {
+    background: transparent;
+    color: var(--brand-ink);
+    border-color: transparent;
+    text-decoration: underline;
+  }
+  /* Active feedback is transient; persistent selection belongs to Toggle. */
+  .pui-button:active:not(:disabled, [data-disabled], [data-variant='link']) {
+    background-image: linear-gradient(
+      var(--interaction-active-bg),
+      var(--interaction-active-bg)
+    );
+  }
+  .pui-button[aria-busy='true'] {
+    cursor: progress;
+  }
+  @media (forced-colors: active) {
+    .pui-button {
+      border-color: ButtonText;
+    }
+    .pui-button:active {
+      background-image: none;
+    }
+  }
+}
+@layer surflane.sizes {
+  .pui-button[data-size='xs'] {
+    height: 24px;
+    min-height: 24px;
+    padding-inline: var(--space-2);
+    font-size: var(--type-caption-size);
+    letter-spacing: var(--type-caption-tracking);
+    gap: var(--space-1);
+  }
+  .pui-button[data-size^='icon'] {
+    width: var(--control-height);
+    padding: 0;
+  }
+  :where([data-ui-size], [data-ui-size] *).pui-button {
+    height: var(--control-height);
+    min-height: var(--control-height);
+    padding-inline: var(--ui-button-padding);
+    font-size: var(--ui-font);
+    line-height: var(--ui-leading);
+  }
+  :where([data-ui-size], [data-ui-size] *).pui-button[data-size^='icon'] {
+    inline-size: var(--control-height);
+    block-size: var(--control-height);
+    padding: 0;
+    border-radius: var(--radius-full);
+  }
+  :where([data-ui-size], [data-ui-size] *):is(.pui-button) > svg {
+    inline-size: var(--ui-icon);
+    block-size: var(--ui-icon);
+  }
+}

package/dist/css/rules/card.css

@@ -0,0 +1,10 @@
+/* Card / Surface, with the styles of what it renders. */
+@layer surflane.tokens, surflane.themes, surflane.base, surflane.components,
+  surflane.sizes;
+
+@layer surflane.sizes {
+  :where([data-ui-size], [data-ui-size] *).pui-card {
+    padding: var(--surface-padding, var(--ui-card-padding));
+    gap: var(--ui-surface-padding);
+  }
+}