@worldcoin/nucleus 0.1.4 → 0.1.5

package/tokens/formats/shared.ts

@@ -1,70 +0,0 @@
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
-
-export function readTemplate(path: string): string {
-  return readFileSync(resolve(ROOT, path), 'utf8');
-}
-
-export function camelCasePath(path: string[]): string {
-  return path
-    .map((segment, index) =>
-      index === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1),
-    )
-    .join('');
-}
-
-export function kebabCasePath(path: string[]): string {
-  return path.join('-').replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-}
-
-export function kebabCase(value: string): string {
-  return value.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-}
-
-export function snakeCase(value: string): string {
-  return value
-    .replace(/\.[^./]+$/, '')
-    .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
-    .toLowerCase();
-}
-
-export function publicColorPath(path: string[]): string[] {
-  if ((path[0] === 'primitive' || path[0] === 'semantic') && path[1] === 'color') {
-    return path.slice(2);
-  }
-  return path;
-}
-
-const REFERENCE_RE = /^\{(.+)\}$/;
-
-export function parseReference(rawValue: string): string[] | null {
-  const match = rawValue.match(REFERENCE_RE);
-  return match ? match[1].split('.') : null;
-}
-
-const FONT_CATEGORY: Record<string, string> = {
-  d: 'display',
-  n: 'number',
-  h: 'headline',
-  s: 'subtitle',
-  l: 'label',
-  b: 'body',
-};
-
-/**
- * Grouped typography path for a flat font-token id, e.g. `s1` → `typography.subtitle.s1`.
- * The category is derived from the id prefix (UI Kit 4.0 grouping).
- */
-export function typographyTokenPath(fontName: string): string {
-  const category = FONT_CATEGORY[fontName[0]];
-  if (!category) {
-    throw new Error(
-      `Cannot derive typography category for font token "${fontName}". ` +
-        `Add a prefix mapping to FONT_CATEGORY in formats/shared.ts.`,
-    );
-  }
-  return `typography.${category}.${fontName}`;
-}

package/tokens/formats/types-web.ts

@@ -1,61 +0,0 @@
-/**
- * Web TypeScript types generator.
- *
- * Emits literal-union types so consumers (e.g. the app-backend SDUI library) get compile-time
- * safety instead of `Record<string, string>` when referencing tokens. The members are the
- * type-scoped wire tokens the backend emits and the resolvers key on (the same `wireToken` values
- * that drive `token-paths.{js,d.ts}`, so the union types and the runtime constants can never
- * diverge):
- *   - colors: `text.primary` (semantic) / `grey.900` (primitive)
- *   - typography: `s3`
- *   - buttons: `inverse.32`
- *   - icons: `arrow-right.regular`
- */
-
-function unionType(name: string, values: string[]): string {
-  const members = [...new Set(values)].sort();
-  if (members.length === 0) {
-    return `export type ${name} = never;`;
-  }
-  return `export type ${name} =\n${members.map((v) => `  | '${v}'`).join('\n')};`;
-}
-
-export interface WebTypesInput {
-  /** Type-scoped color wire tokens (semantic + primitive). */
-  colorTokens: string[];
-  /** Type-scoped typography wire tokens (bare ids). */
-  typographyTokens: string[];
-  /** Type-scoped button style wire tokens. */
-  buttonStyleTokens: string[];
-  /** Type-scoped icon wire tokens. */
-  iconTokens: string[];
-}
-
-export function generateWebTypes({
-  colorTokens,
-  typographyTokens,
-  buttonStyleTokens,
-  iconTokens,
-}: WebTypesInput): string {
-  return [
-    '// AUTOGENERATED by tokens/build — do not edit by hand.',
-    '// Type-scoped Nucleus wire tokens as literal-union types.',
-    '',
-    '/** Type-scoped color token, e.g. `text.primary`. */',
-    unionType('ColorToken', colorTokens),
-    '',
-    '/** Type-scoped typography token (bare id), e.g. `s3`. */',
-    unionType('TypographyToken', typographyTokens),
-    '',
-    '/** Type-scoped button style token, e.g. `inverse.32`. */',
-    unionType('ButtonStyleToken', buttonStyleTokens),
-    '',
-    '/** Type-scoped icon token, e.g. `arrow-right.regular`. */',
-    unionType('IconToken', iconTokens),
-    '',
-    '/** Runtime token maps are published as JSON modules (camelCase keys → values). */',
-    'declare const tokens: Record<string, string>;',
-    'export default tokens;',
-    '',
-  ].join('\n');
-}

package/tokens/templates/android/NucleusButtons.kt.hbs

@@ -1,61 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-package {{packageName}}
-
-import androidx.compose.ui.graphics.Color
-import androidx.compose.ui.unit.Dp
-import androidx.compose.ui.unit.dp
-
-/**
- * A theme-aware color pair for a button token.
- *
- * Holds the light and dark semantic colors for a single button slot; `color(isDark)`
- * resolves to the value for the active theme.
- */
-data class NucleusButtonColor(val light: Color, val dark: Color) {
-    fun color(isDark: Boolean): Color = if (isDark) dark else light
-}
-
-/**
- * A Nucleus button style token.
- *
- * Carries the colors, geometry, and label font for a button variant × size. Colors are
- * theme-aware `NucleusButtonColor` pairs; `pressedInset` is the inset the client applies for
- * the pressed state. See `NucleusButtons` for the available tokens.
- */
-data class NucleusButtonStyle(
-    val background: NucleusButtonColor,
-    val content: NucleusButtonColor,
-    val border: NucleusButtonColor?,
-    val height: Dp,
-    val cornerRadius: Dp,
-    val paddingHorizontal: Dp,
-    val paddingVertical: Dp,
-    val font: NucleusFontStyle,
-    val pressedInset: Dp,
-)
-
-object NucleusButtons {
-{{#each styles}}
-    val {{name}} = NucleusButtonStyle(
-        background = NucleusButtonColor(
-            NucleusSemanticColorsLight.{{background}},
-            NucleusSemanticColorsDark.{{background}},
-        ),
-        content = NucleusButtonColor(
-            NucleusSemanticColorsLight.{{content}},
-            NucleusSemanticColorsDark.{{content}},
-        ),
-        border = {{#if border}}NucleusButtonColor(
-            NucleusSemanticColorsLight.{{border}},
-            NucleusSemanticColorsDark.{{border}},
-        ){{else}}null{{/if}},
-        height = {{height}}.dp,
-        cornerRadius = {{cornerRadius}}.dp,
-        paddingHorizontal = {{paddingHorizontal}}.dp,
-        paddingVertical = {{paddingVertical}}.dp,
-        font = NucleusFonts.{{font}},
-        pressedInset = {{pressedInset}}.dp,
-    )
-{{/each}}
-}

package/tokens/templates/android/NucleusColors.kt.hbs

@@ -1,11 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-package {{packageName}}
-
-import androidx.compose.ui.graphics.Color
-
-object {{objectName}} {
-{{#each tokens}}
-    val {{name}} = {{{value}}}
-{{/each}}
-}

package/tokens/templates/android/NucleusFonts.kt.hbs

@@ -1,39 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-package {{packageName}}
-
-import androidx.compose.ui.text.font.Font
-import androidx.compose.ui.text.font.FontFamily
-import androidx.compose.ui.text.font.FontWeight
-import androidx.compose.ui.unit.TextUnit
-import androidx.compose.ui.unit.em
-import androidx.compose.ui.unit.sp
-import com.worldcoin.nucleus.R
-
-/**
- * A Nucleus design token font.
- *
- * Each value carries enough information to construct a Compose `TextStyle`. The `fontFamily` is
- * wired to the bundled Nucleus font resource, so consumers never need to reference `R.font.*`
- * directly. See `NucleusFonts` for the available tokens and the repo `README.md#typography-tokens`
- * for usage guidance.
- */
-data class NucleusFontStyle(
-    val fontFamily: FontFamily,
-    val fontSize: TextUnit,
-    val fontWeight: FontWeight,
-    val letterSpacing: TextUnit,
-    val lineHeight: TextUnit,
-)
-
-object NucleusFonts {
-{{#each tokens}}
-    val {{name}} = NucleusFontStyle(
-        fontFamily = FontFamily(Font(R.font.{{fontResource}})),
-        fontSize = {{size}}.sp,
-        fontWeight = FontWeight({{weight}}),
-        letterSpacing = ({{letterSpacing}}).em,
-        lineHeight = ({{lineHeight}}).em,
-    )
-{{/each}}
-}

package/tokens/templates/android/NucleusIcon.kt.hbs

@@ -1,71 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-package {{packageName}}
-
-import androidx.annotation.DrawableRes
-import com.worldcoin.nucleus.R
-
-/**
- * A Nucleus design token icon.
- *
- * Each icon is a singleton object whose variant availability is encoded in the type system:
- * an icon implements [HasOutline], [HasRegular], and/or [HasSolid] exactly for the variants
- * it ships, so the per-variant resource IDs are non-null and accessing a variant an icon
- * does not ship is a compile error — never a runtime crash.
- *
- * ```
- * Icon(
- *     painter = painterResource(NucleusIcon.ProfileCircle.solidRes),
- *     contentDescription = null,
- *     tint = ..., // drawables ship with a black placeholder fill — tint at the call site
- * )
- * ```
- *
- * When handling icons generically, branch on availability with a type check, for example
- * `if (icon is NucleusIcon.HasSolid) painterResource(icon.solidRes)`.
- */
-sealed class NucleusIcon(val resourceName: String) {
-    /**
-     * Implemented by icons that ship an outline variant.
-     */
-    sealed interface HasOutline {
-        @get:DrawableRes
-        val outlineRes: Int
-    }
-
-    /**
-     * Implemented by icons that ship a regular variant.
-     */
-    sealed interface HasRegular {
-        @get:DrawableRes
-        val regularRes: Int
-    }
-
-    /**
-     * Implemented by icons that ship a solid variant.
-     */
-    sealed interface HasSolid {
-        @get:DrawableRes
-        val solidRes: Int
-    }
-
-{{#each tokens}}
-    data object {{kotlinCase}} : NucleusIcon("{{resourceName}}"){{#each interfaces}}, {{this}}{{/each}} {
-{{#each properties}}
-        override val {{property}} get() = {{drawable}}
-{{/each}}
-    }
-
-{{/each}}
-    companion object {
-        /**
-         * Every Nucleus icon, in stable alphabetical order. The type is fully qualified because
-         * the [List] icon object shadows `kotlin.collections.List` inside this class body.
-         */
-        val all: kotlin.collections.List<NucleusIcon> = listOf(
-{{#each tokens}}
-            {{kotlinCase}},
-{{/each}}
-        )
-    }
-}

package/tokens/templates/ios/NucleusButton+Defaults.swift.hbs

@@ -1,20 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-import NucleusColors
-import NucleusFonts
-
-public extension NucleusButton {
-{{#each styles}}
-    static let {{name}} = NucleusButton(
-        background: .{{background}},
-        content: .{{content}},
-        border: {{#if border}}.{{border}}{{else}}nil{{/if}},
-        height: {{height}},
-        cornerRadius: {{cornerRadius}},
-        paddingHorizontal: {{paddingHorizontal}},
-        paddingVertical: {{paddingVertical}},
-        font: .{{font}},
-        pressedInset: {{pressedInset}}
-    )
-{{/each}}
-}

package/tokens/templates/ios/NucleusColor+Primitives.swift.hbs

@@ -1,7 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-public extension NucleusColor {
-{{#each tokens}}
-    static let {{name}} = NucleusColor(hex: "{{hex}}")
-{{/each}}
-}

package/tokens/templates/ios/NucleusColor+Semantics.swift.hbs

@@ -1,11 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-public extension NucleusColor {
-{{#each tokens}}
-{{#if sameForBoth}}
-    static let {{name}} = NucleusColor(hex: "{{lightHex}}")
-{{else}}
-    static let {{name}} = NucleusColor(light: "{{lightHex}}", dark: "{{darkHex}}")
-{{/if}}
-{{/each}}
-}

package/tokens/templates/ios/NucleusFont+Defaults.swift.hbs

@@ -1,14 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-public extension NucleusFont {
-{{#each tokens}}
-    static let {{name}} = NucleusFont(
-        fontName: "{{fontName}}",
-        size: {{size}},
-        weight: {{weight}},
-        letterSpacing: {{letterSpacing}},
-        lineHeight: {{lineHeight}},
-        dynamicTypeStyle: .{{dynamicTypeStyle}}
-    )
-{{/each}}
-}

package/tokens/templates/ios/NucleusIcon+Defaults.swift.hbs

@@ -1,17 +0,0 @@
-// This file is auto-generated. Do not edit manually.
-
-public enum NucleusIcon: String, CaseIterable, Sendable {
-{{#each tokens}}
-    /// `{{name}}` icon. Available in: {{availableVariantsHuman}}.
-    case {{swiftCase}} = "{{name}}"
-{{/each}}
-
-    /// The variants this icon is shipped in.
-    public var availableVariants: Set<Variant> {
-        switch self {
-{{#each tokens}}
-        case .{{swiftCase}}: return [{{availableVariantsSwift}}]
-{{/each}}
-        }
-    }
-}

package/tokens/templates/web/package.json

@@ -1,20 +0,0 @@
-{
-  "name": "@worldcoin/nucleus",
-  "description": "Nucleus design tokens for Web — CSS custom properties and JSON",
-  "license": "UNLICENSED",
-  "main": "nucleus-primitive-colors.json",
-  "types": "index.d.ts",
-  "files": [
-    "*.css",
-    "*.json",
-    "fonts/*",
-    "icons/*",
-    "index.d.ts",
-    "token-paths.js",
-    "token-paths.d.ts"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/worldcoin/nucleus.git"
-  }
-}

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2023",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "forceConsistentCasingInFileNames": true,
-    "types": ["node"]
-  },
-  "include": ["tokens/**/*.ts"],
-  "exclude": ["node_modules", "build"]
-}