@funeste38/freeland-bros

freeland-bros is the visual and diagnostic layer on top of freeland.

Where freeland answers:

• what is this value?
• how is it normalized?
• is it compatible with a target runtime?

freeland-bros answers:

• how do I project that value into a stable RGBA / cube space?
• how do I explain incompatibility quickly?
• what is the minimal transition plan from one runtime target to another?

It uses:

• freeland for typed resolution
• @funeste38/morphing for RGBA / compact transport primitives

Install

npm install @funeste38/freeland-bros

Main ideas

Every resolved value becomes a cube:

• r = kind
• g = format
• b = runtime
• a = state

Example:

{
  r: "executable",
  g: "native-binary",
  b: "railway",
  a: "compatible"
}

API

• resolveBrosCube(input, options) resolves a Freeland input and returns both the typed value and the cube
• brosCubeFromValue(value, runtime?) projects an existing Freeland value into cube space
• diagnoseBrosCompatibility(valueOrCube, targetRuntime) returns a short compatibility report
• buildBrosTransitionPlan(valueOrCube, targetRuntime) returns symbolic transitions
• projectBrosCubeToRgba(cube) returns an RGBA tuple via morphing
• rotateBrosCube(cube, axis, turns?) applies deterministic symbolic rotations

Example

import {
  resolveBrosCube,
  diagnoseBrosCompatibility,
  projectBrosCubeToRgba
} from "@funeste38/freeland-bros";

const { value, cube } = await resolveBrosCube(
  'manifest:json:{"kind":"executable","variants":{"windows":"path:./bin/piper.exe","linux":"path:./bin/piper"}}',
  { runtime: "railway" }
);

const diagnostic = diagnoseBrosCompatibility(value, "railway");
const rgba = projectBrosCubeToRgba(cube);

console.log(value, cube, diagnostic, rgba);

Why this package exists

This layer keeps the core packages clean:

• freeland stays a parser / normalizer / adapter
• morphing stays a low-level binary primitive
• freeland-bros handles symbolic cube logic, visual projection and explanation

Development

npm install
npm run build
npm test

License

MIT