@ contentful/ 经验- sdk- core
⚠️ 内部包裹. 你不直接安装这个——框架适配器(例如.
@contentful/experiences-react)再出口所需要一切.
在所有框架中共享无依赖性、运行时间中立的原始物 适应器. 此软件包没有运行时间依赖性 .
住在这里的东西
- 类型 —— 说
PortableRenderPlan, (中文(简体) ),PortableRenderNode, (中文(简体) ),PortableRegistration, (中文(简体) ),ExperiencePayload, (中文(简体) ),ExperienceNode歧视DesignPropValue工会ManualDesignValue编号 :DesignToken, (中文(简体) ),ExperienceContext, (中文(简体) ),ResolveContext。 。 。 . resolveExperience(payload, config, opts)——单自动同步条目,走XDA有效载荷,分解内容与设计属性,解析设计值和符号,捕捉槽,运行任何组件声明resolveData并列挂钩,发出运行时中性PortableRenderPlan任何框架适配器都可以打开。 有效载荷中的每个节点都变成一个PortableRenderNode· ;registration.kind记录适配器是否针对config.components或者说config.experienceTemplates. 一个编码的经验模板是一个普通的节点——payload.sys.experienceTemplate永远不读.- 诊断和设计支助 —— 说
createDebugLogger, (中文(简体) ),resolveDesignProperties,以及applyTokenResolver。 。 。 .
交付运输属于客户,事件构建属于运行时, 在任何运行时间保持此软件包的可用性而不拉入送货客户端 或框架.
提供诊断
resolveExperience 已确认项目 payload.errors 输入可选
plan.deliveryDiagnostics: readonly ExperienceDeliveryDiagnostic[]。每次新鲜
记录只包含只读字符串 fieldPath 财务报告和审定财务报表 message; 输入顺序为
保存,以及 originalError中,删除了额外的字段和输入引用.
缺失、非阵列或未识别出的错误使外地不存在。 一样
正常化服务于原始解析呼叫和现有的客户端/运行时/叶取
路径,包括目的地; 核心进口没有生成交付类型.
这些是上游现场分辨率诊断,与现有的
当地 plan.diagnostics: Error[]它们保存可翻译的内容并序列化
作为普通记录。 投影是故意局部的:永远没有
证明个性化成功或不存在所有上游错误.
上游字符串可能包含私人信息. 更喜欢普通访客
警告/计数,检查明确用于诊断的字段,将其排除于
公共靴子/接头有效载荷和日志。 白名单不是隐私过滤器.
为什么是单独的包裹?
未来Angular,Svelte,Vue,SwiftUI,和Confose适配器消耗相同的计划. 共享核心意味着每个适配器都有零计划构建或prop-分类逻辑来重复——接合是 PortableRenderPlan 合同.
见 ../../AGENTS.md 整个建筑和设计决定.