PtcRunner.Lisp.Java.Surface (PtcRunner v0.14.0)

Copy Markdown View Source

Compile-time authority for the bounded PTC-Lisp Java compatibility surface.

The surface is data, not reflection. priv/java_interop.exs owns admitted classes and references, JVM descriptors, closed dispatch routes, audit targets, and documentation projections. Every admitted overload resolves to a code-owned Java handler. Pinned JVM oracle fixtures independently attest the executable descriptor inventory.

Summary

Functions

Returns one Java audit with stable manifest target/reference IDs removed for public compatibility.

Returns sorted Java audit keys.

Returns Java audit specifications used by docs and upstream checks.

Returns one Java audit including stable manifest identities.

Returns Java namespace labels for analyzer diagnostics.

Returns the canonical implemented-function name for one accepted namespace member.

Returns every admitted source spelling owned by a Java class.

Returns admitted and inventory-only Java class records.

Returns string-to-atom Java namespace mappings used by Registry documentation lookup.

Fetches a Java audit specification.

Fetches one admitted or inventory Java class by stable ID.

Fetches one Java overload by stable ID.

Fetches one Java reference by stable ID.

Returns Java-owned implemented-function presentation rows.

Returns generated Java interop reference presentation rows.

Returns true when an ID names a finite manifest-derived instance member family.

Returns true when a direct-dot spelling names an admitted member family.

Returns true when namespace is owned by the Java surface.

Returns Java compatibility namespace categories for Env diagnostics.

Returns the currently accepted source members of a Java namespace.

Returns admitted overload records on validated closed dispatch routes.

Returns the canonical inert label for a Java reference.

Returns admitted Java reference records.

Appends manifest projections after rejecting legacy generic Java rows.

Resolves a direct-dot source spelling to its finite instance member family.

Resolves a plain constructor source spelling to its admitted reference.

Resolves a bounded Java class/member source identity.

Returns all Java namespace atoms admitted by the source vocabulary.

Returns the validated manifest version.

Functions

audit(key)

@spec audit(atom()) :: [map()]

Returns one Java audit with stable manifest target/reference IDs removed for public compatibility.

audit_keys()

@spec audit_keys() :: [atom()]

Returns sorted Java audit keys.

audit_specs()

@spec audit_specs() :: [map()]

Returns Java audit specifications used by docs and upstream checks.

audit_targets(key)

@spec audit_targets(atom()) :: [map()]

Returns one Java audit including stable manifest identities.

available_namespace_labels()

@spec available_namespace_labels() :: [String.t()]

Returns Java namespace labels for analyzer diagnostics.

canonical_function_name(namespace, member)

@spec canonical_function_name(atom() | String.t(), atom() | String.t()) ::
  String.t() | nil

Returns the canonical implemented-function name for one accepted namespace member.

class_spellings()

@spec class_spellings() :: [String.t()]

Returns every admitted source spelling owned by a Java class.

classes()

@spec classes() :: [map()]

Returns admitted and inventory-only Java class records.

doc_namespaces()

@spec doc_namespaces() :: %{required(String.t()) => atom()}

Returns string-to-atom Java namespace mappings used by Registry documentation lookup.

fetch_audit_spec(key)

@spec fetch_audit_spec(atom()) :: {:ok, map()} | :error

Fetches a Java audit specification.

fetch_class(class_id)

@spec fetch_class(atom()) :: {:ok, map()} | :error

Fetches one admitted or inventory Java class by stable ID.

fetch_overload(overload_id)

@spec fetch_overload(atom()) :: {:ok, map()} | :error

Fetches one Java overload by stable ID.

fetch_reference(reference_id)

@spec fetch_reference(atom()) :: {:ok, map()} | :error

Fetches one Java reference by stable ID.

function_entries()

@spec function_entries() :: [map()]

Returns Java-owned implemented-function presentation rows.

interop_entries()

@spec interop_entries() :: [map()]

Returns generated Java interop reference presentation rows.

member_family?(member_family_id)

@spec member_family?(atom()) :: boolean()

Returns true when an ID names a finite manifest-derived instance member family.

member_family_spelling?(spelling)

@spec member_family_spelling?(atom() | String.t()) :: boolean()

Returns true when a direct-dot spelling names an admitted member family.

namespace?(namespace)

@spec namespace?(atom() | String.t()) :: boolean()

Returns true when namespace is owned by the Java surface.

namespace_categories()

@spec namespace_categories() :: %{required(atom()) => atom()}

Returns Java compatibility namespace categories for Env diagnostics.

namespace_members(namespace)

@spec namespace_members(atom() | String.t()) :: [atom() | String.t()]

Returns the currently accepted source members of a Java namespace.

overloads()

@spec overloads() :: [map()]

Returns admitted overload records on validated closed dispatch routes.

reference_label(reference_id)

@spec reference_label(atom()) :: {:ok, String.t()} | :error

Returns the canonical inert label for a Java reference.

references()

@spec references() :: [map()]

Returns admitted Java reference records.

replace_function_entries(entries)

@spec replace_function_entries([map()]) :: [map()]

Appends manifest projections after rejecting legacy generic Java rows.

resolve_member_family(spelling)

@spec resolve_member_family(atom() | String.t()) :: {:ok, atom()} | :error

Resolves a direct-dot source spelling to its finite instance member family.

resolve_plain_reference(spelling)

@spec resolve_plain_reference(atom() | String.t()) :: {:ok, map()} | :error

Resolves a plain constructor source spelling to its admitted reference.

resolve_reference(namespace, member)

@spec resolve_reference(atom() | String.t(), atom() | String.t()) ::
  {:ok, map()} | :unknown_member | :not_java_class

Resolves a bounded Java class/member source identity.

source_namespace_atoms()

@spec source_namespace_atoms() :: [atom()]

Returns all Java namespace atoms admitted by the source vocabulary.

version()

@spec version() :: pos_integer()

Returns the validated manifest version.