@threadlabs/looma 0.33.1 → 0.35.0

package/vue/UiLightEditor.vue

@@ -0,0 +1,402 @@
+<!-- Generated by HTML Next 1.0.0-alpha.69 for Vue 3.5. Do not edit. -->
+<script setup lang="ts">
+import { computed, getCurrentInstance, provide, ref, useTemplateRef, watchSyncEffect } from 'vue'
+import type { PropType } from 'vue'
+import {
+  checkHydratedRoot,
+  concat,
+  createDispatch,
+  nativeAttrs,
+  useComponentHost,
+  useReflectedProp,
+} from './host'
+import { acceptsControllerWrite } from './props'
+import {
+  BINDING_INPUTS_PROP,
+  checkedProp,
+  checkPropInput,
+  type InputBindings,
+  propValidityState,
+  READY_INPUT,
+  requireInputStatus,
+  UNRESOLVED_INPUT,
+  vPropValidity,
+  vuePropInputs,
+} from './props'
+import UiNumberInput from './UiNumberInput.vue'
+
+defineOptions({ inheritAttrs: false })
+
+const propValidityContract = {
+  props: {
+    disabled: {
+      type: { kind: 'terminal', name: 'boolean' },
+      required: false,
+      target: { attribute: 'disabled' },
+      description: 'Prevents pointer, keyboard and exact edits.',
+      default: false,
+    },
+    label: {
+      type: { kind: 'terminal', name: 'string' },
+      required: false,
+      target: { attribute: 'aria-label' },
+      description: 'Accessible name for the position editor.',
+      default: 'Light position',
+    },
+    size: {
+      type: { kind: 'terminal', name: 'keyword' },
+      required: false,
+      target: { attribute: 'size' },
+      description:
+        'Sets both coordinate fields to the shared small, medium or large control height.',
+      values: ['sm', 'md', 'lg'],
+      default: 'md',
+    },
+    x: {
+      type: { kind: 'terminal', name: 'number' },
+      required: false,
+      target: { attribute: 'x' },
+      description:
+        'Horizontal source position from 0 (left) to 1 (right), relative to every surface.',
+      default: 0.5,
+    },
+    y: {
+      type: { kind: 'terminal', name: 'number' },
+      required: false,
+      target: { attribute: 'y' },
+      description:
+        'Vertical source position from 0 (top) to 1 (bottom), relative to every surface.',
+      default: 0,
+    },
+  },
+} as const
+const props = defineProps({
+  disabled: { type: null as unknown as PropType<boolean | null> },
+  label: { type: null as unknown as PropType<string | null> },
+  size: { type: null as unknown as PropType<'sm' | 'md' | 'lg' | null> },
+  x: { type: null as unknown as PropType<number | null> },
+  y: { type: null as unknown as PropType<number | null> },
+  [BINDING_INPUTS_PROP]: { type: null as unknown as PropType<InputBindings> },
+})
+const acceptedProps: Record<string, unknown> = {
+  disabled: false,
+  label: 'Light position',
+  size: 'md',
+  x: 0.5,
+  y: 0,
+}
+const inputTracking = vuePropInputs(acceptedProps, {
+  disabled: false,
+  label: 'Light position',
+  size: 'md',
+  x: 0.5,
+  y: 0,
+}, (name, value, source, values) => {
+  switch (name) {
+    case 'disabled':
+      return checkPropInput(value, { kind: 'terminal', name: 'boolean' }, true, true)
+    case 'label':
+      return checkPropInput(value, { kind: 'terminal', name: 'string' }, true, true)
+    case 'size':
+      return checkPropInput(value, { kind: 'terminal', name: 'keyword' }, true, true)
+    case 'x':
+      return checkPropInput(value, { kind: 'terminal', name: 'number' }, true, true)
+    case 'y':
+      return checkPropInput(value, { kind: 'terminal', name: 'number' }, true, true)
+    default:
+      return { ok: false }
+  }
+}, () => {
+  void checkedProps.value
+})
+const propInputs = inputTracking.inputs
+const checkedProps = computed(() => {
+  void inputTracking.version.value
+  return ({
+    disabled: propInputs.value<boolean | null>(
+      'disabled',
+      props['disabled'],
+      props[BINDING_INPUTS_PROP],
+    ) as boolean,
+    label: propInputs.value<string | null>(
+      'label',
+      props['label'],
+      props[BINDING_INPUTS_PROP],
+    ) as string,
+    size: propInputs.value<'sm' | 'md' | 'lg' | null>(
+      'size',
+      props['size'],
+      props[BINDING_INPUTS_PROP],
+    ) as 'sm' | 'md' | 'lg',
+    x: propInputs.value<number | null>('x', props['x'], props[BINDING_INPUTS_PROP]) as number,
+    y: propInputs.value<number | null>('y', props['y'], props[BINDING_INPUTS_PROP]) as number,
+  })
+})
+const inputStatus = (name: string, handlesError: boolean) => {
+  void checkedProps.value
+  void inputTracking.version.value
+  return requireInputStatus(propInputs.status(name), handlesError)
+}
+void checkedProps.value
+watchSyncEffect(() => {
+  void checkedProps.value
+})
+const reflectedProp = useReflectedProp()
+const hydrationInstance = getCurrentInstance()
+const emit = defineEmits<{
+  'update:x': [value: number]
+  'update:y': [value: number]
+  input: [event: CustomEvent<{ readonly x: number; readonly y: number }>]
+  change: [event: CustomEvent<{ readonly x: number; readonly y: number }>]
+}>()
+
+const root = ref<HTMLElement | null>(null)
+const planeElement = useTemplateRef<HTMLElement>('planeElement')
+const sourceElement = useTemplateRef<HTMLElement>('sourceElement')
+const horizontal = ref('50')
+const vertical = ref('0')
+let guardedPrevious: any = null
+const guarded = computed(() => {
+  const candidate: any = concat(
+    checkedProps.value.label,
+    '. Arrow keys move the source; Shift moves faster.',
+  )
+  if (candidate === Symbol.for('html-next.invalid-result')) return guardedPrevious
+  return guardedPrevious = candidate
+})
+provide('html-next:ui-light-editor:horizontal', horizontal)
+provide('html-next:ui-light-editor:vertical', vertical)
+checkHydratedRoot('span', 'ui-light-editor')
+
+const isInputDetail = (
+  detail: unknown,
+): boolean => (detail !== null && typeof detail === 'object' && !Array.isArray(detail)
+  && (typeof (detail as Record<string, unknown>)['x'] === 'number'
+    && Number.isFinite((detail as Record<string, unknown>)['x']))
+  && (typeof (detail as Record<string, unknown>)['y'] === 'number'
+    && Number.isFinite((detail as Record<string, unknown>)['y']))
+  && Object.keys(detail as object).every((key) => ['x', 'y'].includes(key)))
+const dispatch = createDispatch(root, emit as (name: string, detail: unknown) => void, {
+  checks: {
+    input: isInputDetail,
+    change: isInputDetail,
+  },
+  modeled: ['x', 'y'],
+})
+
+useComponentHost(() => import('../components/ui-light-editor/ui-light-editor.js'), {
+  root,
+  module: true,
+  dispatch,
+  acceptsState: (name: string, keys: readonly string[], value: unknown) =>
+    acceptsControllerWrite(
+      value,
+      ({
+        horizontal: { kind: 'terminal', name: 'string' },
+        vertical: { kind: 'terminal', name: 'string' },
+      } as Record<string, any>)[name],
+      keys,
+    ),
+  initials: { horizontal: '50', vertical: '0' },
+  controllerSource: {
+    specifier: '../components/ui-light-editor/ui-light-editor.js',
+    definition: './components/ui-light-editor/ui-light-editor.html',
+  },
+  props: checkedProps,
+  inputs: propInputs,
+  inputTracking,
+  propInputs: (name: string) => {
+    const incoming = hydrationInstance?.vnode.props
+    const kebab = name.replace(/[A-Z]/g, (letter) => '-' + letter.toLowerCase())
+    return incoming !== null && incoming !== undefined
+      ? (incoming[name] ?? incoming[kebab] ?? null)
+      : null
+  },
+  propNames: ['disabled', 'label', 'size', 'x', 'y'],
+  propValidity: (name: string) =>
+    propValidityState({ contract: propValidityContract, values: { ...props } }, name),
+  refs: { plane: planeElement, source: sourceElement },
+  state: { horizontal, vertical },
+})
+</script>
+
+<template>
+  <span
+    class="ui-light-editor"
+    v-bind="nativeAttrs($attrs)"
+    data-hn
+    data-hn-ui-light-editor
+    v-prop-validity="{ contract: propValidityContract, values: { ...props } }"
+    :data-ui-light-editor-prop-disabled="reflectedProp('disabled', 'disabled', checkedProps.disabled, undefined, false)"
+    :data-ui-light-editor-prop-label="reflectedProp('label', 'label', checkedProps.label, undefined, false)"
+    :data-ui-light-editor-prop-size="reflectedProp('size', 'size', checkedProps.size, undefined, false)"
+    :data-ui-light-editor-prop-x="reflectedProp('x', 'x', checkedProps.x, undefined, false)"
+    :data-ui-light-editor-prop-y="reflectedProp('y', 'y', checkedProps.y, undefined, false)"
+    ref="root"
+  ><span
+      class="stage"
+      role="group"
+      data-hn-ui-light-editor
+      :aria-label="checkedProps.label ?? undefined"
+    ><span class="plane" data-hn-ui-light-editor ref="planeElement"><svg
+          viewBox="0 0 100 60"
+          preserveAspectRatio="none"
+          aria-hidden="true"
+          data-hn-ui-light-editor
+        >
+          <path d="M0 30 H100 M50 0 V60" data-hn-ui-light-editor></path>
+        </svg>{{ ' ' }}<span class="specimen" data-hn-ui-light-editor><slot /></span>{{
+          ' '
+        }}<button
+          type="button"
+          class="source"
+          data-hn-ui-light-editor
+          :disabled="checkedProps.disabled ?? undefined"
+          :aria-label="guarded"
+          ref="sourceElement"
+        >
+        </button></span></span>{{ ' ' }}<span
+      class="coordinates"
+      data-hn-ui-light-editor
+    ><UiNumberInput
+        class="ui-number-input"
+        data-coordinate="x"
+        :min="0"
+        :max="100"
+        :step="1"
+        unit="%"
+        label="Light horizontal position"
+        :value="horizontal"
+        :size="checkedProps.size"
+        :disabled="checkedProps.disabled"
+        v-bind="{
+          [BINDING_INPUTS_PROP]: {
+            size: () => ({ value: checkedProps.size, status: inputStatus('size', true) }),
+            disabled: () => ({ value: checkedProps.disabled, status: inputStatus('disabled', true) }),
+          },
+        }"
+      />{{ ' ' }}<UiNumberInput
+        class="ui-number-input"
+        data-coordinate="y"
+        :min="0"
+        :max="100"
+        :step="1"
+        unit="%"
+        label="Light vertical position"
+        :value="vertical"
+        :size="checkedProps.size"
+        :disabled="checkedProps.disabled"
+        v-bind="{
+          [BINDING_INPUTS_PROP]: {
+            size: () => ({ value: checkedProps.size, status: inputStatus('size', true) }),
+            disabled: () => ({ value: checkedProps.disabled, status: inputStatus('disabled', true) }),
+          },
+        }"
+      /></span>{{ ' ' }}<span class="hint" data-hn-ui-light-editor
+    >Drag the light, use arrow keys, or enter its position. Top centre is 50%, 0%.</span></span>
+</template>
+
+<style scoped>
+@scope (.ui-light-editor) to ([data-hn]) {
+  :global(:scope:where([data-hn-ui-light-editor])) {
+    display: grid !important;
+    gap: var(--ui-space-3) !important;
+    min-inline-size: 0;
+    padding: 0 !important;
+    margin: 0 !important;
+  }
+  :global(.stage:where([data-hn-ui-light-editor])) {
+    box-sizing: border-box !important;
+    display: block !important;
+    block-size: 13rem;
+    padding: calc(var(--ui-control-min-block-size) / 2) !important;
+    border: var(--ui-border-width) solid var(--ui-control-border);
+    border-radius: var(--ui-field-radius, var(--ui-radius-md));
+    background: var(--ui-neutral-surface, var(--ui-surface));
+  }
+  :global(.plane:where([data-hn-ui-light-editor])) {
+    position: relative;
+    display: block !important;
+    inline-size: 100%;
+    block-size: 100%;
+  }
+  :global(svg:where([data-hn-ui-light-editor])) {
+    inline-size: 100%;
+    block-size: 100%;
+    overflow: visible;
+  }
+  :global(path:where([data-hn-ui-light-editor])) {
+    fill: none;
+    stroke: var(--ui-border);
+    stroke-width: 1;
+    vector-effect: non-scaling-stroke;
+  }
+  :global(.specimen:where([data-hn-ui-light-editor])) {
+    position: absolute;
+    inset: 0;
+    display: grid !important;
+    place-items: center !important;
+  }
+  :global(.source:where([data-hn-ui-light-editor])) {
+    position: absolute;
+    left: 50%;
+    top: 0;
+    translate: -50% -50%;
+    display: grid !important;
+    place-items: center !important;
+    inline-size: max(2rem, var(--ui-control-min-block-size));
+    block-size: max(2rem, var(--ui-control-min-block-size));
+    padding: 0 !important;
+    margin: 0 !important;
+    border: 0;
+    border-radius: 50%;
+    background: transparent;
+    cursor: grab;
+    touch-action: none;
+  }
+  :global(.source:where([data-hn-ui-light-editor])::after) {
+    content: "";
+    inline-size: 1rem;
+    block-size: 1rem;
+    border: var(--ui-border-width) solid var(--ui-accent);
+    border-radius: 50%;
+    background: var(--ui-surface-raised);
+    box-shadow:
+      0 0 0 var(--ui-space-2) color-mix(in srgb, var(--ui-accent) 12%, transparent),
+      var(--ui-shadow-sm);
+  }
+  :global(.source:active:where([data-hn-ui-light-editor])) {
+    cursor: grabbing;
+  }
+  :global(.source:focus-visible:where([data-hn-ui-light-editor])) {
+    outline: var(--ui-focus-width) solid var(--ui-focus-ring);
+    outline-offset: var(--ui-space-1);
+  }
+  :global(.source:disabled:where([data-hn-ui-light-editor])) {
+    cursor: not-allowed;
+  }
+  :global(.source:disabled:where([data-hn-ui-light-editor])::after) {
+    background: var(--ui-disabled-surface);
+    border-color: var(--ui-disabled-border);
+    box-shadow: none;
+  }
+  :global(.coordinates:where([data-hn-ui-light-editor])) {
+    display: grid !important;
+    grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+    gap: var(--ui-space-2) !important;
+  }
+  :global(.hint:where([data-hn-ui-light-editor])) {
+    font-size: var(--ui-font-size-sm);
+    color: var(--ui-text-secondary);
+  }
+  @media (forced-colors: active) {
+    :global(.source:where([data-hn-ui-light-editor])::after) {
+      background: Canvas;
+      border-color: CanvasText;
+    }
+    :global(.source:focus-visible:where([data-hn-ui-light-editor])) {
+      outline-color: Highlight;
+    }
+  }
+}
+</style>

package/vue/UiMenu.vue

@@ -352,6 +352,9 @@ useComponentHost(() => import('../components/ui-menu/ui-menu.js'), {
 
 /* Small follows its trigger down: an item's own hooks still win. */
 
+/* Purpose and measured size shape one shared separation lever. The content plane stays opaque;
+   transparency, saturation and edge light belong to the surrounding decorative material. */
+
 @scope (.ui-menu) to ([data-hn]) {
   :global(:scope[data-ui-menu-state~="density=compact"]:where([data-hn-ui-menu])) {
     --_ui-default-menu-item-padding-block: var(--ui-space-1);
@@ -378,6 +381,7 @@ useComponentHost(() => import('../components/ui-menu/ui-menu.js'), {
   }
 
   :global(:scope:where([data-hn-ui-menu])) {
+    --_ui-material-scale: 0.28;
     --_ui-menu-surface: var(--ui-menu-surface);
     --_ui-menu-border: var(--ui-menu-border);
     --_ui-menu-radius: var(--ui-menu-radius);
@@ -422,6 +426,93 @@ useComponentHost(() => import('../components/ui-menu/ui-menu.js'), {
     max-block-size: inherit;
     overflow: auto;
   }
+  :global(:scope:not([inline]) .surface:where([data-hn-ui-menu])) {
+    --_ui-material-glassiness: clamp(0, var(--ui-glassiness, 0), 1);
+    --_ui-material-separation: clamp(0, var(--ui-surface-separation, 0), 1);
+    --_ui-material-active: clamp(
+      0,
+      calc((var(--_ui-material-glassiness) + var(--_ui-material-separation)) * 100000),
+      1
+    );
+    --_ui-material-rim: calc(
+      (
+        var(--_ui-material-separation) + var(--_ui-material-glassiness) * 0.25
+      ) *
+        var(--_ui-material-scale, 0.28) *
+        8px
+    );
+    --_ui-material-content-color: var(
+      --_ui-menu-surface,
+      var(--ui-material-content, var(--ui-overlay-surface, var(--ui-surface-elevated)))
+    );
+    --_ui-material-rim-color: color-mix(
+      in srgb,
+      var(--ui-material-glass, var(--ui-surface-elevated)) calc(var(--_ui-material-active) * 100%),
+      transparent
+    );
+    background:
+      var(--ui-surface-highlight, linear-gradient(transparent, transparent)) padding-box,
+      linear-gradient(var(--_ui-material-content-color), var(--_ui-material-content-color))
+      padding-box,
+      linear-gradient(var(--_ui-material-rim-color), var(--_ui-material-rim-color)) border-box,
+      var(--_ui-material-content-color) padding-box;
+    border-width: calc(var(--ui-border-width) + var(--_ui-material-rim));
+    border-color: var(
+      --_ui-menu-border,
+      color-mix(
+        in oklab,
+        var(--ui-overlay-border, var(--ui-border-strong)) calc(
+          (1 - var(--_ui-material-active)) * 100%
+        ),
+        transparent
+      )
+    );
+    box-shadow: var(
+      --_ui-menu-shadow,
+      var(
+        --ui-overlay-shadow,
+        0 calc(var(--_ui-material-separation) * var(--_ui-material-scale, 0.28) * 8px) calc(
+          var(--_ui-material-separation) * var(--_ui-material-scale, 0.28) * 24px
+        ) color-mix(in oklab, var(--ui-text-primary) 15%, transparent),
+        var(--ui-material-glow, 0 0 transparent),
+        inset 0 0 0 calc(var(--_ui-material-active) * var(--ui-border-width)) var(
+          --ui-material-edge,
+          var(--ui-border-strong)
+        ),
+        var(--ui-elevation-overlay, var(--ui-shadow-lg))
+      )
+    );
+    backdrop-filter: blur(
+      calc(var(--_ui-material-glassiness) * var(--_ui-material-scale, 0.28) * 18px)
+    ) saturate(calc(1 + var(--_ui-material-glassiness) * var(--_ui-material-scale, 0.28) * 0.18));
+    -webkit-backdrop-filter: blur(
+      calc(var(--_ui-material-glassiness) * var(--_ui-material-scale, 0.28) * 18px)
+    ) saturate(calc(1 + var(--_ui-material-glassiness) * var(--_ui-material-scale, 0.28) * 0.18));
+  }
+
+  @supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
+    :global(:scope:not([inline]) .surface:where([data-hn-ui-menu])) {
+      background: var(--_ui-material-content-color);
+    }
+  }
+
+  @media (prefers-reduced-transparency: reduce) {
+    :global(:scope:not([inline]) .surface:where([data-hn-ui-menu])) {
+      background: var(--_ui-material-content-color);
+      backdrop-filter: none;
+      -webkit-backdrop-filter: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    :global(:scope:not([inline]) .surface:where([data-hn-ui-menu])) {
+      background: Canvas;
+      border-color: CanvasText;
+      box-shadow: none;
+      backdrop-filter: none;
+      -webkit-backdrop-filter: none;
+    }
+  }
 
   :global(.surface hr:where([data-hn-ui-menu])) {
     align-self: stretch;

package/vue/UiNumberInput.d.ts

@@ -0,0 +1,83 @@
+import type { PropType } from 'vue';
+import { type InputBindings } from './props.js';
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    disabled: {
+        type: PropType<boolean | null>;
+    };
+    label: {
+        type: PropType<string | null>;
+    };
+    max: {
+        type: PropType<number | null>;
+    };
+    min: {
+        type: PropType<number | null>;
+    };
+    name: {
+        type: PropType<string | null>;
+    };
+    size: {
+        type: PropType<"sm" | "md" | "lg" | null>;
+    };
+    step: {
+        type: PropType<number | null>;
+    };
+    unit: {
+        type: PropType<string | null>;
+    };
+    value: {
+        type: PropType<string | null>;
+    };
+    "\0htmlNextInputStatus": {
+        type: PropType<InputBindings>;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    input: (event: CustomEvent<{
+        readonly value: string;
+    }>) => any;
+    change: (event: CustomEvent<{
+        readonly value: string;
+    }>) => any;
+    "update:value": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    disabled: {
+        type: PropType<boolean | null>;
+    };
+    label: {
+        type: PropType<string | null>;
+    };
+    max: {
+        type: PropType<number | null>;
+    };
+    min: {
+        type: PropType<number | null>;
+    };
+    name: {
+        type: PropType<string | null>;
+    };
+    size: {
+        type: PropType<"sm" | "md" | "lg" | null>;
+    };
+    step: {
+        type: PropType<number | null>;
+    };
+    unit: {
+        type: PropType<string | null>;
+    };
+    value: {
+        type: PropType<string | null>;
+    };
+    "\0htmlNextInputStatus": {
+        type: PropType<InputBindings>;
+    };
+}>> & Readonly<{
+    onInput?: ((event: CustomEvent<{
+        readonly value: string;
+    }>) => any) | undefined;
+    onChange?: ((event: CustomEvent<{
+        readonly value: string;
+    }>) => any) | undefined;
+    "onUpdate:value"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/vue/UiNumberInput.js

@@ -0,0 +1,2 @@
+import { t as UiNumberInput_default } from "./chunks/UiNumberInput.js";
+export { UiNumberInput_default as default };