@flowstack-ui/agent-tools 0.1.0-bootstrap.0

package/public/packages/colors/0.1.1/docs/palette-generation.txt

@@ -0,0 +1,151 @@
+# Public document: palette-generation
+
+Source: @flowstack-ui/colors@0.1.1
+
+# Palette Candidate Generation
+
+Status: **Batch 7.4 implemented; interchange schema qualified**
+
+Colors turns one or more explicit seeds into reviewable palette candidates. It
+does not turn them into a Theme and never guesses semantic meaning from hue.
+
+## Request
+
+```ts
+import {
+  COLOR_GENERATION_REQUEST_SCHEMA,
+  generatePaletteCandidate,
+} from "@flowstack-ui/colors";
+
+const candidate = generatePaletteCandidate({
+  $schema: COLOR_GENERATION_REQUEST_SCHEMA,
+  seeds: [
+    {
+      id: "primary-brand",
+      name: "Primary brand",
+      intent: "Main interactive identity",
+      color: "#3157d5",
+      profile: "interface",
+    },
+    {
+      id: "campaign",
+      color: "#f97316",
+      profile: "interface",
+      preservation: { mode: "bounded", maxDeltaE: 0.03 },
+    },
+  ],
+});
+```
+
+Seed IDs must be unique. CSS Color 4 strings and structured Design Tokens
+color values use the same input contract as the foundation APIs. Light and
+dark are generated by default; `options.appearances` can request either one.
+
+Malformed requests throw a `TypeError`. A well-formed request that cannot meet
+its constraints returns a serializable `rejected` candidate with exact paths,
+measurements, and reasons. Rejection is data, not an exception.
+
+## Profiles
+
+### Interface
+
+An interface family contains `soft`, `softHover`, `softPressed`, `border`,
+`borderStrong`, `focusRing`, `solid`, `solidHover`, `solidPressed`, `text`,
+`textHover`, `textPressed`, `onSoft`, and `onSolid` roles for each appearance.
+The exact seed is the `solid` anchor. The three text roles form a separately
+generated resting, hover, and pressed foreground sequence; they are candidate
+values for Theme mapping, not interaction behavior owned by Colors.
+
+Colors measures:
+
+- state lightness direction and adjacent deltaEOK distinction;
+- `onSoft` against every soft state;
+- one `onSolid` foreground against all solid states;
+- resting, hover, and pressed text state order and adjacent deltaEOK
+  distinction;
+- every text state against every appearance reference background; and
+- solid, strong border, and focus ring against that background.
+
+Reference backgrounds default to `#ffffff` for light and `#111111` for dark.
+An author may provide one or more opaque backgrounds per appearance with
+`options.referenceBackgrounds`. Colors then finds `text`, `textHover`,
+`textPressed`, `borderStrong`, and `focusRing` values that pass every supplied
+surface and records every exact measurement. This lets a Theme candidate
+account for canvas, raised, overlay, and similar real surfaces before mapping.
+Theme still remeasures the actual Brick pairs after mapping.
+
+### Neutral
+
+A neutral family uses the seed hue and bounded chroma influence to propose
+canvas, surfaces, surface states, borders, ordinary text levels, and an
+inverse text foreground. The exact seed is
+kept as a separate family anchor rather than forced into an unsuitable semantic
+role. Text and strong-border pairs and interactive surface distinctions are
+measured in each appearance.
+
+### Decorative
+
+A decorative family is an ordered raw light/dark palette with no accessibility
+claim. It defaults to 12 steps with the seed at step 9, preserving the former
+explicit scale capability. Authors can request 3 through 24 steps and choose an
+interior anchor step. Colors validates order, adjacent distinction, gamut, and
+preservation only.
+
+## Preservation
+
+`exact` is the default. The canonical sRGB seed remains the family anchor. An
+exact source outside sRGB is rejected rather than silently changed; the
+structured source and required gamut change remain visible.
+
+`bounded` authorizes deterministic adaptation up to `maxDeltaE`. Colors tries
+the canonical sRGB seed first, then searches lightness and chroma candidates in
+a stable order. It chooses the smallest measured adaptation that satisfies the
+declared profile. The source hex, final anchor hex, deltaEOK, and whether an
+adaptation occurred are all recorded. If no solution fits inside the bound,
+the family is rejected.
+
+## Safety defaults
+
+- text pairs: at least `4.5:1` WCAG contrast;
+- non-text pairs: at least `3:1`;
+- adjacent states and decorative steps: at least `0.02` deltaEOK; and
+- multi-seed collision warning: below `0.05` deltaEOK.
+
+A request can strengthen these thresholds. It cannot lower the text, non-text,
+or state safety floors. A collision is advisory because two intentionally
+duplicated families may still be useful; it does not reject otherwise valid
+families.
+
+Every generated color includes its desired structured value, exact sRGB hex,
+whether gamut mapping occurred, mapping deltaEOK, method, and difference from
+the seed. All contrast measurements use the exact emitted hex values, not
+unrounded intermediate coordinates.
+
+## Named raw references
+
+`NAMED_PALETTE_NAMES`, `isNamedPaletteName()`, and `getNamedPalette()` expose
+31 familiar neutral and chromatic names. Every result is generated entirely by
+FLOWSTACK from a documented FLOWSTACK seed, contains 12-step light and dark
+output, and is marked `raw-reference`. These values are convenient color
+families, not Theme-qualified relationships.
+
+## Candidate meaning
+
+`flowstack.colors-candidate.v1` records families, measurements,
+diagnostics, source records, preservation, `unreviewed` status, and deterministic
+algorithm provenance. It has no timestamps or random values, so identical
+normalized inputs produce identical JSON bytes.
+
+Batch 7.4 finalized this serialized boundary after a reviewed seven-family
+candidate was scaffolded into an ordinary editable Theme, passed all 152 exact
+Brick contrast evaluations, and passed the complete rendered catalog in light
+and dark at desktop and mobile sizes. That qualifies the interchange contract,
+not every future candidate. A person must still review each candidate, Theme
+must explicitly map its chosen values, and the relevant product must earn its
+own contract and rendered qualification.
+
+`reviewPaletteCandidate(candidate, decision)` records an explicit `accepted`,
+`edited`, or `rejected` human decision without mutating generation evidence or
+adding timestamps and environment data. A generator-rejected candidate cannot
+be marked accepted without edits. Theme interchange accepts only reviewed
+candidates and still validates every exact mapped value independently.

package/public/packages/colors/0.1.1/docs/releasing.txt

@@ -0,0 +1,34 @@
+# Public document: releasing
+
+Source: @flowstack-ui/colors@0.1.1
+
+# Releasing
+
+Colors publishes only from a version tag on protected repository history. A
+maintainer does not run `npm publish` from a working tree.
+
+## Release contract
+
+1. Set the package, lockfile, exported producer, changelog, and documentation
+   to the same version.
+2. Run `npm run check:release` and review the exact archive inspected by the
+   clean-consumer gate.
+3. Merge the release commit into `main` through required CI.
+4. Create and push the matching `v<version>` tag on that merged commit.
+5. The tag workflow confirms that the tag matches `package.json`, belongs to
+   `main`, and is not already published.
+6. CI rebuilds and rechecks the repository, creates one archive, uploads it,
+   and publishes that same archive through the protected `npm` environment
+   using trusted publishing and provenance.
+7. Verify the registry metadata and install the exact public version into a
+   fresh consumer before declaring the release complete.
+
+The workflow is idempotent for an already-published version and creates the
+matching GitHub release. Tags must never be moved or reused.
+
+## Requalification triggers
+
+Repeat the Theme and complete rendered Brick qualification before releasing a
+change to candidate roles, generation algorithms, exact palette relationships,
+contrast rules, semantic interchange requirements, or the color engine. Pure
+documentation corrections still run repository and exact-archive gates.

package/public/packages/colors/0.1.1/docs/testing.txt

@@ -0,0 +1,51 @@
+# Public document: testing
+
+Source: @flowstack-ui/colors@0.1.1
+
+# Colors Testing
+
+Colors must earn trust through exact evidence rather than visual smoothness
+alone.
+
+## Repository gate
+
+```bash
+npm run check:repository
+```
+
+The repository gate covers TypeScript, serializable boundary tests, CSS and
+Design Tokens inputs, conversion without hidden mapping, difficult gamut
+cases, exact contrast vectors, alpha rejection, difference methods,
+provenance, deterministic fixtures, qualified Culori behavior, package
+contents, Agent Knowledge catalog and report parity, and a clean packed
+consumer. The Agent Knowledge gate rejects missing, stale, duplicate, or extra
+classifications and generated artifacts. Candidate tests add multiple profiles,
+independent appearances, exact and bounded preservation, state ordering,
+foreground pairs, rejection diagnostics, configurable decorative output,
+multi-seed collisions, 31 named raw references, difficult-color gates, and a
+byte-stable golden digest. It also covers explicit review decisions, neutral
+inverse text, and interface qualification against multiple exact project
+surfaces. See
+`dependency-qualification.md` [source reference: dependency-qualification.md] for the selection
+evidence and requalification triggers. The file interchange has additionally
+passed a private real Theme compilation with all 152 Brick contrast results and
+the complete 80-route desktop/mobile light/dark catalog. Those cross-repository
+gates must be repeated when candidate meaning or mapping behavior changes.
+
+## Release gate
+
+```bash
+npm run check:release
+```
+
+The release gate equals the complete repository gate. It verifies the public
+source boundary, release metadata and pinned workflow actions, exact engine
+version, candidate behavior, types, deterministic fixtures, archive contents,
+and a clean JavaScript and TypeScript consumer installed from the archive. The
+installed-copy check resolves the manifest and every guide artifact, traverses
+all 76 classified API surfaces, and exercises all six operation families.
+
+Publishing happens only from a matching immutable tag on `main`. The protected
+workflow rebuilds and repeats this gate, uploads one archive, then publishes
+that exact archive with npm provenance. See
+`releasing.md` [source reference: releasing.md].

package/public/packages/colors/0.1.1/guides/colors-system.txt

@@ -0,0 +1,282 @@
+# FLOWSTACK Colors system
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: guide
+ID: colors-system
+
+# FLOWSTACK Colors system
+
+## Purpose
+
+Select, execute, and review deterministic color operations without assigning component semantics or hiding changes to source colors.
+
+## Decision order
+
+1. Identify whether the task is inspection, conversion, measurement, raw-reference lookup, candidate generation and review, or provenance recording.
+2. Preserve the exact source color unless the caller explicitly requests a bounded adaptation policy.
+3. Keep conversion, gamut mapping, contrast, and perceptual difference as distinct reported operations.
+4. For palette work, declare the intended profile and every exact interface reference surface before generation.
+5. Review the deterministic candidate explicitly and retain its generation and engine provenance.
+6. Hand only reviewed serialized candidates to Theme for semantic mapping and exact Brick contract validation.
+7. Let the application or authorized project process make final brand and product-use decisions.
+
+## Selection map
+
+- **parse, normalize, or validate a supported color value:** use Color inspection. Use parseColor for syntax, normalizeColor for a serializable record, and validateColor for structured diagnostics.
+- **convert a color space or explicitly map a color into an output gamut:** use Color conversion and gamut mapping. Conversion does not silently imply gamut mapping; request and report mapping separately.
+- **measure exact contrast or perceptual difference:** use Color contrast and difference measurement. Measure exact pairs and provide an explicit backdrop before making a claim about translucent colors.
+- **retrieve a stable named FLOWSTACK palette:** use Named palette reference. Treat the result as raw-reference data; step positions do not confer UI meaning or accessibility.
+- **generate, inspect, and explicitly accept or reject a deterministic palette candidate:** use Palette candidate generation and review. Acceptance covers declared Colors measurements only; Theme and rendered Brick qualification remain separate.
+- **record the source, engine, package, and transformation evidence for a color result:** use Color provenance. Keep provenance serializable and preserve the exact qualified engine version.
+- **assign accent, danger, warning, success, information, surface, or text meaning:** use Theme semantic mapping after explicit candidate review. Colors never infers component or project semantics from hue or palette position.
+
+## Rules
+
+- **MUST:** Treat Colors output as a candidate until a person or explicitly authorized project process approves it and Theme maps and validates its exact values.
+- **MUST:** Preserve exact source colors by default; adapt only under an explicit bounded policy and report the perceptual change.
+- **MUST:** Make accessibility claims only for exact measured foreground and background pairs.
+- **MUST:** Do not infer accent, danger, warning, success, or information meaning merely from hue or palette position.
+- **MUST:** Keep Colors out of React, the DOM, Brick, Theme, and the ordinary application browser runtime; exchange serializable artifacts with Theme.
+- **MUST:** Pin the qualified color engine exactly and treat its recorded version as part of deterministic provenance.
+- **MUST:** Do not regenerate an accepted Theme merely because Colors is upgraded; review candidate diffs and repeat semantic and rendered qualification.
+- **MUST:** Keep conversion and gamut mapping separate and report the method and perceptual change whenever a color is mapped.
+- **MUST:** Do not claim contrast or perceptual difference for a translucent color without an explicit backdrop.
+- **MUST:** Treat accepted as passing only the candidate's declared Colors measurements; Theme mapping and rendered Brick qualification remain separate gates.
+- **MUST:** Record an explicit review decision before giving a serialized candidate to Theme and preserve its exact generation evidence.
+- **MUST:** Supply every intended interface reference surface when a family must work across canvas, raised, overlay, or similar backgrounds.
+- **MUST:** Keep named FLOWSTACK palettes labelled raw-reference and do not infer interface semantics or accessibility from their step positions.
+
+## Native and higher-layer handoff
+
+1. Check the six Colors operations before writing a new color parser, converter, mapper, measurement, candidate generator, named palette lookup, or provenance envelope.
+2. Use Theme for semantic mapping and an application or authorized project process for final brand approval; do not rebuild those owners inside Colors.
+3. Report the exact unsupported operation, input, output, backdrop, or higher-layer decision when a Colors owner does not apply.
+
+## Validation checklist
+
+- Confirm the selected operation matches the task and every input uses a supported serialized color shape.
+- Verify parsing and normalization preserve the source while conversion and gamut mapping report their distinct outcomes.
+- Verify contrast and difference claims identify the exact opaque pair or an explicit qualified backdrop.
+- For candidates, inspect profile, appearances, exact reference surfaces, preservation policy, diagnostics, measurements, status, and deterministic output.
+- Confirm explicit review and complete provenance precede Theme interchange and that accepted is not described as Theme-qualified.
+- Confirm no React, DOM, Brick, Theme, application, private brand data, random generation, or hidden semantic inference entered the operation.
+- Resolve the installed package manifest and coverage report and confirm all six operation owners and all 76 public API surfaces are covered.
+
+## Related guidance
+
+- `docs/architecture.md`
+- `docs/color-foundations.md`
+- `docs/compatibility.md`
+- `docs/installation.md`
+- `docs/palette-generation.md`
+- `docs/dependency-qualification.md`
+- `docs/testing.md`
+
+## Current status
+
+0.1-release
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-guide.v1",
+  "id": "colors-system",
+  "name": "FLOWSTACK Colors system",
+  "package": "@flowstack-ui/colors",
+  "layer": "colors",
+  "kind": "guide",
+  "purpose": "Select, execute, and review deterministic color operations without assigning component semantics or hiding changes to source colors.",
+  "status": "0.1-release",
+  "decisionOrder": [
+    "Identify whether the task is inspection, conversion, measurement, raw-reference lookup, candidate generation and review, or provenance recording.",
+    "Preserve the exact source color unless the caller explicitly requests a bounded adaptation policy.",
+    "Keep conversion, gamut mapping, contrast, and perceptual difference as distinct reported operations.",
+    "For palette work, declare the intended profile and every exact interface reference surface before generation.",
+    "Review the deterministic candidate explicitly and retain its generation and engine provenance.",
+    "Hand only reviewed serialized candidates to Theme for semantic mapping and exact Brick contract validation.",
+    "Let the application or authorized project process make final brand and product-use decisions."
+  ],
+  "selection": [
+    {
+      "intent": "parse, normalize, or validate a supported color value",
+      "use": "Color inspection",
+      "note": "Use parseColor for syntax, normalizeColor for a serializable record, and validateColor for structured diagnostics.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "color-inspection"
+        }
+      ]
+    },
+    {
+      "intent": "convert a color space or explicitly map a color into an output gamut",
+      "use": "Color conversion and gamut mapping",
+      "note": "Conversion does not silently imply gamut mapping; request and report mapping separately.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "color-conversion"
+        }
+      ]
+    },
+    {
+      "intent": "measure exact contrast or perceptual difference",
+      "use": "Color contrast and difference measurement",
+      "note": "Measure exact pairs and provide an explicit backdrop before making a claim about translucent colors.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "color-measurement"
+        }
+      ]
+    },
+    {
+      "intent": "retrieve a stable named FLOWSTACK palette",
+      "use": "Named palette reference",
+      "note": "Treat the result as raw-reference data; step positions do not confer UI meaning or accessibility.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "named-palette-reference"
+        }
+      ]
+    },
+    {
+      "intent": "generate, inspect, and explicitly accept or reject a deterministic palette candidate",
+      "use": "Palette candidate generation and review",
+      "note": "Acceptance covers declared Colors measurements only; Theme and rendered Brick qualification remain separate.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "palette-candidate"
+        },
+        {
+          "kind": "native-application",
+          "id": "human-candidate-review"
+        },
+        {
+          "kind": "native-application",
+          "id": "theme-semantic-mapping"
+        }
+      ]
+    },
+    {
+      "intent": "record the source, engine, package, and transformation evidence for a color result",
+      "use": "Color provenance",
+      "note": "Keep provenance serializable and preserve the exact qualified engine version.",
+      "destinations": [
+        {
+          "kind": "operation",
+          "id": "color-provenance"
+        }
+      ]
+    },
+    {
+      "intent": "assign accent, danger, warning, success, information, surface, or text meaning",
+      "use": "Theme semantic mapping after explicit candidate review",
+      "note": "Colors never infers component or project semantics from hue or palette position.",
+      "destinations": [
+        {
+          "kind": "native-application",
+          "id": "theme-semantic-mapping"
+        },
+        {
+          "kind": "native-application",
+          "id": "application-brand-approval"
+        }
+      ]
+    }
+  ],
+  "rules": [
+    {
+      "id": "colors-candidate-not-theme",
+      "level": "must",
+      "statement": "Treat Colors output as a candidate until a person or explicitly authorized project process approves it and Theme maps and validates its exact values."
+    },
+    {
+      "id": "colors-preserve-seed",
+      "level": "must",
+      "statement": "Preserve exact source colors by default; adapt only under an explicit bounded policy and report the perceptual change."
+    },
+    {
+      "id": "colors-pair-claims",
+      "level": "must",
+      "statement": "Make accessibility claims only for exact measured foreground and background pairs."
+    },
+    {
+      "id": "colors-no-semantic-hue",
+      "level": "must",
+      "statement": "Do not infer accent, danger, warning, success, or information meaning merely from hue or palette position."
+    },
+    {
+      "id": "colors-no-runtime",
+      "level": "must",
+      "statement": "Keep Colors out of React, the DOM, Brick, Theme, and the ordinary application browser runtime; exchange serializable artifacts with Theme."
+    },
+    {
+      "id": "colors-engine-version",
+      "level": "must",
+      "statement": "Pin the qualified color engine exactly and treat its recorded version as part of deterministic provenance."
+    },
+    {
+      "id": "colors-upgrade-review",
+      "level": "must",
+      "statement": "Do not regenerate an accepted Theme merely because Colors is upgraded; review candidate diffs and repeat semantic and rendered qualification."
+    },
+    {
+      "id": "colors-gamut-honesty",
+      "level": "must",
+      "statement": "Keep conversion and gamut mapping separate and report the method and perceptual change whenever a color is mapped."
+    },
+    {
+      "id": "colors-alpha-context",
+      "level": "must",
+      "statement": "Do not claim contrast or perceptual difference for a translucent color without an explicit backdrop."
+    },
+    {
+      "id": "colors-accepted-scope",
+      "level": "must",
+      "statement": "Treat accepted as passing only the candidate's declared Colors measurements; Theme mapping and rendered Brick qualification remain separate gates."
+    },
+    {
+      "id": "colors-explicit-review",
+      "level": "must",
+      "statement": "Record an explicit review decision before giving a serialized candidate to Theme and preserve its exact generation evidence."
+    },
+    {
+      "id": "colors-reference-surfaces",
+      "level": "must",
+      "statement": "Supply every intended interface reference surface when a family must work across canvas, raised, overlay, or similar backgrounds."
+    },
+    {
+      "id": "colors-named-reference",
+      "level": "must",
+      "statement": "Keep named FLOWSTACK palettes labelled raw-reference and do not infer interface semantics or accessibility from their step positions."
+    }
+  ],
+  "nativeFallback": {
+    "check": "Check the six Colors operations before writing a new color parser, converter, mapper, measurement, candidate generator, named palette lookup, or provenance envelope.",
+    "use": "Use Theme for semantic mapping and an application or authorized project process for final brand approval; do not rebuild those owners inside Colors.",
+    "report": "Report the exact unsupported operation, input, output, backdrop, or higher-layer decision when a Colors owner does not apply."
+  },
+  "validation": [
+    "Confirm the selected operation matches the task and every input uses a supported serialized color shape.",
+    "Verify parsing and normalization preserve the source while conversion and gamut mapping report their distinct outcomes.",
+    "Verify contrast and difference claims identify the exact opaque pair or an explicit qualified backdrop.",
+    "For candidates, inspect profile, appearances, exact reference surfaces, preservation policy, diagnostics, measurements, status, and deterministic output.",
+    "Confirm explicit review and complete provenance precede Theme interchange and that accepted is not described as Theme-qualified.",
+    "Confirm no React, DOM, Brick, Theme, application, private brand data, random generation, or hidden semantic inference entered the operation.",
+    "Resolve the installed package manifest and coverage report and confirm all six operation owners and all 76 public API surfaces are covered."
+  ],
+  "related": [
+    "docs/architecture.md",
+    "docs/color-foundations.md",
+    "docs/compatibility.md",
+    "docs/installation.md",
+    "docs/palette-generation.md",
+    "docs/dependency-qualification.md",
+    "docs/testing.md"
+  ]
+}
+```

package/public/packages/colors/0.1.1/index.txt

@@ -0,0 +1,29 @@
+# @flowstack-ui/colors@0.1.1
+
+Archive SHA-256: `f23b0be0e9f0a2d514ea893c6555d7562a97e0829828b1aeff5a78c760218b08`
+Coverage: 76/76 public surfaces; zero failures.
+
+## document
+
+- [agent-knowledge](/packages/colors/0.1.1/docs/agent-knowledge.txt)
+- [architecture](/packages/colors/0.1.1/docs/architecture.txt)
+- [color-foundations](/packages/colors/0.1.1/docs/color-foundations.txt)
+- [compatibility](/packages/colors/0.1.1/docs/compatibility.txt)
+- [dependency-qualification](/packages/colors/0.1.1/docs/dependency-qualification.txt)
+- [installation](/packages/colors/0.1.1/docs/installation.txt)
+- [palette-generation](/packages/colors/0.1.1/docs/palette-generation.txt)
+- [releasing](/packages/colors/0.1.1/docs/releasing.txt)
+- [testing](/packages/colors/0.1.1/docs/testing.txt)
+
+## guide
+
+- [FLOWSTACK Colors system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## operation
+
+- [Color conversion and gamut mapping](/packages/colors/0.1.1/operations/color-conversion.txt)
+- [Color inspection](/packages/colors/0.1.1/operations/color-inspection.txt)
+- [Color contrast and difference measurement](/packages/colors/0.1.1/operations/color-measurement.txt)
+- [Color provenance](/packages/colors/0.1.1/operations/color-provenance.txt)
+- [Named palette reference](/packages/colors/0.1.1/operations/named-palette-reference.txt)
+- [Palette candidate generation and review](/packages/colors/0.1.1/operations/palette-candidate.txt)

package/public/packages/colors/0.1.1/operations/color-conversion.txt

@@ -0,0 +1,14 @@
+# Color conversion and gamut mapping
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: operation
+ID: color-conversion
+Guide: [colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## Covered public surfaces
+
+- `.#ColorConversionResult`
+- `.#GamutMappingResult`
+- `.#OutputGamut`
+- `.#convertColor`
+- `.#mapColorToGamut`

package/public/packages/colors/0.1.1/operations/color-inspection.txt

@@ -0,0 +1,23 @@
+# Color inspection
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: operation
+ID: color-inspection
+Guide: [colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## Covered public surfaces
+
+- `.#ColorComponents`
+- `.#ColorDiagnostic`
+- `.#ColorDiagnosticCode`
+- `.#ColorInput`
+- `.#ColorRecord`
+- `.#ColorValidationResult`
+- `.#DtcgColorComponent`
+- `.#DtcgColorToken`
+- `.#DtcgColorValue`
+- `.#StructuredColor`
+- `.#SupportedColorSpace`
+- `.#normalizeColor`
+- `.#parseColor`
+- `.#validateColor`

package/public/packages/colors/0.1.1/operations/color-measurement.txt

@@ -0,0 +1,18 @@
+# Color contrast and difference measurement
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: operation
+ID: color-measurement
+Guide: [colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## Covered public surfaces
+
+- `.#ColorDifferenceMethod`
+- `.#ColorDifferenceReport`
+- `.#ContrastMeasurement`
+- `.#ContrastReport`
+- `.#DifferenceMeasurement`
+- `.#calculateColorDifference`
+- `.#calculateContrast`
+- `.#colorDifference`
+- `.#contrastRatio`

package/public/packages/colors/0.1.1/operations/color-provenance.txt

@@ -0,0 +1,14 @@
+# Color provenance
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: operation
+ID: color-provenance
+Guide: [colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## Covered public surfaces
+
+- `.#ColorProvenance`
+- `.#ColorSource`
+- `.#SeedPreservationPolicy`
+- `.#SeedPreservationResult`
+- `.#createColorProvenance`

package/public/packages/colors/0.1.1/operations/named-palette-reference.txt

@@ -0,0 +1,15 @@
+# Named palette reference
+
+Source: @flowstack-ui/colors@0.1.1
+Kind: operation
+ID: named-palette-reference
+Guide: [colors-system](/packages/colors/0.1.1/guides/colors-system.txt)
+
+## Covered public surfaces
+
+- `.#NAMED_PALETTE_NAMES`
+- `.#NamedPaletteName`
+- `.#NamedPaletteReference`
+- `.#TwelveStepScale`
+- `.#getNamedPalette`
+- `.#isNamedPaletteName`