@blockml/fatblock-target 0.8.0 → 0.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/blocks/org/blockml/bml/target/fatblock/Library.bml +3 -1
- package/blocks/org/blockml/bml/target/fatblock/capability/AssembleFatDocument.bml +5 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/ArchitectureOverview.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/CandidateCollection.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/DesignDecisions.bml +22 -3
- package/blocks/org/blockml/bml/target/fatblock/documentation/Diagnostics.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/EmbedAssemblyRules.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/Introduction.bml +2 -2
- package/blocks/org/blockml/bml/target/fatblock/documentation/LayerSeparation.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/NamespaceMergeRules.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/OutputLayout.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/PackageOwnership.bml +1 -1
- package/blocks/org/blockml/bml/target/fatblock/documentation/PublicApi.bml +4 -4
- package/blocks/org/blockml/bml/target/fatblock/documentation/V1Scope.bml +1 -1
- package/package.json +6 -6
|
@@ -28,13 +28,15 @@
|
|
|
28
28
|
<is>The FatBlock portable .bml render target library catalog</is>
|
|
29
29
|
|
|
30
30
|
<documentation>
|
|
31
|
+
# The FatBlock portable .bml render target library catalog
|
|
32
|
+
|
|
31
33
|
Canonical FatBlock specification for BlockML — registry name fatblock, folder-pool
|
|
32
34
|
candidates, embed assembly, namespace merge, {hostFqn}.fat.bml (FB1–FB20). TypeScript in
|
|
33
35
|
packages/fatblock-target/src/ implements this library. Membership is defined
|
|
34
36
|
exclusively by this blocks list.
|
|
35
37
|
</documentation>
|
|
36
38
|
|
|
37
|
-
<version>0.8.
|
|
39
|
+
<version>0.8.1</version>
|
|
38
40
|
|
|
39
41
|
<language>
|
|
40
42
|
<English />
|
|
@@ -27,7 +27,11 @@
|
|
|
27
27
|
<baseType>core:Capability</baseType>
|
|
28
28
|
<is>Build fat BomDocument from host plus peer embeds</is>
|
|
29
29
|
|
|
30
|
-
<documentation>
|
|
30
|
+
<documentation>
|
|
31
|
+
# Build fat BomDocument from host plus peer embeds
|
|
32
|
+
|
|
33
|
+
FB12: require srcDir. FB13: host not found to BML_FATBLOCK_HOST_NOT_FOUND. FB14: host embeddedBlocks non-empty to BML_FATBLOCK_HOST_HAS_EMBEDDED_BLOCKS. FB15: duplicate candidate FQN to BML_DUPLICATE_EMBEDDED_BLOCK. FB16: embed not root / missing to BML_FATBLOCK_EMBED_NOT_FOUND; embed already has embeds to BML_FATBLOCK_EMBED_HAS_EMBEDDED_BLOCKS. FB17: clone embed, clear nested embeds, preserve subBlocks; sorted embed order; merge NS; abort if any error.
|
|
34
|
+
</documentation>
|
|
31
35
|
|
|
32
36
|
<references>
|
|
33
37
|
<see type="fbdocumentation:EmbedAssemblyRules" relation="SeeAlso" />
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
• fat-output-path.ts → FatOutputBasename
|
|
48
48
|
• fatblock-target.ts → Render, ValidateRequest</documentation>
|
|
49
49
|
<references>
|
|
50
|
-
<see type="fbdocumentation:V1Scope" relation="ReadNext"
|
|
50
|
+
<see type="fbdocumentation:V1Scope" relation="ReadNext" />
|
|
51
51
|
</references>
|
|
52
52
|
|
|
53
53
|
</block>
|
|
@@ -39,7 +39,7 @@
|
|
|
39
39
|
|
|
40
40
|
V1 semantics = folder pool, not dependency graph walk.</documentation>
|
|
41
41
|
<references>
|
|
42
|
-
<see type="fbdocumentation:EmbedAssemblyRules" relation="ReadNext"
|
|
42
|
+
<see type="fbdocumentation:EmbedAssemblyRules" relation="ReadNext" />
|
|
43
43
|
</references>
|
|
44
44
|
|
|
45
45
|
</block>
|
|
@@ -28,24 +28,43 @@
|
|
|
28
28
|
<baseType>core:Documentation</baseType>
|
|
29
29
|
<is>Normative FatBlock decisions FB1–FB20</is>
|
|
30
30
|
|
|
31
|
-
<documentation>
|
|
31
|
+
<documentation>
|
|
32
|
+
# Normative FatBlock decisions FB1–FB20
|
|
33
|
+
|
|
34
|
+
FB1 ResolveOptions default embeddedBlocksStrategy=error.
|
|
35
|
+
|
|
32
36
|
FB2 accepts document only; registry name fatblock.
|
|
37
|
+
|
|
33
38
|
FB3 ValidateRequest requires srcDir.
|
|
39
|
+
|
|
34
40
|
FB4 render empty files on assemble/serialize errors; strip info diags.
|
|
41
|
+
|
|
35
42
|
FB5 RootFqnsByFilePath excludes Sub-Block FQNs.
|
|
43
|
+
|
|
36
44
|
FB6 CollectCandidateFqns path-under-src; exclude host; sort.
|
|
45
|
+
|
|
37
46
|
FB7 include exact or prefix*; OR; empty=all.
|
|
47
|
+
|
|
38
48
|
FB8 CloneBlockDefinition via structuredClone.
|
|
49
|
+
|
|
39
50
|
FB9 Merge host then embeds.
|
|
51
|
+
|
|
40
52
|
FB10 prefix collision diagnostic; no rewrite.
|
|
53
|
+
|
|
41
54
|
FB11 default empty-prefix xmlns.
|
|
55
|
+
|
|
42
56
|
FB12–FB16 assemble host/embed empty-embeds and not-found rules.
|
|
57
|
+
|
|
43
58
|
FB17 preserve subBlocks; clear nested embeds on clone; serialize indent 2.
|
|
59
|
+
|
|
44
60
|
FB18 {hostFqn}.fat.bml basename.
|
|
61
|
+
|
|
45
62
|
FB19 V1 = folder pool not transitive closure.
|
|
46
|
-
|
|
63
|
+
|
|
64
|
+
FB20 embeddedBlocksStrategy reserved; assemble hardcodes empty-embeds check.
|
|
65
|
+
</documentation>
|
|
47
66
|
<references>
|
|
48
|
-
<see type="fbdocumentation:PackageOwnership" relation="ReadNext"
|
|
67
|
+
<see type="fbdocumentation:PackageOwnership" relation="ReadNext" />
|
|
49
68
|
</references>
|
|
50
69
|
|
|
51
70
|
</block>
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
|
|
43
43
|
Severity: all FatBlock codes are error. CLI exit: config → 2; assemble → 1.</documentation>
|
|
44
44
|
<references>
|
|
45
|
-
<see type="fbdocumentation:DesignDecisions" relation="ReadNext"
|
|
45
|
+
<see type="fbdocumentation:DesignDecisions" relation="ReadNext" />
|
|
46
46
|
</references>
|
|
47
47
|
|
|
48
48
|
</block>
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
Meta-model (BOM): embeds are flat under root; Sub-Blocks forbid embeds — validator owns
|
|
41
41
|
BML_EMBEDDED_BLOCKS_ON_SUBBLOCK / BML_NESTED_EMBEDDED_BLOCKS.</documentation>
|
|
42
42
|
<references>
|
|
43
|
-
<see type="fbdocumentation:NamespaceMergeRules" relation="ReadNext"
|
|
43
|
+
<see type="fbdocumentation:NamespaceMergeRules" relation="ReadNext" />
|
|
44
44
|
</references>
|
|
45
45
|
|
|
46
46
|
</block>
|
|
@@ -43,8 +43,8 @@
|
|
|
43
43
|
Pipeline: ResolveOptions → AssembleFatDocument → SerializeFatDocument → {hostFqn}.fat.bml.
|
|
44
44
|
Host CLI wiring (flags, exit codes) lives in org.blockml.bml.cli.*</documentation>
|
|
45
45
|
<references>
|
|
46
|
-
<see type="fbdocumentation:LayerSeparation" relation="ReadNext"
|
|
47
|
-
<see type="fbcap:Render" relation="SeeAlso"
|
|
46
|
+
<see type="fbdocumentation:LayerSeparation" relation="ReadNext" />
|
|
47
|
+
<see type="fbcap:Render" relation="SeeAlso" />
|
|
48
48
|
</references>
|
|
49
49
|
|
|
50
50
|
</block>
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
|
|
46
46
|
Sibling targets (blockdoc, xsd) and domain SCAD are out of scope.</documentation>
|
|
47
47
|
<references>
|
|
48
|
-
<see type="fbdocumentation:ArchitectureOverview" relation="ReadNext"
|
|
48
|
+
<see type="fbdocumentation:ArchitectureOverview" relation="ReadNext" />
|
|
49
49
|
</references>
|
|
50
50
|
|
|
51
51
|
</block>
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
Aligns with docs/19 Definition / bml:xml D2 consumer rules. Serializer may still emit
|
|
37
37
|
BML_NAMESPACE_UNBOUND if a QName lacks a binding after merge.</documentation>
|
|
38
38
|
<references>
|
|
39
|
-
<see type="fbdocumentation:OutputLayout" relation="ReadNext"
|
|
39
|
+
<see type="fbdocumentation:OutputLayout" relation="ReadNext" />
|
|
40
40
|
</references>
|
|
41
41
|
|
|
42
42
|
</block>
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
Single file per render. Content is canonical BML XML from SerializeFatDocument
|
|
35
35
|
(indent 2, no XML declaration by serializer defaults).</documentation>
|
|
36
36
|
<references>
|
|
37
|
-
<see type="fbdocumentation:Diagnostics" relation="ReadNext"
|
|
37
|
+
<see type="fbdocumentation:Diagnostics" relation="ReadNext" />
|
|
38
38
|
</references>
|
|
39
39
|
|
|
40
40
|
</block>
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
|
|
43
43
|
@blockml/compiler owns: RenderTarget contract and document compile scope.</documentation>
|
|
44
44
|
<references>
|
|
45
|
-
<see type="fbdocumentation:ScopeExclusions" relation="ReadNext"
|
|
45
|
+
<see type="fbdocumentation:ScopeExclusions" relation="ReadNext" />
|
|
46
46
|
</references>
|
|
47
47
|
|
|
48
48
|
</block>
|
|
@@ -39,10 +39,10 @@
|
|
|
39
39
|
|
|
40
40
|
BML: fbcap:Render, ValidateRequest, AssembleFatDocument, api/FatBlockOptions.</documentation>
|
|
41
41
|
<references>
|
|
42
|
-
<see type="fbdocumentation:CandidateCollection" relation="ReadNext"
|
|
43
|
-
<see type="fbcap:Render" relation="Defines"
|
|
44
|
-
<see type="fbapi:FatBlockOptions" relation="Defines"
|
|
45
|
-
<see type="fbcap:AssembleFatDocument" relation="Defines"
|
|
42
|
+
<see type="fbdocumentation:CandidateCollection" relation="ReadNext" />
|
|
43
|
+
<see type="fbcap:Render" relation="Defines" />
|
|
44
|
+
<see type="fbapi:FatBlockOptions" relation="Defines" />
|
|
45
|
+
<see type="fbcap:AssembleFatDocument" relation="Defines" />
|
|
46
46
|
</references>
|
|
47
47
|
|
|
48
48
|
</block>
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
• Inventing or rewriting xmlns prefixes
|
|
45
45
|
• Nested / pre-fatted host merge</documentation>
|
|
46
46
|
<references>
|
|
47
|
-
<see type="fbdocumentation:PublicApi" relation="ReadNext"
|
|
47
|
+
<see type="fbdocumentation:PublicApi" relation="ReadNext" />
|
|
48
48
|
</references>
|
|
49
49
|
|
|
50
50
|
</block>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@blockml/fatblock-target",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.1",
|
|
4
4
|
"description": "BlockML FatBlock render target — portable .bml folder bundles",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -32,12 +32,12 @@
|
|
|
32
32
|
"test": "vitest run packages/fatblock-target/test"
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
-
"@blockml/bom": "^0.8.
|
|
36
|
-
"@blockml/compiler": "^0.8.
|
|
35
|
+
"@blockml/bom": "^0.8.1",
|
|
36
|
+
"@blockml/compiler": "^0.8.1",
|
|
37
37
|
"@blockml/core": "^1.0.6",
|
|
38
|
-
"@blockml/framework": "^0.8.
|
|
39
|
-
"@blockml/parser": "^0.8.
|
|
40
|
-
"@blockml/serializer": "^0.8.
|
|
38
|
+
"@blockml/framework": "^0.8.1",
|
|
39
|
+
"@blockml/parser": "^0.8.1",
|
|
40
|
+
"@blockml/serializer": "^0.8.1"
|
|
41
41
|
},
|
|
42
42
|
"engines": {
|
|
43
43
|
"node": ">=20"
|