@a2ui/web_core 0.8.0 → 0.9.0

package/src/v0_8/styles/type.ts

@@ -1,156 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-export const type = `
-  :host {
-    --default-font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
-    --default-font-family-mono: "Courier New", Courier, monospace;
-  }
-
-  .typography-f-s {
-    font-family: var(--font-family, var(--default-font-family));
-    font-optical-sizing: auto;
-    font-variation-settings: "slnt" 0, "wdth" 100, "GRAD" 0;
-  }
-
-  .typography-f-sf {
-    font-family: var(--font-family-flex, var(--default-font-family));
-    font-optical-sizing: auto;
-  }
-
-  .typography-f-c {
-    font-family: var(--font-family-mono, var(--default-font-family));
-    font-optical-sizing: auto;
-    font-variation-settings: "slnt" 0, "wdth" 100, "GRAD" 0;
-  }
-
-  .typography-v-r {
-    font-variation-settings: "slnt" 0, "wdth" 100, "GRAD" 0, "ROND" 100;
-  }
-
-  .typography-ta-s {
-    text-align: start;
-  }
-
-  .typography-ta-c {
-    text-align: center;
-  }
-
-  .typography-fs-n {
-    font-style: normal;
-  }
-
-  .typography-fs-i {
-    font-style: italic;
-  }
-
-  .typography-sz-ls {
-    font-size: 11px;
-    line-height: 16px;
-  }
-
-  .typography-sz-lm {
-    font-size: 12px;
-    line-height: 16px;
-  }
-
-  .typography-sz-ll {
-    font-size: 14px;
-    line-height: 20px;
-  }
-
-  .typography-sz-bs {
-    font-size: 12px;
-    line-height: 16px;
-  }
-
-  .typography-sz-bm {
-    font-size: 14px;
-    line-height: 20px;
-  }
-
-  .typography-sz-bl {
-    font-size: 16px;
-    line-height: 24px;
-  }
-
-  .typography-sz-ts {
-    font-size: 14px;
-    line-height: 20px;
-  }
-
-  .typography-sz-tm {
-    font-size: 16px;
-    line-height: 24px;
-  }
-
-  .typography-sz-tl {
-    font-size: 22px;
-    line-height: 28px;
-  }
-
-  .typography-sz-hs {
-    font-size: 24px;
-    line-height: 32px;
-  }
-
-  .typography-sz-hm {
-    font-size: 28px;
-    line-height: 36px;
-  }
-
-  .typography-sz-hl {
-    font-size: 32px;
-    line-height: 40px;
-  }
-
-  .typography-sz-ds {
-    font-size: 36px;
-    line-height: 44px;
-  }
-
-  .typography-sz-dm {
-    font-size: 45px;
-    line-height: 52px;
-  }
-
-  .typography-sz-dl {
-    font-size: 57px;
-    line-height: 64px;
-  }
-
-  .typography-ws-p {
-    white-space: pre-line;
-  }
-
-  .typography-ws-nw {
-    white-space: nowrap;
-  }
-
-  .typography-td-none {
-    text-decoration: none;
-  }
-
-  /** Weights **/
-
-  ${new Array(9)
-    .fill(0)
-    .map((_, idx) => {
-      const weight = (idx + 1) * 100;
-      return `.typography-w-${weight} { font-weight: ${weight}; }`;
-    })
-    .join("\n")}
-`;

package/src/v0_8/styles/utils.ts

@@ -1,104 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-import { ColorPalettes } from "../types/colors.js";
-
-export function merge(...classes: Array<Record<string, boolean>>) {
-  const styles: Record<string, boolean> = {};
-  for (const clazz of classes) {
-    for (const [key, val] of Object.entries(clazz)) {
-      const prefix = key.split("-").with(-1, "").join("-");
-      const existingKeys = Object.keys(styles).filter((key) =>
-        key.startsWith(prefix)
-      );
-
-      for (const existingKey of existingKeys) {
-        delete styles[existingKey];
-      }
-
-      styles[key] = val;
-    }
-  }
-
-  return styles;
-}
-
-export function appendToAll(
-  target: Record<string, string[]>,
-  exclusions: string[],
-  ...classes: Array<Record<string, boolean>>
-) {
-  const updatedTarget: Record<string, string[]> = structuredClone(target);
-  // Step through each of the new blocks we've been handed.
-  for (const clazz of classes) {
-    // For each of the items in the list, create the prefix value, e.g., for
-    // typography-f-s reduce to typography-f-. This will allow us to find any
-    // and all matches across the target that have the same prefix and swap them
-    // out for the updated item.
-    for (const key of Object.keys(clazz)) {
-      const prefix = key.split("-").with(-1, "").join("-");
-
-      // Now we have the prefix step through all iteme in the target, and
-      // replace the value in the array when we find it.
-      for (const [tagName, classesToAdd] of Object.entries(updatedTarget)) {
-        if (exclusions.includes(tagName)) {
-          continue;
-        }
-
-        let found = false;
-        for (let t = 0; t < classesToAdd.length; t++) {
-          if (classesToAdd[t].startsWith(prefix)) {
-            found = true;
-
-            // In theory we should be able to break after finding a single
-            // entry here because we shouldn't have items with the same prefix
-            // in the array, but for safety we'll run to the end of the array
-            // and ensure we've captured all possible items with the prefix.
-            classesToAdd[t] = key;
-          }
-        }
-
-        if (!found) {
-          classesToAdd.push(key);
-        }
-      }
-    }
-  }
-
-  return updatedTarget;
-}
-
-export function createThemeStyles(
-  palettes: ColorPalettes
-): Record<string, string> {
-  const styles: Record<string, string> = {};
-  for (const palette of Object.values(palettes)) {
-    for (const [key, val] of Object.entries(palette)) {
-      const prop = toProp(key);
-      styles[prop] = val;
-    }
-  }
-
-  return styles;
-}
-
-export function toProp(key: string) {
-  if (key.startsWith("nv")) {
-    return `--nv-${key.slice(2)}`;
-  }
-
-  return `--${key[0]}-${key.slice(1)}`;
-}

package/src/v0_8/types/client-event.ts

@@ -1,80 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-/**
- * A message from the client describing its capabilities, such as the component
- * catalog it supports. Exactly ONE of the properties in this object must be
- * set.
- */
-
-export type ClientCapabilitiesUri = string;
-export type ClientCapabilitiesDynamic = {
-  components: { [key: string]: unknown };
-  styles: { [key: string]: unknown };
-};
-
-export type ClientCapabilities =
-  | { catalogUri: ClientCapabilitiesUri }
-  | { dynamicCatalog: ClientCapabilitiesDynamic };
-
-/**
- * A message sent from the client to the server. Exactly ONE of the properties
- * in this object must be set.
- */
-export interface ClientToServerMessage {
-  userAction?: UserAction;
-  clientUiCapabilities?: ClientCapabilities;
-  error?: ClientError;
-  /** Demo content */
-  request?: unknown;
-}
-
-/**
- * Represents a user-initiated action, sent from the client to the server.
- */
-export interface UserAction {
-  /**
-   * The name of the action.
-   */
-  name: string;
-  /**
-   * The ID of the surface.
-   */
-  surfaceId: string;
-  /**
-   * The ID of the component that triggered the event.
-   */
-  sourceComponentId: string;
-  /**
-   * An ISO timestamp of when the event occurred.
-   */
-  timestamp: string;
-  /**
-   * A JSON object containing the key-value pairs from the component's
-   * `action.context`, after resolving all data bindings.
-   */
-  context?: {
-    [k: string]: unknown;
-  };
-}
-
-/**
- * A message from the client indicating an error occurred, for example,
- * during UI rendering.
- */
-export interface ClientError {
-  [k: string]: unknown;
-}

package/src/v0_8/types/colors.ts

@@ -1,66 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-type ColorShade =
-  | 0
-  | 5
-  | 10
-  | 15
-  | 20
-  | 25
-  | 30
-  | 35
-  | 40
-  | 50
-  | 60
-  | 70
-  | 80
-  | 90
-  | 95
-  | 98
-  | 99
-  | 100;
-
-export type PaletteKeyVals = "n" | "nv" | "p" | "s" | "t" | "e";
-export const shades: ColorShade[] = [
-  0, 5, 10, 15, 20, 25, 30, 35, 40, 50, 60, 70, 80, 90, 95, 98, 99, 100,
-];
-
-type CreatePalette<Prefix extends PaletteKeyVals> = {
-  [Key in `${Prefix}${ColorShade}`]: string;
-};
-
-export type PaletteKey<Prefix extends PaletteKeyVals> = Array<
-  keyof CreatePalette<Prefix>
->;
-
-export type PaletteKeys = {
-  neutral: PaletteKey<"n">;
-  neutralVariant: PaletteKey<"nv">;
-  primary: PaletteKey<"p">;
-  secondary: PaletteKey<"s">;
-  tertiary: PaletteKey<"t">;
-  error: PaletteKey<"e">;
-};
-
-export type ColorPalettes = {
-  neutral: CreatePalette<"n">;
-  neutralVariant: CreatePalette<"nv">;
-  primary: CreatePalette<"p">;
-  secondary: CreatePalette<"s">;
-  tertiary: CreatePalette<"t">;
-  error: CreatePalette<"e">;
-};

package/src/v0_8/types/components.ts

@@ -1,213 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-import { StringValue } from "./primitives";
-
-export interface Action {
-  /**
-   * A unique name identifying the action (e.g., 'submitForm').
-   */
-  name: string;
-  /**
-   * A key-value map of data bindings to be resolved when the action is triggered.
-   */
-  context?: {
-    key: string;
-    /**
-     * The dynamic value. Define EXACTLY ONE of the nested properties.
-     */
-    value: {
-      /**
-       * A data binding reference to a location in the data model (e.g., '/user/name').
-       */
-      path?: string;
-      /**
-       * A fixed, hardcoded string value.
-       */
-      literalString?: string;
-      literalNumber?: number;
-      literalBoolean?: boolean;
-    };
-  }[];
-}
-
-export interface Text {
-  text: StringValue;
-  usageHint: "h1" | "h2" | "h3" | "h4" | "h5" | "caption" | "body";
-}
-
-export interface Image {
-  url: StringValue;
-  usageHint:
-    | "icon"
-    | "avatar"
-    | "smallFeature"
-    | "mediumFeature"
-    | "largeFeature"
-    | "header";
-  fit?: "contain" | "cover" | "fill" | "none" | "scale-down";
-}
-
-export interface Icon {
-  name: StringValue;
-}
-
-export interface Video {
-  url: StringValue;
-}
-
-export interface AudioPlayer {
-  url: StringValue;
-  /**
-   * A label, title, or placeholder text.
-   */
-  description?: StringValue;
-}
-
-export interface Tabs {
-  /**
-   * A list of tabs, each with a title and a child component ID.
-   */
-  tabItems: {
-    /**
-     * The title of the tab.
-     */
-    title: {
-      /**
-       * A data binding reference to a location in the data model (e.g., '/user/name').
-       */
-      path?: string;
-      /**
-       * A fixed, hardcoded string value.
-       */
-      literalString?: string;
-    };
-    /**
-     * A reference to a component instance by its unique ID.
-     */
-    child: string;
-  }[];
-}
-
-export interface Divider {
-  /**
-   * The orientation.
-   */
-  axis?: "horizontal" | "vertical";
-  /**
-   * The color of the divider (e.g., hex code or semantic name).
-   */
-  color?: string;
-  /**
-   * The thickness of the divider.
-   */
-  thickness?: number;
-}
-
-export interface Modal {
-  /**
-   * The ID of the component (e.g., a button) that triggers the modal.
-   */
-  entryPointChild: string;
-  /**
-   * The ID of the component to display as the modal's content.
-   */
-  contentChild: string;
-}
-
-export interface Button {
-  /**
-   * The ID of the component to display as the button's content.
-   */
-  child: string;
-
-  /**
-   * Represents a user-initiated action.
-   */
-  action: Action;
-}
-
-export interface Checkbox {
-  label: StringValue;
-  value: {
-    /**
-     * A data binding reference to a location in the data model (e.g., '/user/name').
-     */
-    path?: string;
-    literalBoolean?: boolean;
-  };
-}
-
-export interface TextField {
-  text?: StringValue;
-  /**
-   * A label, title, or placeholder text.
-   */
-  label: StringValue;
-  type?: "shortText" | "number" | "date" | "longText";
-  /**
-   * A regex string to validate the input.
-   */
-  validationRegexp?: string;
-}
-
-export interface DateTimeInput {
-  value: StringValue;
-  enableDate?: boolean;
-  enableTime?: boolean;
-  /**
-   * The string format for the output (e.g., 'YYYY-MM-DD').
-   */
-  outputFormat?: string;
-}
-
-export interface MultipleChoice {
-  selections: {
-    /**
-     * A data binding reference to a location in the data model (e.g., '/user/name').
-     */
-    path?: string;
-    literalArray?: string[];
-  };
-  options?: {
-    label: {
-      /**
-       * A data binding reference to a location in the data model (e.g., '/user/name').
-       */
-      path?: string;
-      /**
-       * A fixed, hardcoded string value.
-       */
-      literalString?: string;
-    };
-    value: string;
-  }[];
-  maxAllowedSelections?: number;
-  type?: "checkbox" | "chips";
-  filterable?: boolean;
-}
-
-export interface Slider {
-  value: {
-    /**
-     * A data binding reference to a location in the data model (e.g., '/user/name').
-     */
-    path?: string;
-    literalNumber?: number;
-  };
-  minValue?: number;
-  maxValue?: number;
-}

package/src/v0_8/types/primitives.ts

@@ -1,60 +0,0 @@
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-export declare interface StringValue {
-  /**
-   * A data binding reference to a location in the data model (e.g., '/user/name').
-   */
-  path?: string;
-  /**
-   * A fixed, hardcoded string value.
-   */
-  literalString?: string;
-  /**
-   * A fixed, hardcoded string value.
-   */
-  literal?: string;
-}
-
-export declare interface NumberValue {
-  /**
-   * A data binding reference to a location in the data model (e.g., '/user/name').
-   */
-  path?: string;
-  /**
-   * A fixed, hardcoded number value.
-   */
-  literalNumber?: number;
-  /**
-   * A fixed, hardcoded number value.
-   */
-  literal?: number;
-}
-
-export declare interface BooleanValue {
-  /**
-   * A data binding reference to a location in the data model (e.g., '/user/name').
-   */
-  path?: string;
-  /**
-   * A fixed, hardcoded boolean value.
-   */
-  literalBoolean?: boolean;
-  /**
-   * A fixed, hardcoded boolean value.
-   */
-  literal?: boolean;
-}