README
U
AsyncState
U
Attr
U
ComponentRef
U
Context
U
EventHandler
U
MatchCase
U
Node
U
Owner
U
Resource
U
Signal
U
Trigger
U
TriggerType
U
TrustedHtml
U
VAsync
U
VElement
U
VErrorBoundary
U
VInternalRef
U
VSwitch
U
VWcIsland
V
action
V
all
V
any
V
async_
V
attr_dynamic
V
attr_dynamic_style
V
attr_handler
V
attr_static
V
attr_style
V
batch
V
batch_end
V
batch_start
V
combine2
V
combine3
V
combine4
V
component
V
component_ref
V
computed
V
create_context
V
create_root
V
create_root_with_dispose
V
deferred
V
effect
V
effect_once
V
effect_when
V
error_boundary
V
event_handler
V
flatten
V
for_each
V
fragment
V
get_owner
V
h
V
handler
V
handler_from_callback
V
has_dynamic_content
V
has_owner
V
internal_ref
V
match_case
V
memo
V
on
V
on_cleanup
V
on_immediate
V
on_mount
V
previous
V
previous_with_initial
V
provide
V
raw_html
V
raw_trusted_html
V
register_disposer
V
register_owner_cleanup
V
render_effect
V
resource
V
resource_rejected
V
resource_resolved
V
run_with_owner
V
select
V
show
V
signal
V
switch_
V
text
V
text_dyn
V
text_of
V
unsafe_trusted_html
V
untracked
V
use_context
V
watch
V
watch_immediate
V
wc_component_ref
V
wc_island

#Stella

Shard generation module for Island embedding.

#Overview

A Shard is a hydratable HTML fragment in Island Architecture. Marked with luna:* attributes, the loader detects and hydrates them on the client.

#File Structure

File	Responsibility
types.mbt	Shard config and output type definitions
html_builder.mbt	HTML generation utilities
serializer.mbt	JSON/HTML escape processing

#Shard Output Example

<div luna:id="counter"
     luna:url="/static/counter.js"
     luna:state='{"count":0}'
     luna:client-trigger="load">
  <!-- SSR content -->
</div>

#Main Types

#ShardConfig

pub struct ShardConfig {
  id : String              // Component ID (luna:id)
  script_url : String      // Hydration script (luna:url)
  trigger : TriggerType    // Trigger (luna:client-trigger)
  state : StateConfig      // State config
  ssr_content : String?    // SSR HTML
  include_loader : Bool    // Embed loader
  loader_url : String      // Loader URL
}

#StateConfig

pub enum StateConfig {
  Empty                  // No state
  Inline(String)         // Embed in luna:state attribute
  ScriptRef(String)      // Reference to <script id="...">
  Url(String)            // Fetch from external URL
}

#Security

XSS escape processing in serializer.mbt
</script> in JSON is escaped
HTML attribute values are properly quoted

#References

Luna Core - TriggerType definition
Sol - Island integration implementation

ShardConfig

source

pub struct ShardConfig {
  id : String
  script_url : String
  trigger : @mizchi/luna/core.TriggerType
TriggerType
  state : StateConfig
  ssr_content : String?
  include_loader : Bool
  loader_url : String
}

Configuration for generating a shard snippet

ShardConfig::new

source

fn ShardConfig::new(id : String, script_url : String) -> ShardConfig

Create a minimal shard config

ShardConfig::with_default_loader

source

fn ShardConfig::with_default_loader(self : ShardConfig) -> ShardConfig

Builder pattern: include loader script with default URL

ShardConfig::with_loader

source

fn ShardConfig::with_loader(self : ShardConfig, url : String) -> ShardConfig

Builder pattern: include loader script

ShardConfig::with_ssr_content

source

fn ShardConfig::with_ssr_content(self : ShardConfig, content : String) -> ShardConfig

Builder pattern: set SSR content

ShardConfig::with_state

source

fn ShardConfig::with_state(self : ShardConfig, json : String) -> ShardConfig

Builder pattern: set inline state from JSON string

ShardConfig::with_state_ref

source

fn ShardConfig::with_state_ref(self : ShardConfig, script_id : String) -> ShardConfig

Builder pattern: set state from script reference

ShardConfig::with_state_url

source

fn ShardConfig::with_state_url(self : ShardConfig, url : String) -> ShardConfig

Builder pattern: set state from URL

ShardConfig::with_trigger

source

fn ShardConfig::with_trigger(self : ShardConfig, trigger : @mizchi/luna/core.TriggerType
TriggerType) -> ShardConfig

Builder pattern: set trigger

ShardOutput

source

pub struct ShardOutput {
  html : String
  head_scripts : Array[String]
  state_scripts : Array[String]
}

Output from shard generation

StateConfig

source

pub(all) enum StateConfig {
  Empty
  Inline(String)
  ScriptRef(String)
  Url(String)
}

How state is provided

auto_select_state_format

source

fn auto_select_state_format(json : String, base_config : ShardConfig) -> ShardConfig

Estimate the recommended state format based on JSON size

default_loader_url

source

let default_loader_url : String

Default loader URL

format_state_attr

source

fn format_state_attr(state : StateConfig) -> String?

Format state for luna:state attribute Returns the attribute value based on StateConfig

generate_lazy_shard

source

fn generate_lazy_shard(id : String, script_url : String, state_json : String, ssr_content : String) -> String

Generate shard with visible trigger

generate_minimal_shard

source

fn generate_minimal_shard(id : String, script_url : String, state_json : String, ssr_content : String) -> String

Generate minimal shard (no loader, inline state)

generate_shard

source

fn generate_shard(config : ShardConfig) -> ShardOutput

Generate the complete shard HTML

generate_shard_group

source

fn generate_shard_group(loader_url : String, configs : Array[ShardConfig]) -> String

Generate multiple shards that share a single loader

generate_shard_with_state_script

source

fn generate_shard_with_state_script(config : ShardConfig, state_json : String) -> ShardOutput

Generate shard with automatic state script Use this when you have large state that should be in a separate script tag

generate_standalone_shard

source

fn generate_standalone_shard(id : String, script_url : String, loader_url : String, state_json : String, ssr_content : String) -> String

Generate standalone shard (with loader)

generate_state_script

source

fn generate_state_script(id : String, json : String) -> String

Generate a element for state Used when state is too large for inline attribute

recommend_state_format

source

fn recommend_state_format(json_size : Int) -> String

Recommended state format based on size

< 1KB: Inline in attribute
1KB - 100KB: Script reference
100KB: URL reference (needs server support)

Source Files

Site source Report issue Packages Build queue Skills Statistics

#Stella

#Overview

#File Structure

#Shard Output Example

#Main Types

#ShardConfig

#StateConfig

#Security

#References

#ShardConfig

#ShardConfig::new

#ShardConfig::with_default_loader

#ShardConfig::with_loader

#ShardConfig::with_ssr_content

#ShardConfig::with_state

#ShardConfig::with_state_ref

#ShardConfig::with_state_url

#ShardConfig::with_trigger

#ShardOutput

#StateConfig

#auto_select_state_format

#default_loader_url

#format_state_attr

#generate_lazy_shard

#generate_minimal_shard

#generate_shard

#generate_shard_group

#generate_shard_with_state_script

#generate_standalone_shard

#generate_state_script

#recommend_state_format

Source Files

ShardConfig

ShardConfig::new

ShardConfig::with_default_loader

ShardConfig::with_loader

ShardConfig::with_ssr_content

ShardConfig::with_state

ShardConfig::with_state_ref

ShardConfig::with_state_url

ShardConfig::with_trigger

ShardOutput

StateConfig

auto_select_state_format

default_loader_url

format_state_attr

generate_lazy_shard

generate_minimal_shard

generate_shard

generate_shard_group

generate_shard_with_state_script

generate_standalone_shard

generate_state_script

recommend_state_format