@spaced-out/ui-design-system 0.4.15-beta.4 → 0.5.0

package/.flowconfig

@@ -1,45 +0,0 @@
-[include]
-./node_modules/react
-
-[ignore]
-./node_modules/react/node_modules/.*
-.*/**/malformed_package_json/package.json
-./node_modules/systemjs-builder/.*
-./build/.*
-./lib/.*
-
-[declarations]
-
-[libs]
-./node_modules/fbjs/flow/lib
-
-[options]
-sharedmemory.hash_table_pow=21
-
-module.system.node.resolve_dirname=node_modules
-module.system.node.allow_root_relative=true
-
-module.name_mapper='^\(.*\)\.\(png\|jpg\|gif\|mp3\|wav\)$' -> '<PROJECT_ROOT>/flow/FileFlowStub.js.flow'
-module.name_mapper='^\(.*\)\.css$' -> '<PROJECT_ROOT>/flow/CSSFlowStub.js.flow'
-module.name_mapper='^\(.*\)\.svg$' -> '<PROJECT_ROOT>/flow/SVGFlowStub.js.flow'
-module.name_mapper='^\(.*\)\.svg\?noDimensions$' -> '<PROJECT_ROOT>/flow/SVGFlowStub.js.flow'
-module.name_mapper='^\(.*\)\.svg\?noAttrs$' -> '<PROJECT_ROOT>/flow/SVGFlowStub.js.flow'
-
-exact_by_default=true
-
-[strict]
-nonstrict-import
-unclear-type
-unsafe-getters-setters
-untyped-import
-untyped-type-import
-deprecated-type
-unnecessary-invariant
-unnecessary-optional-chain
-
-[lints]
-deprecated-type=warn
-sketchy-number=error
-unclear-type=warn
-unnecessary-invariant=warn
-unnecessary-optional-chain=warn

package/dts-generator/.editorconfig

@@ -1,10 +0,0 @@
-root = true
-
-[*]
-end_of_line = lf
-insert_final_newline = true
-
-[*.{js,json,yml}]
-charset = utf-8
-indent_style = space
-indent_size = 2

package/dts-generator/.gitattributes

@@ -1,4 +0,0 @@
-/.yarn/**            linguist-vendored
-/.yarn/releases/*    binary
-/.yarn/plugins/**/*  binary
-/.pnp.*              binary linguist-generated

package/dts-generator/README.md

@@ -1,63 +0,0 @@
-# DTS Generator
-
-This folder contains a standalone utility to generate TypeScript declaration (`.d.ts`) files from existing `.js.flow` files using [`flow-to-ts`](https://github.com/MarcoPolo/flowToTs). These typings are essential for supporting downstream TypeScript consumers of the Genesis component library.
-
----
-
-## Why this exists
-
-Although Genesis is written in Flow, the JavaScript ecosystem (including editors like VSCode, tsserver, and downstream NPM consumers) expects `.d.ts` files for rich type support. This tool bridges that gap by converting `.js.flow` files into `.d.ts` files that TypeScript understands — without requiring a full migration to TypeScript.
-
-This is **not a Flow-to-TypeScript migration**. It's a compatibility layer that allows us to continue using Flow internally while supporting TS externally.
-
----
-
-## What it does
-
-- Scans `lib/` for `.js.flow` files
-- Uses `flow-to-ts` to convert each file into a `.d.ts` equivalent
-- Writes the `.d.ts` files alongside the original files
-- Formats the output with Prettier
-
-This process runs automatically as part of the `yarn build` step (via Gulp), ensuring typings are up-to-date with every release.
-
----
-
-## Usage
-
-Install dependencies:
-
-```bash
-yarn --cwd dts-generator install
-```
-
-Run the generator:
-
-```bash
-yarn --cwd dts-generator generate
-```
-
-This will generate and format all `.d.ts` files for the project based on the current contents of `lib/`.
-
----
-
-## Included in Release
-
-The `.d.ts` files generated here are published as part of our NPM release and are used by any project consuming Genesis with TypeScript.
-
----
-
-## Tech Stack
-
-- [`flow-to-ts`](https://github.com/khan/flow-to-ts)
-- [`jscodeshift`](https://github.com/facebook/jscodeshift)
-- [`glob`](https://www.npmjs.com/package/glob)
-- [`prettier`](https://prettier.io)
-
----
-
-## Related Context
-
-This setup is a foundational step toward the long-term vision of migrating all frontend codebases (`ui_server`, `ui_design_system`, `ui_chatbot`) to TypeScript at Sense.
-
----

package/dts-generator/convert.js

@@ -1,107 +0,0 @@
-/**
- * Note(Nishant): This script is part of our long-term migration and type safety strategy.
- *
- * Context:
- * Our codebase has historically used Flow for type checking. Flow offers strong static typing,
- * but has limited ecosystem support compared to TypeScript. Since the TypeScript ecosystem
- * (including editors like VSCode, IDE integrations, and npm consumers) natively expects `.d.ts`
- * files for type definitions, we need to bridge that gap.
- *
- * Purpose of this script:
- * 1. It converts `.js.flow` files (Flow declaration files) in our `lib/` directory to
- *    corresponding `.d.ts` files using `flow-to-ts`.
- * 2. The output `.d.ts` files provide equivalent type declarations in TypeScript syntax.
- * 3. We format these generated files using `prettier` to ensure consistent and readable output.
- *
- * Why `.d.ts` files matter:
- * - TypeScript consumers of our NPM package (like internal projects or external partners)
- *   rely on `.d.ts` files to get autocompletion, compile-time checking, and rich IDE support.
- * - They serve as the public API contract of our component library.
- * - Without `.d.ts` files, consumers would have to fall back to `any` or custom typings,
- *   defeating the purpose of having a typed library.
- *
- * Why not just migrate to TS directly?
- * - A full migration to TS is non-trivial and requires coordination across all teams.
- * - In the interim, this approach gives us compatibility with the TypeScript ecosystem
- *   without dropping Flow support.
- *
- * How it works:
- * - We locate all `.js.flow` files under `lib/`
- * - Each file is passed through `flow-to-ts` with `-o d.ts` to get a `.d.ts` representation.
- * - We write the output next to the original file.
- * - The result is then formatted using Prettier.
- *
- * This script is invoked as part of the build pipeline, and must run **after** the Gulp build step.
- * Do not remove or bypass this logic — breaking `.d.ts` generation will break downstream consumers.
- *
- * Future:
- * - Once we fully migrate to TypeScript, this step can be replaced by native `.d.ts` generation
- *   via `tsc` or Babel.
- */
-
-const fs = require('fs');
-const path = require('path');
-const glob = require('glob');
-const {spawnSync} = require('child_process');
-
-
-const files = glob.sync(path.resolve(__dirname, '../lib/**/*.js.flow'));
-
-// eslint-disable-next-line no-console
-console.log('🔄 Converting .js.flow files to TypeScript declaration files...');
-
-files.forEach((file) => {
-  const outPath = file.replace(/\.js\.flow$/, '.d.ts');
-  const flowToTs = path.resolve(__dirname, './node_modules/.bin/flow-to-ts');
-  // Note(Nishant) For some reason if i try to install prettier locally it fails for few components. Not
-  // spending too much time on it because the idea here is to move to ts eventually
-  const prettier = path.resolve(__dirname, '../node_modules/.bin/prettier');
-
-  const result = spawnSync(flowToTs, ['-o', 'd.ts', file], {
-    encoding: 'utf-8',
-    // Note(Nishant): Tells Node.js to run the command inside a shell, like bash or sh.
-    // essential for calling binaries via relative paths (e.g., from node_modules/.bin/)
-    shell: true,
-  });
-
-  const stdout = result.stdout?.trim();
-  const stderr = result.stderr?.trim();
-
-  if (result.error) {
-    console.error(`Spawn error converting ${file}:`, result.error.message);
-    return;
-  }
-
-  if (stderr) {
-    console.error(`stderr converting ${file}:\n${stderr}`);
-    return;
-  }
-
-  if (result.status !== 0) {
-    console.error(`Non-zero exit code for ${file}`);
-    return;
-  }
-
-  if (stdout && !stdout.includes('Processing') && !stdout.includes('Results')) {
-    fs.writeFileSync(outPath, stdout);
-    // eslint-disable-next-line no-console
-    console.log(`✅ Converted: ${file} → ${outPath}`);
-
-    // Format with Prettier
-    const fmt = spawnSync(prettier, ['--write', outPath], {
-      encoding: 'utf-8',
-      shell: true,
-    });
-
-    if (fmt.status !== 0) {
-      console.error(`Prettier formatting failed for ${outPath}`);
-    }
-  } else {
-    console.warn(
-      `⚠️ No meaningful output for ${file}. It may be empty or skipped.`,
-    );
-  }
-});
-
-// eslint-disable-next-line no-console
-console.log(`✅ Flow to d.ts Job Finished`);

package/dts-generator/package.json

@@ -1,16 +0,0 @@
-{
-  "name": "dts-generator",
-  "private": true,
-  "scripts": {
-    "generate": "node convert.js"
-  },
-  "dependencies": {
-    "@khanacademy/flow-to-ts": "^0.5.2",
-    "glob": "^11.0.1",
-    "jscodeshift": "^17.3.0"
-  },
-  "volta": {
-    "node": "20.19.2",
-    "yarn": "1.22.19"
-  }
-}