@ aippy/vite- 插件

Aippy 项目的Vite插件收藏,提供资产管理和组件标记能力.

安装

pnpm add -D @aippy/vite-plugins

插件

1. 资产常数插件

生成静态资产的常数引用并替换硬码路径.

import { assetConstantsPlugin } from '@aippy/vite-plugins/asset-constants';

export default defineConfig({
  plugins: [
    assetConstantsPlugin({
      extensions: ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.mp4', '.mp3'],
      srcDir: 'src',
      outputFile: 'src/config/assets.json',
      devMode: true,
    }),
  ],
});

2. Aippy 预装插件

扫描建立输出并生成资产预装元标记.

import { aippyPreloadPlugin } from '@aippy/vite-plugins/aippy-preload';

export default defineConfig({
  plugins: [
    aippyPreloadPlugin({
      extensions: ['.js', '.css', '.png', '.jpg', '.svg'],
      outDir: 'dist',
      includeSubdirs: true,
    }),
  ],
});

3. Aippy Tagger 插件

Tags React 组件带有元数据用于开发工具和检查.

import { aippyTaggerPlugin } from '@aippy/vite-plugins/aippy-tagger';

export default defineConfig({
  plugins: [aippyTaggerPlugin()],
});

全一导入

import {
  assetConstantsPlugin,
  aippyPreloadPlugin,
  aippyTaggerPlugin,
} from '@aippy/vite-plugins';

工具函数

软件包还输出可以独立使用的公用功能:

import {
  processAssetURL,
  isValidAsset,
  generateConstantName,
  extractAssetsFromContent,
  findProjectRoot,
} from '@aippy/vite-plugins/utils';

// Process asset URLs
const processedUrl = processAssetURL('./image.png'); // '/image.png'

// Validate asset paths
const isValid = isValidAsset('./image.png'); // true

// Generate constant names
const constantName = generateConstantName('/image.png'); // 'IMAGE_ABCD'

// Extract assets from content
const assets = extractAssetsFromContent(htmlContent, 'html', ['.png', '.jpg']);

// Find project root
const projectRoot = findProjectRoot(); // '/path/to/project'

许可证

解放军-爱乐队

资产文件

src/config/assets.json 是一个平面的 URL 词典。 插件只写该文件 。 项目的根基 assets-plan.json 用于保留名称的只读输入 implementation.path 除外情形。 插件不验证计划; ayppy-chat does. 缺少或无法读取的计划不能阻止建设. 无效的词典JSON,一个存储在词典中的计划对象,或者一个失败的词典/wrapper写入会停止构建而不覆盖文件. 源文件插件无法解析或重写只记录一个警告 .

导入生成的地图 @/config/assets。它导出字典的字符串值. window.getReplacedAssets 仍然会变异物体 预加载在其他源文件中读取这些字符串值和 URL,而不是在计划中提示.

来源写作词典url. 建筑重写成一个字典键。 由几个密钥拥有的url使用第一个密钥. URL可以是任何引用的 aippy 聊天接受(ValidReference:http(s), root-relative,或相对.

版本0.4.0-dev.5发布. 这个 dev 直指着它. latest 遗 物 0.3.0。 。 。 .