@sanity/themer 0.3.14 → 0.3.16

package/README.md

@@ -63,51 +63,16 @@ If the Studio already uses a `buildTheme` theme, pass the same options so the to
 
 ## Migrating from themer.sanity.build
 
-This package is also the npm migration path off the hosted Themer service ([themer.sanity.build](https://themer.sanity.build)) — the generator runs locally, so Studio configs no longer need to import modules from a hosted URL.
+The npm migration path off the hosted Themer service ([themer.sanity.build](https://themer.sanity.build)) is [`@sanity/themer-legacy`](https://www.npmjs.com/package/@sanity/themer-legacy): the exact same generator, running locally.
 
-`@sanity/themer/legacy` generates the exact same colors as the hosted service, with the same `createTheme`, `hues` and `theme` exports that `https://themer.sanity.build/api/hues` served. Replace the URL import with `buildThemeFromUrl` and the URL as a string:
+`@sanity/themer/legacy` still works as a deprecated re-export of that package until `@sanity/themer@1.0` removes it; import from `@sanity/themer-legacy` instead. Migrating a hosted URL import looks like this:
 
-```ts
-// Before:
-import {theme} from 'https://themer.sanity.build/api/hues?preset=verdant&primary=22fca8'
-
-// After:
-import {buildThemeFromUrl} from '@sanity/themer/legacy'
-
-const theme = buildThemeFromUrl(
-  'https://themer.sanity.build/api/hues?preset=verdant&primary=22fca8',
-)
-```
-
-Configs that used `createTheme` and `hues` from the URL import work the same way with `parseHuesFromUrl`:
-
-```ts
-// Before:
-// import {createTheme, hues} from 'https://themer.sanity.build/api/hues?preset=verdant'
-
-// After:
-import {createTheme, parseHuesFromUrl} from '@sanity/themer/legacy'
-
-const hues = parseHuesFromUrl('https://themer.sanity.build/api/hues?preset=verdant')
-
-export default defineConfig({
-  theme: createTheme({...hues, primary: {...hues.primary, mid: '#22fca8'}}),
-  // ...rest of the config
-})
-```
-
-The hosted presets are addressed by query, exactly like the service:
-
-```ts
-import {buildThemeFromUrl} from '@sanity/themer/legacy'
-
-const theme = buildThemeFromUrl('?preset=verdant')
+```diff
+-import {theme} from 'https://themer.sanity.build/api/hues?preset=verdant&primary=22fca8'
++import {buildThemeFromUrl} from '@sanity/themer-legacy'
++const theme = buildThemeFromUrl('https://themer.sanity.build/api/hues?preset=verdant&primary=22fca8')
 ```
 
-Once migrated, remove any `themer.d.ts` module declarations and `urlImports` config that the URL imports needed.
-
-The generated theme carries no `__themer` flag, which is the one intentional difference from the hosted module. Sanity Studio uses that flag to throw away the fonts the hosted module bundled, because they had drifted from the Studio's own; here the fonts come from the `@sanity/ui` installed next to the Studio, so there is nothing to throw away.
-
 ## License
 
 MIT © Sanity.io — see [LICENSE](https://github.com/sanity-io/ui/blob/main/LICENSE)

package/dist/index.js

@@ -1,2 +1,2 @@
-import { n as buildTheme, r as buildPalette, t as presets } from "./presets-DWzYcsLg.js";
+import { n as buildTheme, r as buildPalette, t as presets } from "./presets-By3s-D-S.js";
 export { buildPalette, buildTheme, presets };

package/dist/legacy.d.ts

@@ -1,155 +1,80 @@
-import { RootTheme } from "@sanity/ui/theme";
+import * as themerLegacy from "@sanity/themer-legacy";
 /**
- * The tint (between 50 and 950) that a `Hue`'s `mid` color is placed at.
- *
+ * @deprecated Import `buildThemeFromUrl` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-type HueMidPoint = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
+export declare const buildThemeFromUrl: typeof themerLegacy.buildThemeFromUrl;
 /**
- * A single hue configuration, matching the hosted Themer service
- * (themer.sanity.build) hue format.
- *
+ * @deprecated Import `createTheme` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-interface Hue {
-  /** The mid color of the hue's tint ramp, as a hex color */
-  mid: string;
-  /** The tint that `mid` is placed at — the rest of the ramp is interpolated */
-  midPoint: HueMidPoint;
-  /** The hex color that the ramp's lightest end interpolates towards */
-  lightest: string;
-  /** The hex color that the ramp's darkest end interpolates towards */
-  darkest: string;
-}
+export declare const createTheme: typeof themerLegacy.createTheme;
 /**
- * The six hues a legacy Themer theme is generated from.
- *
+ * @deprecated Import `parseHuesFromUrl` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-interface Hues {
-  default: Hue;
-  transparent: Hue;
-  primary: Hue;
-  positive: Hue;
-  caution: Hue;
-  critical: Hue;
-}
+export declare const parseHuesFromUrl: typeof themerLegacy.parseHuesFromUrl;
 /**
- * `Hues` where every hue, and every property of each hue, is optional.
- * Omitted properties fall back to the default Studio theme hues.
- *
+ * @deprecated Import `hues` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-type PartialHues = { [TKey in keyof Hues]?: Partial<Hues[TKey]>; };
+export declare const hues: typeof themerLegacy.hues;
 /**
- * A theme generated by `createTheme`, compatible with the `theme` property in
- * a Sanity Studio `defineConfig`.
- *
+ * @deprecated Import `theme` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-type LegacyTheme = RootTheme & {
-  /**
-   * Set to `undefined` so that `@sanity/ui` derives the v2 theme internally
-   * from the generated colors.
-   */
-  v2: undefined;
-};
+export declare const theme: typeof themerLegacy.theme;
 /**
- * A preset theme, carried over from the hosted Themer service.
- *
+ * @deprecated Import `presets` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` re-exports it unchanged for now and will be removed
+ * in `@sanity/themer@1.0`.
  * @public
  */
-interface ThemePreset {
-  slug: string;
-  title: string;
-  /**
-   * The canonical search params for this preset — the same query that
-   * `https://themer.sanity.build/api/hues` served the preset for.
-   */
-  searchParams: string;
-  /** The preset's resolved hues, ready to pass to `createTheme` */
-  hues: Hues;
-}
+export declare const presets: typeof themerLegacy.presets;
 /**
- * Generates a Studio theme from hues, producing the same colors as importing
- * the theme from the hosted Themer service (themer.sanity.build):
- *
- * ```ts
- * import {createTheme, hues} from '@sanity/themer/legacy'
- * import {defineConfig} from 'sanity'
- *
- * export default defineConfig({
- *   theme: createTheme({...hues, primary: {...hues.primary, mid: '#22fca8'}}),
- *   // ...rest of the config
- * })
- * ```
- *
+ * @deprecated Import `Hue` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare function createTheme(hues?: PartialHues): LegacyTheme;
+export type Hue = themerLegacy.Hue;
 /**
- * Parses the hues encoded in a hosted Themer service URL, returning the exact
- * hues that `https://themer.sanity.build/api/hues` served for that query —
- * presets and overrides included.
- *
- * ```ts
- * import {createTheme, parseHuesFromUrl} from '@sanity/themer/legacy'
- *
- * const hues = parseHuesFromUrl(
- *   'https://themer.sanity.build/api/hues?preset=verdant&primary=22fca8',
- * )
- * const theme = createTheme(hues)
- * ```
- *
+ * @deprecated Import `HueMidPoint` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare function parseHuesFromUrl(url: string | URL): Hues;
+export type HueMidPoint = themerLegacy.HueMidPoint;
 /**
- * The one-line replacement for a theme imported from the hosted Themer
- * service — pass the URL that used to be imported:
- *
- * ```ts
- * // Before:
- * // import {theme} from 'https://themer.sanity.build/api/hues?preset=verdant'
- *
- * // After:
- * import {buildThemeFromUrl} from '@sanity/themer/legacy'
- *
- * const theme = buildThemeFromUrl(
- *   'https://themer.sanity.build/api/hues?preset=verdant',
- * )
- * ```
- *
+ * @deprecated Import `Hues` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare function buildThemeFromUrl(url: string | URL): LegacyTheme;
+export type Hues = themerLegacy.Hues;
 /**
- * The hues of the default Studio theme — the same `hues` export that
- * `https://themer.sanity.build/api/hues` served without any parameters.
- *
+ * @deprecated Import `LegacyTheme` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare const hues: Hues;
+export type LegacyTheme = themerLegacy.LegacyTheme;
 /**
- * The default Studio theme — the same `theme` export that
- * `https://themer.sanity.build/api/hues` served without any parameters.
- *
+ * @deprecated Import `PartialHues` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare const theme: LegacyTheme;
+export type PartialHues = themerLegacy.PartialHues;
 /**
- * The preset themes of the hosted Themer service (themer.sanity.build), with
- * the same slugs and hues:
- *
- * ```ts
- * import {createTheme, presets} from '@sanity/themer/legacy'
- *
- * const verdant = presets.find((preset) => preset.slug === 'verdant')
- * const theme = createTheme(verdant.hues)
- * ```
- *
+ * @deprecated Import `ThemePreset` from `@sanity/themer-legacy` instead.
+ * `@sanity/themer/legacy` will be removed in `@sanity/themer@1.0`.
  * @public
  */
-export declare const presets: ThemePreset[];
-export type { Hue, HueMidPoint, Hues, LegacyTheme, PartialHues, ThemePreset };
+export type ThemePreset = themerLegacy.ThemePreset;
 //# sourceMappingURL=legacy.d.ts.map

package/dist/legacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy.d.ts","names":[],"sources":["../src/legacy/types.ts","../src/legacy/createTheme.ts","../src/legacy/defaults.ts","../src/legacy/presets.ts"],"mappings":";;;;;;KAOY;;;;;;;UAQK;;EAEf;;EAEA,UAAU;;EAEV;;EAEA;;;;;;;UAQe;EACf,SAAS;EACT,aAAa;EACb,SAAS;EACT,UAAU;EACV,SAAS;EACT,UAAU;;;;;;;;KASA,iBAAgB,cAAc,QAAQ,QAAQ,KAAK;;;;;;;KAQnD,cAAc;;;;;EAKxB;;;;;;;UAQe;EACf;EACA;;;;;EAKA;;EAEA,MAAM;;;;;;;;;;;;;;;;;;wBCtDQ,YAAY,OAAM,cAAmB;;;;;;;;;;;;;;;;;wBAoBrC,iBAAiB,cAAc,MAAM;;;;;;;;;;;;;;;;;;;wBAyBrC,kBAAkB,cAAc,MAAM;;;;;;;qBCzDzC,MAAM;;;;;;;qBAQN,OAAO;;;;;;;;;;;;;;qBCcP,SAAS"}
+{"version":3,"file":"legacy.d.ts","names":[],"sources":["../src/legacy/index.ts"],"mappings":";;;;;;;qBAYa,0BAA0B,aAAa;;;;;;;qBASvC,oBAAoB,aAAa;;;;;;;qBAQjC,yBAAyB,aAAa;;;;;;;qBAQtC,aAAa,aAAa;;;;;;;qBAQ1B,cAAc,aAAa;;;;;;;qBAQ3B,gBAAgB,aAAa;;;;;;YAO9B,MAAM,aAAa;;;;;;YAOnB,cAAc,aAAa;;;;;;YAO3B,OAAO,aAAa;;;;;;YAOpB,cAAc,aAAa;;;;;;YAO3B,cAAc,aAAa;;;;;;YAO3B,cAAc,aAAa"}