open-index/open-npm huggingface dataset:
npm package: @flatfy/panorama
Description: Панорама ЖК без карты. Карта встраивается на стороне сайта для большей гибкости (возможность объединения ее с картой генплана, например).
Latest version: 3.0.13

# panorama

Панорама ЖК без карты. Карта встраивается на стороне сайта для большей гибкости (возможность объединения ее с картой генплана, например).

## Подготовка данных для upload

**:warning: эта часть была портирована для админки в PHP в https://github.com/lun/novostroyki**

`node convert.js` в папке [process](/process)

В этой же папке должен находиться видео файл [`panorama.mp4`](https://github.com/lun/panorama/blob/master/process/convert.js#L8) и [`panorama.srt`](https://github.com/lun/panorama/blob/master/process/subtitles.js#L4)

В папку `frames` записывается все то что необходимо для upload: 36 кадров панорамы и geojson с точками съемки и центром окружности.
npm package: @flatina/browser-ctl
Description: CDP browser automation with accessibility-tree refs (@e1, @e2, …)
Latest version: 0.2.0

# @flatina/browser-ctl

- Zero-dependency browser automation **package** built on raw WebSocket CDP.
  - not a cli. Designed to be embedded in other tools (e.g. flmux).
- Inspired by https://github.com/vercel-labs/agent-browser
- Inspired by https://github.com/Ataraxy-Labs/agent-electrobun

## Design

- **Zero dependencies** — only Bun built-ins + WebSocket
- **CDPClient injection** — both WebView and CDP support
- **Single-target** — one `Browser` per page; multi-tab is the caller's concern

## Core Concept: @ref

`snapshot` scans the accessibility tree, assigns `@e1`, `@e2`, ... references to interactive elements,
then commands like `click("@e1")` resolve the ref to a real DOM node via `backendDOMNodeId`.

```
@e1 button "Sign In"
@e2 textbox "Email" value="user@example.com"
@e3 link "Forgot password?"
@e4 checkbox "Remember me" [checked]
```

## Usage

```ts
import { Browser, CDPClient, discoverTargets, findTarget } from "@flatina/browser-ctl";

const targets = await discoverTargets("http://127.0.0.1:9222");
const target = findTarget(targets, t => t.url.startsWith("http"));
const client = await CDPClient.connect(target.webSocketDebuggerUrl);
const browser = new Browser(client, target.url, "/tmp/refs.json");

// Snapshot (with optional filtering — CSS or xpath=)
console.log(await browser.snapshot({ compact: true, selector: "#main" }));
console.log(await browser.snapshot({ selector: "xpath=//form[@id='login']" }));

// Interact
await browser.fill("@e2", "user@example.com");
await browser.click("@e1");
await browser.waitForLoad();
await browser.wait("xpath=//div[@class='success']");

// Query
const url = await browser.getUrl();
const visible = await browser.isVisible("@e3");

// Console capture
browser.captureConsole();
await browser.eval("fetch('/api')");
console.log(browser.logs()); // [{ level: "log", text: "...", timestamp }]

await browser.close();
```

## API

| Category | Methods |
|----------|---------|
| Snapshot | `snapshot(options?)` with `compact`, `selector` (CSS or `xpath=`), `roles` filters |
| Navigation | `navigate` `back` `forward` `reload` |
| Interaction | `click` `dblclick` `hover` `focus` `fill` `type` `press` `select` `check` `scroll` |
| Query | `getText` `getHtml` `getValue` `getAttr` `getBox` `getUrl` `getTitle` |
| State | `isVisible` `isEnabled` `isChecked` |
| Page | `screenshot` `pdf` `eval` |
| Dialog | `dialog("accept" \| "dismiss")` |
| Console | `captureConsole` `logs` |
| Wait | `wait(ms \| selector \| xpath=...)` `waitForLoad` `waitForNetworkIdle` |

## CDP Events

`CDPClient` exposes a typed event system with `on`/`off`/`once`:

```ts
client.on("Page.javascriptDialogOpening", (e) => {
  // e.type: "alert" | "confirm" | "prompt" | "beforeunload"
  browser.dialog("accept");
});

await client.once("Page.loadEventFired"); // Promise-based
```

## License

MIT License
npm package: @flatiron-school/eich
Description: JS/Node Project Creator
Author: Tom Milewski @tmilewski
Latest version: 1.0.5

# @flatironschool/eich

JS/Node Project Creator

[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
[![Version](https://img.shields.io/npm/v/@flatironschool/eich.svg)](https://npmjs.org/package/@flatironschool/eich)
[![Downloads/week](https://img.shields.io/npm/dw/@flatironschool/eich.svg)](https://npmjs.org/package/@flatironschool/eich)
[![License](https://img.shields.io/npm/l/@flatironschool/eich.svg)](https://github.com/flatiron-labs/eich/blob/master/package.json)

<!-- toc -->
* [@flatironschool/eich](#flatironschooleich)
* [Usage](#usage)
* [Commands](#commands)
<!-- tocstop -->

# Usage

<!-- usage -->
```sh-session
$ npm install -g @flatiron-school/eich
$ eich COMMAND
running command...
$ eich (-v|--version|version)
@flatiron-school/eich/1.0.5 linux-x64 node-v15.10.0
$ eich --help [COMMAND]
USAGE
  $ eich COMMAND
...
```
<!-- usagestop -->

# Commands

<!-- commands -->
* [`eich hello [FILE]`](#eich-hello-file)
* [`eich help [COMMAND]`](#eich-help-command)

## `eich hello [FILE]`

describe the command here

```
USAGE
  $ eich hello [FILE]

OPTIONS
  -f, --force
  -h, --help       show CLI help
  -n, --name=name  name to print

EXAMPLE
  $ eich hello
  hello world from ./src/hello.ts!
```

_See code: [src/commands/hello.ts](https://github.com/flatiron-labs/eich/blob/v1.0.5/src/commands/hello.ts)_

## `eich help [COMMAND]`

display help for eich

```
USAGE
  $ eich help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI
```

_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.2/src/commands/help.ts)_
<!-- commandsstop -->
npm package: @flatiron-school/ui
Description: FIS Design System
Author: Tom Milewski
Latest version: 2.0.1

# The Flatiron School Design System

## Installation & Usage

### Install

`yarn add @flatiron-school/ui @material-ui/core`

### Usage

```jsx
import { Button } from '@flatiron-school/ui'

export default () => {
  return <Button primary>Foo</Button>
}
```

To apply your theme wrap your components in our ThemeProvider:

```jsx
import ThemeProvider from '@flatiron-school/ui'

export default () => {
  return <ThemeProvider theme={yourTheme}> </ThemeProvider>
}
```

### Available Components

[TODO]

### Want to Contribute?

If you want to contribute through code or documentation, the [Contributing guide](docs/contribution-guide.md) is the best place to start. If you have questions, feel free to ask.

### Other

- [Why I don't use React.FC](https://fettblog.eu/typescript-react-why-i-dont-use-react-fc/#2.-fc%3C%3E-always-imply-children)
- [TS Styleguide](https://basarat.gitbook.io/typescript/styleguide)
- [Jest styled-components](https://github.com/styled-components/jest-styled-components#react-testing-library)
- [Jest styled-components toHaveStyleRule](https://github.com/styled-components/jest-styled-components#tohavestylerule)
npm package: @flatjs/cli
Description: A tool the modern for rapidly building command line flatjs apps
Latest version: 3.0.15

# @flatjs/cli

A tool the modern for rapidly building command line flatjs apps

## Install globally

- `npm i -g @flatjs/cli`

## Module/Programmatic Usage

- `yarn add @flatjs/cli`

Add this package to package dependencies linked to your app, just import them like regular packages:

```typescript
import { bootstrap } from '@flatjs/cli';

bootstrap().then((cli) => {
  // Register customized plugins chain.
  cli.register(pluginA).register(pluginB);

  // Parse progress arguments.
  cli.parse(process.argv.slice(2));
});
```

## Create a custom flatjs-based plugin chain e.g. `flat test`

- flatjs-cli-plugin-`test`/package.json
  ```json
  "type": "module",
  "exports": {
    ".": {
      "import": "./index.js"
    },
    "./package.json": "./package.json"
  },
  ```
- flatjs-cli-plugin-`test`/src/index.ts

```ts
import type { CommandArgv } from '@armit/commander';
import { AbstractHandler, createCommand } from '@armit/commander';
import { logger } from '@flatjs/common';

type TestCmdArgs = CommandArgv<{
  test: number;
}>;

class CmdTestHandle extends AbstractHandler<TestCmdArgs> {
  handle(): void | Promise<void> {
    console.log('this is test command handle');
    logger.debug('this is debug message for test command');
  }
}

const cmdTest = createCommand(
  'test',
  {
    command: 'test',
    describe: 'Display flatjs project details.',
    builder: (yargs) => {
      return yargs.example(`$0 cmd test `, 'cli testing').option('test', {
        type: 'number',
        alias: 't',
        default: true,
        describe: `cli option test describe`,
      });
    },
  },
  CmdTestHandle
);
// As default export
export default cmdTest;
```

## Contributing

Contributions are happily accepted. I respond to all PR's and can offer guidance on where to make changes. For contributing tips see CONTRIBUTING.md
npm package: @flatjs/cli-plugin-ci
Description: The standard CI workflow
Latest version: 3.0.15

# @flatjs/cli-plugin-ci

The standard CI workflow

## Usage Guides

```json
{
  "scripts": {
    "ci:build": "npx flat ci buildEvolve",
    "ci:checkRequirements": "npx flat ci checkRequirements",
    "ci:parallel": "npx flat ci parallel",
    "ci:publish": "npx flat ci publishCdn -f=\"semic/admin-ui/**/*.{png,jpg,jpeg,gif,svg,js,css}\"",
    "ci:publish": "npx flat ci publishFtp -f=\"semic/admin-ui/**/*.{png,jpg,jpeg,gif,svg,js,css}\""
  }
}
```

## Note

命令行的参数优先级 `低于` 配置文件 `flatjs-plugin-ci.config.ts`定义的参数

```ts filename="flatjs-plugin-ci.config.ts"
defineConfig({
  publishCdn: {
    filter: ['**/*.{png,jpg,jpeg,gif,svg}'],
    ignore: [],
    relative: 'public',
    prefix: '',
    connection: {
      uploadApi: '',
      headers: {
        apikey: '',
        host: '',
      },
      overrideExistFile: false,
    },
  },
  publishFtp: {
    filter: ['**/*.{png,jpg,jpeg,gif,svg}'],
    ignore: [],
    relative: 'public',
    prefix: '',
    connection: {
      port: 21,
      host: '',
      user: '',
      password: '',
    },
  },
  buildEvolve: {
    publishNow: true,
    publishFolder: ['shared'],
    packNow: true,
    // CI 约定配置
    timestamp: 'dynamic',
    cleanNodeModules: true,
    packWithAssets: false,
    compress: true,
  },
  parallel: {
    prefix: '',
  },
  checkRequirements: {
    branch: 'origin/master',
    output: 'packages/manifest.json',
  },
});
```
npm package: @flatjs/cli-plugin-upload
Description: the cli plugin upload for flatjs
Author: tianyingchun
Latest version: 1.7.3

# @flatjs/cli-plugin-upload

> The cli plugin upload for flatjs

## The usages

```sh
npm i @flatjs/cli-plugin-upload
```

## The configurations

- flatjs.cli.js

```ts
const flatjsConfig = {
  flatjsCli: {
    pluginConfigs: {
      uploadCmd: {
        apiBase: 'https://xxx.com/api/package/cli',
      },
    },
  },
};
```

## Features

`flat upload`
`flat upload -u`
`flat upload -u -t="后端"`
`flat upload -u -t="前端"`
npm package: @flatjs/evolve
Description: ## Note: because below configuration of `tsconfig.json `
Latest version: 3.0.15

# @flatjs/evolve

## Note: because below configuration of `tsconfig.json `

```json
{ "baseUrl": "./src" }
```

We should not create folder name like `webpack` in `src/webpack`;

1. while we use `import { moduleX } from webpack`; it will resolve `moduleX` from `src/webpack` instead import from `node_modules`
2. while use `vitest` it may broken cause of wrong `webpack` imported.
3. change `src/webpack` to `src/create-webpack` is ok.

### Notes: cause of `esm`

1. `import { webpack } from 'webpack'` should be change to `import webpack from 'webpack'`
2. `import { merge } from 'lodash'` should be change to `import _ from 'lodash'`
npm package: @flatjs/evolve-preset-babel
Description: ## Notes
Latest version: 2.2.5

# @flatjs/evolve-preset-babel

## Notes

if you run into error `Failed to construct 'HTMLElement': Please use the 'new' operator, this DOM object constructor cannot be called as a function.
e.g. https://github.com/microsoft/vscode-webview-ui-toolkit you may need to setup `@babel/plugin-transform-classes` as below shown.

```ts
// Failed to construct 'HTMLElement': Please use the 'new' operator, this DOM object constructor cannot be called as a function.
[babelPluginTransformClass, { loose: false }];
```

```ts

babelOptions: {
    plugins: [
    [
        env.resolve(import.meta.url, '@babel/plugin-transform-classes'),
        {
        loose: false,
        },
    ],
    ],
},
```
npm package: @flatjs/forge
Description: ## Usages
Latest version: 2.3.10

# @flatjs/forge

## Usages

### The configuration file `flatjs-forge.config.ts`;

```ts
import { defineConfig } from '@flatjs/forge/define-config';

export default defineConfig({
  output: {
    format: 'cjs',
  },
  plugin: {
    pluginConfigs: {
      babelOptions: {
        usePreset: 'react',
      },
      terserOptions: true,
    },
  },
});
```

Note:

1. Can use `.mts` extension if your package.json without `"type": "module"`
2. Can use `.ts`,`.mts` extension if your package.json with `"type": "module"`

### Forge CLI

define `scripts` in package.json

```json
{ "forge": "flatjs-forge" }
```

1. Using Npm scripts

- `yarn forge build --dts`
- `yarn forge build --dts -f=esm`

2. Using npx

- `npx flatjs-forge build --dts`
- `npx flatjs-forge build --dts -f=esm`

3. Show basic tips

- `yarn forge -h`
- `yarn forge help`

- `npx flatjs-forge -h`
- `npx flatjs-forge help`

4. Show help info for command `build`

- `yarn forge build -h`
- `yarn forge help build`

- `npx flatjs-forge build -h`
- `npx flatjs-forge help build`

Notes: if we must use `--dts=false` instead using `-d=false` to indicate `dts:false`, The same usage goes for the other boolean types (`-c=false` => `--compress=false`)

## Note: because below configuration of `tsconfig.json `

```json
{ "baseUrl": "./src" }
```

We should not create folder name like `rollup` in `src/rollup`;

1. while we use `import { moduleX } from rollup`; it will resolve `moduleX` from `src/rollup` instead import from `node_modules`
2. while use `vitest` it may broken cause of wrong `rollup` imported.
3. change `src/rollup` to `src/create-rollup` is ok.
npm package: @flatjs/forge-plugin-babel
Description: A `@flatjs/forge` plugin for seamless integration between Rollup and Babel for `dom`,`react`,`node`, `wxmp`, `wxmpbiz`.
Latest version: 2.2.10

# @flatjs/forge-plugin-babel

A `@flatjs/forge` plugin for seamless integration between Rollup and Babel for `dom`,`react`,`node`, `wxmp`, `wxmpbiz`.

## usages
npm package: @flatjs/forge-plugin-dts
Description: This is a plugin that lets you roll-up your .d.ts definition files.
Latest version: 2.2.5

# @flatjs/forge-plugin-dts

This is a plugin that lets you roll-up your .d.ts definition files.

Note: it depends `@flatjs/forge-plugin-multi-input`, always works on `@flatjs/forge`

## usages
npm package: @flatjs/forge-plugin-multi-input
Description: ## usages
Latest version: 2.2.5

# @flatjs/forge-plugin-multi-input

## usages

## Notes

`fast-glob`, `lodash` is a CommonJS module, which may not support all module.exports as named exports.
CommonJS modules can always be imported via the default export, for example using:

`import fastglob from 'fast-glob';`
`import _ from 'lodash';`
npm package: @flatjs/forge-plugin-ts-paths
Description: faltjs plugin to automatically resolve path aliases set in the compilerOptions section of tsconfig.json. Don't use it if you're already using rollup-plugin-typescript. This plugin is only for use cases where your TypeScript code has already been transpile
Latest version: 2.2.5

# @flatjs/forge-plugin-ts-paths

faltjs plugin to automatically resolve path aliases set in the compilerOptions section of tsconfig.json.
Don't use it if you're already using rollup-plugin-typescript. This plugin is only for use cases where your TypeScript code has already been transpiled before rollup runs.

```json
// tsconfig.json
{
  "compilerOptions": {
    // ...
    "baseUrl": ".",
    "paths": {
      "@utils": ["src/helpers/utils"]
    }
  }
}
```

```ts
import { something } from '@utils';
```

Then this plugin will make sure that rollup knows how to resolve @utils.

## Notes

`typescript` is a CommonJS module, which may not support all module.exports as named exports.
CommonJS modules can always be imported via the default export, for example using:

`import ts from 'typescript`;`
npm package: @flatjs/forge-preset-babel
Description: ## Notes
Latest version: 2.2.5

# @flatjs/forge-preset-babel

## Notes

if you run into error `Failed to construct 'HTMLElement': Please use the 'new' operator, this DOM object constructor cannot be called as a function.
e.g. https://github.com/microsoft/vscode-webview-ui-toolkit you may need to setup `@babel/plugin-transform-classes` as below shown.

```ts
// Failed to construct 'HTMLElement': Please use the 'new' operator, this DOM object constructor cannot be called as a function.
[babelPluginTransformClass, { loose: false }];
```

```ts

babelOptions: {
    plugins: [
    [
        env.resolve(import.meta.url, '@babel/plugin-transform-classes'),
        {
        loose: false,
        },
    ],
    ],
},
```
npm package: @flatjs/rs-evolve
Description: ## Note: because below configuration of `tsconfig.json `
Latest version: 3.0.0-next.2

# @flatjs/rs-evolve

## Note: because below configuration of `tsconfig.json `

```json
{ "baseUrl": "./src" }
```

We should not create folder name like `webpack` in `src/webpack`;

1. while we use `import { moduleX } from webpack`; it will resolve `moduleX` from `src/webpack` instead import from `node_modules`
2. while use `vitest` it may broken cause of wrong `webpack` imported.
3. change `src/webpack` to `src/create-webpack` is ok.

### Notes: cause of `esm`

1. `import { webpack } from 'webpack'` should be change to `import webpack from 'webpack'`
2. `import { merge } from 'lodash'` should be change to `import _ from 'lodash'`
npm package: @flatjs/sculpt
Description: ## Usages
Latest version: 2.3.4

# @flatjs/sculpt

## Usages

### The configuration file `flatjs-sculpt.config.ts`;

```ts
import { defineConfig } from '@flatjs/sculpt';

export default defineConfig({
  input: [
    'src/app.ts',
    'src/components/*/index.ts',
    'src/modules/home/pages/page1/index.ts',
    'src/modules/home/pages/page2/index.ts',
    'src/modules/mine/pages/page1/index.ts',
    'src/modules/mine/pages/page2/index.ts',
  ],
  modularImports: [
    {
      libraryDirectory: 'cjs',
      libraryName: '@dimjs/utils',
    },
  ],
  autoRunIDE: false,
});
```

### The advanced example

```ts
export default defineConfig({
  input: ['src/app.ts', 'src/components/*/index.ts'],
  projectVirtualPath: 'sculpt/demo',
  devServer: {
    mockOptions: {
      mockBaseDir: `./mocks`,
      apiContext: '/api',
      hostname: 'dev.flatjs.com',
      port: 4000,
      staticMap: {
        '/static': 'static',
      },
      mockMap: {
        '/account': { type: 'REST', defs: ['account'], middlewares: {} },
      },
    },
  },
  plugin: {
    pluginConfigs: {
      terserOptions: {
        compress: {
          // drop_console: true,
          pure_funcs: [
            'console.log',
            'console.info',
            'console.debug',
            'console.warn',
          ],
        },
      },
    },
  },
  assetsCopyPattern: ['src/native/*.png'],
  assetsOptions: {
    inlineFallbackType: [
      'public',
      {
        virtualPath: 'sculpt/demo',
        distFolder: 'public',
        cdnUrls: ['https://cdn.example.com'],
      },
    ],
  },
  modularImports: [
    {
      libraryDirectory: 'cjs',
      libraryName: '@wines/core',
    },
    {
      libraryDirectory: 'cjs',
      libraryName: '@wines/request',
    },
    {
      libraryDirectory: 'cjs',
      libraryName: '@dimjs/utils',
    },
    {
      libraryDirectory: 'cjs',
      libraryName: '@dimjs/lang',
    },
    {
      libraryDirectory: 'cjs',
      libraryName: '@dimjs/secure',
    },
  ],
});
```

## API 环境变量

```ts
export const appApi: ServiceConfig = {
  me: process.env.MOCK_SCULPT_BASE || '',
  inte: `http://dev.venus.org/api`,
  rc: `https://qa.example.top/api`,
  prod: 'https://example.top/api',
};
```

## 分包

```json
// app.json
// 注意此处是 `subpackages`而不是`subPackages`
"subpackages": [
   {
     "root": "subpackages-basic",
     "name": "subpackages-basic",
     "pages": [
       "pages/tools/index",
       "pages/login/index",
       "pages/offline/index",
       "pages/webview/index"
     ]
   },
   {
     "root": "subpackages-other",
     "name": "subpackages-other",
     "pages": ["pages/protocol/index"]
   }
 ],
```
npm package: @flatjs/skeleton
Description: The skeleton for @flatjs family projects, it is always used to cli command `flat create`
Author: tianyingchun
Latest version: 1.7.3

# @flatjs/skeleton

> The skeleton for @flatjs family projects, it is always used to cli command `flat create`

## The usages

```sh
 npm i -g @flatjs/skeleton
```

## Features

## Notes