@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.0

package/pipeline/skills/figma-ios/figma-to-component/reference/code-connect.md

@@ -1,531 +0,0 @@
-# CODE CONNECT REFERENCE (SwiftUI)
-
-## 1. SETUP
-
-### 1.1 Prerequisites
-- Swift 6.0+ (Xcode 16.0+)
-- Node.js 18+
-- Figma Access Token with scopes: file_content:read, code_connect:write
-- PATs capped at 90-day expiry
-
-### 1.2 CLI Installation
-Two options:
-- Global: `npm install --global @figma/code-connect@latest` then `figma connect <cmd>`
-- No-install (npx): `npx @figma/code-connect@latest connect <cmd>`  -  recommended for CI/CD and machines without global install
-- Local dependency: if `@figma/code-connect` is a package dependency, just use `npx figma connect <cmd>` from the package root
-
-Current installed version: 1.3.12 (latest available: 1.4.1)
-
-### 1.3 SPM Dependency
-```swift
-.package(url: "https://github.com/figma/code-connect", from: "1.2.0")
-```
-Product: "Figma" library  -  provides property wrappers only. CLI is npm-based, NOT from SPM.
-
-### 1.4 Configuration (figma.config.json)
-```json
-{
-  "codeConnect": {
-    "parser": "swift",
-    "include": ["Sources/**/*.figma.swift"],
-    "exclude": ["Tests/**", ".build/**"],
-    "swiftPackagePath": "./Package.swift",
-    "sourcePackagesPath": "/path/to/DerivedData/SourcePackages"
-  }
-}
-```
-Note: sourcePackagesPath added in 1.3.5, optional. language field added in 1.3.13.
-
-### 1.5 Multi-Package Setup
-When `.figma.swift` files live in a package that doesn't directly depend on the Figma SDK:
-1. Point `swiftPackagePath` to the package that HAS the Figma dependency:
-   ```json
-   { "swiftPackagePath": "../ExternalPackages/Package.swift" }
-   ```
-2. Add `exclude: ["CodeConnect"]` to the target in `Package.swift` so `.figma.swift` files don't break compilation (the target doesn't import Figma):
-   ```swift
-   .target(name: "UIAssets", path: "iOS/Sources/UIAssets", exclude: ["CodeConnect"])
-   ```
-3. Set `include` to match the CodeConnect directory:
-   ```json
-   { "include": ["iOS/Sources/UIAssets/CodeConnect/**/*.figma.swift"] }
-   ```
-
-## 2. FILE FORMAT
-
-### 2.1 Naming
-| Item | Format |
-|------|--------|
-| File | `<ComponentName>.figma.swift` |
-| Struct | `<ComponentName>FigmaConnect` |
-
-### 2.2 Location
-```
-Component/
-├── Component.swift
-├── Component.figma.swift
-└── FIGMA.md
-```
-
-### 2.3 Template  -  Static (No Figma Properties)
-```swift
-import Figma
-import SwiftUI
-
-struct ComponentNameFigmaConnect: FigmaConnect {
-    let component = ComponentName.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-
-    var body: some View {
-        ComponentName(title: "Static Title", isEnabled: true)
-    }
-}
-```
-
-### 2.4 Template  -  Mapped Properties
-```swift
-import Figma
-import SwiftUI
-
-struct ComponentNameFigmaConnect: FigmaConnect {
-    let component = ComponentName.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-
-    @FigmaString("Label")
-    var label: String = "Default"
-
-    @FigmaEnum("Size", mapping: [
-        "Small": ComponentSize.small,
-        "Medium": ComponentSize.medium,
-        "Large": ComponentSize.large
-    ])
-    var size: ComponentSize = .medium
-
-    @FigmaBoolean("Disabled", hideDefault: true)
-    var disabled: Bool = false
-
-    var body: some View {
-        ComponentName(label: label)
-            .size(size)
-            .disabled(disabled)
-    }
-}
-```
-
-### 2.5 Template  -  Multi-Variant (string enum)
-```swift
-struct PrimaryButtonFigmaConnect: FigmaConnect {
-    let component = Button.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    let variant = ["Type": "Primary"]
-    var body: some View { Button("Label", style: .primary) }
-}
-
-struct SecondaryButtonFigmaConnect: FigmaConnect {
-    let component = Button.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    let variant = ["Type": "Secondary"]
-    var body: some View { Button("Label", style: .secondary) }
-}
-```
-
-### 2.6 Template  -  Multi-Variant (boolean gate)
-Use a computed `var variant` property when matching on a boolean toggle (e.g., "Label" on/off):
-```swift
-// Default struct (Label = true, the default)
-struct LabelBadgeFigmaConnect: FigmaConnect {
-    let component = LabelBadge.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    // no variant → matches when Label is true (default)
-    var body: some View { LabelBadge { config in config.text(text) } }
-}
-
-// Icon-only struct (Label = false)
-struct LabelBadgeIconOnlyFigmaConnect: FigmaConnect {
-    let component = LabelBadge.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    var variant: [String: Any]? { ["Label": false] }
-    var body: some View { LabelBadge { config in config.leftIcon(leftIcon) } }
-}
-```
-Figma shows the most specific matching struct. When "Label" is toggled off, the icon-only struct renders.
-
-### 2.7 Template  -  Icon/Symbol (no component)
-For simple icon nodes without component properties  -  no `let component`, no property wrappers:
-```swift
-struct PlusCircleFillIconConnect: FigmaConnect {
-    let figmaNodeUrl = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    var body: some View { Image.plusCircleFill }
-}
-```
-Used for bulk icon Code Connect. See `generate_icons.py` in the configuration package for batch generation.
-
-## 3. PROPERTY WRAPPERS
-
-| Wrapper | Figma Type | Swift Type | Example |
-|---------|-----------|------------|---------|
-| `@FigmaString("Name")` | TEXT | String | `@FigmaString("Label") var label: String = "Default"` |
-| `@FigmaEnum("Name", mapping: [...])` | VARIANT | Enum | `@FigmaEnum("Size", mapping: ["S": .small]) var size` |
-| `@FigmaBoolean("Name")` | BOOLEAN | Bool / Any | `@FigmaBoolean("Disabled") var disabled: Bool = false` |
-| `@FigmaInstance("Name")` | INSTANCE_SWAP | View | `@FigmaInstance("Icon") var icon: AnyView?` |
-| `@FigmaChildren(layers: [...])` | Nested | [View] | `@FigmaChildren(layers: ["Row"]) var children` |
-
-### hideDefault
-Omits parameter from code snippet when at default value:
-`@FigmaBoolean("Disabled", hideDefault: true) var disabled: Bool = false`
-
-### @FigmaBoolean with mapping
-Maps boolean to non-Bool types (e.g., optional Image). Use when a boolean toggle controls presence of a non-boolean value:
-```swift
-@FigmaBoolean("Left Icon", mapping: [true: Image(systemName: "plus.circle"), false: nil], hideDefault: true)
-var leftIcon: Image? = nil
-```
-When `hideDefault: true` and value is `nil` (default), the `.leftIcon(...)` line is omitted from the snippet entirely.
-
-**IMPORTANT  -  hideDefault default value trap:** When using `hideDefault: true` with a mapping, the **default value** determines which mapped result gets hidden. Set the default to the value you want HIDDEN (typically `nil` for optionals):
-
-```swift
-// CORRECT  -  default=nil: Text=true shows .initials("BT"), Text=false hides it
-@FigmaBoolean("Text", mapping: [true: "BT", false: nil], hideDefault: true)
-var initials: String? = nil
-
-// WRONG  -  default="BT": Text=true HIDES .initials("BT"), Text=false shows .initials(nil)
-@FigmaBoolean("Text", mapping: [true: "BT", false: nil], hideDefault: true)
-var initials: String? = "BT"  // ← "BT" matches default, so it's hidden!
-```
-
-### @FigmaEnum  -  prefer implicit shorthand
-Use `.success` instead of `LabelBadgeConfiguration.LabelBadgeState.success` in mappings. The parser captures the expression as-is via `trimmedDescription`, so shorter values produce cleaner snippets:
-```swift
-// GOOD  -  clean snippet output
-@FigmaEnum("State", mapping: ["Success": .success, "Warning": .warning])
-
-// BAD  -  verbose snippet output
-@FigmaEnum("State", mapping: ["Success": LabelBadgeConfiguration.LabelBadgeState.success])
-```
-
-### @FigmaInstance
-Maps instance-swap properties to render the swapped component's Code Connect inline:
-```swift
-@FigmaInstance("Icon")
-var icon: IconComponent
-
-var body: some View {
-    MyComponent()
-        .icon(icon)
-}
-```
-When a designer swaps the icon instance in Figma, Dev Mode renders that specific icon's Code Connect snippet inline.
-
-**Limitations:**
-- Does NOT support `hideDefault`. The line always renders in the snippet, even when the instance swap is hidden (boolean off), resulting in empty content like `.leftIcon()`.
-- Workaround: use `@FigmaBoolean` with `mapping:` instead when the instance swap is controlled by a boolean toggle.
-- Useful when the instance swap is always visible and you want the swapped component's Code Connect to render inline.
-
-### figmaApply
-Conditionally applies view modifiers based on a boolean condition. In Dev Mode, Figma only shows the branch that matches the current property value  -  keeping snippets clean.
-
-**Basic  -  show modifier only when true:**
-```swift
-@FigmaBoolean("Disabled", hideDefault: true)
-var disabled: Bool = false
-
-var body: some View {
-    MyComponent()
-        .figmaApply(disabled) { $0.opacity(0.5) }
-}
-```
-When `Disabled = false` (default + hideDefault), nothing renders. When `Disabled = true`, snippet shows `.opacity(0.5)`.
-
-**With elseApply  -  different modifiers per branch:**
-```swift
-@FigmaEnum("Type", mapping: ["Primary": true, "Secondary": false])
-var isPrimary: Bool = false
-
-var body: some View {
-    MyComponent()
-        .figmaApply(isPrimary) {
-            $0.tint(.blue)
-        } elseApply: {
-            $0.backgroundColor(.clear)
-        }
-}
-```
-`elseApply` is optional  -  omit it to show nothing when condition is false.
-
-**With @FigmaBoolean + chain modifier (project pattern):**
-```swift
-@FigmaBoolean("M&S Member", hideDefault: true)
-var showMember: Bool = false
-
-@FigmaString("Member Text")
-var memberText: String = "CLASSIC"
-
-var body: some View {
-    TicketPassengerInfo(passengerName: passengerName, colorVariant: colorVariant)
-        .figmaApply(showMember) { $0.membershipInfo(.init(memberId: "TK 12345678", memberClass: memberText)) }
-}
-```
-Combines `hideDefault` boolean with a chain modifier that passes a nested configuration. When `M&S Member = false`, the `.membershipInfo(...)` line is hidden entirely in Dev Mode.
-
-**Multiple figmaApply  -  TYPE ERASURE WARNING:**
-
-`figmaApply` returns `some View`, NOT `Self`. This means chaining multiple `figmaApply` calls causes the second call's closure `$0` to be `some View` instead of the concrete view type  -  resulting in a compile error when calling component-specific modifiers inside the closure.
-
-```swift
-// ❌ COMPILE ERROR  -  second $0 is `some View`, not `MyComponent`
-var body: some View {
-    MyComponent(title: title)
-        .figmaApply(showIcon) { $0.leftIcon(icon) }      // returns some View
-        .figmaApply(showBadge) { $0.badge(badgeCount) }   // $0 is some View  -  .badge() not found
-}
-```
-
-**The parser supports multiple chained `figmaApply` calls** (it uses a multi-pass while loop to replace each one independently). The limitation is purely a Swift type-checker issue at compile time.
-
-**Workaround  -  direct modifiers first, single figmaApply last:**
-
-Apply concrete-type modifiers (chain modifiers from Configuration) directly, then place `figmaApply` as the LAST call in the chain since it erases the type:
-
-```swift
-// ✅ CORRECT  -  direct modifier preserves type, figmaApply goes last
-@FigmaBoolean("Show Badge", hideDefault: true)
-var showBadge: Bool = false
-
-@FigmaBoolean("Disabled", hideDefault: true)
-var isDisabled: Bool = false
-
-var body: some View {
-    MyComponent(title: title)
-        .showBadge(showBadge)                              // direct modifier, type preserved
-        .figmaApply(isDisabled) { $0.opacity(0.5) }        // figmaApply last, returns some View  -  OK
-}
-```
-
-**Multiple booleans  -  use direct modifiers + single figmaApply:**
-
-When a component has multiple boolean properties, prefer direct modifiers for Bool-to-Bool mappings and reserve `figmaApply` for conditional complex expressions (optional Strings, nested configs):
-
-```swift
-@FigmaBoolean("Whith Baby", hideDefault: true)
-var whithBaby: Bool = false
-
-@FigmaBoolean("+1 Boarding", hideDefault: true)
-var showBoardingDate: Bool = false
-
-var body: some View {
-    TicketQrInfoGroup(
-        terminalNumber: "1", gateNumber: "G23",
-        seatNumber: "24 A", boardingTime: "23:30",
-        qrCodeData: "TICKET-QR-DATA"
-    )
-    .whithBaby(whithBaby)                                   // Bool → Bool, direct modifier
-    .figmaApply(showBoardingDate) { $0.boardingDate("13 Eyl") }  // Bool → optional String, figmaApply last
-}
-```
-
-**If you MUST use multiple figmaApply (e.g., both need elseApply or complex expressions):**
-
-The parser handles it fine  -  it's only the Swift compiler that objects. Use the comment-out-after-publish pattern:
-
-1. Write the `.figma.swift` with multiple `figmaApply` calls
-2. Comment out the file content temporarily for `figma connect publish` (parser reads the file directly, not via Xcode build)
-3. Actually: the parser reads `.figma.swift` files via SwiftSyntax, NOT through Xcode compilation. So publish works regardless of build errors.
-4. After publish, comment out the body or the entire struct to prevent Xcode build failures:
-
-```swift
-// Published to Figma Dev Mode  -  commented to avoid type erasure build error
-// struct MyComponentFigmaConnect: FigmaConnect {
-//     ...
-//     var body: some View {
-//         MyComponent(title: title)
-//             .figmaApply(showIcon) { $0.leftIcon(icon) }
-//             .figmaApply(showBadge) { $0.badge(badgeCount) }
-//     }
-// }
-```
-
-**Preference order for multiple boolean properties:**
-1. **Direct modifier** (`.whithBaby(whithBaby)`)  -  cleanest, no type erasure
-2. **@FigmaBoolean with mapping** (`mapping: [true: "value", false: nil]`)  -  for Bool → optional type
-3. **Single figmaApply last**  -  for complex conditional expressions
-4. **Multiple figmaApply + comment after publish**  -  last resort when multiple complex conditionals needed
-
-**When to use figmaApply vs direct parameter:**
-- **Direct parameter**: Property maps 1:1 to init/modifier argument (e.g., `@FigmaEnum → colorStyle:`)
-- **Direct modifier with @FigmaBoolean**: Bool property maps 1:1 to Bool modifier parameter
-- **figmaApply**: Boolean controls presence/absence of a non-boolean modifier or configuration block
-- **figmaApply + elseApply**: Boolean switches between two different modifier expressions
-
-### @FigmaChildren
-Renders nested child instances that aren't bound to an instance-swap prop. Takes layer names as parameters (the Figma layer name, not the component name):
-```swift
-@FigmaChildren(layers: ["Header", "Row"])
-var contents: AnyView?
-
-var body: some View {
-    MyList {
-        contents
-    }
-}
-```
-Use when the component uses slot-based composition in Figma (e.g., a list with repeating row children).
-
-**Wildcard matching**  -  match any or partial layer names:
-```swift
-@FigmaChildren(layers: ["*"])           // all children
-var allItems: AnyView?
-
-@FigmaChildren(layers: ["Icon*"])       // partial match  -  "IconLeft", "IconRight", etc.
-var icons: AnyView?
-
-@FigmaChildren(layers: ["Tab 1", "Tab 2", "Tab 3"])  // multiple specific layers
-var tabs: AnyView?
-```
-Layer name matching is **case sensitive**. The nested instance must have its own separate Code Connect file.
-
-**Slots**  -  composable sub-areas within component instances where designers can place freeform content. Code Connect does NOT traverse slot children to generate code  -  it only renders a reference to the slot itself. Use `@FigmaChildren` to capture slot content.
-
-## 3.5 ADVANCED PATTERNS
-
-### Variant restrictions  -  multiple structs per component
-When a single Figma component maps to different Swift types based on variant, create multiple `FigmaConnect` structs pointing to the same node. Figma shows the most specific match:
-```swift
-// Matches when Type = "Primary"
-struct PrimaryButtonConnect: FigmaConnect {
-    let component = PrimaryButton.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    let variant = ["Type": "Primary"]
-    var body: some View { PrimaryButton(label: label) }
-}
-
-// Matches when Type = "Danger" AND Disabled = false
-struct DangerButtonConnect: FigmaConnect {
-    let component = DangerButton.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    let variant = ["Type": "Danger", "Disabled": false]
-    var body: some View { DangerButton(label: label) }
-}
-```
-More specific variant dictionaries take priority. Combine multiple variant properties for fine-grained matching.
-
-### Computed variant  -  boolean gate for separate structs
-Use a computed `var variant` property for dynamic matching (e.g., boolean toggles):
-```swift
-struct IconOnlyBadgeConnect: FigmaConnect {
-    let component = LabelBadge.self
-    let figmaNodeUrl: String = "https://figma.com/design/FILE_KEY/?node-id=X-Y"
-    var variant: [String: Any]? { ["Label": false] }
-    var body: some View { LabelBadge { config in config.leftIcon(icon) } }
-}
-```
-
-### @FigmaBoolean with custom mapping  -  non-Bool types
-Map boolean toggles to any Swift type, not just Bool. Useful for optional views:
-```swift
-// Boolean controls icon presence  -  maps to optional Image
-@FigmaBoolean("Has Icon", mapping: [true: Image(systemName: "star.fill"), false: nil], hideDefault: true)
-var icon: Image? = nil
-
-// Boolean controls text presence  -  maps to optional String
-@FigmaBoolean("Show Label", mapping: [true: "Default Label", false: nil], hideDefault: true)
-var label: String? = nil
-
-var body: some View {
-    MyComponent()
-        .icon(icon)
-        .label(label)
-}
-```
-When `Has Icon = false` (default + hideDefault), `.icon(...)` is omitted from snippet entirely.
-
-### @FigmaEnum  -  map to Bool for figmaApply
-Convert an enum variant to a boolean condition for use with `figmaApply`:
-```swift
-@FigmaEnum("State", mapping: ["Disabled": true, "Default": false, "Hover": false, "Active": false])
-var isDisabled: Bool = false
-
-var body: some View {
-    MyComponent()
-        .figmaApply(isDisabled) { $0.disabled(true).opacity(0.5) }
-}
-```
-
-### Preview as documentation
-Code Connect structs work as Xcode previews, eliminating redundant preview code:
-```swift
-#Preview {
-    ComponentNameFigmaConnect()
-}
-```
-This renders the exact same configuration shown in Figma Dev Mode, keeping code and design in sync.
-
-## 4. CLI COMMANDS
-
-| Command | Purpose |
-|---------|---------|
-| `figma connect create "FIGMA_URL"` | Generate .figma.swift from Figma node URL |
-| `figma connect parse` | Validate Code Connect files locally |
-| `figma connect publish` | Publish to Figma (makes visible in Dev Mode) |
-| `figma connect publish --dry-run` | Preview what would be published |
-| `figma connect unpublish --label="SwiftUI"` | Remove published connections (--label REQUIRED since 1.3.6) |
-
-Auth: set `FIGMA_ACCESS_TOKEN` env var, or use `--token=YOUR_TOKEN` flag.
-
-Keychain retrieve:
-```bash
-export FIGMA_ACCESS_TOKEN=$("$HOME/.claude/lib/credential-store.sh" get \1)
-```
-
-All commands work with npx: `npx @figma/code-connect@latest connect <command>`
-
-## 5. MCP vs CLI
-
-MCP tools do simple path mappings. CLI does rich property-mapped snippets.
-
-| Capability | MCP | CLI |
-|-----------|-----|-----|
-| Map Figma node → code file path | Yes (add_code_connect_map) | Not needed |
-| Auto-detect unmapped components | Yes (get_code_connect_suggestions) | No |
-| Generate .figma.swift with prop mappings | No | Yes (figma connect create) |
-| Publish dynamic snippets to Dev Mode | No | Yes (figma connect publish) |
-| Property mapping (@FigmaEnum etc.) | No | Yes |
-| Swift syntax parsing | No | Yes |
-
-**Use MCP** for AI agent context (which Swift file = which Figma node).
-**Use CLI** for real Code Connect with dynamic Dev Mode snippets.
-
-## 6. PARSER BEHAVIOR
-
-The CLI parser uses SwiftSyntax AST analysis. Key behaviors that affect what developers see in Dev Mode:
-
-| Element | Behavior |
-|---------|----------|
-| `//` comments in body | **Stripped**  -  never appear in snippet |
-| `import` statements beyond Figma/SwiftUI | **Stripped**  -  `imports: []` always empty |
-| View modifiers (`.renderingMode(.template)`) | **Preserved**  -  captured via `trimmedDescription` |
-| Property wrapper expressions | **Preserved**  -  any expression works (e.g., `Image(systemName: "x")`) |
-| `let component = X.self` | **Optional**  -  only needed for component-level Code Connect |
-
-Do NOT rely on comments or extra imports to communicate with developers in snippets. Use view modifiers or static values in body instead.
-
-## 7. ERROR REFERENCE
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `Swift tools version X but installed is Y` | Wrong Swift | Update Xcode |
-| `SyntaxError: Unexpected end of JSON` | Swift version mismatch | Check Swift version |
-| `Property "X" does not exist` | Figma prop not found | Remove wrapper, use static value |
-| `Couldn't find a Figma access token` | Token not set | Set FIGMA_ACCESS_TOKEN |
-| `401 Unauthorized` | Invalid token | Regenerate with correct scopes |
-| `Could not find component at node` | Wrong nodeId | Use colon format, verify node |
-| `No Code Connect files found` | Wrong include | Check figma.config.json |
-| `no such module 'Figma'` | Not resolved | Run swift package resolve |
-
-## 8. VERIFICATION
-
-After publish, verify via MCP:
-```
-mcp__figma-remote__get_code_connect_map(fileKey: "KEY", nodeId: "X:Y")
-```
-Returns mapping if published. Allow 1-2 min propagation delay.

package/pipeline/skills/figma-ios/figma-to-component/reference/confluence-api.md

@@ -1,89 +0,0 @@
-# CONFLUENCE API REFERENCE
-
----
-
-## Authentication
-
-| Platform | Method | Header |
-|----------|--------|--------|
-| Cloud (*.atlassian.net) | Basic Auth | `Authorization: Basic base64(username:token)` |
-| Data Center/Server | Bearer Token (PAT) | `Authorization: Bearer <token>` |
-
----
-
-## Endpoints
-
-### Find Page
-```
-GET /rest/api/content?spaceKey={SPACE}&title={TITLE}&expand=version
-```
-Returns: `{ "results": [{ "id": "123456", "title": "...", "version": { "number": 5 } }] }`
-
-### Create Page
-```
-POST /rest/api/content
-Content-Type: application/json
-```
-Body: `{ "type": "page", "title": "...", "space": { "key": "SPACE_KEY" }, "body": { "wiki": { "value": "h1. Content", "representation": "wiki" } } }`
-
-### Update Page
-```
-PUT /rest/api/content/{pageId}
-Content-Type: application/json
-```
-Body: Same as create + `"id": "123456"` + `"version": { "number": N+1 }`
-
-### Upload Attachment
-```
-POST /rest/api/content/{pageId}/child/attachment
-Content-Type: multipart/form-data
-X-Atlassian-Token: nocheck
-```
-
-### List Attachments
-```
-GET /rest/api/content/{pageId}/child/attachment
-```
-
-### Delete Attachment
-```
-DELETE /rest/api/content/{attachmentId}
-```
-
----
-
-## Content Formats
-
-| Format | Use Case |
-|--------|----------|
-| `wiki` | Wiki markup (simpler, recommended) |
-| `storage` | XHTML storage format (complex) |
-
----
-
-## Wiki Markup Quick Reference
-
-| Markdown | Wiki Markup |
-|----------|-------------|
-| `# H1` | `h1. H1` |
-| `## H2` | `h2. H2` |
-| `**bold**` | `*bold*` |
-| `- item` | `* item` |
-| `---` | `----` |
-| `\|a\|b\|` (header) | `\|\|a\|\|b\|\|` |
-| `\|a\|b\|` (row) | `\|a\|b\|` |
-| `[text](url)` | `[text\|url]` |
-| image | `!image.png!` |
-| attachment link | `[^filename.csv]` |
-
----
-
-## Macros
-
-```
-{toc}                             - Table of contents
-{panel:title=Title}content{panel} - Panel box
-{code:language=swift}code{code}   - Code block
-{note}text{note}                  - Note callout
-{warning}text{warning}            - Warning callout
-```