@udixio/theme 1.0.0-beta.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 vigreux-joël
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+<p align="center">
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="200" alt="Nest Logo" /></a>
+</p>
+
+[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
+[circleci-url]: https://circleci.com/gh/nestjs/nest
+
+  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+    <p align="center">
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
+<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
+<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
+<a href="https://coveralls.io/github/nestjs/nest?branch=master" target="_blank"><img src="https://coveralls.io/repos/github/nestjs/nest/badge.svg?branch=master#9" alt="Coverage" /></a>
+<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
+<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
+<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
+  <a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg"/></a>
+    <a href="https://opencollective.com/nest#sponsor"  target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
+  <a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow"></a>
+</p>
+  <!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
+  [![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
+
+## Description
+
+[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
+
+## Installation
+
+```bash
+$ npm install
+```
+
+## Running the app
+
+```bash
+# development
+$ npm run start
+
+# watch mode
+$ npm run start:dev
+
+# production mode
+$ npm run start:prod
+```
+
+## Test
+
+```bash
+# unit tests
+$ npm run test
+
+# e2e tests
+$ npm run test:e2e
+
+# test coverage
+$ npm run test:cov
+```
+
+## Support
+
+Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
+
+## Stay in touch
+
+- Author - [Kamil Myśliwiec](https://kamilmysliwiec.com)
+- Website - [https://nestjs.com](https://nestjs.com/)
+- Twitter - [@nestframework](https://twitter.com/nestframework)
+
+## License
+
+Nest is [MIT licensed](LICENSE).

package/dist/app.container.d.ts

@@ -0,0 +1,5 @@
+import { AwilixContainer, BuildResolver, DisposableResolver } from 'awilix';
+export type Module = Record<string, BuildResolver<any> & DisposableResolver<any>>;
+export declare function importContainer(container: AwilixContainer, services: Module[]): AwilixContainer<any>;
+declare const AppContainer: AwilixContainer<any>;
+export default AppContainer;

package/dist/app.module.d.ts

@@ -0,0 +1,2 @@
+import { Module } from './app.container';
+export declare const AppModule: Module;

package/dist/app.service.d.ts

@@ -0,0 +1,13 @@
+import { ColorService } from './color';
+import { ThemeService } from './theme';
+import { PluginService } from './plugin/plugin.service';
+export declare class AppService {
+    colorService: ColorService;
+    themeService: ThemeService;
+    pluginService: PluginService;
+    constructor({ colorService, themeService, pluginService, }: {
+        colorService: ColorService;
+        themeService: ThemeService;
+        pluginService: PluginService;
+    });
+}

package/dist/color/color.interface.d.ts

@@ -0,0 +1,8 @@
+import { ColorEntity, ColorOptions } from './entities/color.entity';
+export interface ColorInterface {
+    addColor(key: string, color: ColorOptions): ColorEntity;
+    removeColor(key: string): boolean;
+    getColor(key: string): ColorEntity;
+    updateColor(key: string, newColor: ColorOptions): ColorEntity;
+    getColors(): ReadonlyMap<string, ColorEntity>;
+}

package/dist/color/color.module.d.ts

@@ -0,0 +1,2 @@
+import { Module } from '../app.container';
+export declare const ColorModule: Module;

package/dist/color/entities/color.entity.d.ts

@@ -0,0 +1,42 @@
+import { TonalPalette } from '@material/material-color-utilities';
+import { SchemeEntity } from '../../theme/entities/scheme.entity';
+import { DynamicColor } from '../../material-color-utilities/dynamic_color';
+import { ContrastCurve } from '../../material-color-utilities';
+import { SchemeService } from '../../theme/services/scheme.service';
+import { ColorManagerService } from '../services/color-manager.service';
+export interface ColorOptions {
+    palette: (scheme: SchemeEntity) => TonalPalette;
+    tone: (scheme: SchemeEntity) => number;
+    isBackground?: boolean;
+    background?: (scheme: SchemeEntity) => DynamicColor;
+    secondBackground?: (scheme: SchemeEntity) => DynamicColor;
+    contrastCurve?: ContrastCurve;
+    toneDeltaPair?: (scheme: SchemeEntity) => {
+        roleA: DynamicColor;
+        readonly roleB: DynamicColor;
+        readonly delta: number;
+        readonly polarity: 'darker' | 'lighter' | 'nearer' | 'farther';
+        readonly stayTogether: boolean;
+    };
+}
+export declare class ColorEntity {
+    private option;
+    private schemeService;
+    private colorService;
+    private dynamicColor;
+    constructor(option: ColorOptions & {
+        name: string;
+    }, schemeService: SchemeService, colorService: ColorManagerService);
+    update(args: Partial<ColorOptions & {
+        name: string;
+    }>): void;
+    getHex(): string;
+    getArgb(): number;
+    getRgb(): {
+        r: number;
+        g: number;
+        b: number;
+    };
+    getName(): string;
+    getDynamicColor(): DynamicColor;
+}

package/dist/color/entities/index.d.ts

@@ -0,0 +1 @@
+export * from './color.entity';

package/dist/color/index.d.ts

@@ -0,0 +1,5 @@
+export * from './color.interface';
+export * from './color.module';
+export * from './entities';
+export * from './models';
+export * from './services';

package/dist/color/models/default-color.model.d.ts

@@ -0,0 +1,3 @@
+import { AddColorsOptions } from '../services/color.service';
+export type DynamicColorKey = 'background' | 'onBackground' | 'surface' | 'surfaceDim' | 'surfaceBright' | 'surfaceContainerLowest' | 'surfaceContainerLow' | 'surfaceContainer' | 'surfaceContainerHigh' | 'surfaceContainerHighest' | 'onSurface' | 'surfaceVariant' | 'onSurfaceVariant' | 'inverseSurface' | 'inverseOnSurface' | 'outline' | 'outlineVariant' | 'shadow' | 'scrim' | 'surfaceTint' | 'primary' | 'onPrimary' | 'primaryContainer' | 'onPrimaryContainer' | 'inversePrimary' | 'secondary' | 'onSecondary' | 'secondaryContainer' | 'onSecondaryContainer' | 'tertiary' | 'onTertiary' | 'tertiaryContainer' | 'onTertiaryContainer' | 'error' | 'onError' | 'errorContainer' | 'onErrorContainer' | 'primaryFixed' | 'primaryFixedDim' | 'onPrimaryFixed' | 'onPrimaryFixedVariant' | 'secondaryFixed' | 'secondaryFixedDim' | 'onSecondaryFixed' | 'onSecondaryFixedVariant' | 'tertiaryFixed' | 'tertiaryFixedDim' | 'onTertiaryFixed' | 'onTertiaryFixedVariant';
+export declare const defaultColors: AddColorsOptions;

package/dist/color/models/index.d.ts

@@ -0,0 +1 @@
+export * from './default-color.model';

package/dist/color/services/color-manager.service.d.ts

@@ -0,0 +1,18 @@
+import { DynamicColor } from '../../material-color-utilities/dynamic_color';
+import { SchemeEntity } from '../../theme/entities/scheme.entity';
+import { ColorEntity, ColorOptions } from '../entities/color.entity';
+import { SchemeService } from '../../theme/services/scheme.service';
+import { ColorService } from './color.service';
+export declare const highestSurface: (s: SchemeEntity, colorService: ColorManagerService | ColorService) => DynamicColor;
+export declare class ColorManagerService {
+    private colorMap;
+    private readonly schemeService;
+    constructor({ schemeService }: {
+        schemeService: SchemeService;
+    });
+    createOrUpdate(key: string, args: Partial<ColorOptions>): ColorEntity;
+    remove(key: string): boolean;
+    get(key: string): ColorEntity;
+    getAll(): ReadonlyMap<string, ColorEntity>;
+    addFromPalette(key: string): void;
+}

package/dist/color/services/color.service.d.ts

@@ -0,0 +1,21 @@
+import { ColorManagerService } from './color-manager.service';
+import { ColorInterface } from '../color.interface';
+import { ColorEntity, ColorOptions } from '../entities';
+type AddColors = {
+    colors?: Record<string, Partial<ColorOptions>>;
+    fromPalettes?: string[] | string;
+};
+export type AddColorsOptions = AddColors | ((colorService: ColorService) => AddColors);
+export declare class ColorService implements ColorInterface {
+    private readonly colorManagerService;
+    constructor({ colorManagerService, }: {
+        colorManagerService: ColorManagerService;
+    });
+    getColors(): ReadonlyMap<string, ColorEntity>;
+    addColor(key: string, color: Partial<ColorOptions>): ColorEntity;
+    addColors(args: AddColorsOptions | AddColorsOptions[]): void;
+    getColor(key: string): ColorEntity;
+    removeColor(key: string): boolean;
+    updateColor(key: string, newColor: Partial<ColorOptions>): ColorEntity;
+}
+export {};

package/dist/color/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './color-manager.service';
+export * from './color.service';

package/dist/config/config.interface.d.ts

@@ -0,0 +1,13 @@
+import { VariantEntity } from '../theme';
+import { AddColorsOptions } from '../color';
+import { PluginConstructor } from '../plugin/plugin.service';
+export interface ConfigInterface {
+    sourceColor: string;
+    contrastLevel?: 0;
+    isDark?: boolean;
+    variant?: VariantEntity;
+    colors?: AddColorsOptions | AddColorsOptions[];
+    useDefaultColors?: boolean;
+    palettes?: Record<string, string>;
+    plugins?: (PluginConstructor | [PluginConstructor, object])[];
+}

package/dist/config/config.module.d.ts

@@ -0,0 +1,2 @@
+import { Module } from '../app.container';
+export declare const ConfigModule: Module;

package/dist/config/config.service.d.ts

@@ -0,0 +1,12 @@
+import { ConfigInterface } from './config.interface';
+import { AppService } from '../app.service';
+export declare function defineConfig(configObject: ConfigInterface): ConfigInterface;
+export declare class ConfigService {
+    configPath: string;
+    private appService;
+    constructor({ appService }: {
+        appService: AppService;
+    });
+    loadConfig(): Promise<void>;
+    private getConfig;
+}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from './config.interface';
+export * from './config.module';
+export * from './config.service';

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { default as AppContainer } from './app.container';
+export * from './app.container';
+export * from './app.module';
+export * from './app.service';
+export * from './color';
+export * from './config';
+export * from './main';
+export * from './material-color-utilities';
+export * from './plugin';
+export * from './plugins/tailwind';
+export * from './theme';

package/dist/index.js

@@ -0,0 +1,8 @@
+
+'use strict'
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./theme.cjs.production.min.js')
+} else {
+  module.exports = require('./theme.cjs.development.js')
+}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+import { AppService } from './app.service';
+export declare function bootstrap(): AppService;
+export declare function bootstrapFromConfig(path?: string): Promise<AppService>;

package/dist/material-color-utilities/contrastCurve.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2023 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
+ *
+ *      http://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 class containing a value that changes with the contrast level.
+ *
+ * Usually represents the contrast requirements for a dynamic color on its
+ * background. The four values correspond to values for contrast levels -1.0,
+ * 0.0, 0.5, and 1.0, respectively.
+ */
+export declare class ContrastCurve {
+    readonly low: number;
+    readonly normal: number;
+    readonly medium: number;
+    readonly high: number;
+    /**
+     * Creates a `ContrastCurve` object.
+     *
+     * @param low Value for contrast level -1.0
+     * @param normal Value for contrast level 0.0
+     * @param medium Value for contrast level 0.5
+     * @param high Value for contrast level 1.0
+     */
+    constructor(low: number, normal: number, medium: number, high: number);
+    /**
+     * Returns the value at a given contrast level.
+     *
+     * @param contrastLevel The contrast level. 0.0 is the default (normal); -1.0
+     *     is the lowest; 1.0 is the highest.
+     * @return The value. For contrast ratios, a number between 1.0 and 21.0.
+     */
+    get(contrastLevel: number): number;
+}

package/dist/material-color-utilities/dynamic_color.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2022 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
+ *
+ *      http://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 { Hct, TonalPalette } from '@material/material-color-utilities';
+import { ContrastCurve } from './contrastCurve';
+import { ToneDeltaPair } from './toneDeltaPair';
+import { SchemeEntity } from '../theme/entities/scheme.entity';
+/**
+ * @param name The name of the dynamic color. Defaults to empty.
+ * @param palette Function that provides a TonalPalette given
+ * SchemeEntity. A TonalPalette is defined by a hue and chroma, so this
+ * replaces the need to specify hue/chroma. By providing a tonal palette, when
+ * contrast adjustments are made, intended chroma can be preserved.
+ * @param tone Function that provides a tone given SchemeEntity.
+ * @param isBackground Whether this dynamic color is a background, with
+ * some other color as the foreground. Defaults to false.
+ * @param background The background of the dynamic color (as a function of a
+ *     `SchemeEntity`), if it exists.
+ * @param secondBackground A second background of the dynamic color (as a
+ *     function of a `SchemeEntity`), if it
+ * exists.
+ * @param contrastCurve A `ContrastCurve` object specifying how its contrast
+ * against its background should behave in various contrast levels options.
+ * @param toneDeltaPair A `ToneDeltaPair` object specifying a tone delta
+ * constraint between two colors. One of them must be the color being
+ * constructed.
+ */
+interface FromPaletteOptions {
+    name?: string;
+    palette: (scheme: SchemeEntity) => TonalPalette;
+    tone: (scheme: SchemeEntity) => number;
+    isBackground?: boolean;
+    background?: (scheme: SchemeEntity) => DynamicColor;
+    secondBackground?: (scheme: SchemeEntity) => DynamicColor;
+    contrastCurve?: ContrastCurve;
+    toneDeltaPair?: (scheme: SchemeEntity) => ToneDeltaPair;
+}
+/**
+ * A color that adjusts itself based on UI state provided by SchemeEntity.
+ *
+ * Colors without backgrounds do not change tone when contrast changes. Colors
+ * with backgrounds become closer to their background as contrast lowers, and
+ * further when contrast increases.
+ *
+ * Prefer static constructors. They require either a hexcode, a palette and
+ * tone, or a hue and chroma. Optionally, they can provide a background
+ * DynamicColor.
+ */
+export declare class DynamicColor {
+    readonly name: string;
+    readonly palette: (scheme: SchemeEntity) => TonalPalette;
+    readonly tone: (scheme: SchemeEntity) => number;
+    readonly isBackground: boolean;
+    readonly background?: ((scheme: SchemeEntity) => DynamicColor) | undefined;
+    readonly secondBackground?: ((scheme: SchemeEntity) => DynamicColor) | undefined;
+    readonly contrastCurve?: ContrastCurve | undefined;
+    readonly toneDeltaPair?: ((scheme: SchemeEntity) => ToneDeltaPair) | undefined;
+    private readonly hctCache;
+    /**
+     * The base constructor for DynamicColor.
+     *
+     * _Strongly_ prefer using one of the convenience constructors. This class is
+     * arguably too flexible to ensure it can support any scenario. Functional
+     * arguments allow  overriding without risks that come with subclasses.
+     *
+     * For example, the default behavior of adjust tone at max contrast
+     * to be at a 7.0 ratio with its background is principled and
+     * matches accessibility guidance. That does not mean it's the desired
+     * approach for _every_ design system, and every color pairing,
+     * always, in every case.
+     *
+     * @param name The name of the dynamic color. Defaults to empty.
+     * @param palette Function that provides a TonalPalette given
+     * SchemeEntity. A TonalPalette is defined by a hue and chroma, so this
+     * replaces the need to specify hue/chroma. By providing a tonal palette, when
+     * contrast adjustments are made, intended chroma can be preserved.
+     * @param tone Function that provides a tone, given a SchemeEntity.
+     * @param isBackground Whether this dynamic color is a background, with
+     * some other color as the foreground. Defaults to false.
+     * @param background The background of the dynamic color (as a function of a
+     *     `SchemeEntity`), if it exists.
+     * @param secondBackground A second background of the dynamic color (as a
+     *     function of a `SchemeEntity`), if it
+     * exists.
+     * @param contrastCurve A `ContrastCurve` object specifying how its contrast
+     * against its background should behave in various contrast levels options.
+     * @param toneDeltaPair A `ToneDeltaPair` object specifying a tone delta
+     * constraint between two colors. One of them must be the color being
+     * constructed.
+     */
+    constructor(name: string, palette: (scheme: SchemeEntity) => TonalPalette, tone: (scheme: SchemeEntity) => number, isBackground: boolean, background?: ((scheme: SchemeEntity) => DynamicColor) | undefined, secondBackground?: ((scheme: SchemeEntity) => DynamicColor) | undefined, contrastCurve?: ContrastCurve | undefined, toneDeltaPair?: ((scheme: SchemeEntity) => ToneDeltaPair) | undefined);
+    /**
+     * Create a DynamicColor defined by a TonalPalette and HCT tone.
+     *
+     * @param args Functions with SchemeEntity as input. Must provide a palette
+     * and tone. May provide a background DynamicColor and ToneDeltaConstraint.
+     */
+    static fromPalette(args: FromPaletteOptions): DynamicColor;
+    /**
+     * Given a background tone, find a foreground tone, while ensuring they reach
+     * a contrast ratio that is as close to [ratio] as possible.
+     *
+     * @param bgTone Tone in HCT. Range is 0 to 100, undefined behavior when it
+     *     falls outside that range.
+     * @param ratio The contrast ratio desired between bgTone and the return
+     *     value.
+     */
+    static foregroundTone(bgTone: number, ratio: number): number;
+    /**
+     * Returns whether [tone] prefers a light foreground.
+     *
+     * People prefer white foregrounds on ~T60-70. Observed over time, and also
+     * by Andrew Somers during research for APCA.
+     *
+     * T60 used as to create the smallest discontinuity possible when skipping
+     * down to T49 in order to ensure light foregrounds.
+     * Since `tertiaryContainer` in dark monochrome scheme requires a tone of
+     * 60, it should not be adjusted. Therefore, 60 is excluded here.
+     */
+    static tonePrefersLightForeground(tone: number): boolean;
+    /**
+     * Returns whether [tone] can reach a contrast ratio of 4.5 with a lighter
+     * color.
+     */
+    static toneAllowsLightForeground(tone: number): boolean;
+    /**
+     * Adjust a tone such that white has 4.5 contrast, if the tone is
+     * reasonably close to supporting it.
+     */
+    static enableLightForeground(tone: number): number;
+    /**
+     * Return a ARGB integer (i.e. a hex code).
+     *
+     * @param scheme Defines the conditions of the user interface, for example,
+     * whether or not it is dark mode or light mode, and what the desired
+     * contrast level is.
+     */
+    getArgb(scheme: SchemeEntity): number;
+    /**
+     * Return a color, expressed in the HCT color space, that this
+     * DynamicColor is under the conditions in scheme.
+     *
+     * @param scheme Defines the conditions of the user interface, for example,
+     * whether or not it is dark mode or light mode, and what the desired
+     * contrast level is.
+     */
+    getHct(scheme: SchemeEntity): Hct;
+    /**
+     * Return a tone, T in the HCT color space, that this DynamicColor is under
+     * the conditions in scheme.
+     *
+     * @param scheme Defines the conditions of the user interface, for example,
+     * whether or not it is dark mode or light mode, and what the desired
+     * contrast level is.
+     */
+    getTone(scheme: SchemeEntity): number;
+}
+export {};

package/dist/material-color-utilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './contrastCurve';
+export * from './dynamic_color';
+export * from './toneDeltaPair';

package/dist/material-color-utilities/toneDeltaPair.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2023 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
+ *
+ *      http://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 { DynamicColor } from './dynamic_color';
+/**
+ * Describes the different in tone between colors.
+ */
+export type TonePolarity = 'darker' | 'lighter' | 'nearer' | 'farther';
+/**
+ * Documents a constraint between two DynamicColors, in which their tones must
+ * have a certain distance from each other.
+ *
+ * Prefer a DynamicColor with a background, this is for special cases when
+ * designers want tonal distance, literally contrast, between two colors that
+ * don't have a background / foreground relationship or a contrast guarantee.
+ */
+export declare class ToneDeltaPair {
+    readonly roleA: DynamicColor;
+    readonly roleB: DynamicColor;
+    readonly delta: number;
+    readonly polarity: TonePolarity;
+    readonly stayTogether: boolean;
+    /**
+     * Documents a constraint in tone distance between two DynamicColors.
+     *
+     * The polarity is an adjective that describes "A", compared to "B".
+     *
+     * For instance, ToneDeltaPair(A, B, 15, 'darker', stayTogether) states that
+     * A's tone should be at least 15 darker than B's.
+     *
+     * 'nearer' and 'farther' describes closeness to the surface roles. For
+     * instance, ToneDeltaPair(A, B, 10, 'nearer', stayTogether) states that A
+     * should be 10 lighter than B in light mode, and 10 darker than B in dark
+     * mode.
+     *
+     * @param roleA The first role in a pair.
+     * @param roleB The second role in a pair.
+     * @param delta Required difference between tones. Absolute value, negative
+     * values have undefined behavior.
+     * @param polarity The relative relation between tones of roleA and roleB,
+     * as described above.
+     * @param stayTogether Whether these two roles should stay on the same side of
+     * the "awkward zone" (T50-59). This is necessary for certain cases where
+     * one role has two backgrounds.
+     */
+    constructor(roleA: DynamicColor, roleB: DynamicColor, delta: number, polarity: TonePolarity, stayTogether: boolean);
+}

package/dist/plugin/index.d.ts

@@ -0,0 +1,3 @@
+export * from './plugin.abstract';
+export * from './plugin.module';
+export * from './plugin.service';

package/dist/plugin/plugin.abstract.d.ts

@@ -0,0 +1,6 @@
+import { AppService } from '../app.service';
+export declare abstract class PluginAbstract {
+    static dependencies: (new () => PluginAbstract)[];
+    protected abstract appService: AppService;
+    protected abstract options: object;
+}

package/dist/plugin/plugin.module.d.ts

@@ -0,0 +1,2 @@
+import { Module } from '../app.container';
+export declare const PluginModule: Module;

package/dist/plugin/plugin.service.d.ts

@@ -0,0 +1,10 @@
+import { PluginAbstract } from './plugin.abstract';
+import { AppService } from '../app.service';
+export type PluginConstructor = new (appService: AppService, options: any) => PluginAbstract;
+export declare class PluginService {
+    private pluginInstances;
+    private pluginConstructors;
+    addPlugin(plugin: PluginConstructor, config: object): void;
+    loadPlugins(appService: AppService): void;
+    getPlugin<T extends PluginAbstract>(plugin: new (appService: AppService, options: any) => T): T;
+}

package/dist/plugins/tailwind/Tailwind.plugin.d.ts

@@ -0,0 +1,14 @@
+import { PluginAbstract } from '../../plugin/plugin.abstract';
+import { AppService } from '../../app.service';
+import { Theme } from './main';
+interface TailwindPluginOptions {
+    darkMode: 'class' | 'media';
+}
+export declare class TailwindPlugin extends PluginAbstract {
+    protected appService: AppService;
+    protected options: TailwindPluginOptions;
+    constructor(appService: AppService, options: TailwindPluginOptions);
+    static config(options: TailwindPluginOptions): TailwindPluginOptions;
+    getTheme(): Theme;
+}
+export {};

package/dist/plugins/tailwind/index.d.ts

@@ -0,0 +1,3 @@
+export * from './main';
+export * from './plugins-tailwind';
+export * from './Tailwind.plugin';