@broke_wire/crud

@broke_wire/crud 是一个 core-only 的 CRUD 逻辑内核库。

导出入口

1. @broke_wire/crud
2. @broke_wire/crud/core

两者均导出核心能力。

核心能力

1. 契约与版本握手：CORE_CONTRACT_VERSION、runVersionHandshake、assertVersionHandshake
2. 三大控制器：createListController、createFormController、createActionController
3. 内核装配：createCrudKernel
4. 生命周期与事件总线：createLifecycleHub、createEventBus、runLifecycleProtocol
5. 插件机制：createPluginHost
6. Schema 与权限审计：createCrudSchemaPack 等
7. 调试能力：createCrudDevtools
8. 列状态持久化：createColumnStateManager 等
9. 统一错误码：CRUD_REASON_CODES、createReasonError

最小接入示例

import { createCrudKernel } from '@broke_wire/crud'

const kernel = createCrudKernel({
  list: {
    fetchList: (payload) => api.queryList(payload),
  },
  form: {
    createApi: (payload) => api.create(payload),
    updateApi: (payload) => api.update(payload),
  },
  action: {
    deleteApi: (payload) => api.remove(payload),
  },
})

await kernel.listController.commands.loadList()

使用原则

1. 核心只做行为流程，不做视觉和组件实现。
2. 业务项目自行决定 UI 框架与样式规范。
3. 复杂交互通过插件、Hook、Schema 扩展，不改核心内核。

参考文档

1. ../../docs/02-architecture-overview.md
2. ../../docs/03-core-contract-v1.md
3. ../../docs/13-version-handshake-v1.md
4. ../../docs/19-error-code-reference-v1.md